API Reference

接口参考

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

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

对话补全

OpenAI Chat Completions 兼容接口,支持同步与 SSE 流式返回。

接口信息

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

输入参数

参数类型必填说明
modelstring模型编码。
messagesarray消息数组,包含 role 和 content。
messages[].rolestringsystem / user / assistant。
messages[].contentstring消息内容。
streamboolean是否启用 SSE 流式返回。默认 false。
temperaturenumber采样温度。
top_pnumber核采样参数。
max_tokensinteger最大输出 token 数。

输出参数

参数类型返回说明
idstring响应 ID。
objectstring通常为 chat.completion。
choicesarray模型输出候选。
choices[].messageobject非流式响应的消息内容。
usageobjecttoken 用量统计。

错误代码

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

示例

请求示例

{
  "model": "your-model-code",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "max_tokens": 1024,
  "stream": false
}

响应示例

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 8,
    "total_tokens": 16
  }
}