聊天补全

使用 OpenAI 兼容格式 创建聊天补全。仅支持文本输入，支持流式（stream:true，SSE）与非流式两种返回。

POSThttps://api.longcat.chat/openai/v1/chat/completions

Authorizations

Authorizationstringheaderrequired

身份验证密钥，需以 Bearer YOUR_API_KEY 形式置于请求头。

default: false

Bodyapplication/json

modelstringrequired

模型标识符。目前支持 LongCat-2.0。

default: false

messagesarrayrequired

消息对象数组，仅允许文本输入。

default: false

rolestringrequired

消息作者角色，必须为 system · user · assistant 之一。

default: false

contentstringrequired

消息内容，纯文本字符串。

default: false

streambooleanoptional

是否以 SSE 流式返回响应。

default: false

max_tokensintegeroptional

生成的最大 Token 数。LongCat-2.0 最大 131072（128K）。

default: 32768

temperaturenumberoptional

采样温度，范围 0 ~ 1。

default: false

top_pnumberoptional

核采样（nucleus sampling）参数。

default: false

thinkingobjectoptional

是否开启思考。{"type":"enabled"} 开启思考，{"type":"disabled"} 关闭思考。

default: false

请求示例

cURL

基础调用

bash

curl --location --request POST 'https://api.longcat.chat/openai/v1/chat/completions' \
  --header "Authorization: Bearer $LONGCAT_API_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "model": "LongCat-2.0",
    "messages": [
      { "role": "system", "content": "你是一个乐于助人的助手" },
      { "role": "user", "content": "你好，请介绍一下自己" }
    ],
    "max_tokens": 1024,
    "temperature": 0.7,
    "thinking": {
      "type": "enabled"
    }
  }'

响应示例

非流式

json

{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1677652288,
  "model": "LongCat-2.0",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好！我是 LongCat，很高兴为你服务。",
        "reasoning_content": "\n用户只是在打招呼，这是一个简单的对话开场。我应该以友好、乐于助人的方式回应，介绍自己并表达愿意提供帮助。这是一次直接的互动，不需要复杂的推理。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 15,
    "total_tokens": 35,
    "completion_tokens_details": {
      "reasoning_tokens": 78
    }
  }
}