使用文档
艺豪API 提供 OpenAI 兼容接口,一站接入 DeepSeek / GLM / Kimi / MiniMax 等 18 款模型,支持 Claude Code、Codex CLI、Cline、Cherry Studio 等主流客户端。
Base URL
https://api.yihao.im/v1Anthropic 兼容
https://api.yihao.im(Claude Code 用,不带 /v1)认证方式
Authorization: Bearer sk-你的API密钥1. 快速开始
- 使用邮箱在 https://api.yihao.im 注册并登录。
- 进入「API 密钥」页面创建密钥,复制
sk-开头的完整字符串(只显示一次,请妥善保存)。 - 账户余额不足时,通过「兑换」页面输入兑换码充值,或联系客服人工充值。
- 按下方示例把 Base URL 和密钥填入你的客户端即可开始调用。
2. 模型列表
当前共 18 款模型,按分组划分;模型中带 cn: 前缀的别名与同名模型完全等价、价格相同,仅为兼容部分客户端的命名习惯。
| 分组 | 模型 ID | 说明 |
|---|---|---|
| DeepSeek 系列 | deepseek-v4-pro deepseek-v4-flash deepseek-v4.1-flash | 通用对话、推理与代码 |
| GLM 系列 | glm-5.3 glm-5.3-flash glm-5.2 | 中文写作、长文本处理 |
| Kimi 系列 | kimi-k3.1-pro kimi-k3-1 kimi-k2.8-preview | 长上下文、资料分析 |
| 旗舰系列 | auto step-5-preview space-bunny mimo-v2.6-pro minimax-m3.1-flash hy4std hy4-preview-f | 综合能力与多场景任务 |
| 轻量系列 | hy4flash hy4flash-free | 低延迟、低成本;free 为免费额度模型 |
实时可用模型、单价与上下文长度以 模型广场 和
GET /v1/models 返回为准。3. 兼容端点
| 端点 | 说明 |
|---|---|
GET /v1/models | 列出当前密钥可用的模型 |
POST /v1/chat/completions | OpenAI Chat Completions 协议,支持 stream |
POST /v1/responses | OpenAI Responses 协议(Codex 等客户端使用) |
POST /v1/messages | Anthropic Messages 协议(Claude Code 等客户端使用) |
4. 调用示例
查询模型
curl https://api.yihao.im/v1/models \
-H "Authorization: Bearer $YIHAO_API_KEY"
curl(对话)
curl https://api.yihao.im/v1/chat/completions \
-H "Authorization: Bearer $YIHAO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4-pro",
"messages": [{"role": "user", "content": "用三句话介绍你自己"}],
"stream": false
}'
Python(openai SDK)
from openai import OpenAI
client = OpenAI(
api_key="sk-你的密钥",
base_url="https://api.yihao.im/v1",
)
resp = client.chat.completions.create(
model="deepseek-v4-pro",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-你的密钥",
baseURL: "https://api.yihao.im/v1",
});
const resp = await client.chat.completions.create({
model: "glm-5.3",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);
5. 客户端接入
| 客户端 | 配置 |
|---|---|
| Claude Code | ANTHROPIC_BASE_URL=https://api.yihao.imANTHROPIC_AUTH_TOKEN=sk-你的密钥 |
| Codex CLI | ~/.codex/config.toml 中设置 base_url = "https://api.yihao.im/v1"、env_key 指向存放密钥的环境变量 |
| Cline / Roo Code | Provider 选 OpenAI Compatible,Base URL 填 https://api.yihao.im/v1 |
| Cherry Studio / ChatBox | 添加 OpenAI 兼容服务商,地址填 https://api.yihao.im/v1 |
| OpenAI SDK | base_url="https://api.yihao.im/v1" |
6. 计费与充值
- 按 token 计费,输入与输出分别计价,请求完成后从账户余额中扣减。
- 当前所有分组倍率均为
1.0,无额外加价;cn:前缀模型与同名模型同价。 - 充值方式:兑换码(/redeem)或联系客服人工充值。
- 余额不足时请求会返回
402,请先充值再调用。
7. 限流与配额
| 项目 | 默认值 |
|---|---|
| 并发请求 | 10 |
| 每分钟请求数(RPM) | 120 |
| 单次请求体 | 最大 256 MB |
| 流式响应超时 | 900 秒 |
超出限制会返回 429,请按响应头 Retry-After 退避重试。如需提高额度请联系客服。
8. 错误码
| 状态码 | 含义 | 处理建议 |
|---|---|---|
401 | 未授权 / 密钥无效 | 检查 Authorization 头是否完整、密钥是否被删除或停用 |
403 | 无权访问该模型 | 确认密钥已分配到包含该模型的分组 |
404 | 模型不存在 | 用 GET /v1/models 核对模型 ID,注意 cn: 前缀 |
402 | 余额不足 | 前往兑换页充值 |
429 | 触发限流 | 按 Retry-After 退避,或降低并发 |
5xx | 上游或网关异常 | 稍后重试;持续出现请联系客服并提供请求时间 |
9. 常见问题
返回 401,但密钥看起来没问题?
确认请求头是 Authorization: Bearer sk-...,不要把密钥放进 URL 或请求体;若密钥已删除需重新创建。
模型列表里有,但调用报 404?
多数是模型名拼写或分组权限问题。先用 GET /v1/models 取回准确 ID,再检查密钥所属分组。
流式输出中途断开?
通常是客户端读超时或网络中断,建议把客户端超时设为 300 秒以上并开启重试。
Claude Code 连不上?
ANTHROPIC_BASE_URL 只填 https://api.yihao.im,不要带 /v1;密钥使用 ANTHROPIC_AUTH_TOKEN。
10. 获取帮助
客服 QQ:527653066 | 控制台工单:https://api.yihao.im | 模型与价格:模型广场