Check one video model first: GET /v1/video-router/models/{id}

Before you spend on a clip, read one model's limits with GET /v1/video-router/models/{model_id}. It returns capabilities and price, and 404s on an unknown id.

3 min readSume
All posts

The cheapest failed video request is the one you never send. Sume's Video Router has a one-model endpoint for exactly this: GET /v1/video-router/models/{model_id}. It returns the same row as the catalog list, and answers 404 when the id is not in the catalog.

What the row tells you

The Video Router docs say the limits differ by model, so read capabilities and do not assume one envelope.

  • Resolutions, durations and which of first_frame, last_frame, image, video and audio references the model accepts.
  • Whether audio is a toggle or always on. MiniMax H3 and Gemini Omni Flash 1.1 have native audio with no toggle.
  • Price: the row's per-model rate already includes Sume's 1.25 multiple, and billable_formula is the per-model truth.

Examples that matter

Limits from the Video Router docs (read 2026-10-05)
Model idResolutionsDurationsNotes
seedance-2.5480p, 720p, 1080p4 to 30 sNo bitrate_mode
kling-3720p, 1080p4 to 15 sNo reference URLs
minimax-h3480p, 768p5 to 15 s768p is native, not 720p
gemini-omni-flash-1.1360p to 4K3 to 10 s16:9 or 9:16 only

A guard in Python

This helper fetches one model's row and raises when the id is not in the catalog. Print the row, then compare your length against the duration range it reports before you submit. The response envelope uses data; adapt to the row you receive.

import os

import requests

BASE = "https://api.sume.com/v1/video-router"
HEADERS = {"Authorization": "Bearer " + os.environ["SUME_API_KEY"]}


def model_row(model_id):
    r = requests.get(BASE + "/models/" + model_id, headers=HEADERS, timeout=30)
    if r.status_code == 404:
        raise ValueError(model_id + " is not in the Sume catalog")
    r.raise_for_status()
    return r.json()


row = model_row("seedance-2.5")
print(row)

Try it with an id from a launch announcement. If it 404s, the model is not available through Sume yet, whatever its vendor page says.

Sources

Related posts

More in Developers

All Developers posts

Written by Sume