Chat Completions

POST /v1/chat/completions 是兼容范围最广的对话接口，适用于多数 OpenAI SDK、聊天客户端和服务端应用。

最小请求

curl https://sprelaytoken.com/v1/chat/completions \
  -H "Authorization: Bearer $SPRELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "system", "content": "回答要简洁。"},
      {"role": "user", "content": "解释什么是 API 网关。"}
    ]
  }'

Python SDK

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["SPRELAY_API_KEY"],
    base_url="https://sprelaytoken.com/v1",
    timeout=60.0,
)

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[
        {"role": "system", "content": "回答要简洁。"},
        {"role": "user", "content": "解释什么是 API 网关。"},
    ],
)

print(response.choices[0].message.content)

JavaScript SDK

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.SPRELAY_API_KEY,
  baseURL: 'https://sprelaytoken.com/v1',
  timeout: 60_000,
})

const response = await client.chat.completions.create({
  model: 'gpt-5.4',
  messages: [
    { role: 'system', content: '回答要简洁。' },
    { role: 'user', content: '解释什么是 API 网关。' },
  ],
})

console.log(response.choices[0].message.content)

常用字段

字段	说明
model	必填，使用当前分组支持的完整模型名称
messages	必填，对话消息数组
stream	是否使用 SSE 流式输出
temperature	可选；模型不支持时不要强行传递
max_tokens	可选；具体模型可能使用不同限制
tools	可选，声明可调用工具

不同模型支持的可选字段并不完全一致。遇到“unsupported parameter”时，先删除非必需字段，只保留 model 和 messages 验证。

多轮对话

API 不会替你长期保存对话。下一轮请求需要把仍然相关的历史消息放入 messages。控制历史长度，避免上下文不断增长导致延迟和费用上升。

下一步

• 逐段显示回复：流式响应
• 让模型调用程序函数：工具调用
• 新式统一接口：Responses