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：接入 2-API 要改业务代码吗？
A：大多数情况下不用改业务逻辑。把官方 SDK / 客户端里的接口地址改成 2-API，并把密钥换成本站创建的 sk-xxxx 即可。
Claude / Anthropic：https://2-api.com
OpenAI SDK：https://2-api.com/v1
Q：目前支持哪些模型或协议？
A：当前公开开通 Claude 与 GPT / OpenAI 兼容 能力。OpenAI / GPT 分组可使用文本对话、Responses、Embeddings，以及 gpt-image-2 图片生成/编辑能力。Gemini 等其它能力以控制台实际可见分组和模型列表为准；未看到对应分组时，不建议在生产业务中配置。
Q：注册会赠送免费额度吗？
A：不赠送。注册后需要先充值，或由管理员给账号开通额度和分组权限后再使用。
Q：在哪里获取 API Key？
A：登录控制台，进入 API 密钥 / 令牌 页面创建并复制，格式通常为 sk-xxxx。请不要把密钥暴露在前端代码、公开仓库、截图或 URL 查询参数中。
Q：创建密钥时找不到后台配置的分组怎么办？
A：通常是分组没有对当前账号开放。请联系运营管理员检查分组是否启用、是否允许用户选择、账号是否有对应授权、分组里是否配置了可用模型和渠道。

调用相关#

Q：密钥应该放在哪里？
A：放在请求头中，不要放进 URL 查询参数。
调用方式请求头
OpenAI 兼容Authorization: Bearer sk-xxxx
Claude / Anthropicx-api-key: sk-xxxx
Claude Code环境变量 ANTHROPIC_AUTH_TOKEN=sk-xxxx
Q：支持流式输出吗？
A：支持。OpenAI 兼容接口可在请求体中设置 "stream": true；Claude Messages 接口同样支持流式返回。
Q：图片生成用哪个模型？
A：OpenAI / GPT 分组使用 gpt-image-2。文生图调用 POST /v1/images/generations，图生图/图片编辑调用 POST /v1/images/edits。
Q：GPT-Image-2 的尺寸和计费怎么算？
A：请求里可使用 resolution 控制图片档位：1k、2k、4k。提交任务时不扣费，只有任务完成、图片成功生成并返回后才会产生用量记录并扣费；失败、审核未通过、任务未完成、图片不可用等情况不会扣费。
Q：有哪些模型、价格如何？
A：以站内 控制台 / 模型列表 / 分组价格 为准。接口可调用 GET /v1/models 获取当前 Key 可见的实时模型清单。
Q：同一个 Key 可以同时调用 Claude 和 GPT 吗？
A：取决于该 Key 绑定的分组权限。如果分组同时开放 Claude 与 GPT/OpenAI 兼容模型，就可以调用；如果只开放某一类模型，需要创建或申请对应分组权限的 Key。

报错排查#

HTTP常见含义处理建议
400请求参数错误检查模型名、请求体字段、Content-Type
401缺少或无效 Key检查请求头中的 API Key 是否正确
403余额不足、Key 过期、分组无权限充值、更换 Key 或联系管理员开通分组
404路径不存在或当前协议不支持该端点确认 base URL 和接口路径是否匹配
429额度用尽或触发频率限制稍后重试、提升额度或调整并发
5xx服务或上游异常可重试；持续异常请联系客服

安全建议#

不要把 API Key 写进前端页面或公开仓库。
不要把 API Key 放进 URL 查询参数。
为不同客户、项目或环境创建独立 Key，方便限额、停用和审计。
发现密钥泄露后，立即在控制台禁用或删除旧 Key，并创建新 Key。
修改于 2026-06-06 02:10:42
上一页
使用指南
下一页
安装 Git
Built with