# minimax-h3接口

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v1/api/generate:
    post:
      summary: minimax-h3接口
      deprecated: false
      description: |-
        基础节点：
        https://grsaiapi.com                (全球节点)
        https://grsai.dakka.com.cn     (国内节点)

        例子：
        https://grsaiapi.com/v1/api/generate
        https://grsai.dakka.com.cn/v1/api/generate

        注意：minimax-h3模型需要专业的提示词来精确控制视频，门槛较高
      tags:
        - Grsai图片/视频生成接口
      parameters:
        - name: base_url
          in: path
          description: ''
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: 请前往以下页面获取APIKEY：https://grsai.ai/zh/dashboard/api-keys
          required: false
          example: Bearer sk-xxxxxxxxxxx
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                prompt:
                  type: string
                  title: 提示词
                aspectRatio:
                  type: string
                  title: 比例
                  description: |-
                    图像比例支持的参数:
                    portrait (竖屏)
                    landscape (横屏)
                images:
                  type: array
                  items:
                    type: string
                  title: 参考图
                  description: 支持base64与url链接，最大支持9张图
                audios:
                  type: array
                  items:
                    type: string
                  description: 支持base64与url，最大支持3个音频
                  title: 参考音频
                resolution:
                  type: string
                  title: 分辨率
                  description: 480p/768p/1080p
                model:
                  type: string
                  title: 模型名称
                  description: |-
                    支持以下模型
                    minimax-h3
                duration:
                  type: integer
                  title: 视频时长
                  description: 支持1~15秒，1080p最多支持10秒
                replyType:
                  type: string
                  title: 回复类型
                  description: |-
                    支持参数
                    json（返回json）
                    stream（返回stream）
                    async（异步轮询）
                    异步生成结果查询接口：https://qmy27nhsd9.apifox.cn/452409577e0
                seed:
                  type: integer
                  title: 随机种子
              required:
                - prompt
                - aspectRatio
                - resolution
                - model
                - duration
                - replyType
              x-apifox-orders:
                - model
                - prompt
                - aspectRatio
                - images
                - audios
                - seed
                - resolution
                - duration
                - replyType
            example:
              prompt: >-
                视频时长：10秒｜电影级写实风格｜科幻悬疑短片

                场景：深夜的未来都市街头，暴雨倾盆，霓虹灯映照在湿漉漉的街道上。一名年轻男子穿着黑色风衣，独自站在十字路口，手中握着一个正在闪烁蓝光的神秘金属球。

                0-3秒：镜头从远景快速推进到男子中景，男子低头看着手中的金属球，神情紧张，雨水顺着脸颊流下。他低声说：“你终于醒了……”

                3-6秒：金属球突然发出强烈蓝光，周围的雨滴全部悬浮在空中，街上的灯光开始闪烁。男子震惊地抬起头，说：“不可能……现在还不是时候。”

                6-10秒：男子身后的街道尽头突然打开一道巨大的蓝色传送门，传送门中传来一个低沉神秘的声音：“我等你，已经三百年了。”男子猛然回头，瞳孔放大，镜头快速推近他的脸，随后画面瞬间切黑。

                对白要求：中文普通话，人物口型与台词同步，男声自然、低沉、具有电影感，神秘声音更加低沉有空间感。台词清晰，不抢环境音。

                声音设计：暴雨声、远处雷声、城市环境低鸣、金属球启动的低频嗡鸣声、传送门开启的巨大能量声，最后一句声音带有轻微回响。

                视觉要求：真实电影质感、真实人物皮肤、自然面部表情、逼真暴雨、水滴、霓虹反射、体积光、浅景深、自然运动模糊、冷色科幻氛围、镜头运动稳定流畅、人物外观前后一致、场景连续。

                负面提示词：人物变形、多余手指、多余肢体、脸部崩坏、口型不同步、台词乱码、声音失真、多人突然出现、人物外观变化、场景跳变、画面闪烁、低清晰度、卡顿、文字、水印、Logo。
              aspectRatio: portrait
              images:
                - https://xxxxxx.png
                - https://xxxxxx.png
              audios:
                - https://xxxxxx.mp3
                - https://xxxxxx.mp3
              seed: 1000
              resolution: 480p
              model: minimax-h3
              duration: 10
              replyType: json
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    title: 任务id
                  status:
                    type: string
                    title: 状态
                    description: |
                      任务状态
                      running  (进行中)
                      violation  (违规)
                      succeeded (生成成功)
                      failed (任务失败)
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                          title: 图片/视频链接
                      x-apifox-orders:
                        - url
                  progress:
                    type: integer
                    title: 进度
                    description: 0~100
                  error:
                    type: string
                    title: 报错信息
                required:
                  - id
                  - status
                x-apifox-orders:
                  - id
                  - status
                  - progress
                  - results
                  - error
              example:
                id: 14-5f3cf761-a4bb-486a-8016-77f490998f80
                status: succeeded
                results:
                  - url: >-
                      https://file1.aitohumanize.com/file/fcdd2d07449d438d9d69d450f5626976.mp4
          headers: {}
          x-apifox-name: 成功
        '400':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  status:
                    type: string
                    title: 状态
                    description: |-
                      状态
                      violation（违规）
                      failed（失败）
                  error:
                    type: string
                    title: 报错信息
                required:
                  - id
                  - status
                  - error
                x-apifox-orders:
                  - id
                  - status
                  - error
              example:
                id: 12-1f771fbf-f23a-4b89-a7d0-a98ba9862edb
                status: failed
                error: generate failed
          headers: {}
          x-apifox-name: 报错
        x-200:异步生成返回结果:
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    title: 任务id
                    description: |-
                      通过该id调用异步结果查询接口
                      接口文档：https://qmy27nhsd9.apifox.cn/452409577e0
                  status:
                    type: string
                    title: 状态
                required:
                  - id
                  - status
                x-apifox-orders:
                  - id
                  - status
              example:
                id: 6-f671fc51-d5d7-4eff-a1c7-26e612fe08ab
                status: running
          headers: {}
          x-apifox-name: 异步生成返回结果
      security: []
      x-apifox-folder: Grsai图片/视频生成接口
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/8212034/apis/api-514679297-run
components:
  schemas: {}
  securitySchemes: {}
servers: []
security: []

```