API Reference

接口参考

按接口拆分查看请求地址、输入参数、输出参数与错误代码。

Gateway Protocols多标准协议兼容
OpenAIAnthropicGeminiOpenRouter
Chat / Responses / Messages / Claude Messages
POST /v1/messages

Claude Messages API

Claude Messages API,兼容 x-api-key 与 Bearer 鉴权。

接口信息

请求地址https://api.4stoken.cn
请求路径/v1/messages
请求方式POST
Content-Typeapplication/json
鉴权Authorization: Bearer sk-...

输入参数

参数类型必填说明
modelstringClaude 模型编码。
max_tokensinteger最大输出 token 数。
messagesarray对话消息数组。
systemstring系统提示词。
streamboolean是否启用流式返回。
x-api-keyheader可替代 Authorization Bearer 的鉴权 Header。

输出参数

参数类型返回说明
idstring消息 ID。
typestring固定为 message。
rolestring通常为 assistant。
content[]array输出内容块。
stop_reasonstring停止原因。
usageobjecttoken 用量统计。

错误代码

HTTP 状态码错误说明
401UnauthorizedClient Key 无效或未提供。
402Payment Required余额不足或配额超限。

示例

请求示例

{
  "model": "claude-3-5-sonnet",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ]
}

响应示例

{
  "id": "msg_01HExample",
  "type": "message",
  "role": "assistant",
  "model": "claude-3-5-sonnet",
  "content": [
    {
      "type": "text",
      "text": "Hello! How can I help?"
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 8
  }
}