开发接入
OpenAI SDK（Python / Node）
用 OpenAI 官方 SDK 调用 Athandra，只需要改 api_key 和 base_url。
Athandra 兼容 OpenAI 的 Chat Completions 接口。已有的 OpenAI 代码，只需要改两处：api_key 和 base_url。
安装
pip install openai基础调用
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ATHANDRA_API_KEY"],
base_url="https://ai.athandra.com/v1",
)
resp = client.chat.completions.create(
model=os.environ.get("ATHANDRA_MODEL", "deepseek-v3.2"),
messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(resp.choices[0].message.content)
print("用量：", resp.usage.prompt_tokens, "输入 /", resp.usage.completion_tokens, "输出")
要点：
base_url/baseURL必须带/v1：https://ai.athandra.com/v1。model填/v1/models里能看到的模型名，区分大小写（例如MiniMax-M3）。- Key 从环境变量读取，不要写进代码。
查看可用模型
#!/usr/bin/env bash
# 列出当前令牌可以调用的模型
curl -sS https://ai.athandra.com/v1/models \
-H "Authorization: Bearer $ATHANDRA_API_KEY"
用 SDK 也一样：
for m in client.models.list():
print(m.id)查询令牌余额
#!/usr/bin/env bash
# 查询当前令牌的额度（单位为“额度”，500000 额度 = 1 美元）
curl -sS https://ai.athandra.com/api/usage/token/ \
-H "Authorization: Bearer $ATHANDRA_API_KEY"
返回里的 total_available 是剩余额度，除以 500000 得到美元数。
实测过的模型
下面是在线上环境实测可正常使用的结论（default 分组令牌，除非另有说明）：
| 模型 | 实测结果 |
|---|---|
deepseek-v3.2 | 对话、流式、函数调用均可用，也能走 Anthropic Messages；文档示例默认使用，便宜稳定 |
qwen3.7-flash | 支持图片理解（示例里加 enable_thinking: false），也是目前唯一实测能走 Responses 接口 的模型 |
claude-haiku-4-5 | 只有 official 分组的令牌能用，走 Anthropic Messages 格式 |
完整的模型列表和价格见 模型广场与价格；你的令牌能用哪些模型，以 GET /v1/models 返回为准。
推理模型
部分模型默认会先“思考”再回答（返回里有 reasoning_content 字段）。思考内容也计入输出 token，max_tokens 设得太小时可能思考没完就被截断，导致 content 为空。遇到这种情况请调大 max_tokens。