higgsfield-genjutsu missing from /v1/videos/models: why

If higgsfield-genjutsu is missing from your GET /v1/videos/models list, that is expected: Sume lists it only when its provider is configured. The other eleven catalog ids are always listed. Do not hard-code genjutsu in a pipeline without checking the live list.

What genjutsu is

The Video Router doc describes the row as Motion Transfer only.

How it differs from other rows

Motion Transfer takes the movement from your source video and applies it to the character in your reference images. The row is chosen explicitly: sume/auto never routes to it. video_url is accepted only by this row, h3-max-recast and gemini-omni-flash-1.1.

Check for it first

Check for it before you submit, and fall back or fail clearly.

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()
        ids = {m["id"] for m in r.json()["data"]}
        print("genjutsu available:", "higgsfield-genjutsu" in ids)

asyncio.run(main())

If it is not there

If it is absent, a submit with that id returns 404 model_not_found. For a person swap in an existing video, h3-max-recast is the always-listed alternative; it replaces people with 1-4 photos instead of transferring motion onto a still.