Studio jobs API
Use an images-scoped key — the "Create images key" button on your account page. This is the same card catalogue the studio UI uses, not raw Comfy graphs. For OSS ComfyUI clients, use /comfy instead.
Endpoints
GET /api/meta— public cards and capabilities for this deploymentPOST /api/jobs— enqueue a card (card, prompt, optional uploads)GET /api/jobs/{id}— poll status and output URL
On a chat-only deployment (no image plane), POST /api/jobs returns 501. Chat and /v1 keep working.
Example
curl -sS https://YOUR-HOST/api/meta \
-H "Authorization: Bearer YOUR_IMAGES_KEY"
curl -sS https://YOUR-HOST/api/jobs \
-H "Authorization: Bearer YOUR_IMAGES_KEY" \
-H "Content-Type: application/json" \
-d '{"card":"txt2img","prompt":"a red bicycle on a hill"}'Exact card ids come from /api/meta for your host — do not assume every deployment ships the same set.
Also see
- OpenAI /v1 for chat agents
- Comfy /comfy for graph clients