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
协议标准Anthropic Messages API
能力分类文本对话
Content-Typeapplication/json
鉴权Authorization: Bearer sk-...

输入参数

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

输出参数

参数类型返回说明
idstring是消息 ID。
typestring是固定为 message。
rolestring是通常为 assistant。
modelstring是本次响应对应的模型编码。
contentarray是输出内容块数组。
content[].typestring是内容块类型,例如 text 或 tool_use。
content[].textstring文本块文本内容。
stop_reasonstring否停止原因。
stop_sequencestring | null否触发停止的 stop sequence;未命中时为 null。
usageobject否token 用量统计。
usage.input_tokensinteger否输入 token 数。
usage.output_tokensinteger否输出 token 数。
usage.cache_read_input_tokensinteger否缓存读取的输入 token 数;仅当上游返回且大于 0 时出现。
usage.cache_creation_input_tokensinteger否缓存写入的输入 token 数;仅当上游返回且大于 0 时出现。

错误代码

HTTP 状态码错误说明
401UnauthorizedClient Key 无效或未提供。
402Payment RequiredClient Key 配额或消费限额超限。

在线调试

model
your-model-code

仅展示该接口支持的已发布模型

暂无可用模型 →
stream

SSE 流式返回

false
JSON
max_tokens

生成 token 上限

user message

对话用户消息 content

curl -X POST 'https://api.4stoken.cn/v1/messages' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  --data-raw '{"model":"your-model-code","max_tokens":1024,"messages":[{"role":"user","content":"Hello"}],"stream":false}'
在线调试会向 Gateway 发起真实请求并可能产生费用。请确认参数无误后再点击。