快速开始
登录控制台、创建令牌、发起第一次调用，5 分钟跑通。
跟着下面三步，5 分钟内完成第一次调用。
演示视频
登录控制台
打开 https://ai.athandra.com 并登录（也可以直接访问 https://ai.athandra.com/sign-in）。还没有账号，或需要充值额度，直接在控制台里完成即可，见 钱包与额度。
创建令牌（API Key）
- 进入左侧菜单「API 密钥」（也可直接访问 https://ai.athandra.com/keys）。
- 点击「创建 API 密钥」。
- 填写名称（例如
my-first-key），选择分组，其它保持默认；需要限额的话，关闭「无限配额」并填写额度（USD）。 - 点击「保存更改」，回到列表后点击掩码密钥复制完整 Key，得到形如
sk-xxxxxxxx的字符串。
Key 等同于密码：不要提交到 Git，不要发到聊天群。下面所有示例都从环境变量读取。
export ATHANDRA_API_KEY="sk-你的Key"发起第一次调用
先确认 Key 可用，并查看你能调用哪些模型：
#!/usr/bin/env bash
# 列出当前令牌可以调用的模型
curl -sS https://ai.athandra.com/v1/models \
-H "Authorization: Bearer $ATHANDRA_API_KEY"
返回的 data[].id 就是可以填进 model 参数的模型名。下面的示例用 deepseek-v3.2，价格低、响应快，适合试通链路。
#!/usr/bin/env bash
# 第一次调用：Chat Completions
curl -sS https://ai.athandra.com/v1/chat/completions \
-H "Authorization: Bearer $ATHANDRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "'"${ATHANDRA_MODEL:-deepseek-v3.2}"'",
"messages": [
{"role": "user", "content": "用一句话介绍你自己"}
]
}'
成功时会返回类似下面的 JSON，回答在 choices[0].message.content：
{
"id": "chatcmpl-a877592a-...",
"object": "chat.completion",
"model": "deepseek-v3.2",
"choices": [
{
"index": 0,
"message": { "role": "assistant", "content": "我是你的智能助手DeepSeek，由深度求索公司创造……" },
"finish_reason": "stop"
}
],
"usage": { "prompt_tokens": 8, "completion_tokens": 33, "total_tokens": 41 }
}看到回答，说明接入完成。
遇到问题
- 返回
401 Invalid token：Key 复制不完整，或多了空格、换行。 - 返回
model_not_found：当前令牌所在分组没有这个模型，先用/v1/models确认。 - 其它报错见 错误排查。