POST
https://octopusx.ai
/
v1
/
videos
Jimeng Video Generation
curl --request POST \
  --url https://octopusx.ai/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "seconds": "<string>",
  "size": "<string>"
}
'
{
  "id": "video_123",
  "task_id": "video_123",
  "object": "video",
  "model": "jimeng-video-3.0",
  "status": "queued",
  "progress": 0,
  "created_at": 1712697600
}

​
Jimeng Video Generation

OpenAI-format entry point. If you need to use the unified video POST /v1/video/create, see Generate Video. Jimeng currently uses POST /v1/videos to submit tasks, primarily via multipart/form-data.
  • The route entry is POST /v1/videos.
  • Currently submitted via multipart/form-data.
  • The reference image is passed as a single file through the input_reference field.
  • After a successful submission, the task id and status are returned, and you can later poll the result via Task Status Query.

​
Supported Models

  • jimeng-video-3.0
  • jimeng-video-2.0

​
Method and Path

POST /v1/videos

​
Request Example

curl -X POST https://octopusx.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=jimeng-video-3.0" \
  -F "prompt=猫咪在草地上追逐蝴蝶" \
  -F "seconds=5" \
  -F "size=1280x720"

​
Image-to-Video Example

# 带参考图的请求示例
curl -X POST https://octopusx.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=jimeng-video-3.0" \
  -F "prompt=让人物向前走并微笑" \
  -F "seconds=5" \
  -F "size=720x1280" \
  -F "input_reference=@/path/to/image.png"

​
Response Example

{
  "id": "video_123",
  "task_id": "video_123",
  "object": "video",
  "model": "jimeng-video-3.0",
  "status": "queued",
  "progress": 0,
  "created_at": 1712697600
}

​
Authentication

Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
required
Model name. Supports jimeng-video-3.0 and jimeng-video-2.0.
​
prompt
string
required
Prompt describing the video content. Supports Chinese and English.
​
input_reference
file
Reference image. Upload a single image file for image-to-video scenarios. Supported image formats include png, jpeg, jpg, and webp.
​
seconds
string
Video duration in seconds. Available values: 5, 10, 15.
​
size
string
Video size. Available values: 720x1280 (portrait), 1280x720 (landscape). Defaults to 720x1280.

​
Current Rules

ItemRule
Default durationIf not explicitly provided, defaults to 5 seconds
Default sizeIf not explicitly provided, defaults to 720x1280
Reference imageUpload a single image file via input_reference
Reference image formatsSupports png, jpeg, jpg, and webp