Kilo Gateway 免费网关：免绑卡领取 Auto Free 模型池额度，500+ 模型零加价

Kilo Gateway 对外提供 OpenAI 兼容接口，base_url 形态为 https://网关域名/v1，具体地址以 Kilo Code 应用内 Gateway 页面或控制台显示为准，鉴权用上一步创建的 API Key。建议先把地址和密钥放进环境变量，避免硬编码到代码里。

export KILO_API_KEY="把控制台复制的密钥粘贴到这里"
export KILO_BASE_URL="把 Gateway 页面显示的 Base URL 粘贴到这里"

模型名怎么来：免费模型池的名单在应用内的模型列表里查看，Auto Free 策略下由网关自动挑选可用模型；如果你要手动指定，就填列表里显示的那个模型标识。下文的 model 字段请替换成列表中的实际值。

先用 curl 做一次最小可用性验证：

curl "$KILO_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $KILO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "填写免费模型池中显示的模型名",
    "messages": [
      {"role": "user", "content": "用一句话解释什么是向量数据库"}
    ],
    "temperature": 0.7,
    "max_tokens": 512
  }'

Python 侧用官方 OpenAI SDK 即可，只需改 base_url 和 key：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KILO_API_KEY"],
    base_url=os.environ["KILO_BASE_URL"],
)

resp = client.chat.completions.create(
    model="填写免费模型池中显示的模型名",
    messages=[
        {"role": "user", "content": "用一句话解释什么是向量数据库"}
    ],
    temperature=0.7,
    max_tokens=512,
)
print(resp.choices[0].message.content)

关键参数说明

• model：必填，取自免费模型池列表；写错会直接返回模型不存在的错误，而不是自动降价。
• messages：必填，标准 role/content 数组，支持 system 预设角色。
• temperature：可选，0 到 2，写代码类任务建议 0.2 到 0.5，发散创意再调高。
• max_tokens：可选，限制单次输出长度，免费额度紧张时把它调小能显著降低消耗。
• stream：可选，设为 true 走流式返回，适合聊天类前端，注意按 SSE 逐块解析。

额度耗尽或限流的典型表现与排查顺序

1. 401 / 403：密钥错误、被删除或未带上 Authorization 头。先确认环境变量在当前 shell 里确实生效（echo $KILO_API_KEY 只看前后几位），再重新生成密钥。
2. 404 模型不存在：多半是免费池轮换导致该模型已下线。回到应用内模型列表重新选一个，或改回 Auto Free 自动策略。
3. 429 请求过多：命中速率限制。加指数退避重试（首次等 2 秒，逐次翻倍），并降低并发；免费池对突发流量更敏感。
4. 402 / 余额不足类提示：免费额度用完或误用了付费模型。检查调用里的 model 是否落在免费池范围内，再到控制台用量页看剩余额度与重置时间。
5. 5xx 或长时间无响应：先用 curl 复测同一条请求，排除业务代码问题；仍失败则缩短 max_tokens、换免费池里的另一个模型，并关注控制台公告是否在维护。