API 接入文档

AIGC微风 完全兼容 OpenAI 接口规范。下面给出最常用的接入信息与示例,现有 OpenAI 客户端或代码只需替换地址与密钥。

基础信息

接口地址(Base URL)
https://api.aigcbreeze.cn/v1
鉴权方式
请求头 Authorization: Bearer 你的密钥
密钥获取
登录 控制台 → 「令牌」页面创建
协议
OpenAI Chat Completions 兼容(/chat/completions
返回格式
JSON,结构同 OpenAI 官方;支持 stream: true 流式输出

调用示例

cURL

curl https://api.aigcbreeze.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的密钥" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "system", "content": "你是一个专业的中文写作助手"},
      {"role": "user", "content": "帮我写一段产品介绍"}
    ],
    "stream": false
  }'

Python(openai 官方 SDK)

from openai import OpenAI

client = OpenAI(
    api_key="你的密钥",
    base_url="https://api.aigcbreeze.cn/v1",
)

resp = client.chat.completions.create(
    model="glm-5.3",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "你的密钥",
  baseURL: "https://api.aigcbreeze.cn/v1",
});

const r = await client.chat.completions.create({
  model: "qwen3.8-flash",
  messages: [{ role: "user", content: "你好" }],
});
console.log(r.choices[0].message.content);

流式输出

# 在请求体中加入 stream 参数即可
{
  "model": "deepseek-v4-flash",
  "messages": [{"role": "user", "content": "写一首短诗"}],
  "stream": true
}

常用客户端配置

客户端API 地址填法密钥
ChatBox / NextChathttps://api.aigcbreeze.cn/v1你的密钥
Cherry Studiohttps://api.aigcbreeze.cn你的密钥
Lobe Chathttps://api.aigcbreeze.cn/v1你的密钥
沉浸式翻译 / 浏览器插件https://api.aigcbreeze.cn/v1你的密钥
各类 OpenAI 兼容 SDKhttps://api.aigcbreeze.cn/v1你的密钥
控制台首页也内置了各家客户端的一键配置引导,登录后按提示操作更省事。

常见返回码

状态码含义建议处理
200调用成功正常解析返回内容
401密钥无效或未携带检查 Authorization 头与密钥内容
404模型不存在核对 模型列表 中的 ID 是否拼写正确
429请求过于频繁降低并发或稍后重试
500 / 502上游线路异常稍后重试;同一模型若有备用 ID 可切换