> ## Documentation Index > Fetch the complete documentation index at: https://docs.powertokens.ai/llms.txt > Use this file to discover all available pages before exploring further. # Vidu 图生视频 viduq3-pro-fast > 使用 Vidu 模型将图片转换为视频。提交任务后，请通过 `GET /vidu/ent/v2/tasks/{task_id}/creations` 查询状态。 使用模型 viduq3-pro-fast。 ## OpenAPI ````yaml api-reference/zh-Hans/zmodelVideo/vidu/viduq3-pro-fast-image-to-video.json POST /vidu/ent/v2/img2video openapi: 3.0.1 info: title: Vidu 图生视频 (viduq3-pro-fast) version: 1.0.0 servers: - url: https://api.powertokens.ai security: [] paths: /vidu/ent/v2/img2video: post: summary: Vidu 图生视频 (viduq3-pro-fast) description: >- 使用 Vidu 模型将图片转换为视频。提交任务后，请通过 `GET /vidu/ent/v2/tasks/{task_id}/creations` 查询状态。 使用模型 viduq3-pro-fast。 operationId: viduImageToVideoViduq3ProFast requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ImageToVideoRequest' examples: basic_image_to_video: summary: 图生视频示例 value: model: viduq3-pro images: - >- https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png prompt: The astronaut waved and the camera moved up. audio: true duration: 5 seed: 0 resolution: 1080p off_peak: false responses: '200': description: 提交成功，返回视频任务对象。 content: application/json: schema: $ref: '#/components/schemas/ImageToVideoResponse' examples: success: summary: 提交成功 value: task_id: your_task_id_here state: created model: viduq3-pro-fast images: - >- https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png prompt: The astronaut waved and the camera moved up. duration: 5 seed: 123456789 resolution: 1080p payload: '' off_peak: false credits: 10 created_at: '2025-01-01T15:41:31.968916Z' '400': description: 请求参数不合法。 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_request: summary: 参数错误 value: code: bad_request_body message: 请求体格式错误或字段取值非法 data: null '401': description: 鉴权失败。 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unauthorized: summary: 未授权 value: code: access_denied message: 无效的令牌 data: null '429': description: 触发速率限制或账户额度不足。 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: quota_exceeded: summary: 额度不足 value: code: insufficient_user_quota message: 当前账户额度不足，请稍后重试 data: null '500': description: 服务器内部错误。 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: server_error: summary: 服务器错误 value: code: internal_server_error message: 服务器内部错误，请稍后重试 data: null security: - BearerAuth: [] components: schemas: ImageToVideoRequest: type: object required: - model - images properties: model: type: string enum: - viduq3-pro-fast description: |- 视频生成模型名称。 - **viduq3-pro-fast**: 高效生成高质量音视频内容，生成速度更快，性价比高 images: type: array minItems: 1 maxItems: 1 items: type: string description: |- 用作生成视频起始帧的图片。 - 仅接受 1 张图片 - 支持公网 URL 或 Base64 格式 - 支持格式：png, jpeg, jpg, webp - 图片宽高比必须在 1:4 到 4:1 之间 - 单张图片限制 50MB - HTTP 请求体不超过 20MB - Base64 格式示例：`data:image/png;base64,{base64_encode}` prompt: type: string maxLength: 5000 description: |- 文本提示词，用于描述视频生成内容。 注意：如果使用了推荐提示词（is_rec=true），模型将忽略手动输入的 prompt 参数。 is_rec: type: boolean default: false description: |- 是否使用推荐提示词。 - **true**: 是，系统自动生成并应用推荐提示词，推荐提示词数量 = 1 - **false**: 否，根据用户提供的提示词生成视频 注意：启用推荐提示词功能时，每个任务将额外消耗 10 积分。 audio: type: boolean default: false description: |- 是否使用直出音视频能力。 - **false**: 不进行直出音视频，输出无声视频 - **true**: 需要直出音视频，输出有声视频（包含对话和音效） 注意 1：voice_id 参数仅在 audio=true 时生效 注意 2：当此参数为 true 时，不支持交错模式（q3 模型支持交错模式） 注意 3：当 model 为 q3 时，此参数默认值为 true audio_type: type: string enum: - all - speech_only - sound-effect_only default: all description: |- 音频类型，当 audio=true 时必填。 - **all**: 音效+人声 - **speech_only**: 仅人声 - **sound-effect_only**: 仅音效 注意：目前该参数仅支持 q2、q1 和 2.0 系列模型的音频分离。 duration: type: integer description: |- 视频时长（秒）。不同模型的默认值和可用范围： - **viduq3-pro-fast, viduq3-pro, viduq3-turbo**: 默认 5，可用 1-16 minimum: 1 maximum: 16 default: 5 seed: type: integer description: |- 随机种子。 - 默认为随机种子数 - 手动设置值将覆盖默认随机种子 resolution: type: string enum: - 720p - 1080p description: |- 分辨率（基于模型和时长）。 - **viduq3-pro-fast (1-16s)**: 默认 720p，可选 720p, 1080p - **viduq3-pro, viduq3-turbo (1-16s)**: 默认 720p，可选 540p, 720p, 1080p payload: type: string maxLength: 1048576 description: |- 透传参数。 不做处理，仅做数据透传，最大长度 1048576 字符。 off_peak: type: boolean default: false description: |- 错峰模式，默认为：false，可选值： - true：错峰生成视频； - false：即时生成视频； 注1：错峰模式消耗的积分更低，具体请查看产品定价 注2：错峰模式下提交的任务，会在48小时内生成，未能完成的任务会被自动取消，并返还该任务的积分； 注3：您也可以手动取消错峰任务 注4：除q3 外的其他音视频直出功能，都不支持错峰模式 watermark: type: boolean description: |- 是否添加水印 - true：添加水印； - false：不添加水印； 注1：目前水印内容为固定，内容由AI生成，默认不加 注2：您可以通过watermarked_url参数查询获取带水印的视频内容，详情见查询任务接口 default: false wm_position: type: integer description: |- 水印位置，表示水印出现在图片的位置，可选项为： - **1**: 左上角 - **2**: 右上角 - **3**: 右下角 - **4**: 左下角 默认为：3 default: 3 enum: - 1 - 2 - 3 - 4 minimum: 1 maximum: 4 x-options: - label: 左上角 value: 1 - label: 右上角 value: 2 - label: 右下角 value: 3 - label: 左下角 value: 4 wm_url: type: string description: 水印内容，此处为图片URL。不传时，使用默认水印：内容由AI生成 meta_data: type: string description: |- 元数据标识，json格式字符串，透传字段，您可以自定义格式或使用示例格式，示例如下： ```json { "Label": "your_label", "ContentProducer": "your_content_producer", "ContentPropagator": "your_content_propagator", "ProduceID": "your_product_id", "PropagateID": "your_propagate_id", "ReservedCode1": "your_reserved_code1", "ReservedCode2": "your_reserved_code2" } ``` 该参数为空时，默认使用vidu生成的元数据标识 callback_url: type: string description: >- Callback 协议。需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致。 回调返回的 "status" 包括以下状态： - **processing**: 任务处理中 - **success**: 任务完成（如发送失败，回调三次） - **failed**: 任务失败（如发送失败，回调三次） ImageToVideoResponse: type: object properties: task_id: type: string description: 任务 ID。 state: type: string enum: - created - queueing - processing - success - failed description: |- 任务处理状态： - **created**: 任务创建成功 - **queueing**: 任务排队中 - **processing**: 任务处理中 - **success**: 生成成功 - **failed**: 任务失败 model: type: string description: 本次调用使用的模型参数。 prompt: type: string description: 本次调用使用的文本提示词。 images: type: array items: type: string description: 本次调用使用的图片列表。 duration: type: integer description: 本次调用使用的视频时长参数。 audio: type: boolean description: 本次调用是否使用音频。 audio_type: type: string description: 本次调用使用的音频类型参数。 seed: type: integer description: 本次调用使用的随机种子参数。 resolution: type: string description: 本次调用使用的分辨率参数。 payload: type: string description: 本次调用使用的透传参数。 off_peak: type: boolean description: 本次调用使用的错峰模式参数。 credits: type: integer description: 本次调用消耗的积分。 watermark: type: boolean description: 本次提交任务是否使用水印。 created_at: type: string format: date-time description: 任务创建时间。 ErrorResponse: type: object properties: code: type: string description: 错误代码。 message: type: string description: 错误描述信息。 data: type: object nullable: true description: 附加的错误数据（可选）。 securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: '在请求头中传入 `Authorization: Bearer `。' ````