Video 1.0
Sume will retire this API soon. Video 1.0 is a compatibility alias for Video Router Auto.
For new integrations, use POST /v1/videos with model: "sume/auto".
The URLs below continue to accept their legacy request shape. But they use the
same Auto model selection, capability validation, and prices. Job receipts show
sume/auto. The API accepts retired routing_preset values and ignores them.
Primary invoke URL:
Model-run alias (same body):
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 a minimum of one image or video reference) |
Use only public HTTPS media URLs.
Request fields
| Field | Required | Notes |
|---|---|---|
prompt | Yes | Non-empty string. |
image_url | No | First-frame image URL. We recommend it over the deprecated first_frame_url. |
end_image_url | No | End-frame image URL. You must also send image_url (or the deprecated first_frame_url). We recommend it over the 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. You must also send a minimum of one reference image or video. |
resolution | No | Sume validates it against the Auto serving family. From this legacy vocabulary, that family supports 720p (the default if you do not send it) and 1080p. This URL rejects 4k. For 4K, use POST /v1/videos with sume/auto. |
duration | No | Integer seconds. Sume validates it against the Auto serving family. We recommend it over duration_seconds. If you set the two fields, they must agree. |
duration_seconds | No | Alias of duration. |
bitrate_mode | No | The legacy shape keeps it, but Auto rejects it. |
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. Do not send this field. |
routing_preset | No | Deprecated. Sume ignores these values: cost, speed, quality, grok, kling. All of them use Auto. |
metadata | No | Caller metadata that Sume stores on the job. Sume does not send it 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
Generate a Video 1.0 job
POST /v1/video-1.0/generate
Required
Image-to-video example:
Poll and fetch the result
Obey next_action from the submit envelope (poll_status, then
fetch_result). For the full lifecycle details, refer to
Jobs and results.
Artifacts
Completed Video 1.0 jobs return Sume-hosted video artifacts (and in some cases, image artifacts):
Artifact URLs are opaque. Do not parse their paths to find workspace, job, or provider identifiers.
Next
- Image 1.0 for stills / first frames
- Avatar video for talking-head scripts on a reusable avatar
- Generation admission for queue and concurrency behavior