Generate a 3D model
POST /v1/3d/generations
prompt and image_url must be present. A prompt longer than 5000 characters is refused.Authorizations
API key in format: Bearer inf_***
Body
Slug of the 3D model to run, as listed by GET /v1/models. Must be an object_3d-modality model served by FAL; anything else is rejected with 400.
Text prompt for text-to-3D. Either prompt (non-blank) or image_url must be supplied; both may be. Rejected above 5000 characters.
5000"A low-poly wooden chair"
Reference image for image-to-3D, as a URL. Forwarded onto the model's own image input field when it declares one, and dropped otherwise. Either prompt or image_url must be supplied.
"https://example.com/reference.png"
An existing mesh to transform, as a URL. This is what the 3D-to-3D models take — rigging, remesh, retexture, segment. Forwarded onto whichever field the model's own schema declares for it (mesh_url on hi3d and tripo, model_url on meshy). A model that transforms a mesh REQUIRES this and is refused without it; a model that generates one refuses it.
"https://storage.googleapis.com/…/chair.glb"
Seed forwarded onto the model's own seed input field when it declares one, and dropped otherwise. Reproducibility therefore depends on the model exposing a seed.
Response
The generated mesh. data normally holds a single artifact.
Unix timestamp, in seconds, of when the result was produced.
1713204900
One entry per produced mesh, in the order the provider returned them.
Credits actually settled for this request (1 credit = $0.01). Settled against measured compute for per_second models, clamped to the amount reserved before the call, so it is never larger than the hold. May be fractional.
25