Hydrilla
Get API Key
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.

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

Overview

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.

Request bodyapplication/json

ParameterTypeRequiredDefaultDescription
prompt#stringrequired—Text description of the 3D model (e.g. 'A futuristic cyberpunk cybernetic samurai helmet, matte titanium, emissive neon cyan visor').
image_model#objectoptional—Optional provider settings: { provider: 'openai' | 'gemini', quality: 'standard' | 'high', aspect: '1:1' }
Show image_model properties
  • provider string optional · default openaiConcept render provider: openai or gemini.
  • quality string optional · default standardRender quality: standard or high.
  • aspect string optional · default 1:1Concept render aspect ratio.
provider#stringoptionalopenaiConcept render provider: openai or gemini.
quality#stringoptionalstandardRender quality: standard or high.
aspect#stringoptional1:1Concept render aspect ratio.
resolution#numberoptional1536Mesh cascade resolution: 1024 or 1536.
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' }

  • provider string — Concept render provider: openai or gemini.
  • quality string — Render quality: standard or high.
  • aspect string — Concept render aspect ratio.
resolutionoptional
numberdefault: 1536

Mesh cascade resolution: 1024 or 1536.

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 POST https://backend.hydrilla.ai/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
  }'
json200_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://backend.hydrilla.ai/v1/3d/tasks/job_c18ab44d03e192a40"
  }
}
Response fields
  • id string
  • status string
  • prompt string
  • resolution number
  • concept_image_url string
  • created_at string
  • eta_seconds number
  • links object
    • poll string

Was this page helpful?