POST /videos/generation requires an Idempotency-Key header of up to 255 characters. Use a fresh UUID for every new job.
How keys behave
Keys are unique within your workspace and never expire.
Retrying safely
If a request times out or returns 500, retry with the same key and the exact same body. You get the job that was created, or a new one if the first attempt never reached CreatOK.
To submit a new job after a failure, such as a job that failed with model_busy, use a new key. Reusing the key returns the same failed job.
Store the idempotency key with your own record before you send the request. Then a crash between sending and saving the job ID cannot create a duplicate job.