Skip to main content
POST
/
v1
/
messages
curl -X POST https://gogogotoken.ai/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "用三点说明 API 网关的作用。" }
    ]
  }'

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-20250514",
  "content": [
    {
      "type": "text",
      "text": "API 网关可以统一鉴权、稳定路由，并集中记录用量。"
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 24,
    "output_tokens": 18
  }
}
使用 Claude Messages API 兼容格式调用 Claude 模型。Claude Code、Claude SDK 或直接 HTTP 请求都可以通过该接口接入使用 Claude Messages API 兼容格式调用 Claude 模型。Claude Code、Claude SDK 或直接 HTTP 请求都可以通过该接口接入。 
curl -X POST https://gogogotoken.ai/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "用三点说明 API 网关的作用。" }
    ]
  }'

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-20250514",
  "content": [
    {
      "type": "text",
      "text": "API 网关可以统一鉴权、稳定路由，并集中记录用量。"
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 24,
    "output_tokens": 18
  }
}

​
接口说明

1

创建 API Key

在控制台 令牌管理 中创建以 sk- 开头的令牌，并确保所选分组包含目标 Claude 模型。
2

设置环境变量

export ANTHROPIC_BASE_URL="https://gogogotoken.ai"
export ANTHROPIC_API_KEY="YOUR_API_KEY"
3

启动 Claude Code

在 IDE 插件 / CLI 中确认 Base URL 已生效，发送一次测试请求验证模型可用。
该接口会自动识别 /v1/messages 路径与 claude-* 模型，并路由到 Claude 专用通道。Claude Code 使用时，Base URL 只填写 https://gogogotoken.ai，客户端会自动拼接 /v1/messages。
完整模型列表以 GET /v1/models 返回结果和控制台分组配置为准。

​
请求头

​
Authorization
string
required
API Key 鉴权信息，格式为 Bearer YOUR_API_KEY。
​
Content-Type
string
required
固定为 application/json。
​
anthropic-version
string
Claude Messages API 版本，常用值为 2023-06-01。

​
请求体

​
model
string
default:"claude-sonnet-4-20250514"
required
Claude 模型 ID，例如 claude-sonnet-4-20250514。
​
messages
object[]
required
对话消息数组。
​
role
string
required
消息角色，通常为 user 或 assistant。
​
content
string
required
消息内容。文本可直接传字符串；多模态内容可按 Claude Messages 格式传数组。
​
max_tokens
integer
default:1024
required
最大输出 token 数。
​
stream
boolean
default:false
是否使用流式返回，默认 false。
​
temperature
number
采样温度。
​
metadata.user_id
string
可选的用户标识。网关可基于该字段保持同一会话的上游路由稳定。

​
响应体

​
id
string
本次消息响应 ID。
​
type
string
对象类型，通常为 message。
​
content
object[]
模型输出内容数组，文本内容通常在 content[0].text。
​
stop_reason
string
生成停止原因，例如 end_turn、max_tokens。
​
usage
object
token 用量统计，通常包含 input_tokens 与 output_tokens。
curl -X POST https://gogogotoken.ai/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "用三点说明 API 网关的作用。" }
    ]
  }'

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-20250514",
  "content": [
    {
      "type": "text",
      "text": "API 网关可以统一鉴权、稳定路由，并集中记录用量。"
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 24,
    "output_tokens": 18
  }
}

​
接口说明

1

创建 API Key

在控制台 令牌管理 中创建以 sk- 开头的令牌，并确保所选分组包含目标 Claude 模型。
2

设置环境变量

export ANTHROPIC_BASE_URL="https://gogogotoken.ai"
export ANTHROPIC_API_KEY="YOUR_API_KEY"
3

启动 Claude Code

在 IDE 插件 / CLI 中确认 Base URL 已生效，发送一次测试请求验证模型可用。
该接口会自动识别 /v1/messages 路径与 claude-* 模型，并路由到 Claude 专用通道。Claude Code 使用时，Base URL 只填写 https://gogogotoken.ai，客户端会自动拼接 /v1/messages。
完整模型列表以 GET /v1/models 返回结果和控制台分组配置为准。

​
请求头

​
Authorization
string
required
API Key 鉴权信息，格式为 Bearer YOUR_API_KEY。
​
Content-Type
string
required
固定为 application/json。
​
anthropic-version
string
Claude Messages API 版本，常用值为 2023-06-01。

​
请求体

​
model
string
default:"claude-sonnet-4-20250514"
required
Claude 模型 ID，例如 claude-sonnet-4-20250514。
​
messages
object[]
required
对话消息数组。
​
role
string
required
消息角色，通常为 user 或 assistant。
​
content
string
required
消息内容。文本可直接传字符串；多模态内容可按 Claude Messages 格式传数组。
​
max_tokens
integer
default:1024
required
最大输出 token 数。
​
stream
boolean
default:false
是否使用流式返回，默认 false。
​
temperature
number
采样温度。
​
metadata.user_id
string
可选的用户标识。网关可基于该字段保持同一会话的上游路由稳定。

​
响应体

​
id
string
本次消息响应 ID。
​
type
string
对象类型，通常为 message。
​
content
object[]
模型输出内容数组，文本内容通常在 content[0].text。
​
stop_reason
string
生成停止原因，例如 end_turn、max_tokens。
​
usage
object
token 用量统计，通常包含 input_tokens 与 output_tokens。

​
错误码错误码

状态码含义含义处理建议建议
401API Key 无效或未传API Key 无效或未传检查请求头与令牌状态请求头与令牌状态
403无权限访问目标 Claude 模型检查 API Key 分组权限
403无权限访问目标 Claude 模型检查 API Key 分组权限
429触发限速降低请求频率或调整降低请求频率或调整套餐
5xx上游或网关或网关异常稍后重试，并查看控制台日志稍后重试，并查看控制台日志