Getting started
Sume API
Make images and video from your own code. One key, two generate endpoints, and every request turns into a job you poll or get called back about.
At a glance
| Base URL | https://api.sume.com |
| Auth | Authorization: Bearer <key> |
| Keys | Dashboard → API keys |
| Billing | Your workspace balance, in US dollars. Models are billed at the provider's price with 0% markup (Billing). |
| Body | JSON in and out. Successful responses wrap the body in data, errors in error. |
Make a request
This asks gpt-image-2 for one low-quality image, which costs under a cent. The call answers at once with a job; the image arrives a few seconds later.
curl -X POST https://api.sume.com/v1/image-router/generate \
-H "Authorization: Bearer $SUME_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "gpt-image-2",
"prompt": "A ceramic coffee cup on a wooden table, soft morning light",
"quality": "low",
"aspect_ratio": "1:1"
}'202 Accepted
{
"data": {
"request_id": "job_7513b52d-3669-4ffe-b317-8b02000715eb",
"job": {
"id": "job_7513b52d-3669-4ffe-b317-8b02000715eb",
"type": "image_generation",
"status": "queued",
"model": "gpt-image-2",
"created_at": "2026-10-21T02:31:52.075Z",
"result": null,
"error": null
},
"status_url": "https://api.sume.com/v1/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb/status",
"result_url": "https://api.sume.com/v1/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb/result",
"events_url": "https://api.sume.com/v1/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb/events",
"cancel_url": null,
"cancelable": false,
"next_action": "poll_status",
"next_poll_after_seconds": 2,
"terminal": false,
"idempotency_hit": false
}
}How a request runs
- Submit.
POST /v1/image-router/generateor/v1/video-router/generatewith amodeland its inputs. Sume checks the body, reserves the price and answers202with a job id. - Wait. Poll
status_urluntilterminalistrue, or pass awebhook_urland let Sume call you. - Read.
GET result_urlreturns the artifacts, each with a download URL onmedia.sume.com. A failed job is refunded.
Where to go next
- QuickstartA key, one image, the result in four steps.
- AuthenticationMaking keys, sending them, checking them.
- ModelsEvery model id, what it makes and its endpoint.
- ImagesText to image and image edits.
- VideoText, image and reference to video, lip-sync, captions.
- Jobs and pollingStates, intervals, results, cancel.
- WebhooksSigned callbacks when a job ends.
- Errors and retriesError codes and what to do about each.