/v1/videos canonical_slug: the stable model id to store

Pin the canonical_slug or id from GET /v1/videos/models, not the name. The display name ("Seedance 2.0") is for people. The slug (seedance-2) is what you send as model, and the Sume docs describe canonical_slug as the permanent model identifier.

One catalog row

The catalog row in the Sume docs looks like this. The id and canonical_slug are the same string, and Sume uses bare ids with no provider-org prefix.

Why bare ids

The catalog is a projection of the Video Router catalog, so the ids match what POST /v1/video-router/generate takes. A client that used the legacy surface needs no id remapping.

OpenRouter publishes ids as org/slug. Sume does not: its published contract never has a provider-org prefix. If you port a client written from OpenRouter docs, replace such ids with the bare ids from this catalog.

List the live ids

This script prints every slug and name from the live catalog, so you can diff it against what you pinned.

import asyncio, os
import httpx

async def main():
    headers = {"Authorization": f"Bearer {os.environ['SUME_API_KEY']}"}
    async with httpx.AsyncClient(base_url="https://api.sume.com", headers=headers) as c:
        r = await c.get("/v1/videos/models")
        r.raise_for_status()
        for m in r.json()["data"]:
            print(m["canonical_slug"], "|", m["name"])

asyncio.run(main())

One exception

sume/auto is not in this list. It is a routing pseudo-model that the API accepts as model but does not list. Treat it as a separate value in your config.