Skip to main content
POST
/
api
/
open-api
/
v1
/
videos
Create Video Task
curl --request POST \
  --url https://www.jimmyai.cn/api/open-api/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "duration": 123,
  "images": [
    "<string>"
  ]
}
'
{
  "code": "20000",
  "msg": "ok",
  "data": {
    "task_id": "<string>",
    "status": "<string>",
    "model": "<string>",
    "created_at": 123
  }
}

Routes and models

Assign a route in the OpenAPI model config, then call this endpoint. Common Sora examples:
RouteConfig routeModel examplesDuration
Route 1route1sora2-12s12s only
Route 3route3sora2-gz-stable, sora2-gz-spPer model
Route 6route6openai-sora-2, etc.Per model

Route 1 (sora2-12s)

  • duration must be 12
  • orientation: landscape → 16:9, portrait → 9:16
  • Optional images: one reference image URL for image-to-video
  • Query tasks via Query video task
Result URLs are kept for about 3 days; download promptly.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
model
string
required

Model name. Route 1: sora2-12s (duration must be 12). Route 3: sora2-gz-stable, sora2-gz-sp, etc.

prompt
string
required

Text prompt for video generation

duration
integer
required

Duration in seconds. Route 1 sora2-12s must be 12

orientation
enum<string>

Video orientation

Available options:
landscape,
portrait
images
string[]

Reference image URLs

Response

200 - application/json

Task created successfully

code
string
Example:

"20000"

msg
string
Example:

"ok"

data
object