---
title: "生成视频"
method: POST
path: "/api/ai/video/generations"
tags: ["AI 服务/视频生成"]
---

# 生成视频

`POST /api/ai/video/generations`

接口说明：提交视频生成任务，可传入参考图片、视频、音频。任务异步执行，返回 taskId 用于轮询结果。

调用本接口前，请先请求[「视频生成模型」](/api-reference/get-api-ai-models-video-generation)接口（`GET /api/ai/models/video/generation`），获取当前可用的模型列表及各模型的参数限制（分辨率、时长、宽高比、参考媒体约束与价格），再据此填写本接口参数。

## Request body

- object
  - `model` string, required — 视频生成模型名称。先调用[「视频生成模型」](/api-reference/get-api-ai-models-video-generation)接口（`GET /api/ai/models/video/generation`），传入其返回的 `data[n].name`；各模型支持的分辨率、时长、宽高比与价格以该接口返回为准。
  - `prompt` string, required — 提示词，长度 1-4000 字符
  - `images` string[] — 参考图片 URL 列表。最大数量与格式限制随模型而不同，以[「视频生成模型」](/api-reference/get-api-ai-models-video-generation)接口返回的 `data[n].maxInputImages` 和 `data[n].inputConstraints` 为准。
  - `videos` string[] — 参考视频 URL 列表。是否支持视频输入，以及数量、格式、时长、大小限制随模型而不同，以[「视频生成模型」](/api-reference/get-api-ai-models-video-generation)接口返回的 `data[n].modes` 和 `data[n].inputConstraints` 为准。
  - `audios` string[] — 参考音频 URL 列表。是否支持音频输入，以及数量、格式、时长、大小限制随模型而不同，以[「视频生成模型」](/api-reference/get-api-ai-models-video-generation)接口返回的 `data[n].modes` 和 `data[n].inputConstraints` 为准。
  - `resolution` '480p' | '720p' | '1080p' — 视频分辨率。可选值随模型而不同，以[「视频生成模型」](/api-reference/get-api-ai-models-video-generation)接口返回的 `data[n].resolutions` 为准。
  - `ratio` string — 视频宽高比。可选值随模型而不同，以[「视频生成模型」](/api-reference/get-api-ai-models-video-generation)接口返回的 `data[n].aspectRatios` 为准。
  - `duration` number — 视频时长（秒）。可选范围随模型而不同，以[「视频生成模型」](/api-reference/get-api-ai-models-video-generation)接口返回的 `data[n].durations` 为准。

## Response `200`

请求已被服务处理。业务是否成功以响应体 code === 0 为准。

- object
  - `data` VideoGenerationResponseVo
    - `id` string, required — 任务 ID
    - `status` string, required — 任务状态
  - `code` integer, required — 业务状态码。0 表示成功，非 0 表示业务错误。
  - `message` string, required — 响应消息。
  - `requestId` string — 请求 ID。
  - `timestamp` integer — 错误响应时间戳，Unix 毫秒。

---

[API](https://skmtc.net/aitoearn/apis/aitoearn-api.md) · [All operations](https://skmtc.net/aitoearn/apis/aitoearn-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aitoearn/aitoearn-api/versions/19d860d9260d/schema)