/v1/3d/tasks/:taskIdFree · 0 creditsTasks & Polling
Poll the current progress and download URLs of an asynchronous 3D generation job. The status moves from PENDING to IN_PROGRESS, then ends as SUCCEEDED, FAILED or CANCELLED. Poll every 2–3 seconds; generation usually takes a few minutes. Failed and cancelled jobs refund their credits automatically.
Overview
Poll the current progress and download URLs of an asynchronous 3D generation job. The status moves from PENDING to IN_PROGRESS, then ends as SUCCEEDED, FAILED or CANCELLED. Poll every 2–3 seconds; generation usually takes a few minutes. Failed and cancelled jobs refund their credits automatically.
Path & query parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| taskId# | string | required | — | The job identifier returned by /v1/3d/text-to-3d or /v1/3d/image-to-3d. |
The job identifier returned by /v1/3d/text-to-3d or /v1/3d/image-to-3d.
Response
Successful requests return the job object. Errors use the status codes below.
Authentication errors
401 — Invalid or revoked API key. 402 — Not enough credits.
curl -X GET https://backend.hydrilla.ai/v1/3d/tasks/job_9b1deb4d3b7d4e8b82 \
-H "Authorization: Bearer hyd_live_your_api_key_here"import requests
import time
taskId = "job_9b1deb4d3b7d4e8b82"
headers = {"Authorization": "Bearer hyd_live_your_api_key_here"}
while True:
res = requests.get(f"https://backend.hydrilla.ai/v1/3d/tasks/{taskId}", headers=headers).json()
status = res.get("status")
print(f"Status: {status} ({res.get('progress', 0)}%)")
if status == "SUCCEEDED":
print("Download GLB:", res["result"]["mesh_url"])
break
elif status in ("FAILED", "CANCELLED"):
print("Job failed:", res.get("error"))
break
time.sleep(3)const taskId = "job_9b1deb4d3b7d4e8b82";
const headers = { "Authorization": "Bearer hyd_live_your_api_key_here" };
const pollTask = async () => {
const res = await fetch(`https://backend.hydrilla.ai/v1/3d/tasks/${taskId}`, { headers });
const data = await res.json();
if (data.status === "SUCCEEDED") {
console.log("3D Mesh ready:", data.result.mesh_url);
return data.result;
}
if (data.status === "FAILED" || data.status === "CANCELLED") {
throw new Error(data.error);
}
await new Promise((r) => setTimeout(r, 3000));
return pollTask();
};{
"id": "job_9b1deb4d3b7d4e8b82",
"object": "task",
"type": "text-to-3d",
"status": "SUCCEEDED",
"progress": 100,
"status_message": null,
"model": "bluefox-1",
"result": {
"mesh_url": "https://storage.googleapis.com/hydrilla-meshes/job_9b1deb4d3b7d4e8b82.glb",
"preview_image_url": "https://storage.googleapis.com/hydrilla-meshes/job_9b1deb4d3b7d4e8b82_thumb.png",
"format": "glb",
"model": "bluefox-1"
},
"error": null,
"created_at": 1790762400,
"updated_at": 1790762442
}Response fields
- id string
- object string
- type string
- status string
- progress number
- status_message null
- model string
result object
- mesh_url string
- preview_image_url string
- format string
- model string
- error null
- created_at number
- updated_at number
{
"error": "Unauthorized",
"message": "Invalid or revoked API key."
}{
"id": "job_9b1deb4d3b7d4e8b82",
"object": "task",
"status": "FAILED",
"progress": 0,
"result": null,
"error": "GPU worker error during reconstruction. Credits refunded."
}