Suzanne
Sign inGet started
Browse docs

Quickstart

Submit a text-to-3D job, poll for completion, and download the GLB in 60 seconds.

The fastest path from API key to downloaded mesh. Submit a job, poll until it's done, and grab the GLB.

KEY="sk_test_xxx"
BASE="https://api.suzanne3d.com"
 
# 1. Submit a job
JOB=$(curl -sS -X POST "$BASE/v1/generations/text-to-3d" \
  -H "Authorization: Bearer $KEY" \
  -H "content-type: application/json" \
  -d '{"model":"sculptor","prompt":"a low-poly fox, game-ready"}' \
  | python -c "import sys,json;print(json.load(sys.stdin)['job_id'])")
 
# 2. Poll until done (typical: 30s – 2min)
while true; do
  STATE=$(curl -sS "$BASE/v1/jobs/$JOB" -H "Authorization: Bearer $KEY" \
    | python -c "import sys,json;print(json.load(sys.stdin)['status'])")
  echo "status: $STATE"
  [[ "$STATE" == "done" || "$STATE" == "failed" || "$STATE" == "cancelled" ]] && break
  sleep 5
done
 
# 3. Download the mesh
curl -sSL "$BASE/v1/models/$JOB/download?format=glb" \
  -H "Authorization: Bearer $KEY" -o out.glb

Next steps