DEVELOPER GUIDE / 开发指南
从第一行代码开始。
一把密钥,接入图片、对话与视频。使用熟悉的 OpenAI 兼容格式,跟着示例完成你的第一次调用。
文档更新于 2026-09-04查看模型价格 ↗
三步接入
- 注册账号并登录后,到「控制台 → 令牌」创建 API 密钥。完整密钥可在「API 密钥 → 详情」中按需查看。新账号初始额度为 0,由站长人工开通后即可调用。
- base_url 设为 https://hxai666.com/v1,api_key 填这把密钥。
- 按下面的端点调用。任何 OpenAI SDK 或兼容客户端都可以。
from openai import OpenAI client = OpenAI(base_url="https://hxai666.com/v1", api_key="sk-你的密钥")
认证
所有请求带 Bearer。不要把密钥写进前端页面或 URL。
Authorization: Bearer sk-xxxxxxxx
泄露后立刻在令牌页删除并重建。Codex / GPT-5.x 目前暂未开放,请先查看模型价格页的可用状态。
图片
POST /v1/images/generations,同步返回。客户端超时请设 180 秒以上,过早断开服务端仍可能已经出图。
| 模型 | 计费 |
|---|---|
| gpt-image-2 / -1k / -4k | 按张 |
| grok-imagine-image* | 按张 |
curl https://hxai666.com/v1/images/generations \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-image-2-1k","prompt":"一只在雪地里奔跑的柴犬","size":"1024x1024"}'
图片返回示例
成功时与 OpenAI Images 格式兼容,常见字段如下。
{
"created": 1756982400,
"data": [
{
"b64_json": null,
"url": "https://example.invalid/generated.png",
"revised_prompt": "一只在雪地里奔跑的柴犬"
}
]
}
对话
POST /v1/chat/completions,支持 stream: true。模型:grok-4.5、grok-4.6、grok-chat-fast、grok-composer-2.5-fast,按 token 计费。
curl https://hxai666.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{"model":"grok-chat-fast","messages":[{"role":"user","content":"用一句话介绍柴犬"}]}'
视频模型请使用视频任务端点,避免 400/404 错误。
流式对话
把 stream 设为 true,响应为 SSE(data: {...}),最后一行为 data: [DONE]。
curl https://hxai666.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-N \
-d '{"model":"grok-chat-fast","stream":true,"messages":[{"role":"user","content":"用一句话介绍柴犬"}]}'
视频
异步任务:POST /v1/videos 拿到任务 ID,再 GET /v1/videos/{task_id} 轮询。也可走 /v1/video/generations。不要用 /v1/videos/generations(404),也不要走聊天。
Grok 视频
- grok-imagine-video $0.05 / 秒;grok-imagine-video-1.5 / grok-1.5-video $0.10 / 秒
- seconds 必须是 "1"–"15" 的数字字符串
- 可选 size,如 720x1280 / 1280x720
- 完成后用返回地址下载,或 GET /v1/videos/{task_id}/content。链接有时效,尽快转存
- 失败(含审核拒绝)会退款。轮询间隔 3–5 秒,客户端等 5 分钟即可
curl https://hxai666.com/v1/videos \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{"model":"grok-imagine-video","prompt":"一只柴犬在雪地里跑,镜头跟随","seconds":"1"}'
import time, requests
BASE, H = "https://hxai666.com", {"Authorization": "Bearer sk-你的密钥"}
task = requests.post(f"{BASE}/v1/videos", headers=H, json={
"model": "grok-imagine-video",
"prompt": "海浪拍打礁石,黄昏,慢镜头",
"seconds": "1",
}).json()
tid = task.get("id") or task.get("task_id")
while True:
r = requests.get(f"{BASE}/v1/videos/{tid}", headers=H).json()
if r.get("status") in ("completed", "failed"):
print(r); break
time.sleep(5)
Seedance 视频
- 本站统一使用 /v1/videos 端点,无需更换接入地址
- 模型:doubao-seedance-2-0-mini-260615 等,按 token,单价见价格页
- 提交时可能先预扣一笔较大额度,结束后按实际用量结算。余额不够预扣会 403,不生成
- 单次通常 3–6 分钟,请轮询
curl https://hxai666.com/v1/videos \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{"model":"doubao-seedance-2-0-mini-260615","prompt":"海浪拍打礁石,黄昏,电影感","duration":4}'
列出模型
GET /v1/models 返回当前可用模型列表。
curl https://hxai666.com/v1/models \ -H "Authorization: Bearer sk-你的密钥"
Node.js OpenAI SDK
与 Python 一样,只改 baseURL 和密钥。
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://hxai666.com/v1",
apiKey: "sk-你的密钥",
});
const r = await client.chat.completions.create({
model: "grok-chat-fast",
messages: [{ role: "user", content: "用一句话介绍柴犬" }],
});
console.log(r.choices[0].message.content);
Cherry Studio / ChatBox
任意 OpenAI 兼容客户端都可以,关键是填对 base_url 和 api_key。
Cherry Studio
- 打开 Cherry Studio,进入「设置 → 模型服务」。
- 添加一个「OpenAI 兼容」服务商(或自定义 OpenAI)。
- API 地址 / Host 填 https://hxai666.com/v1(可用本页「复制 base_url」)。
- API Key 填控制台「令牌」页创建的密钥。
- 保存后,在对话里选择 grok-chat-fast 等已开通模型。
ChatBox
- 打开 ChatBox → Settings → Providers(或「模型提供方」)。
- 选择 OpenAI Compatible / 自定义 API。
- API Host 填 https://hxai666.com/v1,API Key 填同一把密钥。
- 模型名按「模型价格」页填写,保存后即可对话或出图。
计费
- 展示单位美元,1 美元 = 500,000 额度
- 失败请求(上游错误、无可用渠道、参数错误)不扣费;视频任务失败会退还预扣
- 流式对话会先预扣,结束后按实际 token 结算
- 余额由站长人工充值,明细在控制台日志
错误
| HTTP | 含义 |
|---|---|
| 400 | 参数不合法,例如视频 seconds 不在 1–15 |
| 401 | 密钥无效或缺失 |
| 403 | 余额不足(含视频预扣不够)或无权 |
| 404 | 路径写错,或把视频模型丢进了聊天端点 |
| 429 / 5xx | 限流或上游异常,退避重试 |
排障请带上请求时间、模型名和返回错误。
