> ## Documentation Index > Fetch the complete documentation index at: https://docs.aihubmax.com/llms.txt > Use this file to discover all available pages before exploring further. # Seedance 2.5 图生视频 > - Seedance 2.5 图生视频模型，使用一张首帧图片和文本提示词生成视频 - 支持 `480p`、`720p`、`1080p` 分辨率和 `4`–`30` 秒整数时长 - `image_url` 必须是公开可访问的图片 URL - 异步处理模式，使用返回的任务ID [进行查询](/pages/zh/api-manual/task-management/get-task-detail) - 结果中的 `results[i].url` 是统一视频 URL；任务原始结果和视频元数据会保留在 `results[i].result`、`video_url`、`videoUrls`、`resultUrls`、`outputs` 等字段中，详见 [任务查询特殊格式说明](/pages/zh/api-manual/task-management/get-task-detail#特殊格式) ## OpenAPI ````yaml openapi/zh/seedance-2.5-image-to-video.json POST /v1/videos/generations openapi: 3.1.0 info: title: Seedance 2.5 图生视频 version: '1.0' servers: - url: https://api.aihubmax.com security: - BearerAuth: [] paths: /v1/videos/generations: post: tags: - Video > Seedance2.5 summary: Seedance 2.5 图生视频 description: > - Seedance 2.5 图生视频模型，使用一张首帧图片和文本提示词生成视频 - 支持 `480p`、`720p`、`1080p` 分辨率和 `4`–`30` 秒整数时长 - `image_url` 必须是公开可访问的图片 URL - 异步处理模式，使用返回的任务ID [进行查询](/pages/zh/api-manual/task-management/get-task-detail) - 结果中的 `results[i].url` 是统一视频 URL；任务原始结果和视频元数据会保留在 `results[i].result`、`video_url`、`videoUrls`、`resultUrls`、`outputs` 等字段中，详见 [任务查询特殊格式说明](/pages/zh/api-manual/task-management/get-task-detail#特殊格式) operationId: seedance-2.5-image-to-video requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/Seedance25I2VRequest' examples: 图生视频: summary: 图生视频 value: model: seedance-2.5-image-to-video prompt: 镜头缓慢推进，小球继续向右滚动。 image_url: https://picsum.photos/id/237/512/512.jpg resolution: 720p aspect_ratio: '9:16' duration: 5 responses: '200': $ref: '#/components/responses/TaskCreated' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/PaymentRequired' '422': $ref: '#/components/responses/UnprocessableEntity' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' '503': $ref: '#/components/responses/ServiceUnavailable' components: schemas: Seedance25I2VRequest: type: object required: - model - prompt - image_url properties: model: description: '`seedance-2.5-image-to-video`：使用首帧图片和提示词生成视频，支持分辨率和时长参数' examples: - seedance-2.5-image-to-video type: string default: seedance-2.5-image-to-video prompt: description: 描述希望生成的视频内容。 minLength: 1 type: string example: 固定镜头，一只蓝色小球在白色桌面上缓慢从左向右滚动。 resolution: default: 720p description: 输出视频分辨率。系统根据该值选择能够承接请求的模型版本。 type: string example: 480p aspect_ratio: default: '9:16' description: 输出视频宽高比。 type: string example: '16:9' duration: default: 5 description: 输出视频时长（秒）。不同模型版本的可用时长由运行时能力目录继续筛选。 maximum: 30 minimum: 4 type: integer example: 4 image_url: description: 首帧图片的公开 URL。 type: string example: https://picsum.photos/id/237/512/512.jpg TaskResponse: type: object properties: created: type: integer description: 任务创建时间戳 example: 1757165031 id: type: string description: 任务ID example: task-unified-1757165031-uyujaw3d model: type: string description: 实际使用的模型名称 object: type: string description: 任务的具体类型 enum: - video.generation.task progress: type: integer description: 任务进度百分比 (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: 任务状态 enum: - pending - processing - completed - failed example: pending task_info: type: object description: 异步任务信息 properties: can_cancel: type: boolean description: 任务是否可以取消 example: true estimated_time: type: integer description: 预计完成时间（秒） example: 45 type: type: string description: 任务的输出类型 enum: - video example: video ErrorResponse400: type: object properties: error: type: object properties: message: type: string example: 请求格式错误 type: type: string example: invalid_request_error ErrorResponse401: type: object properties: error: type: object properties: message: type: string example: API密钥无效 type: type: string example: authentication_error ErrorResponse402: type: object properties: error: type: object properties: message: type: string example: 账户余额不足 type: type: string example: insufficient_quota ErrorResponse422: type: object properties: error: type: object properties: message: type: string example: 参数校验失败 type: type: string example: validation_error ErrorResponse429: type: object properties: error: type: object properties: message: type: string example: 请求频率超限 type: type: string example: rate_limit_error ErrorResponse500: type: object properties: error: type: object properties: message: type: string example: 服务器内部错误 type: type: string example: server_error ErrorResponse503: type: object properties: error: type: object properties: message: type: string example: 服务暂不可用，请稍后重试 type: type: string example: service_unavailable responses: TaskCreated: description: 任务创建成功 content: application/json: schema: $ref: '#/components/schemas/TaskResponse' BadRequest: description: 请求格式错误 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse400' Unauthorized: description: 未授权 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse401' PaymentRequired: description: 余额不足 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse402' UnprocessableEntity: description: 参数校验失败 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse422' TooManyRequests: description: 请求频率超限 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse429' InternalServerError: description: 服务器内部错误 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse500' ServiceUnavailable: description: 服务暂不可用 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse503' securitySchemes: BearerAuth: type: http scheme: bearer description: | ## 所有接口均需要使用Bearer Token进行认证 ## 使用时在请求头中添加： `Authorization: Bearer YOUR_API_KEY` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.