GET
/v1/3d/tasksFree · 0 creditsList Tasks
List the account's recent 3D generation tasks, newest first. Use it to find a model that already exists instead of generating it again, or to resume after your app restarts. Finished tasks include result.mesh_url.
AuthenticationAuthorization: Bearer hyd_live_your_api_key_here
Base URLhttps://backend.hydrilla.ai
Overview
List the account's recent 3D generation tasks, newest first. Use it to find a model that already exists instead of generating it again, or to resume after your app restarts. Finished tasks include result.mesh_url.
Request body
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| limit# | integer | optional | 20 | How many tasks to return, from 1 to 100. |
limitoptional
integerdefault: 20
How many tasks to return, from 1 to 100.
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?limit=10" \
-H "Authorization: Bearer hyd_live_your_api_key_here"import requests
headers = {"Authorization": "Bearer hyd_live_your_api_key_here"}
res = requests.get("https://backend.hydrilla.ai/v1/3d/tasks", params={"limit": 10}, headers=headers).json()
for task in res["data"]:
mesh = (task.get("result") or {}).get("mesh_url")
print(task["id"], task["status"], mesh or "")const res = await fetch("https://backend.hydrilla.ai/v1/3d/tasks?limit=10", {
headers: { "Authorization": "Bearer hyd_live_your_api_key_here" },
});
const { data } = await res.json();
const ready = data.filter((task) => task.status === "SUCCEEDED");
console.log(ready.map((task) => task.result.mesh_url));{
"object": "list",
"data": [
{
"id": "job_9b1deb4d3b7d4e8b82",
"object": "task",
"type": "text-to-3d",
"status": "SUCCEEDED",
"prompt": "a medieval treasure chest",
"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
}
],
"has_more": false
}Response fields
- object string
data array
- id string
- object string
- type string
- status string
- prompt string
- model string
result object
- mesh_url string
- preview_image_url string
- format string
- model string
- error null
- created_at number
- updated_at number
- has_more boolean
{
"error": {
"message": "Invalid API key.",
"type": "authentication_error"
}
}