3D generation API

3D Generation

Generate 3D meshes from text or images using Hunyuan3D, Seed3D, and more.

Endpoint

POST /api/generate

Available models

Model key	Provider	Text-to-3D	Image-to-3D
`tripo3d`	Tencent Hunyuan3D Pro	✓	✓
`meshy3`	Hunyuan3D + Seed3D	✓	✓
`luma-genie`	Tencent Hunyuan3D Pro	✓	✓
`csm`	Hunyuan3D Rapid	✓	✓

Request body

Parameter	Type	Required	Description
`modelKey`	string	✓	One of: `tripo3d`, `meshy3`, `luma-genie`, `csm`
`prompt`	string	✓	Description of the 3D object
`inputUrl`	string		Image URL (for image-to-3D). If omitted, text-to-3D is used.

Text-to-3D example

curl -X POST https://api.oyefilmy.com/api/generate \
  -H "Authorization: Bearer of_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "modelKey": "tripo3d",
    "prompt": "A low-poly medieval castle with a moat and drawbridge"
  }'

Image-to-3D example

curl -X POST https://api.oyefilmy.com/api/generate \
  -H "Authorization: Bearer of_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "modelKey": "meshy3",
    "prompt": "Convert this product photo into a 3D model",
    "inputUrl": "https://your-bucket.s3.amazonaws.com/product.png"
  }'

Output format

3D models are returned as downloadable GLB files (GL Transmission Format Binary). The outputUrl in the success response points to the GLB file.

{
  "status": "completed",
  "outputUrl": "https://oyefilmy-assets.s3.amazonaws.com/.../model.glb",
  "outputType": "3d"
}

Tip: 3D generation typically takes 30–90 seconds. Use webhooks for production workflows.