API 文档 / OpenAI 格式

对话补全

POSThttps://api.tokenjoy.org/v1/chat/completions

根据对话历史生成回复，与 OpenAI Chat Completions 接口兼容。

请求参数

参数	类型	说明
`model`	string	必填。模型名，见模型列表
`messages`	array	必填。对话历史，每条包含 `role`（system / user / assistant / tool）和 `content`
`stream`	boolean	是否以 SSE 流式返回，默认 false
`max_tokens`	integer	最多生成的 token 数
`temperature`	number	采样温度，越高越随机
`reasoning_effort`	string	Gemini 3.8 Flash 的思考强度：`low`、`medium`、`high`；省略时由模型自动选择
`tools`	array	可供模型调用的工具，见 Tool Calls
`response_format`	object	例如 `{"type": "json_object"}` 要求输出 JSON

示例

curl https://api.tokenjoy.org/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${TOKENJOY_API_KEY}" \
  -d '{"model": "gpt-5", "messages": [{"role": "user", "content": "Hello!"}]}'

响应

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "gpt-5",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Hello! How can I help you today?" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 9, "completion_tokens": 10, "total_tokens": 19 }
}