Generate a 3D model
generate_3dStart a 3D generation and return its job id at once. mode picks the input: text (prompt), image (options with the image URL), multiview (several view images), sketch, or model (edit an existing 3D model). Take the model id and its option names from list_models, and check the price with estimate_cost first: this spends credits. Pass a stable idempotency_key when retrying so a retry replays the same job instead of billing twice. Then call get_job to follow it.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | Which input the model is given. | |
| model | Yes | A 3D model id from list_models. | |
| prompt | No | ||
| options | No | Model-specific options; take the field names from list_models with include_inputs, and price them with estimate_cost first. | |
| idempotency_key | No | Reuse the same value when retrying this exact request. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | Yes | ||
| scene | Yes | ||
| job_id | Yes | Pass to get_job to follow progress. | |
| status | Yes | pending and processing are running; success, partial, failed and canceled are final. 'partial' means some outputs finished and the rest were refunded. | |
| deduped | Yes | True when an earlier call with the same idempotency key already started this job: nothing was charged again. | |
| outputs | Yes | How many results this job makes. | |
| media_type | Yes | ||
| credits_charged | Yes | Credits taken from the balance. |