> ## Documentation Index > Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Seedance 1.0 Pro 图生视频 > Seedance 1.0 Pro API 可将静态图片转为 5 秒或 10 秒的视频，用文本引导场景和运动。 > [!TIP] > > 1. 提交后会返回 `task_id`。如果提供了 `callback_url`，当任务状态变为 `finished` 或 `failed` 时，系统会向 `callback_url` 发送 POST 请求。 > 2. 无论是否提供 `callback_url`，都可以通过统一的[查询任务状态](https://docs.vidgo.ai/zh/api-manual/task-management/status.md)接口获取结果。 使用 Seedance 1.0 Pro 将静态图片转为 5 秒或 10 秒的视频，用文本引导场景和运动。 ## 模型 * **bytedance/seedance/v1/pro/image-to-video** - 根据输入图片生成视频。 ## 功能 * 根据输入图片生成视频。 * `image_urls` 中只接受恰好 1 张图片。 * 输出分辨率可选 `720p`、`1080p`。 ## 时长选项 * **5、10 秒** - 将 `duration` 设为数值整数。可选。仅在省略时默认为 **5 秒**。字符串、布尔值、null 和小数会被拒绝。`5.0` 这样的数值等同于 `5`。 ## 高级参数 `model` 和可选的 `callback_url` 放在请求根级。所有工作流参数（包括输出选项）都放在 `input` 中。 只传本工作流支持的 input 字段。不支持的 `input` 字段会在扣除积分前被拒绝。输入 URL 必须使用 HTTP(S)、包含主机名，且不能内嵌凭证或包含空白。默认值仅在省略可选 input 字段时生效；显式传入 null 或空值会被拒绝。 ### 提示词 * `prompt`：必填字符串。描述场景和期望的运动。去除首尾空白后，长度必须为 **1-10,000 个 Unicode 字符**。非字符串值会被拒绝。 * 传入时值不能为空白。 ### 图片 URL * `image_urls`：必填。提供可公开访问的图片 URL。恰好传 1 项，每项必须是 HTTP(S) URL。Base64、用裸字符串代替数组以及空数组都会被拒绝。 ### 分辨率 * `resolution`：可选。可选值：`720p`、`1080p`。仅在省略时默认为 `720p`。别名、大小写不同、带首尾空白或数值形式的值都会被拒绝。 ## 计费因素 计费取决于输出分辨率（`resolution`）和视频时长（`duration`）。文生视频和图生视频使用相同费率。 积分在提交时扣除，任务失败时退还。 ## OpenAPI ````yaml zh/api-manual/video-series/bytedance-seedance-v1-pro-image-to-video.json POST /api/generate/submit openapi: 3.0.0 info: title: Vidgo API - Seedance 1.0 Pro 图生视频 description: 使用 Seedance 1.0 Pro 将静态图片转为 5 秒或 10 秒的视频，用文本引导场景和运动。 version: 1.0.0 servers: - url: https://api.vidgo.ai security: - BearerAuth: [] paths: /api/generate/submit: post: tags: - Video Series summary: Seedance 1.0 Pro 图生视频 description: >- 按文档说明的输入类型和取值传参。prompt 必须是字符串，去除首尾空白后为 1–10,000 个 Unicode 字符。duration 必须是数值 5 或 10，字符串和小数会被拒绝。resolution 必须是 720p 或 1080p。图片输入要求恰好一个带主机名的 HTTP(S) URL，不能内嵌凭证或包含空白；不支持 Base64。 operationId: submit_bytedance_seedance_v1_pro_image_to_video requestBody: required: true content: application/json: schema: type: object required: - model - input additionalProperties: true properties: model: type: string example: bytedance/seedance/v1/pro/image-to-video input: type: object required: - image_urls - prompt description: 生成所需的输入参数 properties: prompt: type: string description: 必填字符串；先去除首尾空白，再校验长度为 1–10,000 个 Unicode 字符。 maxLength: 10000 example: >- Animate this exact outdoor loom scene in one continuous five-second shot. The same Ghanaian weaver throws the wooden shuttle once through the open shed, then beats the weft so the navy-and-gold cloth settles with a slight sag. Preserve her face, hair, clothing, loom geometry, textile pattern, mango-tree background, and camera framing. Very slow gentle lateral camera drift. Tactile wood and cloth physics. No extra people, no cuts, no lettering, no logos, no brands, no advertising, no watermark. minLength: 1 image_urls: type: array items: type: string format: uri maxItems: 1 description: 恰好一个带主机名的 HTTP(S) 图片 URL，不能内嵌凭证或包含空白。Base64 和裸字符串会被拒绝。 example: - >- https://cdn.vidgo.ai/apis/models/bytedance/seedance/v1/pro/image-to-video/v1/01/input.png minItems: 1 resolution: type: string description: 仅支持 720p 或 1080p。仅在省略时默认为 720p；别名、null 和空字符串会被拒绝。 enum: - 720p - 1080p example: 720p default: 720p duration: type: integer description: 数值整数 5 或 10 秒。仅在省略时默认为 5；字符串、布尔值、null 和小数会被拒绝。 enum: - 5 - 10 example: 5 default: 5 additionalProperties: false callback_url: type: string nullable: true description: 可选，接收任务完成通知的公开 HTTP(S) 地址，建议使用 HTTPS。省略、传 null 或传空字符串即不启用回调。 description: >- model 和可选的 callback_url 放在根级。不支持的 input 字段会被拒绝。默认值仅对省略的字段生效；null 和空的 input 值会被拒绝。 examples: basic: summary: 肯特布织机梭子 value: model: bytedance/seedance/v1/pro/image-to-video input: prompt: >- Animate this exact outdoor loom scene in one continuous five-second shot. The same Ghanaian weaver throws the wooden shuttle once through the open shed, then beats the weft so the navy-and-gold cloth settles with a slight sag. Preserve her face, hair, clothing, loom geometry, textile pattern, mango-tree background, and camera framing. Very slow gentle lateral camera drift. Tactile wood and cloth physics. No extra people, no cuts, no lettering, no logos, no brands, no advertising, no watermark. resolution: 720p duration: 5 image_urls: - >- https://cdn.vidgo.ai/apis/models/bytedance/seedance/v1/pro/image-to-video/v1/01/input.png callback: summary: 肯特布织机梭子（含完成回调） value: model: bytedance/seedance/v1/pro/image-to-video input: prompt: >- Animate this exact outdoor loom scene in one continuous five-second shot. The same Ghanaian weaver throws the wooden shuttle once through the open shed, then beats the weft so the navy-and-gold cloth settles with a slight sag. Preserve her face, hair, clothing, loom geometry, textile pattern, mango-tree background, and camera framing. Very slow gentle lateral camera drift. Tactile wood and cloth physics. No extra people, no cuts, no lettering, no logos, no brands, no advertising, no watermark. resolution: 720p duration: 5 image_urls: - >- https://cdn.vidgo.ai/apis/models/bytedance/seedance/v1/pro/image-to-video/v1/01/input.png callback_url: https://your-domain.com/callback responses: '200': description: 任务已提交 content: application/json: schema: type: object required: - code - data properties: code: type: integer enum: - 200 data: type: object required: - task_id - status - created_time properties: task_id: type: string status: type: string enum: - not_started - running - finished - failed created_time: type: string format: date-time example: code: 200 data: task_id: task-unified-example status: running created_time: '2026-09-10T08:00:00' '400': description: 输入无效、档位不支持、媒体无法访问或积分不足 content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '401': description: 凭证无效 content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '403': description: 拒绝访问 content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '404': description: 模型未知或已停用 content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '408': description: 请求超时 content: text/plain: schema: type: string example: Request timeout '422': description: JSON 无效或请求体不是对象 content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '429': description: 超出速率限制或 API Key 积分限额 content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '500': description: 内部错误 content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '502': description: 无法创建上游生成任务 content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '503': description: 所请求的模型暂时不可用 content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} components: securitySchemes: BearerAuth: type: http scheme: bearer description: 使用 VIDGO_API_KEY。 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.