MMETASO AI
/开发者中心/New API 接入
返回 H3 教程
NEW API · H3 VIDEO

用 New API，接入 H3 视频生成

从创建渠道到拿到第一个视频结果，只需要几步。下面的配置项、截图与 cURL 示例可以直接照着操作。

模型：sora-2映射：sora-2 → Minimax-H3OpenAI 兼容协议
01

创建渠道

约 2 分钟

进入 New API 的渠道配置，点击“创建渠道”，选择 Sora 类型并填入秘塔 H3 的 API Key。名称可以自定义。

1

进入渠道配置，点击右上角“创建渠道”。

2

类型选择 Sora，填写渠道名称。

3

API 地址填入 https://metaso.cn/api/openai，再填入秘塔 H3 API Key。

4

模型输入 sora-2，映射为 Minimax-H3。

5

将渠道分到目标分组，点击保存。

进入渠道配置，点击右上角“创建渠道”。
类型选择 Sora，填写任意渠道名称。
API 地址填写 https://metaso.cn/api/openai，再填入秘塔 H3 API Key。
模型填写 sora-2，并添加 sora-2 到 Minimax-H3 的映射。
将渠道划分到目标分组，完成后保存。
02

创建 API Key

一次配置，重复使用

在面板中打开“API 密钥”，创建一个密钥并选择刚才使用的分组。后续请求只需要携带这个 New API 令牌。

打开 API 密钥进入面板中的 API 密钥菜单。
填写并保存填写名称、选择分组，点击保存。
打开“API 密钥”，点击“创建 API 密钥”。
填写密钥名称，选择对应分组后保存。
03

使用 New API 调用

OpenAI 兼容协议

使用 New API 令牌调用 /v1/videos。先用 768P 请求验证渠道是否配置正确，再按需切换到 2K。

cURL768P 16:91280x720 · 4 秒
curl -X POST "http://{Your New API Domain}/v1/videos" \
  -H "Authorization: Bearer sk-你的NewAPI令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "一只橘猫在雨夜街道上缓慢行走，电影级光影，镜头跟随",
    "seconds": 4,
    "size": "1280x720",
    "input_reference": {
      "image_url": "https://cdn.example.com/assets/cat.png"
    }
  }'
cURL768P 9:16720x1280 · 8 秒
curl -X POST "http://{Your New API Domain}/v1/videos" \
  -H "Authorization: Bearer sk-你的NewAPI令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "人物从画面底部走向镜头，雨水落在透明伞上，适合短视频竖屏构图",
    "seconds": 8,
    "size": "720x1280",
    "input_reference": {
      "image_url": "https://cdn.example.com/assets/person.jpg"
    }
  }'
cURL2K 16:91792x1024 · 8 秒
curl -X POST "http://{Your New API Domain}/v1/videos" \
  -H "Authorization: Bearer sk-你的NewAPI令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "一辆未来城市列车穿过霓虹灯街区，电影级细节，宽屏镜头",
    "seconds": 8,
    "size": "1792x1024",
    "input_reference": {
      "image_url": "https://cdn.example.com/assets/train.webp"
    }
  }'
cURL2K 9:161024x1792 · 12 秒
curl -X POST "http://{Your New API Domain}/v1/videos" \
  -H "Authorization: Bearer sk-你的NewAPI令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "高楼之间升起巨大的机械凤凰，镜头由下向上推进，细节丰富",
    "seconds": 12,
    "size": "1024x1792",
    "input_reference": {
      "image_url": "https://cdn.example.com/assets/phoenix.png"
    }
  }'
创建任务响应
200 OK
{
  "id": "task_HRRamZUPptDAQ2U5nK1E7aVF86mUkSKz",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1788315700
}
04

查询任务状态

使用 task_id

创建接口返回任务 id。用这个 id 查询任务状态，直到返回 completed 后再获取视频内容。

查询任务GET
curl http://{Your New API Domain}/v1/videos/{task_id} \
  -H "Authorization: Bearer sk-你的NewAPI令牌"
完成响应completed
{
  "id": "task_HRRamZUPptDAQ2U5nK1E7aVF86mUkSKz",
  "object": "video",
  "model": "sora-2",
  "status": "completed",
  "progress": 100,
  "created_at": 1788315700,
  "completed_at": 1788315840
}
05

获取视频结果

下载 mp4

任务完成后，使用同一个 task_id 下载生成的视频。

保存生成结果将返回内容写入本地 result.mp4。
curl -L http://{Your New API Domain}/v1/videos/{task_id}/content \
  -H "Authorization: Bearer sk-你的NewAPI令牌" \
  -o result.mp4
06

限制与注意事项

输入限制

目前 OpenAI 协议只支持传入图片来做生成，暂未支持参考视频和音频。

Sora 生命周期

OpenAI 的 Sora 在 2026.9.24 永久关闭，请谨慎使用。

仍需在 New API 中使用？

请在 New API 中选择 Minimax 类型，修改 hailuo 插件，通过秘塔 API 来调用。