Skip to content

Create video

POST
/v1/videos
curl --request POST \
--url https://api.mirapi.ai/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form model=sora-2 \
--form 'prompt=cute cat dance' \
--form seconds=8 \
--form input_reference=undefined

OpenAI-compatible video generation endpoint.

Reference: https://platform.openai.com/docs/api-reference/videos/create

Media typemultipart/form-data
object
model

Model name

string
prompt

Prompt

string
seconds

Duration to generate, in seconds

string
input_reference

Reference image file

string format: binary
Example
{
"model": "sora-2",
"prompt": "cute cat dance",
"seconds": "8",
"input_reference": ""
}

Video task created

Media typeapplication/json
object
id
required

Video ID

string
object
required

Object type

string
model
required

Model used

string
status
required

Task status

string
progress
required

Progress percentage

integer
created_at
required

Creation timestamp

integer
seconds
required

Video duration

string
completed_at

Completion timestamp

integer
expires_at

Expiry timestamp

integer
size

Video size

string
error

OpenAI video error

object
message

Error message

string
code

Error code

string
metadata

Additional metadata

object
key
additional properties
any
Example
{
"id": "sora-2-123456",
"object": "video",
"model": "sora-2",
"status": "queued",
"progress": 0,
"created_at": 1764347090922,
"seconds": "8"
}

Invalid request parameters

Media typeapplication/json
object
error
object
message

Error message

string
type

Error type

string
param

Related parameter

string
nullable
code

Error code

string
nullable
Examplegenerated
{
"error": {
"message": "example",
"type": "example",
"param": "example",
"code": "example"
}
}