API Reference
Chat Completions
使用 OpenAI Chat Completions 兼容接口完成对话、摘要、翻译和简单代码任务。
Chat Completions 是目前兼容性最好的接口之一。大多数 OpenAI-compatible 客户端、旧版 SDK、编辑器插件都会使用它。
Endpoint
POST https://0x1c.io/v1/chat/completions请求体
{
"model": "MODEL_ID",
"messages": [
{
"role": "system",
"content": "你是一个简洁的中文助手。"
},
{
"role": "user",
"content": "帮我总结这段文字。"
}
],
"temperature": 0.7
}curl 示例
curl https://0x1c.io/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"messages": [
{
"role": "user",
"content": "写一个三行的 Python Hello World。"
}
],
"temperature": 0.2
}'流式输出
如果客户端支持流式输出,可以加上:
{
"stream": true
}curl 示例:
curl https://0x1c.io/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"stream": true,
"messages": [
{
"role": "user",
"content": "从 1 数到 5。"
}
]
}'常用参数
| 参数 | 说明 |
|---|---|
model | 模型 ID,从控制台复制 |
messages | 对话消息数组 |
temperature | 随机性,越低越稳定 |
max_tokens | 限制最大输出长度 |
stream | 是否启用流式输出 |
不同模型不一定支持所有参数。如果某个参数报错,先删掉非必要参数测试。
新手常见问题
Base URL 应该填什么?
客户端里填 https://0x1c.io/v1。只有你手写 curl 请求时,才会请求完整地址 https://0x1c.io/v1/chat/completions。
messages 和 prompt 有什么区别?
Chat Completions 使用 messages。如果旧教程里写的是 prompt,那多半是 Completions 旧接口,不建议新项目继续使用。
模型 ID 报错怎么办?
回控制台复制完整模型 ID。不要把显示名称、中文名称或价格页标题当成模型 ID。