9.4 KiB
9.4 KiB
minimax-h3接口
OpenAPI Specification
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: []