接入文档

1. 获取 API Key

登录控制台 → API Key → 新建 Key，复制保存（只显示一次）。

2. 替换 base_url 即可使用

如果你已有 OpenAI SDK 代码，只需把 https://api.openai.com/v1 换成：

https://api.yyc5858.xyz/v1

无需修改模型名以外的任何代码。

所有请求须在 HTTP Header 中携带 API Key：

Authorization: Bearer sk-your-api-key
Content-Type: application/json

Key 的权限分组如下，新建时默认属于 default 分组：

default — 仅国内模型（DeepSeek / 通义 / 智谱 / Kimi / 豆包 / 百川）
intl — 仅海外模型（GPT / Claude / Gemini 等）
all — 全部模型（管理员或特殊申请开通）

传入的 model 参数会由网关自动映射到上游可用渠道。你不需要关心后端实际调用的是哪个上游。

你传入的 model	实际映射	分组	备注
`deepseek-chat`	DeepSeek-V3	default	国产·性价比高
`deepseek-reasoner`	DeepSeek-R1	default	推理模型
`qwen-turbo`	通义千问-Turbo	default	国产
`qwen-plus`	通义千问-Plus	default	国产
`qwen-max`	通义千问-Max	default	国产·最强
`glm-4-plus`	智谱 GLM-4-Plus	default	国产
`glm-4-flash`	智谱 GLM-4-Flash	default	国产·极速
`moonshot-v1-8k`	Kimi-V1-8K	default	国产
`moonshot-v1-32k`	Kimi-V1-32K	default	国产
`doubao-pro`	豆包-Pro	default	国产
`baichuan4`	百川4	default	国产
`gpt-4o`	GPT-4o	intl	OpenAI
`gpt-4o-mini`	GPT-4o-mini	intl	OpenAI
`gpt-3.5-turbo`	GPT-3.5-Turbo	intl	OpenAI
`claude-3-5-sonnet`	Claude-3.5-Sonnet	intl	Anthropic
`claude-3-haiku`	Claude-3-Haiku	intl	Anthropic
`gemini-1.5-pro`	Gemini-1.5-Pro	intl	Google
`gemini-1.5-flash`	Gemini-1.5-Flash	intl	Google

提示：default 分组用户调用 intl 模型会返回 403；如需开通海外模型请联系客服。

POST /v1/chat/completions

与 OpenAI 格式 100% 兼容。支持 messages、temperature、max_tokens、stream、tools、response_format（json_mode）等参数。

请求示例

curl https://api.yyc5858.xyz/v1/chat/completions \\
  -H "Authorization: Bearer sk-your-key" \\
  -H "Content-Type: application/json" \\
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role":"user","content":"你好"}],
    "temperature": 0.7
  }'

响应示例

{
  "id": "chatcmpl-xxxxx",
  "object": "chat.completion",
  "created": 1724500000,
  "model": "deepseek-chat",
  "choices": [{
    "index": 0,
    "message": {"role":"assistant", "content":"你好！有什么可以帮你的吗？"},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens":2, "completion_tokens":10, "total_tokens":12}
}

注意：usage 字段一定返回，方便你统计用量。

设置 "stream": true 即可启用 Server-Sent Events。逐字返回，首 token 延迟通常在 300~1200ms。

curl -N https://api.yyc5858.xyz/v1/chat/completions \\
  -H "Authorization: Bearer sk-your-key" \\
  -H "Content-Type: application/json" \\
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role":"user","content":"讲个笑话"}],
    "stream": true
  }'

返回格式为 data: {...}\n\n，结束标志为 data: [DONE]。与 OpenAI 官方行为完全一致。

HTTP 状态	错误码	含义	处理建议
200	—	成功	正常解析响应
401	`invalid_api_key`	API Key 无效或已过期	检查 Key 是否正确，是否在控制台被禁用
403	`model_not_allowed`	当前 Key 分组无权调用该模型	default 分组用户调用了 intl 模型，联系客服开通
429	`rate_limit_exceeded`	请求过于频繁	降低调用频率，或联系客服提升限流
402	`insufficient_quota`	余额不足	前往控制台充值
500	`upstream_error`	上游服务异常	稍后重试；如持续出现请提交工单
502/503	`service_unavailable`	网关或上游暂不可用	等待 5~10 秒后重试，通常自动恢复
422	`invalid_request`	请求参数错误	检查 model 名称、messages 格式是否合法

所有错误响应均返回 JSON：{"error": {"code": "...", "message": "..."}}，不会返回 HTML 页面。

按 Token 计费，与上游官方价格基本一致，无隐藏加价。1 USD = 500,000 点（1 点 ≈ 1 token）。

输入（prompt）与输出（completion）分别计价，输出通常更贵
每次请求响应中均包含 usage 字段，可精确核对
控制台提供实时余额、消耗趋势、Top5 模型统计
充值档位：$10 / $20 / $50 / $100 / 企业定制
支持支付宝（国内）、PayPal（海外）

查看完整价格表 → 查看我的用量

Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    base_url="https://api.yyc5858.xyz/v1",
    api_key="sk-your-api-key"
)

r = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role":"user", "content":"你好"}]
)
# 一定包含 usage，方便记账
print(r.choices[0].message.content)
print(r.usage.total_tokens)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.yyc5858.xyz/v1",
  apiKey: "sk-your-api-key"
});

const r = await client.chat.completions.create({
  model: "deepseek-chat",
  messages: [{ role: "user", content: "你好" }]
});
console.log(r.choices[0].message.content);
console.log(r.usage.total_tokens);

遇到问题？

查看控制台、联系客服或阅读常见问题

联系客服进入控制台

快速开始

1. 获取 API Key

2. 替换 base_url 即可使用

认证方式

模型列表与映射

对话接口

请求示例

响应示例

流式接入（SSE）

错误码体系

计费说明

SDK 示例

Python（OpenAI SDK）

Node.js

遇到问题？