接入文档 Documentation

三分钟接入第一个模型

本站完全兼容 OpenAI 协议,任何支持自定义 base_url 的 SDK 或工具都能直接使用,不需要改业务代码。

快速开始

拿到密钥

登录控制台,进入「令牌」页新建一个,复制 sk- 开头的字符串。密钥只在创建时完整显示一次,请立即保存。

配置 base_url

把 SDK 的接口地址改成 https://console.jinxiaodouai.cn/v1,其余参数保持原样。

发一次请求

用下面的示例跑通一次,确认返回内容正常即接入完成。

接口地址

所有请求走同一个入口,模型通过请求体里的 model 字段区分:

# OpenAI 兼容入口
https://console.jinxiaodouai.cn/v1
# 常用端点
POST /v1/chat/completions
POST /v1/embeddings
GET  /v1/models

不要使用其它域名的地址。海外站与本站在账号、余额、模型上彼此独立,跨站调用会返回密钥无效。

调用示例

# curl
curl https://console.jinxiaodouai.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4.1-flash","messages":[{"role":"user","content":"你好"}]}'
# Python(openai>=1.0)
from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://console.jinxiaodouai.cn/v1",
)
r = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "你好"}],
)
print(r.choices[0].message.content)
# Node.js
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的密钥",
  baseURL: "https://console.jinxiaodouai.cn/v1",
});
const r = await client.chat.completions.create({
  model: "deepseek-v4.1-flash",
  messages: [{ role: "user", content: "你好" }],
});
console.log(r.choices[0].message.content);

可用模型

当前开通 7 个模型:doubao-seed-2.0-lite、glm-5.3-flash、deepseek-v4.1-flash、doubao-seed-2.1-pro、glm-5.3、deepseek-v4-pro、kimi-k3。

完整价格与定位见 模型与价格 页。调用未开通的模型会返回 model_not_found。

常见错误

  • 401 invalid_api_key — 密钥错误、已被删除,或用了别的站的密钥。
  • 403 model_not_allowed — 该密钥有模型白名单限制,需要在创建密钥时勾选对应模型。
  • 429 rate_limit_exceeded — 触发限流,按响应头里的重试时间退避。
  • 402 insufficient_quota — 额度不足,联系商务追加。
  • model_not_found — 模型名拼错,或该模型尚未在本站开通。

限额与计费

按 token 计费,输入与输出分别计价,命中上下文缓存的部分按缓存价计费且不重复计入输入。请求失败不扣费。

每个令牌可以单独设置额度上限、模型白名单、IP 白名单与过期时间,建议按项目拆分令牌,便于定位消耗来源。

数据与安全

  • 密钥在服务端加密存储,控制台列表只显示前后各几位。
  • 请求日志用于计费与排障,可按账号导出,不做二次利用。
  • 本站不提供绕过上游使用限制的能力,遵守运营所在地法律法规。

有问题直接发邮件到 wangyifu@jinxiaodouai.cn,工作日通常当天回复。