Aion Labs 免费 API：每日刷新额度，免绑卡调用自研写作模型

接口兼容 OpenAI 的对话补全格式：把 OpenAI SDK 的地址换成控制台给出的 base_url、密钥换成刚创建的 API Key，就能跑通。base_url 在控制台的接入指引页面中给出，末尾是 /v1；模型名在控制台的模型列表里查看，Aion 系列自研模型会以列表中的确切名称出现，直接照抄填进 model 字段。

先把三个值放进环境变量，避免把密钥写死在代码里：

export AION_API_KEY="粘贴控制台创建好的 API Key"
export AION_BASE_URL="粘贴控制台接入指引里的地址（末尾为 /v1）"
export AION_MODEL="粘贴模型列表里的模型名"

最简的 curl 调用如下，请求体就是标准的对话补全结构：

curl -s "$AION_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $AION_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"$AION_MODEL\",
    \"messages\": [
      {\"role\": \"system\", \"content\": \"你是一名中文写作助手\"},
      {\"role\": \"user\", \"content\": \"写一段一百字的科幻小说开场\"}
    ],
    \"temperature\": 0.7,
    \"max_tokens\": 512
  }"

在 Python 里可以直接复用 OpenAI 官方 SDK：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AION_API_KEY"],
    base_url=os.environ["AION_BASE_URL"],
)

resp = client.chat.completions.create(
    model=os.environ["AION_MODEL"],
    messages=[
        {"role": "system", "content": "你是一名中文写作助手"},
        {"role": "user", "content": "写一段一百字的科幻小说开场"},
    ],
    temperature=0.7,
    max_tokens=512,
)
print(resp.choices[0].message.content)

关键参数说明：model 填控制台模型列表里的名称，大小写要与列表保持一致；messages 是有序数组，system 用来定风格和身份，user 放具体指令；temperature 控制发散程度，角色扮演和写作场景可用 0.7 到 0.9，事实类问答调到 0.2 左右更稳；max_tokens 限制输出长度，免费额度按 token 计，设小一些更省；stream 打开后会逐字返回，适合做打字机效果，但排查问题时建议先用非流式。调用时必须带上 Authorization 请求头，格式是 Bearer 加空格再加密钥。

额度耗尽或限流时的典型表现，以及排查顺序：

• 返回 401 或提示密钥无效：先确认密钥是否复制完整、有没有多余空格，以及请求头是否漏了 Bearer 前缀。
• 返回 404 或提示模型不存在：检查 base_url 末尾是否带 /v1，并核对模型名与控制台列表是否逐字一致。
• 返回 429 或提示请求过多：先看控制台当天 credits 是否已用尽，再看是否踩到每分钟约 15 次请求的限制，最后看每分钟 2 万 tokens 与每天 2 万 tokens 的总量限制；长提示词或长上下文很容易一次就吃掉大半额度。
• 请求超时或返回 5xx：先用一条十来个字的最小请求重试，本地网络与代理设置也可能导致连不上，这与额度无关。
• 建议的排查顺序：环境变量是否已生效，然后依次检查密钥、base_url 与模型名、单次请求体大小、频率限制、当天剩余额度。逐项排除，基本都能定位到原因。