Skip to main content
POST
/
v1
/
videos
Create or query video generation tasks
curl --request POST \
  --url https://proxy.innk.cc/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form model=sora-2 \
  --form 'prompt=A cute kitten playing in the sun' \
  --form callback_url=https://example.com/notify \
  --form 'seconds=<string>' \
  --form size=720x1280 \
  --form 'input_reference=<string>' \
  --form 0.input_reference='@example-file'
{
  "id": "task_1234567890",
  "object": "video",
  "created_at": 1759938772,
  "status": "queued"
}

Authorizations

​
Authorization
string
header
required

The authentication header format is Bearer <API_KEY>, where <API_KEY> is your API token.

Headers

​
Content-Type
enum<string>
default:multipart/form-data
required
Available options:
multipart/form-data,
application/json

Body

multipart/form-data
​
model
enum<string>
required

Model name (fixed to sora)

Available options:
sora-2,
sister-2-pro
​
prompt
string
required

Prompt word description generated by video

Example:

"A cute kitten playing in the sun"

​
callback_url
string<type>

Callback notification URL after task completion

Example:

"https://example.com/notify"

​
seconds
string

Video generation duration Reverse channel, sora-2: 10, 15, sora-2-pro: 10, 15, 25, Official transfer channel, sora-2: 4, 8, 12

​
size
enum<string>

Video generation size

Available options:
720x1280,
1280x720,
1024x1792,
1792x1024
​
input_reference
file

Enter reference image

Response

200 - application/json

successful response

​
id
string
required

Task ID

Example:

"task_1234567890"

​
object
string
required

Object type

Example:

"video"

​
created_at
integer
required

Creation time

Example:

1759938772

​
status
string

Task status

Example:

"queued"