> ## 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 Multimodal Reference to Video > - Seedance 2.5 reference-to-video model. Generate video from reference images, videos, or audio. - Supports `480p`, `720p`, and `1080p` resolutions and integer durations from `4` to `30` seconds. - Provide at least one non-empty `image_urls`, `video_urls`, or `audio_urls` array. - Processing is asynchronous. Use the returned task ID to [query task status](/pages/en/api-manual/task-management/get-task-detail). - `results[i].url` is the unified video URL. Original task results and video metadata are preserved in fields such as `results[i].result`, `video_url`, `videoUrls`, `resultUrls`, and `outputs`. See [special task result formats](/pages/en/api-manual/task-management/get-task-detail#special-formats-by-model). ## OpenAPI ````yaml openapi/en/seedance-2.5-reference-to-video.json POST /v1/videos/generations openapi: 3.1.0 info: title: Seedance 2.5 Reference to Video version: '1.0' servers: - url: https://api.aihubmax.com security: - BearerAuth: [] paths: /v1/videos/generations: post: tags: - Video > Seedance2.5 summary: Seedance 2.5 Reference to Video description: > - Seedance 2.5 reference-to-video model. Generate video from reference images, videos, or audio. - Supports `480p`, `720p`, and `1080p` resolutions and integer durations from `4` to `30` seconds. - Provide at least one non-empty `image_urls`, `video_urls`, or `audio_urls` array. - Processing is asynchronous. Use the returned task ID to [query task status](/pages/en/api-manual/task-management/get-task-detail). - `results[i].url` is the unified video URL. Original task results and video metadata are preserved in fields such as `results[i].result`, `video_url`, `videoUrls`, `resultUrls`, and `outputs`. See [special task result formats](/pages/en/api-manual/task-management/get-task-detail#special-formats-by-model). operationId: seedance-2.5-reference-to-video requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/Seedance25R2VRequest' examples: 参考图片生视频: summary: Reference Images to Video value: model: seedance-2.5-reference-to-video prompt: >- Use the blue ball in the reference images to generate a smooth moving shot. image_urls: - https://picsum.photos/id/237/512/512.jpg - https://picsum.photos/id/1025/512/512.jpg resolution: 720p aspect_ratio: '16:9' 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: Seedance25R2VRequest: type: object required: - model - prompt properties: model: description: >- `seedance-2.5-reference-to-video`: Generate video from reference images, videos, or audio. examples: - seedance-2.5-reference-to-video type: string default: seedance-2.5-reference-to-video prompt: description: Describe the video you want to generate. minLength: 1 type: string example: >- A static shot of a small blue ball slowly rolling from left to right on a white table. resolution: default: 720p description: >- Output video resolution. The system uses this value to select a model version that can handle the request. type: string example: 480p aspect_ratio: default: '9:16' description: Output video aspect ratio. type: string example: '16:9' duration: default: 5 description: >- Output video duration in seconds. Available durations for each model version are further checked against the current capability catalog. maximum: 30 minimum: 4 type: integer example: 4 image_urls: description: List of reference image URLs. items: type: string type: array example: - https://picsum.photos/id/237/512/512.jpg video_urls: description: List of reference video URLs. items: type: string type: array example: - https://samplelib.com/lib/preview/mp4/sample-5s.mp4 audio_urls: description: List of reference audio URLs. items: type: string type: array example: - https://samplelib.com/lib/preview/mp3/sample-3s.mp3 TaskResponse: type: object properties: created: type: integer description: Task creation timestamp example: 1757165031 id: type: string description: Task ID example: task-unified-1757165031-uyujaw3d model: type: string description: Name of the model used object: type: string description: Specific task object type enum: - video.generation.task progress: type: integer description: Task progress percentage (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Task status enum: - pending - processing - completed - failed example: pending task_info: type: object description: Asynchronous task information properties: can_cancel: type: boolean description: Whether the task can be canceled example: true estimated_time: type: integer description: Estimated completion time in seconds example: 45 type: type: string description: Task output type enum: - video example: video ErrorResponse400: type: object properties: error: type: object properties: message: type: string example: Invalid request format type: type: string example: invalid_request_error ErrorResponse401: type: object properties: error: type: object properties: message: type: string example: Invalid API key type: type: string example: authentication_error ErrorResponse402: type: object properties: error: type: object properties: message: type: string example: Insufficient account balance type: type: string example: insufficient_quota ErrorResponse422: type: object properties: error: type: object properties: message: type: string example: Parameter validation failed type: type: string example: validation_error ErrorResponse429: type: object properties: error: type: object properties: message: type: string example: Rate limit exceeded type: type: string example: rate_limit_error ErrorResponse500: type: object properties: error: type: object properties: message: type: string example: Internal server error type: type: string example: server_error ErrorResponse503: type: object properties: error: type: object properties: message: type: string example: Service temporarily unavailable. Please try again later. type: type: string example: service_unavailable responses: TaskCreated: description: Task created successfully content: application/json: schema: $ref: '#/components/schemas/TaskResponse' BadRequest: description: Invalid request format content: application/json: schema: $ref: '#/components/schemas/ErrorResponse400' Unauthorized: description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse401' PaymentRequired: description: Insufficient balance content: application/json: schema: $ref: '#/components/schemas/ErrorResponse402' UnprocessableEntity: description: Parameter validation failed content: application/json: schema: $ref: '#/components/schemas/ErrorResponse422' TooManyRequests: description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorResponse429' InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse500' ServiceUnavailable: description: Service temporarily unavailable content: application/json: schema: $ref: '#/components/schemas/ErrorResponse503' securitySchemes: BearerAuth: type: http scheme: bearer description: | ## All endpoints require Bearer Token authentication ## Add the following request header: `Authorization: Bearer YOUR_API_KEY` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.