Skip to main content
POST
/
v1
/
assets
Generate an asset
curl --request POST \
  --url https://api.gizmo.antimlabs.com/v1/assets \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "scene_id": "<string>",
  "model": "<string>",
  "asset_pipeline": "auto",
  "persist": true
}
'
{
  "ok": true,
  "scene_id": "jh72k3m4n5p6q7r8",
  "job_id": "job_x9y8z7w6",
  "status": "queued"
}

Headers

authorization
string | null
x-gizmo-service-token
string | null
x-gizmo-user-id
string | null
x-gizmo-convex-user-id
string | null

Body

application/json

Request body for asset generation.

prompt
string
required

Natural language description of the asset

Minimum string length: 1
Example:

"A 6-DOF robotic arm with gripper end-effector"

scene_id
string | null

Target scene ID. If omitted, a default scene is created.

model
string | null

Override the default LLM model

asset_pipeline
enum<string>
default:auto

Geometry pipeline

Available options:
auto,
gizmo,
cad
persist
boolean
default:true

Whether to persist to S3

Response

Job created