对话接口

对话接口用于聊天问答、文本生成、总结、翻译、代码辅助等场景。

接口地址

POST https://api.oskyi.com/v1/chat/completions

请求示例

curl https://api.oskyi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {
        "role": "system",
        "content": "你是一个有帮助的助手。"
      },
      {
        "role": "user",
        "content": "请用三句话介绍 OpenSky API。"
      }
    ]
  }'

流式输出

聊天场景建议开启流式输出，这样可以更快看到首字：

{
  "model": "gpt-5.5",
  "stream": true,
  "messages": [
    {
      "role": "user",
      "content": "你好"
    }
  ]
}

常用参数

参数	说明
model	模型名称，以控制台为准
messages	对话消息数组
temperature	创造性，值越高越发散
max_tokens	最大输出长度
stream	是否流式输出

Messages 格式

[
  {
    "role": "system",
    "content": "你是一个有帮助的助手。"
  },
  {
    "role": "user",
    "content": "请帮我写一段文案。"
  }
]

常见角色：

• system：系统提示词。
• user：用户输入。
• assistant：模型历史回复。

排查建议

如果请求失败，请先尝试最小请求，只保留 model 和一条 user 消息。确认成功后再逐步添加复杂参数。