使用文档

艺豪API 提供 OpenAI 兼容接口,一站接入 DeepSeek / GLM / Kimi / MiniMax 等 18 款模型,支持 Claude Code、Codex CLI、Cline、Cherry Studio 等主流客户端。

Base URLhttps://api.yihao.im/v1
Anthropic 兼容https://api.yihao.im(Claude Code 用,不带 /v1)
认证方式Authorization: Bearer sk-你的API密钥

1. 快速开始

  1. 使用邮箱在 https://api.yihao.im 注册并登录。
  2. 进入「API 密钥」页面创建密钥,复制 sk- 开头的完整字符串(只显示一次,请妥善保存)。
  3. 账户余额不足时,通过「兑换」页面输入兑换码充值,或联系客服人工充值。
  4. 按下方示例把 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/completionsOpenAI Chat Completions 协议,支持 stream
POST /v1/responsesOpenAI Responses 协议(Codex 等客户端使用)
POST /v1/messagesAnthropic 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 CodeANTHROPIC_BASE_URL=https://api.yihao.im
ANTHROPIC_AUTH_TOKEN=sk-你的密钥
Codex CLI~/.codex/config.toml 中设置 base_url = "https://api.yihao.im/v1"、env_key 指向存放密钥的环境变量
Cline / Roo CodeProvider 选 OpenAI Compatible,Base URL 填 https://api.yihao.im/v1
Cherry Studio / ChatBox添加 OpenAI 兼容服务商,地址填 https://api.yihao.im/v1
OpenAI SDKbase_url="https://api.yihao.im/v1"

6. 计费与充值

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 | 模型与价格:模型广场