動画生成

This page includes the Midjourney video sub-endpoint together with Hailuo, Sora-2, Veo 3, Alibaba Qwen, and Vidu video APIs.

Apifox のカバー範囲

• Sora-2: create video, create with Character, remix, official chat format, two async query modes, fetch video content
• Veo 3: official format, OpenAI-compatible format, and paired query endpoints
• Additional video vendors: Doubao, Jimeng, Kling, Alibaba Qwen, Vidu, OpenAI-compatible vendor endpoints, and Hailuo

Midjourney

POST 14. Generate Video

POST /mj/submit/video

Executes a video action and submits a task. After submission, use the task ID to query status. Video buttons can be triggered through the action endpoint.

Body Parameters

{
  "prompt": "飞来一只蜜蜂",
  "motion": "low",
  "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRYE4elHfZ6kxSlyKAQU7UOs6TCo3SM6pLBfg&s",
  "endImage": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSViuCyuU-LlfhKz-scHtFnMpnvvvaMVXVpHw&s",
  "loop": false
}

Request Parameters

Name	In	Type	Required	Description
body	body	any	No	none

Response Example

200 Response

null

Responses

Status	Meaning	Description	Model
200	OK	none	Inline
201	Created	none	Inline
401	Unauthorized	none	Inline
403	Forbidden	none	Inline
404	Not Found	none	Inline

Response Schema

モデル API / 動画生成

POST Hailuo (Create Video)

POST /videos

Body Parameters

model: MiniMax-Hailuo-2.3
prompt: A calico cat playing a piano on stage
seconds: "10"
input_reference: ""
size: ""

Request Parameters

Name	In	Type	Required	Description
body	body	object	No	none
» model	body	string	Yes	Video generation model. Defaults to sora-2.
» prompt	body	string	Yes	Text prompt describing the video to generate.
» seconds	body	string	No	Video duration in seconds.
» input_reference	body	string(binary)	No	Optional image reference used to guide generation.
» size	body	string	No	Width x height. The exact numeric value is not enforced; width > height means landscape, width < height means portrait.

Response Example

200 Response

{}

Responses

Status	Meaning	Description	Model
200	OK	none	Inline

Response Schema

モデル API / 動画生成 / Sora-2

POST Sora-2 (Edit Video Remix)

POST /videos/{id}/remix

Body Parameters

{
    "prompt": "让这个video背景变成草地"
}

Request Parameters

Name	In	Type	Required	Description
id	path	string	Yes	none
Authorization	header	string	Yes	none
body	body	object	No	none

Response Example

200 Response

{}

Responses

Status	Meaning	Description	Model
200	OK	none	Inline

Response Schema

GET Fetch Video Content

GET /videos/{task_id}/content

Fetches the video file contents for a completed video task. This endpoint proxies the video file stream back to the client.

Request Parameters

Name	In	Type	Required	Description
task_id	path	string	Yes	Video task ID.
Content-Type	header	string	No	none
Accept	header	string	No	none
Authorization	header	string	No	none

Response Example

200 Response

null

Responses

Status	Meaning	Description	Model
200	OK	none	Inline
401	Unauthorized	none	Inline
403	Forbidden	none	Inline
404	Not Found	none	Inline

Response Schema

モデル API / 動画生成 / Veo 3

GET Fetch Video (Official Format)

GET /videos/{id}

Available only on the full-model dedicated route group.

Request Parameters

Name	In	Type	Required	Description
id	path	string	Yes	none
Content-Type	header	string	No	none
Accept	header	string	No	none
Authorization	header	string	No	none

Response Example

200 Response

null

Responses

Status	Meaning	Description	Model
200	OK	none	Inline
401	Unauthorized	none	Inline
403	Forbidden	none	Inline
404	Not Found	none	Inline

Response Schema

モデル API / 動画生成 / Alibaba Qwen

GET Fetch Video (Async Task)

GET /videos/{video_id}

Body Parameters

{}

Request Parameters

Name	In	Type	Required	Description
video_id	path	string	Yes	none
Authorization	header	string	Yes	none
body	body	object	No	none

Response Example

200 Response

{}

Responses

Status	Meaning	Description	Model
200	OK	none	Inline

Response Schema

モデル API / 動画生成 / Vidu

POST Vidu Text-to-Video

POST /video/generations

API docs:

Body Parameters

{
    "model": "viduq1",
    "prompt": "一个穿着宇航服的宇航员在月球上行走, 高品质, 电影级",
    "size": "1920x1080",
    "image": "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png",
    "duration": 5,
    "metadata": {
        "duration": 5,
        "seed": 0,
        "resolution": "1080p",
        "movement_amplitude": "auto",
        "bgm": false,
        "payload": "",
        "callback_url": "https://your-callback-url.com/webhook"
    }
}

Request Parameters

Name	In	Type	Required	Description
Authorization	header	string	No	none
body	body	object	No	none

Response Example

200 Response

{
  "created": 0,
  "data": [
    {
      "url": "string"
    }
  ]
}

Responses

Status	Meaning	Description	Model
200	OK	none	Inline

Response Schema

Status 200

Name	Type	Required	Constraints	Chinese Name	Description
» created	integer	true	none		none
» data	[object]	true	none		none
»» url	string	true	none		none

GET Fetch Video

GET /video/generations/{task_id}

Request Parameters

Name	In	Type	Required	Description
task_id	path	string	Yes	Task ID
Content-Type	header	string	No	none
Accept	header	string	No	none
Authorization	header	string	No	none

Response Example

200 Response

null

Responses

Status	Meaning	Description	Model
200	OK	none	Inline
401	Unauthorized	none	Inline
403	Forbidden	none	Inline
404	Not Found	none	Inline

Response Schema