Keep the same characters in every video
The API does not remember the characters of your last video. Each create request uses exactly the characters it sends in characters.
Leave characters out and the video makes new characters from your prompt, so they look different every time. The universe's cast is not added for you.
To keep a cast: save each character once (on your characters page or with POST /api/v1/characters), read their ids with GET /api/v1/characters, and send the same ids in every create request. A saved character keeps its look and its voice.
An object such as { "name": "Luna", "description": "A wise owl" } only describes a character for that one video. It is not saved and does not carry over.
If you send two saved characters with the same name, the video uses the first one. A universe set to "Only its cast" refuses characters that are not in its cast (universe_cast_only).
{
"prompt": "Catboy Logan helps a lost kitten find home",
"duration": "60",
"animationPreset": "fast",
"videoFormat": "9:16",
"characters": [
"80d3a3c9-3673-46c3-8fab-47d3acf5b72d",
"db129137-0aeb-498c-adc4-b36ab54303c9"
]
}