---
title: API reference
description: Every operation of the Sume Open API.
---
**Base URL** `https://api.open.sume.com` · **Auth** `Authorization: Bearer <key>` or `x-api-key: <key>` · **Body** JSON

Every successful response wraps its body in `data`. Errors return one `error` object; see [Errors and retries](/docs/errors). Every response carries `x-sume-request-id`.

## Images

| Operation | Endpoint |
|---|---|
| [Generate an image](/docs/reference/images/generate) | `POST /v1/image-router/generate` |
| [List image models](/docs/reference/images/list-models) | `GET /v1/image-router/models` |
| [Get an image model](/docs/reference/images/get-model) | `GET /v1/image-router/models/{model_id}` |

## Video

| Operation | Endpoint |
|---|---|
| [Generate a video](/docs/reference/video/generate) | `POST /v1/video-router/generate` |
| [List video models](/docs/reference/video/list-models) | `GET /v1/video-router/models` |
| [Get a video model](/docs/reference/video/get-model) | `GET /v1/video-router/models/{model_id}` |

## Jobs

| Operation | Endpoint |
|---|---|
| [Get job status](/docs/reference/jobs/status) | `GET /v1/jobs/{id}/status` |
| [Get a job result](/docs/reference/jobs/result) | `GET /v1/jobs/{id}/result` |
| [Get a job](/docs/reference/jobs/get) | `GET /v1/jobs/{id}` |
| [List jobs](/docs/reference/jobs/list) | `GET /v1/jobs` |
| [Cancel a job](/docs/reference/jobs/cancel) | `POST /v1/jobs/{id}/cancel` |

## Models and prices

| Operation | Endpoint |
|---|---|
| [List open models](/docs/reference/catalog/list) | `GET /v1/open/catalog` |
| [Get an open model](/docs/reference/catalog/get) | `GET /v1/open/catalog/{model_id}` |
| [Estimate a price](/docs/reference/catalog/estimate) | `POST /v1/open/estimate` |
| [Top up your balance](/docs/reference/billing/top-up) | `POST /v1/open/top-ups` |
| [Get a top-up](/docs/reference/billing/get-top-up) | `GET /v1/open/top-ups/{id}` |