1. 站点介绍
2-API 接口文档
  • 站点介绍
    • 2-API简介
    • 使用指南
    • 常见问题
  • 环境准备
    • 安装 Git
    • Node.js 环境安装
  • 快速接入
    • Claude Code 快速接入
    • Codex 快速接入
    • Cherry Studio 快速接入
    • Claude Desktop 第三方 Provider 接入
  • IDE 指南
    • VS Code 接入(Cline / Roo Code 等)
  • OpenAI 兼容
    • 对话补全 (Chat Completions)
      POST
    • Responses API
      POST
    • 文本向量 (Embeddings)
      POST
    • 文生图 (Image Generations)
      POST
    • 图片编辑 (Image Edits)
      POST
    • 模型列表 (List Models)
      GET
  • Claude 兼容
    • Claude 对话 (Messages)
      POST
    • 估算 token (Count Tokens)
      POST
  • Gemini 兼容
    • Gemini 模型列表
      GET
    • Gemini 模型详情
      GET
    • Gemini 生成内容 (generateContent)
      POST
    • Gemini 流式生成 (streamGenerateContent)
      POST
  • 通用
    • 查询本 Key 用量
  • 数据模型
    • ChatMessage
    • ChatCompletionRequest
    • ChatCompletionResponse
    • ResponsesRequest
    • ResponsesResponse
    • EmbeddingRequest
    • EmbeddingResponse
    • ImageGenerationRequest
    • ImageEditRequest
    • ImageResponse
    • ModelList
    • MessagesRequest
    • MessagesResponse
    • GeminiPart
    • GeminiContent
    • GeminiGenerateContentRequest
    • GeminiGenerateContentResponse
    • Usage
    • ErrorResponse
  1. 站点介绍

常见问题

接入相关#

Q:接入要改业务代码吗?
A:基本不用。把官方 SDK / 客户端的接口地址(base url)改成 https://2-api.com,密钥换成本站 sk-xxxx 即可。
Q:我的 Key 该用哪一套接口?
A:取决于 Key 所属渠道的协议(Claude / OpenAI / Gemini),用与之匹配的端点。调用到不支持的协议端点会返回 404。不确定时先调 GET /v1/models 看返回。
Q:在哪里获取 API Key?
A:登录 控制台 → API 密钥 创建并复制(形如 sk-xxxx)。

调用相关#

Q:支持流式输出吗?
A:支持。OpenAI / Claude 协议在请求体加 "stream": true;Gemini 用 :streamGenerateContent。返回为 SSE / 分块流。
Q:怎么传密钥?
A:放在请求头,三选一:Authorization: Bearer sk-xxxx / x-api-key: sk-xxxx / x-goog-api-key: sk-xxxx。不要放进 URL 查询参数(会返回 400)。
Q:有哪些模型、价格如何?
A:以站内 控制台 / 模型列表 为准,调用 GET /v1/models 获取实时清单。

报错排查#

HTTP含义处理
401缺少 / 无效 Key检查请求头里的 Key 是否正确
403余额不足 / Key 过期 / 被限制充值或更换 Key
404当前渠道不支持该端点换用与渠道协议匹配的端点
429额度用尽 / 触发用量限制稍后重试或提升额度
5xx服务异常可重试;持续异常请联系客服
修改于 2026-06-04 04:22:57
上一页
使用指南
下一页
安装 Git
Built with