AI3D for agents

Connect

How an agent connects

1. Read the agent guide, then call GET /v2/models at runtime. Use only the model IDs it returns.
2. Authenticate from a trusted server with a customer API key in the Authorization header. Never put a key in a public client.
3. Submit with POST /v2/jobs and an Idempotency-Key. Poll GET /v2/jobs/{job_id} until the status is succeeded, failed, or submission_unknown.

Jobs reserve prepaid credits before dispatch, so check the price list first. Retry timeouts with the same Idempotency-Key, and never resubmit a submission_unknown job automatically.

# 1. See which models are enabled right now
curl https://api.ai3d.dev/v2/models

# 2. Submit a job (customer API key with write permission)
curl -X POST https://api.ai3d.dev/v2/jobs \
  -H "Authorization: Bearer $AI3D_API_KEY" \
  -H "Idempotency-Key: my-unique-key-1" \
  -H "Content-Type: application/json" \
  -d '{"model":"MODEL_ID","image_url":"https://example.com/input.png"}'

# 3. Poll until the job finishes
curl https://api.ai3d.dev/v2/jobs/JOB_ID \
  -H "Authorization: Bearer $AI3D_API_KEY"

Replace MODEL_ID with an ID from step 1. The model guide names the source field each model expects.