> ## Documentation Index > Fetch the complete documentation index at: https://docs.aitoearn.ai/llms.txt > Use this file to discover all available pages before exploring further. # 生成视频 > 接口说明：提交视频生成任务，可传入参考图片、视频、音频。任务异步执行，返回 taskId 用于轮询结果。 调用本接口前，请先请求[「视频生成模型」](/api-reference/get-api-ai-models-video-generation)接口（`GET /api/ai/models/video/generation`），获取当前可用的模型列表及各模型的参数限制（分辨率、时长、宽高比、参考媒体约束与价格），再据此填写本接口参数。 ## OpenAPI ````yaml /openapi/zh/aitoearn.openapi.json post /api/ai/video/generations openapi: 3.0.1 info: title: AiToEarn 开放平台 API description: AiToEarn 开放平台 API，支持在中国站与国际站之间切换调试。业务是否成功以响应体 code === 0 为准。 version: 1.0.0 contact: {} servers: - url: https://aitoearn.cn description: 中国站 - url: https://aitoearn.ai description: 国际站 security: [] tags: - name: AI 服务 - name: AI 服务/视频生成 - name: AI 服务/图像生成 - name: 渠道管理 - name: 渠道管理/账号 - name: 渠道管理/内容发布 - name: 渠道管理/平台 - name: 渠道管理/作品 - name: 渠道管理/账号分组 - name: 渠道管理/授权 - name: 资源管理 - name: AI 服务/大语言模型 paths: /api/ai/video/generations: post: tags: - AI 服务/视频生成 summary: 生成视频 description: >- 接口说明：提交视频生成任务，可传入参考图片、视频、音频。任务异步执行，返回 taskId 用于轮询结果。 调用本接口前，请先请求[「视频生成模型」](/api-reference/get-api-ai-models-video-generation)接口（`GET /api/ai/models/video/generation`），获取当前可用的模型列表及各模型的参数限制（分辨率、时长、宽高比、参考媒体约束与价格），再据此填写本接口参数。 operationId: VideoController_videoGeneration parameters: [] requestBody: content: application/json: schema: type: object properties: model: type: string description: >- 视频生成模型名称。先调用[「视频生成模型」](/api-reference/get-api-ai-models-video-generation)接口（`GET /api/ai/models/video/generation`），传入其返回的 `data[n].name`；各模型支持的分辨率、时长、宽高比与价格以该接口返回为准。 minLength: 1 prompt: type: string minLength: 1 maxLength: 4000 description: 提示词，长度 1-4000 字符 images: description: >- 参考图片 URL 列表。最大数量与格式限制随模型而不同，以[「视频生成模型」](/api-reference/get-api-ai-models-video-generation)接口返回的 `data[n].maxInputImages` 和 `data[n].inputConstraints` 为准。 type: array items: type: string videos: description: >- 参考视频 URL 列表。是否支持视频输入，以及数量、格式、时长、大小限制随模型而不同，以[「视频生成模型」](/api-reference/get-api-ai-models-video-generation)接口返回的 `data[n].modes` 和 `data[n].inputConstraints` 为准。 type: array items: type: string audios: description: >- 参考音频 URL 列表。是否支持音频输入，以及数量、格式、时长、大小限制随模型而不同，以[「视频生成模型」](/api-reference/get-api-ai-models-video-generation)接口返回的 `data[n].modes` 和 `data[n].inputConstraints` 为准。 type: array items: type: string resolution: type: string description: >- 视频分辨率。可选值随模型而不同，以[「视频生成模型」](/api-reference/get-api-ai-models-video-generation)接口返回的 `data[n].resolutions` 为准。 enum: - 480p - 720p - 1080p ratio: description: >- 视频宽高比。可选值随模型而不同，以[「视频生成模型」](/api-reference/get-api-ai-models-video-generation)接口返回的 `data[n].aspectRatios` 为准。 type: string duration: description: >- 视频时长（秒）。可选范围随模型而不同，以[「视频生成模型」](/api-reference/get-api-ai-models-video-generation)接口返回的 `data[n].durations` 为准。 type: number required: - model - prompt examples: '1': value: model: seedance-2-beta-1080p prompt: 生成一条旅行 vlog 风格视频，图片作为主体参考，视频作为运动参考，音频作为节奏参考，画面自然真实 images: - https://example.com/input/character.png videos: - https://example.com/input/motion-reference.mp4 audios: - https://example.com/input/music-reference.mp3 resolution: 1080p ratio: '9:16' duration: 12 summary: 多参考生成视频 '2': value: model: seedance-2-fast-beta prompt: 一盏智能台灯在现代摄影棚中缓缓亮起，镜头平滑推进，画面干净高级，产品反光自然 resolution: 480p ratio: '16:9' duration: 6 summary: 文本生成视频 required: true responses: '200': description: 请求已被服务处理。业务是否成功以响应体 code === 0 为准。 content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/VideoGenerationResponseVo' code: type: integer description: 业务状态码。0 表示成功，非 0 表示业务错误。 message: type: string description: 响应消息。 requestId: type: string description: 请求 ID。 timestamp: type: integer description: 错误响应时间戳，Unix 毫秒。 required: - code - message examples: success: summary: 成功 value: code: 0 message: 请求成功 data: id: string status: string validationFailed10002: summary: ValidationFailed (10002) value: code: 10002 message: 参数验证失败 data: {} timestamp: 1772099056662 unauthorized401: summary: 未认证或 API Key 无效 value: code: 401 message: Unauthorized data: {} timestamp: 1772099056662 aiVideoGenerationUnsupportedMode12310: summary: AiVideoGenerationUnsupportedMode (12310) value: code: 12310 message: 不支持的视频生成模式 data: {} timestamp: 1772099056662 invalidModel12300: summary: InvalidModel (12300) value: code: 12300 message: 无效的 AI 模型 data: {} timestamp: 1772099056662 materialGroupNotFound12801: summary: MaterialGroupNotFound (12801) value: code: 12801 message: 素材分组未找到 data: {} timestamp: 1772099056662 deprecated: false security: - apikey-header-X-Api-Key: [] components: schemas: VideoGenerationResponseVo: type: object properties: id: type: string description: 任务 ID status: type: string description: 任务状态 required: - id - status additionalProperties: false securitySchemes: apikey-header-X-Api-Key: type: apiKey in: header name: X-Api-Key description: AiToEarn Open Platform API Key。 ````