接入文档 · A01代理站

三步接入

开通账号并登录后，到「控制台 → 令牌」创建 API 密钥。密钥只显示一次。本站不开放自助注册。
base_url 设为 https://a01.xuetianai.com/v1，api_key 填这把密钥。
按下面的端点调用。任何 OpenAI SDK 或兼容客户端都可以。

OpenAI SDK · Python

from openai import OpenAI
client = OpenAI(base_url="https://a01.xuetianai.com/v1", api_key="sk-你的密钥")

认证

所有请求带 Bearer。不要把密钥写进前端页面或 URL。

Authorization: Bearer sk-xxxxxxxx

泄露后立刻在令牌页删除并重建。Codex / GPT-5.x 目前暂停，请求会失败。

图片

POST /v1/images/generations，同步返回。客户端超时请设 180 秒以上，过早断开服务端仍可能已经出图。

模型	计费
gpt-image-2 / -1k / -4k	按张
grok-imagine-image*	按张

curl · 出图

curl https://a01.xuetianai.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2-1k","prompt":"一只在雪地里奔跑的柴犬","size":"1024x1024"}'

图片返回示例

成功时与 OpenAI Images 格式兼容，常见字段如下。

JSON · 200

{
  "created": 1756982400,
  "data": [
    {
      "b64_json": null,
      "url": "https://example.invalid/generated.png",
      "revised_prompt": "一只在雪地里奔跑的柴犬"
    }
  ]
}

对话

POST /v1/chat/completions，支持 stream: true。模型：grok-4.5、grok-4.6、grok-chat-fast、grok-composer-2.5-fast，按 token 计费。

curl · 对话

curl https://a01.xuetianai.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-chat-fast","messages":[{"role":"user","content":"用一句话介绍柴犬"}]}'

不要把视频模型放到这个端点，上游会 400/404。

流式对话

把 stream 设为 true，响应为 SSE（data: {...}），最后一行为 data: [DONE]。

curl · stream:true

curl https://a01.xuetianai.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -N \
  -d '{"model":"grok-chat-fast","stream":true,"messages":[{"role":"user","content":"用一句话介绍柴犬"}]}'

视频

异步任务：POST /v1/videos 拿到任务 ID，再 GET /v1/videos/{task_id} 轮询。也可走 /v1/video/generations。不要用 /v1/videos/generations（404），也不要走聊天。

Grok 视频

grok-imagine-video $0.05 / 秒；grok-imagine-video-1.5 / grok-1.5-video $0.10 / 秒
seconds 必须是 "1"–"15" 的数字字符串
可选 size，如 720x1280 / 1280x720
完成后用返回地址下载，或 GET /v1/videos/{task_id}/content。链接有时效，尽快转存
失败（含审核拒绝）会退款。轮询间隔 3–5 秒，客户端等 5 分钟即可

curl · Grok 视频

curl https://a01.xuetianai.com/v1/videos \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-imagine-video","prompt":"一只柴犬在雪地里跑，镜头跟随","seconds":"1"}'

Python · 提交并轮询

import time, requests
BASE, H = "https://a01.xuetianai.com", {"Authorization": "Bearer sk-你的密钥"}
task = requests.post(f"{BASE}/v1/videos", headers=H, json={
    "model": "grok-imagine-video",
    "prompt": "海浪拍打礁石，黄昏，慢镜头",
    "seconds": "1",
}).json()
tid = task.get("id") or task.get("task_id")
while True:
    r = requests.get(f"{BASE}/v1/videos/{tid}", headers=H).json()
    if r.get("status") in ("completed", "failed"):
        print(r); break
    time.sleep(5)

Seedance 视频

本站走同一套 /v1/videos，不是主站的 /api/v3
模型：doubao-seedance-2-0-mini-260615 等，按 token，单价见价格页
提交时可能先预扣一笔较大额度，结束后按实际用量结算。余额不够预扣会 403，不生成
单次通常 3–6 分钟，请轮询

curl · Seedance

curl https://a01.xuetianai.com/v1/videos \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"doubao-seedance-2-0-mini-260615","prompt":"海浪拍打礁石，黄昏，电影感","duration":4}'

列出模型

GET /v1/models 返回当前可用模型列表。

curl · GET /v1/models

curl https://a01.xuetianai.com/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

Node.js OpenAI SDK

与 Python 一样，只改 baseURL 和密钥。

OpenAI SDK · Node.js

import OpenAI from "openai";
const client = new OpenAI({
  baseURL: "https://a01.xuetianai.com/v1",
  apiKey: "sk-你的密钥",
});
const r = await client.chat.completions.create({
  model: "grok-chat-fast",
  messages: [{ role: "user", content: "用一句话介绍柴犬" }],
});
console.log(r.choices[0].message.content);

Cherry Studio / ChatBox

任意 OpenAI 兼容客户端都可以，关键是填对 base_url 和 api_key。

Cherry Studio

打开 Cherry Studio，进入「设置 → 模型服务」。
添加一个「OpenAI 兼容」服务商（或自定义 OpenAI）。
API 地址 / Host 填 https://a01.xuetianai.com/v1（可用本页「复制 base_url」）。
API Key 填控制台「令牌」页创建的密钥。
保存后，在对话里选择 grok-chat-fast 等已开通模型。

ChatBox

打开 ChatBox → Settings → Providers（或「模型提供方」）。
选择 OpenAI Compatible / 自定义 API。
API Host 填 https://a01.xuetianai.com/v1，API Key 填同一把密钥。
模型名按「模型价格」页填写，保存后即可对话或出图。

计费

展示单位美元，1 美元 = 500,000 额度
失败请求（上游错误、无可用渠道、参数错误）不扣费；视频任务失败会退还预扣
流式对话会先预扣，结束后按实际 token 结算
余额由站长人工充值，明细在控制台日志

错误

HTTP	含义
400	参数不合法，例如视频 seconds 不在 1–15
401	密钥无效或缺失
403	余额不足（含视频预扣不够）或无权
404	路径写错，或把视频模型丢进了聊天端点
429 / 5xx	限流或上游异常，退避重试

排障请带上请求时间、模型名和返回错误。