Create a new job
POST/v1/jobs
Submit a ComfyUI workflow for execution. The job will be queued and processed by an available GPU node.
Authentication Required: Include your API key in the Authorization header.
Rate Limits: Requests are subject to rate limiting based on your account tier:
- Free: 60 requests/minute, 2 concurrent jobs, 5 queue depth
- Pro: 300 requests/minute, 10 concurrent jobs, 50 queue depth
- Enterprise: 1000 requests/minute, 50 concurrent jobs, 500 queue depth
Idempotency: Optionally include an idempotency_key to ensure duplicate requests return the same response.
Response Codes:
- 201: Job created AND completed (only when
sync=trueand job finishes within timeout) - 202: Job accepted for async processing (default), or sync timeout
Request
Responses
- 201
- 202
- 400
- 401
- 409
- 429
- 500
Job created and completed synchronously (only returned when sync=true and job finishes within timeout)
Response Headers
Maximum requests per minute
Remaining requests in current window
Unix timestamp when the rate limit resets
Job accepted for asynchronous processing (default response, or when sync=true times out)
Response Headers
Maximum requests per minute
Remaining requests in current window
Unix timestamp when the rate limit resets
Job's position in the queue
Invalid request (malformed workflow, invalid URL, etc.)
Authentication failed (missing or invalid API key)
Idempotency conflict (different request body with same key)
Rate limit exceeded or queue full
Response Headers
Seconds to wait before retrying
Internal server error