Video 1.0
Retiring 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 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:
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 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
Generate a Video 1.0 job
POST /v1/video-1.0/generate
Required
Image-to-video example:
Poll and fetch the result
Follow next_action from the submit envelope (poll_status, then
fetch_result). Full lifecycle details live in
Jobs and results.
Artifacts
Completed Video 1.0 jobs return Sume-hosted video (and sometimes image) artifacts:
Treat artifact URLs as opaque. Do not parse paths for 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