Hydrilla
Get API Key
GET/v1/3d/tasks/:taskIdFree · 0 credits

Tasks & 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.

AuthenticationAuthorization: Bearer hyd_live_your_api_key_here
Base URLhttps://backend.hydrilla.ai

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

ParameterTypeRequiredDefaultDescription
taskId#stringrequired—The job identifier returned by /v1/3d/text-to-3d or /v1/3d/image-to-3d.
taskIdrequired
string

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.

bashrequest.sh
curl -X GET https://backend.hydrilla.ai/v1/3d/tasks/job_9b1deb4d3b7d4e8b82 \
  -H "Authorization: Bearer hyd_live_your_api_key_here"
json200_SUCCESS.json
{
  "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

Was this page helpful?