268 lines
9.4 KiB
Markdown
268 lines
9.4 KiB
Markdown
# 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: []
|
||
|
||
``` |