Hydrilla
Get API Key
GET/v1/3d/tasksFree · 0 credits

List 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

ParameterTypeRequiredDefaultDescription
limit#integeroptional20How 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.

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

Was this page helpful?