对话补全指南
了解如何通过兼容 OpenAI 的消息格式调用 UnderSky 对话补全,并使用模型选择、流式输出和用量统计。
对话补全端点完全兼容 OpenAI。将现有 OpenAI SDK 或 HTTP 客户端指向 UnderSky,即可直接使用。
基础请求
curl -X POST https://api.undersky.ai/v1/chat/completions \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "auto",
"messages": [
{"role": "user", "content": "Explain quantum computing in one paragraph."}
]
}'{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Quantum computing uses qubits..."
},
"finish_reason": "stop"
}
]
}将 model 设置为 "auto" 后,请求默认路由到 gpt-6-luna。你也可以明确指定模型,例如 "gpt-6-luna"。
流式输出
设置 stream: true 后,结果会通过服务器发送事件(SSE)返回。Token 会在生成过程中逐步发送。
curl -X POST https://api.undersky.ai/v1/chat/completions \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "auto",
"stream": true,
"messages": [
{"role": "user", "content": "Write a haiku about APIs."}
]
}'每个 SSE 事件都包含一行 data:,后面是一个 JSON 数据块:
data: {"id":"chatcmpl-abc123","choices":[{"delta":{"content":"Endpoints"},"index":0}]}
data: {"id":"chatcmpl-abc123","choices":[{"delta":{"content":" await"},"index":0}]}
data: [DONE]工具调用 / 函数调用
你可以传入 tools 数组,让模型调用你定义的函数。模型判断需要调用函数时,会返回 tool_calls。其格式与 OpenAI 函数调用 API 相同。
{
"model": "auto",
"messages": [{"role": "user", "content": "What's the weather in Tokyo?"}],
"tools": [
{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a city",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string"}
},
"required": ["city"]
}
}
}
]
}完整参数列表和响应结构请参阅 API 参考。