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-...

输入参数

参数类型必填说明
modelstringClaude 模型编码。
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。
usageobjecttoken 用量统计。
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 发起真实请求并可能产生费用。请确认参数无误后再点击。