---
title: Video 1.0
description: Retiring soon. Compatibility alias for Video Router Auto.
---

**Retiring soon.** Video 1.0 is a compatibility alias for [Video Router Auto](/models/videos).
For new integrations, use `POST /v1/videos` with `model: "sume/auto"`.
The URLs below keep accepting their legacy request shape but use the same Auto
model selection, capability validation, and pricing. Job receipts report
`sume/auto`. Retired `routing_preset` values are accepted and ignored.

Primary invoke URL:

```text
POST /v1/video-1.0/generate
```

Model-run alias (same body):

```text
POST /v1/models/sume/video-1.0/runs
```

Public model id: `sume/video-1.0`.

## When to use

| Goal | Approach |
|---|---|
| Text → video | `prompt` only |
| Image → video | `prompt` + `image_url` (first frame) |
| Start + end frames | `image_url` + `end_image_url` |
| Reference-guided | `reference_image_urls` and/or `reference_video_urls` (optional `reference_audio_urls` with at least one image or video reference) |

Use public HTTPS media URLs only.

## Request fields

| Field | Required | Notes |
|---|---|---|
| `prompt` | Yes | Non-empty string. |
| `image_url` | No | First-frame image URL. Prefer over deprecated `first_frame_url`. |
| `end_image_url` | No | End-frame image URL. Requires `image_url` (or deprecated `first_frame_url`). Prefer over deprecated `last_frame_url`. |
| `reference_image_urls` | No | 1–9 image URLs. |
| `reference_video_urls` | No | 1–3 video URLs. |
| `reference_audio_urls` | No | 1–3 audio URLs; requires at least one reference image or video. |
| `resolution` | No | Validated against the Auto serving family. Omit to use its default. Legacy `720p` and `4k` are not supported by the current Auto family. |
| `duration` | No | Integer seconds, validated against the Auto serving family. Prefer over `duration_seconds`. If both are set, they must agree. |
| `duration_seconds` | No | Alias of `duration`. |
| `bitrate_mode` | No | Retained in the legacy shape; rejected by Auto. |
| `aspect_ratio` | No | `auto`, `adaptive`, `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`. |
| `generate_audio` | No | Boolean. The current Auto family always generates audio; omit this field. |
| `routing_preset` | No | Deprecated and ignored: `cost`, `speed`, `quality`, `grok`, `kling`. All use Auto. |
| `metadata` | No | Caller metadata stored on the job; not sent to the provider. |
| `mode` | No | `async`, `sync`, `subscribe`, `webhook`. |
| `webhook_url` | No | Public HTTPS callback for webhook mode. |
| `wait_timeout_seconds` | No | 0–30 for `sync` / `subscribe`. |

The legacy URL does **not** accept a `model` body field. To select a family,
use `POST /v1/videos` with a catalog model ID.

## Create a video job

<!-- api-call-example:video-generate -->

Image-to-video example:

```bash
curl -X POST https://api.sume.com/v1/video-1.0/generate \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: video-i2v-001" \
  -d '{
    "prompt": "Gentle camera drift; keep the product locked in frame",
    "image_url": "https://example.com/first-frame.png",
    "resolution": "1080p",
    "duration": 6,
    "aspect_ratio": "16:9"
  }'
```

## Poll and fetch the result

```bash
curl https://api.sume.com/v1/jobs/job_123/status \
  -H "Authorization: Bearer $SUME_API_KEY"

curl https://api.sume.com/v1/jobs/job_123/events \
  -H "Authorization: Bearer $SUME_API_KEY"

curl https://api.sume.com/v1/jobs/job_123/result \
  -H "Authorization: Bearer $SUME_API_KEY"
```

Follow `next_action` from the submit envelope (`poll_status`, then
`fetch_result`). Full lifecycle details live in
[Jobs and results](/workflows/jobs-and-results).

## Artifacts

Completed Video 1.0 jobs return Sume-hosted video (and sometimes image) artifacts:

```json
{
  "id": "job_...",
  "status": "completed",
  "result": {
    "artifacts": [
      {
        "id": "artifact_...",
        "type": "video",
        "url": "https://media.sume.com/artifacts/...",
        "content_type": "video/mp4"
      }
    ]
  }
}
```

Treat artifact URLs as opaque. Do not parse paths for workspace, job, or
provider identifiers.

## Next

- [Image 1.0](/models/image) for stills / first frames
- [Avatar video](/models/avatar-videos) for talking-head scripts on a reusable avatar
- [Generation admission](/workflows/generation-admission) for queue and concurrency behavior