Create a video

OpenAI-compatible video generation endpoint. Reference: https://platform.openai.com/docs/api-reference/videos/create

POST /v1/videos

Service root: https://getrouter.ai

Protocol: Video task API

Authentication: Authorization: Bearer YOUR_API_KEY

Request body

The request body is optional. Media type: multipart/form-data

Request fields

FieldTypeRequiredDescription
modelstringNoModel name
promptstringNoPrompt
secondsstringNoNumber of seconds to generate
input_referencestringNoReference image file

Example request

curl --request POST \
  --url https://getrouter.ai/v1/videos \
  --header "Authorization: Bearer YOUR_API_KEY"

Responses

StatusDescription
200Video task created successfully
400Invalid request parameters

Success response fields

FieldTypeRequiredDescription
idstringYesVideo ID
objectstringYesObject type
modelstringYesModel used
statusstringYesTask status
progressintegerYesProgress percentage
created_atintegerYesCreation timestamp
secondsstringYesVideo duration
completed_atintegerNoCompletion timestamp
expires_atintegerNoExpiration timestamp
sizestringNoVideo dimensions
errorobjectNo
metadataobjectNoAdditional metadata

Example response

{
  "id": "string",
  "object": "object",
  "model": "MODEL_ID",
  "status": "completed",
  "progress": 1,
  "created_at": 1,
  "seconds": "string"
}

For complete workflows and examples, read the Video Generation API Guide.


This page is generated from the public Relay OpenAPI specification. Browse the complete specification in the API Explorer.