> ## 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.

# MiniMax-Hailuo-2.3-Fast 图生视频

> 适用于 `MiniMax-Hailuo-2.3-Fast` 图生视频模型。提交任务后，请通过 `GET /v1/videos/{task_id}` 查询状态。

公开字段：`model`、`image`、`prompt`、`seconds`、`size`。



## OpenAPI

````yaml api-reference/zh-Hans/zmodelVideo/minimax/minimax-hailuo-2.3-fast-image-to-video.json POST /v1/videos
openapi: 3.0.1
info:
  title: Hailuo 图生视频
  version: 1.0.0
  description: Hailuo 系列图生视频能力文档。公开统一入口为 `/v1/videos`，用于创建异步视频生成任务。
  license:
    name: Project License
    url: https://github.com/QuantumNous/new-api/blob/main/LICENSE
servers:
  - url: https://api.powertokens.ai
    description: Baze API 服务地址
security: []
tags:
  - name: Hailuo Video
    description: Hailuo 图生视频能力
paths:
  /v1/videos:
    post:
      tags:
        - Hailuo Video
      summary: Hailuo 图生视频
      description: >-
        适用于 `MiniMax-Hailuo-2.3-Fast` 图生视频模型。提交任务后，请通过 `GET
        /v1/videos/{task_id}` 查询状态。


        公开字段：`model`、`image`、`prompt`、`seconds`、`size`。
      operationId: minimaxImageToVideo
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImageToVideoRequest'
            examples:
              basic_request:
                summary: 基础图生视频请求
                value:
                  model: MiniMax-Hailuo-2.3-Fast
                  image: https://example.com/assets/first-frame.png
                  prompt: The girl looks at the camera and smiles.
                  seconds: '6'
                  size: 720P
      responses:
        '200':
          description: 提交成功，返回统一 OpenAI 风格视频任务对象。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIVideo'
        '400':
          description: 请求参数不合法，例如缺少 `image`，或传入不支持图生视频的模型。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                invalid_request:
                  summary: 参数错误
                  value:
                    code: bad_request_body
                    message: 请求体格式错误或字段取值非法
                    data: null
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                unauthorized:
                  summary: 未授权
                  value:
                    code: access_denied
                    message: 无效的令牌
                    data: null
          description: 鉴权失败，例如未提供令牌或令牌无效。
        '413':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                request_too_large:
                  summary: 请求体过大
                  value:
                    code: read_request_body_failed
                    message: 请求体过大，请缩小输入后重试
                    data: null
          description: 请求体过大。
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                quota_exceeded:
                  summary: 额度不足或速率受限
                  value:
                    code: insufficient_user_quota
                    message: 当前账户额度不足，请稍后重试
                    data: null
          description: 触发速率限制或账户额度不足。
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                internal_error:
                  summary: 内部处理失败
                  value:
                    code: gen_relay_info_failed
                    message: 服务内部处理失败，请稍后重试
                    data: null
          description: 服务端处理请求时发生内部错误。
        '502':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                bad_gateway:
                  summary: 上游响应异常
                  value:
                    code: bad_response_status_code
                    message: 上游服务返回了无效响应
                    data: null
          description: 上游服务返回异常响应。
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                service_unavailable:
                  summary: 服务暂不可用
                  value:
                    code: get_channel_failed
                    message: 当前模型暂时无可用渠道，请稍后重试
                    data: null
          description: 上游服务暂不可用，或当前模型暂无可用渠道。
      security:
        - BearerAuth: []
components:
  schemas:
    ImageToVideoRequest:
      type: object
      required:
        - model
        - image
      properties:
        model:
          type: string
          enum:
            - MiniMax-Hailuo-2.3-Fast
          description: 模型名称。可用值：`MiniMax-Hailuo-2.3-Fast`。
        image:
          type: string
          description: "将指定图片作为视频的起始帧。支持公网 URL 或 Base64 编码的 Data URL (`data:image/jpeg;base64,...`)\n\n- 图片要求：\n\t- 格式：JPG, JPEG, PNG, WebP\n\t- 体积：小于 20MB\n\t- 尺寸：短边像素大于 300px，长宽比在 2:5 和 5:2 之间  "
        prompt:
          type: string
          description: "视频的文本描述，最大 2000 字符。对于 `MiniMax-Hailuo-2.3-Fast` 模型，支持使用 `[指令]` 语法进行运镜控制。\n可在 prompt 中通过 [指令] 格式添加运镜指令，以实现精确的镜头控制。\n\n- 支持 15 种运镜指令的指令:\n\t - 左右移: [左移], [右移]\n\t - 左右摇: [左摇], [右摇]\n\t - 推拉: [推进], [拉远]\n\t - 升降: [上升], [下降]\n\t - 上下摇: [上摇], [下摇]\n\t - 变焦: [变焦推近], [变焦拉远]\n\t - 其他: [晃动], [跟随], [固定]\n\n - 使用规则:\n\t - 组合运镜: 同一组 [] 内的多个指令会同时生效，如 [左摇,上升]，建议组合不超过 3 个\n\t - 顺序运镜: prompt 中前后出现的指令会依次生效，如 \"...[推进], 然后...[拉远]\"\n\t - 自然语言: 也支持通过自然语言描述运镜，但使用标准指令能获得更准确的响应 "
          maxLength: 2000
        seconds:
          type: string
          description: |-
            视频时长（秒），默认值为 6。其可用值与分辨率相关：
            | Model | 768P | 1080P |
            | :--- | :--- | :--- |
            | MiniMax-Hailuo-2.3-Fast | `6` 或 `10` | `6` |
          enum:
            - '6'
            - '10'
          x-linkage:
            rules:
              - when:
                  field: size
                  operator: eq
                  value: 1080P
                set_options:
                  - '6'
        size:
          type: string
          description: |-
            视频分辨率。其可用值与模型相关：
            | Model | 6s | 10s |
            | :--- | :--- | :--- |
            | MiniMax-Hailuo-2.3-Fast |  `768P` (默认), `1080P` |  `768P` (默认) |
          enum:
            - 768P
            - 1080P
    OpenAIVideo:
      type: object
      properties:
        id:
          type: string
        task_id:
          type: string
          description: 视频生成任务的 ID，用于后续查询任务状态
        object:
          type: string
          example: video
        model:
          type: string
        status:
          type: string
          example: queued
        progress:
          type: integer
          example: 0
        created_at:
          type: integer
          format: int64
    ErrorResponse:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
        data: {}
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: '在请求头中传入 `Authorization: Bearer <token>`。'

````