Video 1.0
Video 1.0 is Sume's optimal video-model router. Send a prompt (and optional
frames/references); Sume picks the best available video model for the job.
Steer only with routing_preset (cost, speed, quality, grok, kling) —
never with a provider model id. Job receipts always report sume/video-1.0.
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 | 480p, 720p, 1080p. 1080p uses the high-resolution lane, which is capped at 15 seconds. 4k is reserved and rejected in v1. |
duration | No | Integer seconds. 4–30 on the default/quality lane at 480p/720p; 4–15 for cost, speed, grok, kling, and any 1080p request. Prefer over duration_seconds. If both are set, they must agree. |
duration_seconds | No | Alias of duration. |
bitrate_mode | No | standard, high. |
aspect_ratio | No | auto, adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16. |
generate_audio | No | Boolean. |
routing_preset | No | Sume-owned routing hint: cost, speed, quality, grok, kling. Omitting it is equivalent to quality; cost and speed share the fast lane. Never a provider model id. |
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. |
Video 1.0 does not accept a model body field. Use routing_preset for
Sume-owned routing hints only.
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