> ## 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. # Veo3.1 首尾帧生视频 > - VEO 3.1 首尾帧生视频模型（按模式拆分入口） - 输入起始帧 `first_image_url` 与结束帧 `last_image_url` - 标准版与 Fast 支持 `720p` / `1080p` / `4k`，Lite 仅支持 `720p` / `1080p` - 异步处理模式，使用返回的任务ID [进行查询](/pages/zh/api-manual/task-management/get-task-detail) - 生成的视频链接，有效期为24小时，请尽快保存 ## OpenAPI ````yaml openapi/zh/veo-3.1-first-last-frame-to-video.json POST /v1/videos/generations openapi: 3.1.0 info: title: Veo3.1 首尾帧生视频 version: '1.0' servers: - url: https://api.aihubmax.com security: - BearerAuth: [] paths: /v1/videos/generations: post: tags: - Video > Veo3.1 summary: Veo3.1 首尾帧生视频 description: > - VEO 3.1 首尾帧生视频模型（按模式拆分入口） - 输入起始帧 `first_image_url` 与结束帧 `last_image_url` - 标准版与 Fast 支持 `720p` / `1080p` / `4k`，Lite 仅支持 `720p` / `1080p` - 异步处理模式，使用返回的任务ID [进行查询](/pages/zh/api-manual/task-management/get-task-detail) - 生成的视频链接，有效期为24小时，请尽快保存 operationId: veo-3.1-first-last-frame-to-video requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/Veo31FirstLastFrameToVideoRequest' examples: 标准版首尾帧过渡: summary: 标准版首尾帧过渡 value: model: veo-3.1-first-last-frame-to-video prompt: Smooth transition from day to night first_image_url: https://example.com/start.jpg last_image_url: https://example.com/end.jpg duration: 8 resolution: 1080p 快速版首尾帧过渡: summary: 快速版首尾帧过渡 value: model: veo-3.1-fast-first-last-frame-to-video prompt: Time-lapse from misty dawn to golden sunset first_image_url: https://example.com/dawn.jpg last_image_url: https://example.com/sunset.jpg duration: 6 resolution: 720p lite_版首尾帧过渡: summary: Lite 版首尾帧过渡 value: model: veo-3.1-lite-first-last-frame-to-video prompt: Cherry blossoms opening into full bloom first_image_url: https://example.com/bud.jpg last_image_url: https://example.com/bloom.jpg duration: 8 resolution: 1080p 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: Veo31FirstLastFrameToVideoRequest: type: object required: - model - prompt - first_image_url - last_image_url properties: model: description: |- `veo-3.1-first-last-frame-to-video`：标准版首尾帧过渡 `veo-3.1-fast-first-last-frame-to-video`：快速版 `veo-3.1-lite-first-last-frame-to-video`：Lite 版 examples: - veo-3.1-first-last-frame-to-video - veo-3.1-fast-first-last-frame-to-video - veo-3.1-lite-first-last-frame-to-video type: string default: veo-3.1-first-last-frame-to-video prompt: description: | 文本提示词，描述从首帧到尾帧的过渡过程 **说明：** - 支持中英文 type: string example: Smooth transition from day to night first_image_url: description: | 起始帧图片 URL **说明：** - 必须为公开可访问的图片 URL - 推荐分辨率不低于 `720p`，宽高比为 `16:9` 或 `9:16` type: string example: https://example.com/start.jpg last_image_url: description: | 结束帧图片 URL **说明：** - 必须为公开可访问的图片 URL - 推荐与起始帧使用相同的宽高比 type: string example: https://example.com/end.jpg aspect_ratio: default: '16:9' description: | 输出视频宽高比 **可选值：** - `16:9` — 横屏（默认） - `9:16` — 竖屏 type: string example: '16:9' duration: default: 8 description: > 输出视频时长（秒） **可选值：** `4`、`6`、`8` **模型差异：** - `veo-3.1-lite-first-last-frame-to-video` 在 `resolution=1080p` 时仅支持 `8` 秒 type: integer example: 4 resolution: default: 1080p description: > 输出视频分辨率 **可选值：** - `720p` — 标清 - `1080p` — 高清（默认） - `4k` — 4K 超高清 **模型差异：** - `veo-3.1-first-last-frame-to-video` / `veo-3.1-fast-first-last-frame-to-video` 支持 `720p` / `1080p` / `4k` - `veo-3.1-lite-first-last-frame-to-video` 仅支持 `720p` / `1080p` examples: - 720p - 1080p - 4k type: string x-model-enum-overrides: veo-3.1-lite-first-last-frame-to-video: - 720p - 1080p generate_audio: default: false description: | 是否生成配套音频 **说明：** - 默认关闭 type: boolean example: true auto_fix: anyOf: - type: boolean - type: 'null' default: null description: |- 自动修复提示词；三个模型变体都可传该字段。 > 非必须不要传这个参数。 x-advanced: true example: true safety_tolerance: anyOf: - maximum: 6 minimum: 1 type: integer - type: 'null' default: null description: >- 内容安全等级，`1` 最严格，`6` 最宽松 **模型差异：** - `veo-3.1-first-last-frame-to-video` / `veo-3.1-fast-first-last-frame-to-video` 可用 - `veo-3.1-lite-first-last-frame-to-video` 不适用 > 非必须不要传这个参数。 x-advanced: true x-unsupported-models: - veo-3.1-lite-first-last-frame-to-video example: 3 enhance_prompt: anyOf: - type: boolean - type: 'null' default: null description: >- 自动优化提示词 **模型差异：** - 仅 `veo-3.1-first-last-frame-to-video` 可用 - `veo-3.1-fast-first-last-frame-to-video` / `veo-3.1-lite-first-last-frame-to-video` 不适用 > 非必须不要传这个参数。 x-advanced: true x-unsupported-models: - veo-3.1-fast-first-last-frame-to-video - veo-3.1-lite-first-last-frame-to-video example: true person_generation: anyOf: - type: string - type: 'null' default: null description: >- 人物生成控制 **可选值：** `dont_allow` / `allow_adult` **模型差异：** - 仅 `veo-3.1-first-last-frame-to-video` 可用 - `veo-3.1-fast-first-last-frame-to-video` / `veo-3.1-lite-first-last-frame-to-video` 不适用 > 非必须不要传这个参数。 x-advanced: true x-unsupported-models: - veo-3.1-fast-first-last-frame-to-video - veo-3.1-lite-first-last-frame-to-video example: allow_adult negative_prompt: anyOf: - type: string - type: 'null' default: null description: |- 负面提示词，用逗号分隔多个关键词。 > 非必须不要传这个参数。 x-advanced: true example: blurry, low quality, watermark seed: anyOf: - type: integer - type: 'null' default: null description: |- 随机种子；设置固定值可复现生成结果。 > 非必须不要传这个参数。 x-advanced: true example: 42 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` ````