POST/v1/3d/text-to-3d3 credits (1024) / 5 credits (1536)

Text to 3D Generation

Automated end-to-end pipeline: optimizes your text prompt, generates a multi-view 2D concept render via OpenAI or Gemini, and reconstructs into a 3D mesh via BlueFox 3D.

Authentication

Authorization: Bearer hyd_live_...

Base URL

https://api.hydrilla.co

Request Body(application/json)

Parameter	Type	Description
promptrequired	string	Text description of the 3D model (e.g. 'A futuristic cyberpunk cybernetic samurai helmet, matte titanium, emissive neon cyan visor').
image_modeloptional	object	Optional provider settings: { provider: 'openai' \| 'gemini', quality: 'standard' \| 'high', aspect: '1:1' }
resolutionoptional	number	Mesh cascade resolution: 1024 or 1536.default: 1536

Request Example

BASH

curl -X POST https://api.hydrilla.co/v1/3d/text-to-3d \
  -H "Authorization: Bearer hyd_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Futuristic cyberpunk vehicle, high details, game ready prop",
    "image_model": {
      "provider": "openai",
      "quality": "high"
    },
    "resolution": 1536
  }'

Response

200_SUCCESS.json

{
  "id": "job_c18ab44d03e192a40",
  "status": "queued",
  "prompt": "Futuristic cyberpunk vehicle, high details, game ready prop",
  "resolution": 1536,
  "concept_image_url": "https://hydrilla-assets.s3.amazonaws.com/generated/concept_c18ab.png",
  "created_at": "2026-09-30T10:00:00.000Z",
  "eta_seconds": 60,
  "links": {
    "poll": "https://api.hydrilla.co/v1/3d/tasks/job_c18ab44d03e192a40"
  }
}