跳转到主要内容

​
前置要求

  • 一个 清波 API 账户（注册）
  • API 密钥
  • 基础的编程知识

​
获取 API 密钥

1

登录控制台

访问 Dashboard 并登录
2

创建密钥

在密钥管理页面点击”创建新密钥”
3

保存密钥

复制并安全保存你的 API 密钥，密钥只显示一次
请勿在前端代码或公开仓库中暴露 API Key。

​
发送第一个请求

清波 API 完全兼容 OpenAI SDK，只需替换 base_url 即可使用。 
from openai import OpenAI

client = OpenAI(
    base_url="https://www.qingbo.dev/v1",
    api_key="YOUR_API_KEY"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "user", "content": "你好，介绍一下你自己"}
    ]
)

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

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://www.qingbo.dev/v1',
  apiKey: 'YOUR_API_KEY'
});

const response = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [
    { role: 'user', content: '你好，介绍一下你自己' }
  ]
});

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

curl https://www.qingbo.dev/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "你好，介绍一下你自己"}
    ]
  }'

​
理解响应

{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1677652288,
  "model": "gpt-4o",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "你好！我是一个 AI 助手..."
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 9,
    "completion_tokens": 12,
    "total_tokens": 21
  }
}

​
下一步

认证与密钥

了解认证方式和密钥管理

同步与异步

了解不同端点的调用方式

文本生成 API

完整的聊天 API 参数和选项

任务系统

图像和视频的异步生成流程