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. 站点介绍

使用指南

整体接入流程建议按四步走:拿密钥 → 确认可用分组 → 改接口地址 → 发请求。
当前 2-API 公开开通 Claude 与 GPT / OpenAI 兼容能力。OpenAI / GPT 分组可使用 gpt-image-2 生图模型;Gemini 等未在控制台分组或模型列表中看到的能力,不要直接配置到生产业务中。

第 1 步:获取 API Key#

登录 2-API 控制台,进入 API 密钥 / 令牌 页面创建密钥,复制生成的 sk-xxxx。
请注意:注册不赠送免费额度。测试或正式使用前,需要先完成充值,或由管理员为账号开通额度和分组权限。

第 2 步:确认可用分组和模型#

创建密钥时请选择后台已经开放给你的分组。不同分组可能对应不同模型、价格、额度和上游账号池。
Claude / Anthropic:用于 Claude Code、Claude Messages 等能力。
GPT / OpenAI:用于 Chat Completions、Responses、Embeddings、gpt-image-2 图片生成/编辑等能力。
如果创建密钥时找不到某个分组,通常说明该分组还没有向你的账号开放,需要联系运营管理员检查:
分组是否已启用;
分组是否允许普通用户创建密钥时选择;
你的账号是否被加入对应用户组或授权范围;
分组内是否已经配置可用模型和渠道。

第 3 步:把接口地址改成 2-API#

Claude / Anthropic 兼容地址:
https://2-api.com
OpenAI SDK 兼容地址:
https://2-api.com/v1

第 4 步:携带密钥发请求#

常见请求头如下:
调用方式请求头
OpenAI 兼容Authorization: Bearer sk-xxxx
Claude / Anthropicx-api-key: sk-xxxx
Claude CodeANTHROPIC_AUTH_TOKEN=sk-xxxx
OpenAI 兼容示例:
GPT-Image-2 文生图示例:
Claude 兼容示例:

当前接口一览#

协议方法路径用途
OpenAI 兼容GET/v1/models查询可用模型
OpenAI 兼容POST/v1/chat/completionsGPT 对话补全
OpenAI 兼容POST/v1/responsesOpenAI Responses 兼容调用
OpenAI 兼容POST/v1/embeddings文本向量
OpenAI 兼容POST/v1/images/generationsgpt-image-2 文生图
OpenAI 兼容POST/v1/images/editsgpt-image-2 图生图/图片编辑
Claude 兼容POST/v1/messagesClaude 对话
通用GET/v1/usage查询当前 Key 用量
字段级细节请看对应接口页。客户端配置请看 快速接入、OpenAI 兼容 和 Claude 兼容 目录。
修改于 2026-06-06 02:01:47
上一页
2-API简介
下一页
常见问题
Built with