Create Video (Multimodal Reference-to-Video)

POST

/v1/videos

Model IDs:

sora-v3-fast

sora-v3-pro

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

{
    "model": "sora-v3-fast",
    "prompt": "Replace the perfume in video 1 box with the cream in picture 1, while keeping the camera movement unchanged.",
    "seconds": "8",
    "reference_images": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_edit_pic1.jpg"
    ],
    "reference_videos": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_edit_video1.mp4"
    ],
    "video_config": {
        "aspect_ratio": "16:9",
        "resolution_name": "720p"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.aiide.com/v1/videos' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "sora-v3-fast",
    "prompt": "Replace the perfume in video 1 box with the cream in picture 1, while keeping the camera movement unchanged.",
    "seconds": "8",
    "reference_images": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_edit_pic1.jpg"
    ],
    "reference_videos": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_edit_video1.mp4"
    ],
    "video_config": {
        "aspect_ratio": "16:9",
        "resolution_name": "720p"
    }
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "id": "string",
    "task_id": "string",
    "object": "string",
    "model": "string",
    "status": "string",
    "progress": 0,
    "created_at": 0
}

🟠429Rate Limit

🟠400Bad Request

Modified at 2026-09-10 06:21:30

Create Video (Text-to-Video)

Get Video Generation Task Status