Quickstart
5 分钟把 HeiyuGateway 接入你的应用:注册 → 充值 → 拿 sk-gw- key → 改 base_url。
1. 注册账号
访问 注册页,邮箱 + 密码即可创建账号。联系客服以获取测试额度。
2. 充值
登录后进入 充值页,选套餐完成支付, 余额自动到账。最低 ¥50,各套餐默认赠送面值 5% 的余额。
3. 创建 API Key
进入控制台 → API Keys → "创建新 Key"。Key 形如 sk-gw-XXXX...,只在创建那一次显示完整内容;复制保存即可,丢失需重建。
创建时可选范围:默认所有模型,也可以按 model ID 限定到目录里的某几个。
4. 调用
把 OpenAI / Anthropic SDK 的 base_url 指向我们即可:
OpenAI Python SDK
from openai import OpenAI
client = OpenAI(
api_key="sk-gw-XXXXXXXXXXXXXXXXXXXXXXXXXX",
base_url="https://heiyutv.com/api/v1",
)
resp = client.chat.completions.create(
model="deepseek-v4-pro",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)Anthropic Python SDK
from anthropic import Anthropic
client = Anthropic(
api_key="sk-gw-XXXXXXXXXXXXXXXXXXXXXXXXXX",
base_url="https://heiyutv.com",
)
resp = client.messages.create(
model="deepseek-v4-pro",
max_tokens=1024,
messages=[{"role": "user", "content": "你好"}],
)
print(resp.content[0].text)cURL
curl https://heiyutv.com/api/v1/chat/completions \
-H "Authorization: Bearer sk-gw-XXXXXXXXXXXXXXXXXXXXXXXXXX" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4-pro",
"messages": [{"role": "user", "content": "你好"}]
}'5. 监控
每次请求都进 Logs 页。点行查看路由链 + token 拆分 + 上游 request_id。账户流水在Billing 页。
下一步
- OpenAI 兼容细节(参数白名单、不支持的字段)
- Anthropic /messages(字节级透传 + cache_control)
- 视频生成(Seedance 2.0,火山方舟兼容接口,异步任务制)
- 素材库(素材组、图片/视频/音频素材与真人认证,火山 Action 协议兼容)
- 计费与余额(查余额、查用量、拉逐条消费明细的接口)
- 错误码列表
- 测试账号——接入联调期间不花钱地把成功和失败两半都跑通