API KEY INSIGHT

看清每一笔
API 消耗。

粘贴你的API密钥,快速确认可用余额、额度和最近调用情况。

  • 额度一目了然余额、已用和总额度
  • 最近调用记录模型、Token 与耗时
  • 只读且不保存Key 仅用于本次查询

SECURE LOOKUP

连接你的 API

KEY

粘贴客服提供的 API Key,以 sk- 开头。

Key 不会被保存,也不会写入服务器日志。

这个 Key 能查什么?
sk-
余额与近期调用

可查询剩余额度、有效期和最近调用;趋势仅代表近期日志。

INTEGRATION

接入大模型

网关同时兼容 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 与 Gemini 原生协议。按五步接入:拿到端点、填进客户端、选 Agent、发起请求、验证排错。

STEP 01 · ENDPOINT

拿到接入端点和密钥

下单后提供
接入端点
下单时由客服提供
路径前缀
/v1 · Gemini 为 /v1beta
API Key
下单时由客服提供
模型清单
GET /v1/models

接入端点和 API Key 都由客服提供;示例里的 https://api.example.com 替换成实际域名即可,路径保持不变。

STEP 02 · CLIENT

填进客户端或 SDK

只需两项
OpenAI 协议客户端
https://api.example.com/v1
Anthropic 协议客户端
https://api.example.com(不带 /v1)
API Key
sk-… 填入 api_key
鉴权头
由客户端自动带上,无需手写

大多数 agent / SDK 只需要 base_url 和 api_key 两项:OpenAI 客户端自动加 Authorization,Anthropic 客户端自动加 x-api-key 与 anthropic-version,Gemini 客户端自动加 x-goog-api-key。

STEP 03 · AGENTS

接入常用 Agent 与客户端

OpenAI 兼容
Codex CLI
Claude Code
Claude Desktop
Gemini CLI
WorkBuddy
Cursor
Cline
Roo Code
Continue
Aider
OpenCode
Kimi Code
DeepSeek
MiniMax Code
Pi / Oh My Pi
Antigravity
OpenClaw
LobeChat
Open WebUI

以上客户端都只需要 Base URL 和 API Key:Claude Code / Claude Desktop 走 Anthropic 协议,Gemini CLI 走 Gemini 原生,其余走 OpenAI 兼容;模型名以 GET /v1/models 为准。列表之外,只要支持自定义 Base URL 的客户端都能接入。

STEP 04 · REQUEST

按协议发起请求

OPENAI 兼容
POST /v1/chat/completions
REQUEST
curl -X POST "https://api.example.com/v1/chat/completions" \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4.1-mini",
    "messages": [
      { "role": "user", "content": "用一句话解释什么是 SSE" }
    ],
    "stream": true
  }'
RESPONSE
{
  "object": "chat.completion",
  "model": "gpt-4.1-mini",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "SSE 是……" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 18, "completion_tokens": 42, "total_tokens": 60 }
}
正文 choices[0].message.content SSE · STREAM

STEP 05 · CHECK

验证与排错

  • 先用 GET /v1/models 确认这个 Key 能看到目标模型。
  • 首次调用先用非流式(去掉 stream),方便看完整响应。
  • 失败时记录响应头 x-request-id,反馈问题时一起提供。
  • 遇到 429 按 Retry-After 退避,不要立即重试。
常见状态码与处理 400 · 401 · 403 · 404 · 429 · 5xx
状态 含义 处理建议
400 请求体或参数不合法 检查 JSON、模型 ID、max_tokens 等必填参数
401 Key 无效 确认 Key 完整、未被禁用,且鉴权头与协议匹配
403 无权限或被拦截 模型不在该 Key 的可用列表;或出口 IP 不在白名单
404 模型或路径不存在 用 /v1/models 校对模型 ID;确认协议路径没写错
413 请求体或上下文过长 精简 messages,或换用上下文更大的模型
429 限流或额度不足 按 Retry-After 退避重试;到首页确认余额
5xx 上游渠道异常 稍后重试或切换模型;持续出现可带上 x-request-id 反馈

完整说明: docs/model-access.md Key 只在服务端保存,不要在客户端代码里硬编码。