CleanAPIs 免费额度领取与用法：每月 50 万 tokens 可用全部 33 个模型

一、base_url 与模型名

接口兼容 OpenAI 的 /chat/completions，base_url 固定为 https://cleanapis.com/v1。可用模型名请在控制台的模型列表页复制，33 个模型共用同一份额度，覆盖 Claude、GPT 等系列。

先把密钥写进环境变量，避免硬编码在代码里：

export CLEANAPIS_API_KEY="你的 API Key"

二、发起一次对话补全请求

curl 示例，把 MODEL_ID 换成控制台模型列表里复制的模型名：

curl https://cleanapis.com/v1/chat/completions \
  -H "Authorization: Bearer $CLEANAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [
      {"role": "system", "content": "你是一名简洁的技术助手"},
      {"role": "user", "content": "用一句话说明什么是 OpenAI 兼容接口"}
    ],
    "temperature": 0.7,
    "max_tokens": 256,
    "stream": false
  }'

Python 里直接用官方 openai 库，只改 base_url 即可：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["CLEANAPIS_API_KEY"],
    base_url="https://cleanapis.com/v1",
)

resp = client.chat.completions.create(
    model="MODEL_ID",
    messages=[{"role": "user", "content": "写一段 50 字的产品简介"}],
    max_tokens=256,
)
print(resp.choices[0].message.content)

三、关键参数说明

• model：必填，填控制台模型列表中显示的 ID，列表内 33 个模型同额度、同计价。
• messages：必填，按 role（system、user、assistant）排列的数组，多轮对话需要带上完整历史消息。
• stream：设为 true 时以流式增量返回，需逐块读取 delta 内容再拼接；不设或设为 false 则一次性返回完整结果。
• max_tokens：限制单次输出长度，用来控制 token 消耗；temperature 控制随机性，常见取值 0 到 2。
• tools：需要函数调用时传入工具定义数组；平台也支持视觉输入，图片以 image_url 形式放进 content 数组。

四、额度耗尽与限流的排查顺序

1. 先看 HTTP 状态码：401 多为密钥错误或请求头缺少 Bearer 前缀；404 多为 base_url 漏了 /v1 或路径拼写不对。
2. 遇到 429：先到控制台用量页面确认本月 tokens 是否用尽，用尽则等下月重置或充值；若仍有余额，一般是并发过高，降低并发并加入指数退避重试。
3. 换模型复测：个别模型短时不可用时会直接报错，换一个同列表内的模型即可判断是否为模型侧问题。
4. 检查请求体：max_tokens 设置过大、messages 为空、JSON 里误用中文引号都会导致 400，建议先用最小请求体验证连通性。