/v1/chat/completions

这个接口兼容 OpenAI Chat Completions 格式，适合纯文本对话、带图提问和图片理解。

• 请求地址：https://api.cccode.top/v1/chat/completions
• 鉴权方式：Authorization: Bearer YOUR_API_KEY
• 推荐模型：gpt-5.5

提示

带图提问不是生成图片。它是把图片作为输入，让模型理解图片内容并回答问题。

请求参数

字段	必填	说明
model	是	模型名称，例如 gpt-5.5
messages	是	对话消息数组
stream	否	是否使用流式输出

纯文本示例

curl --location 'https://api.cccode.top/v1/chat/completions' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-5.5",
    "stream": false,
    "messages": [
      {
        "role": "user",
        "content": "只回复两个字：可用"
      }
    ]
  }'

返回内容在 choices[0].message.content 中。

{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "可用"
      }
    }
  ],
  "usage": {
    "prompt_tokens": 309,
    "completion_tokens": 6,
    "total_tokens": 315
  }
}

带图提问示例

messages[].content 可以传数组，把文字和图片一起放进去。图片可以使用公网 URL，也可以使用 data:image/...;base64,... 形式。

curl --location 'https://api.cccode.top/v1/chat/completions' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-5.5",
    "stream": false,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "这张图片的主色是什么？只回答一种颜色。"
          },
          {
            "type": "image_url",
            "image_url": {
              "url": "data:image/png;base64,..."
            }
          }
        ]
      }
    ]
  }'

返回示例：

{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "绿色"
      }
    }
  ]
}

流式输出

将 stream 设置为 true 后，接口会按 SSE 分片返回。正文里常用字段是 choices[0].delta.content。

data: {"choices":[{"delta":{"role":"assistant","content":"你好"}}]}

data: {"choices":[{"delta":{"content":"，有什么可以帮你？"}}]}