Skip to main content
POST
Reconstruct a complete Team scene

Authorizations

Authorization
string
header
required

Select Personal or your Team in Gizmo, then create a key in API Access. The key selects your library and billing account.

Headers

idempotency-key
string
required
Required string length: 1 - 128
Pattern: ^[A-Za-z0-9._:-]+$

Body

application/json
prompt
string
required
Required string length: 1 - 20000
reference_images
SceneReference · object[]
Maximum array length: 3
max_cost_cents

Optional total scene spending limit: integer cents (1–1000000), or "unlimited" for no total dollar cap. Omit/null uses the server setting. Fixed-priced scenes charge per delivered canonical asset plus assembly; the full planned price must fit this cap before assets start. Older metered releases apply it to usage.

max_asset_definitions
integer
default:50

Fail planning before asset generation if this canonical-design limit is exceeded; never silently truncate the scene.

Required range: 1 <= x <= 100
max_instances
integer
default:100
Required range: 1 <= x <= 500

Response

Successful Response

ok
boolean
required
job_id
string
required
scene_id
string
required
status
string
default:queued
Allowed value: "queued"