Announcement2026-09-21 16:43
09-22 Grok-4.7新模型上新
grok-4.7模型已在Grok-heavy分组可用
Announcement2026-09-18 02:48
GPT6满血全分组可用
目前所有GPT相关分组均可用满血GPT6,部分plus分组高峰期可能存在重连,求稳换pro即可
Announcement2026-09-16 16:07
openai 官方更新通知
在使用 astra 时出现空返回,表征该分组暂时不可用 Astra 模型(5.6sol 仍可正常使用)。
如果需要使用 astra 模型请及时切换分组。
官方更新拦截策略后,astra 模型不再有路由的情况,
一句话来讲就是
能用即满血
Announcement2026-09-11 01:09
服务服务恢复通知
openai 亚服算力恢复,目前 GPT 相关分组已可正常使用
Announcement2026-09-09 13:40
满血GPT-6分组上线
# 新增GPT-PRO-独享 分组 0.3x
一人一号一并发,满血GPT-6,无惧路由!
Announcement2026-09-09 06:25
09-09 · GPT Images 2.5系列模型上新
# 📢 09-09 · ChatGPT Images 2.5 系列生图模型正式上线
> **发布日期**:2026 年 9 月 9 日 · 即日起全面开放
---
## 🚀 速览
OpenAI 新一代图像模型 **ChatGPT Images 2.5** 已向 ChatGPT(含免费版)、Work 及 Codex 用户开放,同时 API 提供 `gpt-image-2.5-flare`(高速)和 `gpt-image-2.5-sunburst`(高精度)两款模型。
---
## ✨ 核心升级
- **速度翻倍**:生成延迟较 2.0 版本降低 **50%**
- **画质提升**:光照、纹理更真实,细节更锐利,参照对象保持力更强
- **精准编辑**:支持**画圈批注**,只改指定区域,不改其余
- **手绘辅助**:输入 `@Sketch` 调用绘图板,草图 + 文字一键成图
- **模板与分享**:内置海报/商品模板,可导出完整提示词复用
---
## 📦 API 版本
| 模型 | 适合场景 |
|------|----------|
| `flare` | 快速生成、批量创作、社交配图 |
| `sunburst` | 高精度成品、营销素材、品牌设计 |
> 支持 1024~3840 像素分辨率,定价与 GPT-Image-2 保持一致。
---
## 🔒 安全与合规性改变
所有生成图均嵌入 **C2PA 元数据**和隐形水印,可溯源。
---
## 📌 如何开始
- **开发者**:API 调用时替换 `model` 字段为 `gpt-image-2.5-flare` 或 `gpt-image-2.5-sunburst`
---
**适用的分组:**
现已在
GPT-img-备用
分组可用,其他生图分组将在短时间内陆续更新。
—— Halion-API
UTC+8 2026-09-09
Announcement2026-09-07 14:30
09-07官方限流通知
OpenAI 官方对 **GPT-6-Astra** 模型出现限流 bug 与延迟问题,推测因新模型发布产生大量蒸馏请求,导致官方风控策略收紧。
GPT 仍可正常调用,但错误重试率偏高、稳定性不及稳定组,全网均受影响,实测新开 PRO20 账号同样现象,**5.6 系列模型**也受到波及。
所有分组模型均可正常调度,可前往**渠道状态页**关注各分组可用性。
Announcement2026-09-03 21:52
GPT-Astra 模型重磅上新-09-05🔥
# 公告:GPT Astra 十万亿参数模型将陆续在 Pro 、plus 订阅推出
**2026年9月 5 日**
OpenAI 于今日正式向订阅账户推出新一代旗舰模型 **GPT-6 Astra**,参数规模达 **10 万亿**。
---
## 核心亮点
- **10万亿参数**,上下文窗口 **105万 token**,支持图文输入。
- **Computer-Use 能力**:可自主操控浏览器、办公软件,完成调研、写报告、做PPT、编程等完整工作流,无需人工逐项执行。
- **性能全面超越**:在数学推理、软件工程、自主智能体等测试中领先上一代旗舰。
- **安全评级**:内部评为“关键级”,高风险攻防功能不对普通用户开放。
---
- **官方定价**(对 plus 用户开放):输入 $10/百万 token,输出 $50/百万 token。
---
Announcement2026-09-01 10:52
MiniMaxH3视频模型接口文档
# MiniMax H3 视频 API
本文档是 kkapi.work 面向下游用户的 MiniMax H3 视频接口说明。接口采用异步任务模式:创建任务后取得 `task_id`,再轮询任务状态,任务成功后从响应中的公开视频地址下载结果。
## 1. 服务地址与鉴权
生产环境服务地址:
```text
https://kkapi.work
```
所有请求都需要使用已分配到 MiniMax 分组的下游 API Key:
```http
Authorization: Bearer
Content-Type: application/json
```
API Key 在本站控制台创建。下游用户不需要接触 MiniMax/DMC 上游 Key。Key 所属分组(MiniMax 专用分组或已配置 MiniMax 路由的组合分组)必须绑定至少一个处于 active/schedulable 状态的 MiniMax 上游账号;未绑定时接口返回 `503`,不会产生费用。
视频创建请求会按 `model: "MiniMax-H3"` 选择 MiniMax 上游,不会因为分组默认平台是 OpenAI 或其他平台而返回 “Videos API is not supported for this platform”。
## 2. 接口一览
| 方法 | 路径 | 说明 |
|---|---|---|
| `POST` | `/v1/videos/generations` | 创建 MiniMax H3 视频任务 |
| `GET` | `/v1/videos/generations/{task_id}` | 查询任务状态、错误或结果地址 |
本站下游协议以以上两个 OpenAI 兼容路径为准。不要使用上游 DMC 的 `/v2/...` 路径,也不要在下游请求中填写本站内部的上游地址。
## 3. 创建视频任务
### 请求
```http
POST /v1/videos/generations HTTP/1.1
Host: kkapi.work
Authorization: Bearer
Content-Type: application/json
Idempotency-Key:
```
请求体:
```json
{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "A cinematic view of ocean waves at sunset"
}
],
"resolution": "768P",
"duration": 5,
"ratio": "16:9"
}
```
对应的 cURL 示例:
```bash
curl -sS -X POST https://kkapi.work/v1/videos/generations \
-H 'Authorization: Bearer ' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: order-demo-001' \
--data-raw '{
"model": "MiniMax-H3",
"content": [
{"type": "text", "text": "A cinematic view of ocean waves at sunset"}
],
"resolution": "768P",
"duration": 5,
"ratio": "16:9"
}'
```
### 请求字段
| 字段 | 类型 | 必填 | 取值和说明 |
|---|---|---:|---|
| `model` | string | 是 | 必须严格填写 `MiniMax-H3` |
| `content` | array | 是 | 必须包含恰好 1 个文本项,媒体项最多 12 个 |
| `resolution` | string | 是 | 当前本站固定为 `768P` |
| `duration` | integer | 是 | 输出时长,整数 `1` 至 `15` 秒 |
| `ratio` | string | 是 | 画面比例,不能为空;常用值见下表 |
| `callback_url` | string | 否 | 上游回调地址;必须是调用方可接收回调的公网 HTTPS 地址 |
本站入口对顶层 JSON 使用严格字段校验。不要添加未列出的顶层字段;字段类型错误、未知字段、多余 JSON 值都会返回 `400`。
### 画面比例
| `ratio` | 画布尺寸 |
|---|---:|
| `21:9` | `1536×672` |
| `16:9` | `1344×768` |
| `4:3` | `1024×768` |
| `1:1` | `768×768` |
| `3:4` | `768×1024` |
| `9:16` | `768×1344` |
| `adaptive` | 仅建议用于带视觉参考素材的请求 |
比例最终由 MiniMax 上游校验。纯音频参考请求应使用固定比例;关键帧或视觉参考请求可使用固定比例或 `adaptive`。
## 4. 文本与参考素材
`content` 必须有且只有一个 `text` 项,文本不能为空,最长 7000 个 Unicode 字符。其余项目可以是 `image_url`、`video_url` 或 `audio_url`,三类媒体合计不超过 12 个。
媒体必须使用上游可访问的公网 HTTPS URL。不支持 Base64、`data:` URI、内网地址、回环地址或云元数据地址。
上游对媒体文件的限制如下:
| 媒体 | `type` | 支持格式 | 单文件限制 |
|---|---|---|---|
| 图片 | `image_url` | JPG/JPEG、PNG、WebP、HEIC、HEIF;必须是静态图片 | 最大 30 MB;单边 256–5760 像素,解码后不超过 33,177,600 像素,宽高比 0.4–2.5 |
| 视频 | `video_url` | MP4/MOV;H.264/H.265;可含 AAC/MP3 音轨 | 最大 50 MB;最短 2 秒,超过 15 秒只取开头 15 秒 |
| 音频 | `audio_url` | WAV/PCM、MP3、M4A/AAC、裸 ADTS AAC | 最大 15 MB;最短 2 秒,超过 15 秒只取开头 15 秒 |
参考素材数量限制:参考图片最多 9 张、参考视频最多 3 段、参考音频最多 3 段,全部媒体合计最多 12 个。超过限制、无法下载、无法解码或转码失败的任务会进入 `failed`,不会静默丢弃素材。
### 首帧、尾帧
```json
{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "Move from the first frame into a rainy city"
},
{
"type": "image_url",
"image_url": {"url": "https://assets.example.com/first.png"},
"role": "first_frame"
}
],
"resolution": "768P",
"duration": 8,
"ratio": "16:9"
}
```
图片的 `role` 可使用:
- `first_frame`:首帧;
- `last_frame`:尾帧;
- `reference_image`:参考图片。
首尾帧请求可在 `content` 中同时放置一张 `first_frame` 和一张 `last_frame` 图片。多张参考图片应显式设置 `reference_image`。
### 参考视频和音频
```json
{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "Follow the motion and rhythm in with "
},
{
"type": "video_url",
"video_url": {"url": "https://assets.example.com/motion.mp4"},
"role": "reference_video"
},
{
"type": "audio_url",
"audio_url": {"url": "https://assets.example.com/music.mp3"},
"role": "reference_audio"
}
],
"resolution": "768P",
"duration": 10,
"ratio": "adaptive"
}
```
媒体角色:
- `video_url` 配 `reference_video`;
- `audio_url` 配 `reference_audio`。
图片、视频、音频的格式、大小、时长、尺寸、角色组合等由 MiniMax 上游继续校验。同步校验通过后,媒体下载、转码或内容审核失败会在异步任务中以 `failed` 返回。
对于参考视频或音频,单段超过 15 秒时只保留从开头起的 15 秒;这是裁切,不是压缩或加速。视频参考累计时长和独立音频累计时长仍须分别不超过 15 秒。
## 5. 创建响应
创建成功只表示任务已受理,不代表视频已生成。响应至少包含上游任务号:
```json
{
"task_id": "task_01HXXXXXXXXXXXXXXX"
}
```
请保存 `task_id`,用于查询任务。建议为每次创建请求设置唯一的 `Idempotency-Key`。网络超时后重试时,必须复用相同的 Key 和请求体,以避免重复创建任务。
如果填写 `callback_url`,该地址必须是调用方可接收请求的公网 HTTPS 地址。上游可能先发送 challenge 验证,随后在 `queued`、`running`、`succeeded`、`failed` 或 `cancelled` 状态变化时回调;回调接收端应按 `task_id` 和状态实现幂等处理。
## 6. 查询任务
### 请求
```bash
curl -sS \
-H 'Authorization: Bearer ' \
https://kkapi.work/v1/videos/generations/
```
任务只对创建它的用户、API Key 和分组可见。建议每隔 2–5 秒查询一次,直到任务进入终态。
### 成功响应
本站透传 MiniMax 上游任务结构,示例:
```json
{
"task": {
"id": "task_01HXXXXXXXXXXXXXXX",
"model": "MiniMax-H3",
"status": "succeeded",
"resolution": "768P",
"duration": 5,
"ratio": "16:9",
"progress": 1,
"content": {
"url": "https://media.example.com/result.mp4"
},
"usage": {
"output_seconds": 5,
"input_image_count": 0
}
}
}
```
### 任务状态
| 状态 | 含义 | 是否扣费 |
|---|---|---:|
| `queued` | 已受理,正在准备输入、审核或排队 | 否 |
| `running` | 正在生成或发布结果 | 否 |
| `succeeded` | 视频已生成并发布结果地址 | 是 |
| `failed` | 输入准备、审核或生成失败 | 否 |
| `cancelled` | 任务被服务端终止 | 否 |
判断成功必须同时满足:
1. `task.status` 为 `succeeded`;
2. `task.content.url` 为非空 HTTPS 地址。
查询一个已失败的任务仍可能返回 HTTP `200`,必须检查 `task.status` 和 `task.error`,不能只看 HTTP 状态码。
## 7. 下载视频
成功响应中的 `task.content.url` 是完整的公开 HTTPS 直链。请尽快下载并保存到自己的存储:
```bash
curl -L --output result.mp4 '替换为 task.content.url 的完整值'
```
下载结果直链时不要携带本站 API Key 或 MiniMax Bearer 鉴权头。公开结果的保留时间由上游服务策略决定,本站不建议将该直链作为长期存储地址。
成功输出为 MP4 容器、H.264 视频(24 FPS),音频为 AAC、32 kHz、双声道。实际容器时长可能因帧网格略长于请求的名义时长,账单仍按任务 usage 中的输出秒数计费。
## 8. 计费规则
- MiniMax H3 按成功输出时长计费,计费单位为秒;
- 计费时长优先使用任务 `usage.output_seconds`,缺失时回退到创建请求的 `duration`;
- 当前本站入口固定 `768P`,参考图片数量会记录在用量元数据中,当前不按图片数量额外收费;
- 当前默认平台单价为 `0.100000 USD/秒`,分组价格覆盖、用户费率倍率和运营方当前配置可能改变实际账单;
- 费用在账单中按小数点后 6 位精度计算和舍入;
- 只有任务成功并返回有效 `task.content.url` 后才会写入用量账单;创建失败、异步失败、取消、排队和生成中的任务不会扣费。
费用估算(未计入分组或用户倍率):
```text
基础费用 = 成功输出秒数 × 每秒单价
示例:5 秒 × 0.100000 USD/秒 = 0.500000 USD
```
## 9. 错误处理
同步错误示例:
```json
{
"error": {
"type": "bad_request_error",
"message": "duration must be an integer from 1 to 15"
}
}
```
常见 HTTP 错误:
| HTTP | 类型 | 常见原因 |
|---:|---|---|
| `400` | `bad_request_error` | JSON、模型、字段、时长、比例、内容数量或幂等参数不合法 |
| `401` | 认证错误 | API Key 缺失、无效或已失效 |
| `403` | `permission_error` | 当前 MiniMax 分组未启用视频生成权限或账户额度不足 |
| `404` | `not_found_error` | 路径错误、任务不属于当前用户/Key/分组,或 MiniMax 分组未启用 |
| `502` | `upstream_error` | MiniMax 上游请求失败 |
| `503` | `service_unavailable_error` | 当前没有可用的 MiniMax 上游账号 |
异步失败时,错误位于查询响应的 `task.error`:
```json
{
"task": {
"id": "task_01HXXXXXXXXXXXXXXX",
"status": "failed",
"error": {
"code": "input_format_unsupported",
"message": "media format is not supported"
}
}
}
```
常见异步错误包括:`input_download_failed`、`input_security_violation`、`input_too_large`、`input_probe_failed`、`input_format_unsupported`、`input_duration_out_of_range`、`input_dimensions_out_of_range`、`input_transcode_failed`、`content_policy_violation` 和 `fail_to_fetch_task`。
## 10. 接入检查清单
1. 使用本站分配到 MiniMax 分组的 API Key;
2. 请求模型填写 `MiniMax-H3`,分辨率填写 `768P`;
3. `content` 保证恰好一个文本项,媒体 URL 使用公网 HTTPS;
4. `duration` 使用 `1–15` 的整数,`ratio` 不留空;
5. 创建请求设置唯一 `Idempotency-Key` 并保存 `task_id`;
6. 轮询查询,只有 `succeeded` 且存在 `task.content.url` 时才认为成功;
7. 下载公开结果地址时不要附带 Bearer 鉴权头。
Announcement2026-09-01 10:52
MiniMaxH3视频模型接口文档
# MiniMax H3 视频 API
本文档是 kkapi.work 面向下游用户的 MiniMax H3 视频接口说明。接口采用异步任务模式:创建任务后取得 `task_id`,再轮询任务状态,任务成功后从响应中的公开视频地址下载结果。
## 1. 服务地址与鉴权
生产环境服务地址:
```text
https://kkapi.work
```
所有请求都需要使用已分配到 MiniMax 分组的下游 API Key:
```http
Authorization: Bearer
Content-Type: application/json
```
API Key 在本站控制台创建。Key 所属分组(MiniMax 专用分组或已配置 MiniMax 路由的组合分组)已绑定至少一个处于 active/schedulable 状态的 MiniMax 上游账号;未绑定时接口返回 `503`,不会产生费用。
视频创建请求会按 `model: "MiniMax-H3"` 选择 MiniMax 上游,不会因为分组默认平台是 OpenAI 或其他平台而返回 “Videos API is not supported for this platform”。
## 2. 接口一览
| 方法 | 路径 | 说明 |
|---|---|---|
| `POST` | `/v1/videos/generations` | 创建 MiniMax H3 视频任务 |
| `GET` | `/v1/videos/generations/{task_id}` | 查询任务状态、错误或结果地址 |
本站下游协议以以上两个 OpenAI 兼容路径为准。
## 3. 创建视频任务
### 请求
```http
POST /v1/videos/generations HTTP/1.1
Host: kkapi.work
Authorization: Bearer
Content-Type: application/json
Idempotency-Key:
```
请求体:
```json
{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "A cinematic view of ocean waves at sunset"
}
],
"resolution": "768P",
"duration": 5,
"ratio": "16:9"
}
```
对应的 cURL 示例:
```bash
curl -sS -X POST https://kkapi.work/v1/videos/generations \
-H 'Authorization: Bearer ' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: order-demo-001' \
--data-raw '{
"model": "MiniMax-H3",
"content": [
{"type": "text", "text": "A cinematic view of ocean waves at sunset"}
],
"resolution": "768P",
"duration": 5,
"ratio": "16:9"
}'
```
### 请求字段
| 字段 | 类型 | 必填 | 取值和说明 |
|---|---|---:|---|
| `model` | string | 是 | 必须严格填写 `MiniMax-H3` |
| `content` | array | 是 | 必须包含恰好 1 个文本项,媒体项最多 12 个 |
| `resolution` | string | 是 | 当前本站固定为 `768P` |
| `duration` | integer | 是 | 输出时长,整数 `1` 至 `15` 秒 |
| `ratio` | string | 是 | 画面比例,不能为空;常用值见下表 |
| `callback_url` | string | 否 | 上游回调地址;必须是调用方可接收回调的公网 HTTPS 地址 |
本站入口对顶层 JSON 使用严格字段校验。不要添加未列出的顶层字段;字段类型错误、未知字段、多余 JSON 值都会返回 `400`。
### 画面比例
| `ratio` | 画布尺寸 |
|---|---:|
| `21:9` | `1536×672` |
| `16:9` | `1344×768` |
| `4:3` | `1024×768` |
| `1:1` | `768×768` |
| `3:4` | `768×1024` |
| `9:16` | `768×1344` |
| `adaptive` | 仅建议用于带视觉参考素材的请求 |
比例最终由 MiniMax 上游校验。纯音频参考请求应使用固定比例;关键帧或视觉参考请求可使用固定比例或 `adaptive`。
## 4. 文本与参考素材
`content` 必须有且只有一个 `text` 项,文本不能为空,最长 7000 个 Unicode 字符。其余项目可以是 `image_url`、`video_url` 或 `audio_url`,三类媒体合计不超过 12 个。
媒体必须使用上游可访问的公网 HTTPS URL。不支持 Base64、`data:` URI、内网地址、回环地址或云元数据地址。
上游对媒体文件的限制如下:
| 媒体 | `type` | 支持格式 | 单文件限制 |
|---|---|---|---|
| 图片 | `image_url` | JPG/JPEG、PNG、WebP、HEIC、HEIF;必须是静态图片 | 最大 30 MB;单边 256–5760 像素,解码后不超过 33,177,600 像素,宽高比 0.4–2.5 |
| 视频 | `video_url` | MP4/MOV;H.264/H.265;可含 AAC/MP3 音轨 | 最大 50 MB;最短 2 秒,超过 15 秒只取开头 15 秒 |
| 音频 | `audio_url` | WAV/PCM、MP3、M4A/AAC、裸 ADTS AAC | 最大 15 MB;最短 2 秒,超过 15 秒只取开头 15 秒 |
参考素材数量限制:参考图片最多 9 张、参考视频最多 3 段、参考音频最多 3 段,全部媒体合计最多 12 个。超过限制、无法下载、无法解码或转码失败的任务会进入 `failed`,不会静默丢弃素材。
### 首帧、尾帧
```json
{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "Move from the first frame into a rainy city"
},
{
"type": "image_url",
"image_url": {"url": "https://assets.example.com/first.png"},
"role": "first_frame"
}
],
"resolution": "768P",
"duration": 8,
"ratio": "16:9"
}
```
图片的 `role` 可使用:
- `first_frame`:首帧;
- `last_frame`:尾帧;
- `reference_image`:参考图片。
首尾帧请求可在 `content` 中同时放置一张 `first_frame` 和一张 `last_frame` 图片。多张参考图片应显式设置 `reference_image`。
### 参考视频和音频
```json
{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "Follow the motion and rhythm in with "
},
{
"type": "video_url",
"video_url": {"url": "https://assets.example.com/motion.mp4"},
"role": "reference_video"
},
{
"type": "audio_url",
"audio_url": {"url": "https://assets.example.com/music.mp3"},
"role": "reference_audio"
}
],
"resolution": "768P",
"duration": 10,
"ratio": "adaptive"
}
```
媒体角色:
- `video_url` 配 `reference_video`;
- `audio_url` 配 `reference_audio`。
图片、视频、音频的格式、大小、时长、尺寸、角色组合等由 MiniMax 上游继续校验。同步校验通过后,媒体下载、转码或内容审核失败会在异步任务中以 `failed` 返回。
对于参考视频或音频,单段超过 15 秒时只保留从开头起的 15 秒;这是裁切,不是压缩或加速。视频参考累计时长和独立音频累计时长仍须分别不超过 15 秒。
## 5. 创建响应
创建成功只表示任务已受理,不代表视频已生成。响应至少包含上游任务号:
```json
{
"task_id": "task_01HXXXXXXXXXXXXXXX"
}
```
请保存 `task_id`,用于查询任务。建议为每次创建请求设置唯一的 `Idempotency-Key`。网络超时后重试时,必须复用相同的 Key 和请求体,以避免重复创建任务。
如果填写 `callback_url`,该地址必须是调用方可接收请求的公网 HTTPS 地址。上游可能先发送 challenge 验证,随后在 `queued`、`running`、`succeeded`、`failed` 或 `cancelled` 状态变化时回调;回调接收端应按 `task_id` 和状态实现幂等处理。
## 6. 查询任务
### 请求
```bash
curl -sS \
-H 'Authorization: Bearer ' \
https://kkapi.work/v1/videos/generations/
```
任务只对创建它的用户、API Key 和分组可见。建议每隔 2–5 秒查询一次,直到任务进入终态。
### 成功响应
本站透传 MiniMax 上游任务结构,示例:
```json
{
"task": {
"id": "task_01HXXXXXXXXXXXXXXX",
"model": "MiniMax-H3",
"status": "succeeded",
"resolution": "768P",
"duration": 5,
"ratio": "16:9",
"progress": 1,
"content": {
"url": "https://media.example.com/result.mp4"
},
"usage": {
"output_seconds": 5,
"input_image_count": 0
}
}
}
```
### 任务状态
| 状态 | 含义 | 是否扣费 |
|---|---|---:|
| `queued` | 已受理,正在准备输入、审核或排队 | 否 |
| `running` | 正在生成或发布结果 | 否 |
| `succeeded` | 视频已生成并发布结果地址 | 是 |
| `failed` | 输入准备、审核或生成失败 | 否 |
| `cancelled` | 任务被服务端终止 | 否 |
判断成功必须同时满足:
1. `task.status` 为 `succeeded`;
2. `task.content.url` 为非空 HTTPS 地址。
查询一个已失败的任务仍可能返回 HTTP `200`,必须检查 `task.status` 和 `task.error`,不能只看 HTTP 状态码。
## 7. 下载视频
成功响应中的 `task.content.url` 是完整的公开 HTTPS 直链。请尽快下载并保存到自己的存储:
```bash
curl -L --output result.mp4 '替换为 task.content.url 的完整值'
```
下载结果直链时不要携带本站 API Key 或 MiniMax Bearer 鉴权头。公开结果的保留时间由上游服务策略决定,本站不建议将该直链作为长期存储地址。
成功输出为 MP4 容器、H.264 视频(24 FPS),音频为 AAC、32 kHz、双声道。实际容器时长可能因帧网格略长于请求的名义时长,账单仍按任务 usage 中的输出秒数计费。
## 8. 计费规则
- MiniMax H3 按成功输出时长计费,计费单位为秒;
- 计费时长优先使用任务 `usage.output_seconds`,缺失时回退到创建请求的 `duration`;
- 当前本站入口固定 `768P`,参考图片数量会记录在用量元数据中,当前不按图片数量额外收费;
- 当前默认平台单价为 `0.100000 USD/秒`,分组价格覆盖、用户费率倍率和运营方当前配置可能改变实际账单;
- 费用在账单中按小数点后 6 位精度计算和舍入;
- 只有任务成功并返回有效 `task.content.url` 后才会写入用量账单;创建失败、异步失败、取消、排队和生成中的任务不会扣费。
费用估算(未计入分组或用户倍率):
```text
基础费用 = 成功输出秒数 × 每秒单价
示例:5 秒 × 0.100000 USD/秒 = 0.500000 USD
```
## 9. 错误处理
同步错误示例:
```json
{
"error": {
"type": "bad_request_error",
"message": "duration must be an integer from 1 to 15"
}
}
```
常见 HTTP 错误:
| HTTP | 类型 | 常见原因 |
|---:|---|---|
| `400` | `bad_request_error` | JSON、模型、字段、时长、比例、内容数量或幂等参数不合法 |
| `401` | 认证错误 | API Key 缺失、无效或已失效 |
| `403` | `permission_error` | 当前 MiniMax 分组未启用视频生成权限或账户额度不足 |
| `404` | `not_found_error` | 路径错误、任务不属于当前用户/Key/分组,或 MiniMax 分组未启用 |
| `502` | `upstream_error` | MiniMax 上游请求失败 |
| `503` | `service_unavailable_error` | 当前没有可用的 MiniMax 上游账号 |
异步失败时,错误位于查询响应的 `task.error`:
```json
{
"task": {
"id": "task_01HXXXXXXXXXXXXXXX",
"status": "failed",
"error": {
"code": "input_format_unsupported",
"message": "media format is not supported"
}
}
}
```
常见异步错误包括:`input_download_failed`、`input_security_violation`、`input_too_large`、`input_probe_failed`、`input_format_unsupported`、`input_duration_out_of_range`、`input_dimensions_out_of_range`、`input_transcode_failed`、`content_policy_violation` 和 `fail_to_fetch_task`。
## 10. 接入检查清单
1. 使用本站分配到 MiniMax 分组的 API Key;
2. 请求模型填写 `MiniMax-H3`,分辨率填写 `768P`;
3. `content` 保证恰好一个文本项,媒体 URL 使用公网 HTTPS;
4. `duration` 使用 `1–15` 的整数,`ratio` 不留空;
5. 创建请求设置唯一 `Idempotency-Key` 并保存 `task_id`;
6. 轮询查询,只有 `succeeded` 且存在 `task.content.url` 时才认为成功;
7. 下载公开结果地址时不要附带 Bearer 鉴权头。
Announcement2026-08-31 19:07
team 分组 暂时停用 通知
team 号池并发限制+官方大面积杀号+故障期间的并发累积,延迟过高,几乎不可用,现决定对其暂时关停,待 2026-09-01 上午(具体时间未知) 进行连通性检查后决定是否重新开放。
Announcement2026-08-24 18:20
0825 服务更新公告
# 服务更新公告
**UTC+8 2026-08-25 02:14**
## 更新内容
1. 常规系统版本升级。
2. 加入每日累计消耗抽奖系统。
3. 加入每周累计消耗排行抽奖。
4. 加入可控每日签到系统。
5. 对系统UI进行了毛玻璃美化。
Announcement2026-08-24 13:58
视频模型上新
grok-视频创作专线已上新,欢迎加入画布进行尝试
Announcement2026-08-16 12:29
8.16 Gemini模型上新
Gemini-3.7-flash新模型已在Gemini-稳定 分组中可用
Announcement2026-08-14 09:44
使用前请阅读
# 🌐 Halion 中转站使用说明
**本站不对中国大陆任何人开放使用**
---
## 一、联系方式
| 渠道 | 账号 |
|------------|-------------------|
| QQ群 | `1102271557` |
| TG群 | `t.me/halionapi` |
| 客服QQ | `2485272466` |
| 客服微信 | `husky_5071` |
> 如有任何使用问题,欢迎随时加入交流群咨询。
---
## 二、中转站地址
**主地址:**
```
https://halion.asia
```
> ⚠️ 提示:若当前分组不可用,请及时切换到其他可用分组。
---
## 三、倍率说明
在 Key 配置界面中已显示 **「实际落地倍率」**,计算规则如下:
### 计算公式
```
实际倍率 = 标注倍率 ÷ 汇率
实际价格 = 实际落地倍率 × 官方价格
```
### 充值汇率
> 💡 充值时 **RMB : USD = 1 : 1**
### 示例说明
| 项目 | 说明 |
| :--- | :--- |
| 标注倍率 | Key 配置界面中显示的倍率 |
| 实际落地倍率 | 标注倍率 ÷ 对美元汇率(配置界面已自动计算) |
| 实际价格 | 实际落地倍率 × 官方价格 |
---
## 四、邀请返利
### 返利规则
| 项目 | 内容 |
| :---: | :---: |
| 返利比例 | **10%** |
| 冻结期 | **24 小时** |
> 📢 邀请新用户注册充值后,即可获得充值金额 10% 的返利。返利金额在 **24 小时冻结期**后可提取,请耐心等待。
Announcement2026-08-14 09:44
使用前请阅读
# 🌐 Halion 中转站使用说明
**收藏地址不迷路*
---
## 一、联系方式
| 渠道 | 账号 |
|------------|-------------------|
| QQ群 | `1102271557` |
| TG群 | `t.me/halionapi` |
| 客服QQ | `2485272466` |
| 客服微信 | `husky_5071` |
> 如有任何使用问题,欢迎随时加入交流群咨询。
---
## 二、中转站地址
**主地址:**
```
https://halion.asia
```
> ⚠️ 提示:若当前分组不可用,请及时切换到其他可用分组。
---
## 三、倍率说明
在 Key 配置界面中已显示 **「实际落地倍率」**,计算规则如下:
### 计算公式
```
实际倍率 = 标注倍率 ÷ 汇率
实际价格 = 实际落地倍率 × 官方价格
```
### 充值汇率
> 💡 充值时 **RMB : USD = 1 : 1**
### 示例说明
| 项目 | 说明 |
| :--- | :--- |
| 标注倍率 | Key 配置界面中显示的倍率 |
| 实际落地倍率 | 标注倍率 ÷ 对美元汇率(配置界面已自动计算) |
| 实际价格 | 实际落地倍率 × 官方价格 |
---
## 四、邀请返利
### 返利规则
| 项目 | 内容 |
| :---: | :---: |
| 返利比例 | **5%** |
| 冻结期 | **24 小时** |
> 📢 邀请新用户注册充值后,即可获得充值金额 5% 的返利。返利金额在 **24 小时冻结期**后可提取,请耐心等待。
Announcement2026-08-14 09:44
使用前请阅读
# 🌐 Halion 中转站使用说明
**本站不对中国大陆任何人开放使用**
---
## 一、联系方式
| 渠道 | 账号 |
|------------|-------------------|
| QQ群 | `1102271557` |
| TG群 | `t.me/halionapi` |
| 客服QQ | `2485272466` |
| 客服微信 | `husky_5071` |
> 如有任何使用问题,欢迎随时加入交流群咨询。
---
## 二、中转站地址
**主地址:**
```
https://halion.asia
```
> ⚠️ 提示:若当前分组不可用,请及时切换到其他可用分组。
---
## 三、倍率说明
在 Key 配置界面中已显示 **「实际落地倍率」**,计算规则如下:
### 计算公式
```
实际倍率 = 标注倍率 ÷ 汇率
实际价格 = 实际落地倍率 × 官方价格
```
### 充值汇率
> 💡 充值时 **RMB : USD = 1 : 1**
### 示例说明
| 项目 | 说明 |
| :--- | :--- |
| 标注倍率 | Key 配置界面中显示的倍率 |
| 实际落地倍率 | 标注倍率 ÷ 对美元汇率(配置界面已自动计算) |
| 实际价格 | 实际落地倍率 × 官方价格 |
---
## 四、邀请返利
### 返利规则
| 项目 | 内容 |
| :---: | :---: |
| 返利比例 | **5%** |
| 冻结期 | **24 小时** |
> 📢 邀请新用户注册充值后,即可获得充值金额 5% 的返利。返利金额在 **24 小时冻结期**后可提取,请耐心等待。
Announcement2026-08-12 16:42
8.13 Grok 4.6 上新
grok 4.6 模型在 Grok 分组中已可用