进入控制台 ↗

DOCUMENTATION

接入 Atria API

支持 Chat Completions、Messages 和 Responses 三种标准接口，可直接接入现有应用与 Agent 工具。

鉴权：创建 API Key

Atria API 使用你在控制台创建的 API Key 识别调用者。创建过程只需几步。

  1. 1
    登录控制台使用 Google 账号登录，然后进入 API Key 页面。
  2. 2
    填写密钥名称使用能区分环境或应用的名称，例如 production-agent。
  3. 3
    创建并立即复制点击“创建密钥”后复制完整 Key。完整内容只显示一次，关闭提示后无法再次查看。
  4. 4
    安全保存将 Key 放入服务端环境变量或密码管理器，不要写入前端代码。
如果 Key 丢失，请吊销旧 Key 并创建新的 Key；系统无法恢复已经隐藏的完整 Key。前往 API Key 控制台 →

鉴权与环境变量

所有请求都使用 Bearer API Key。Key 只在创建时完整显示一次，请保存到密码管理器或服务端环境变量。

macOS / Linux

export ATRIA_API_KEY=atr_xxx

Windows PowerShell

$env:ATRIA_API_KEY="atr_xxx"

请求头

Authorization: Bearer <ATRIA_API_KEY>
Content-Type: application/json

非流式调用

适合一次性获取完整回答。复制下面的命令，替换 API Key 后即可运行。

curl -X POST https://api.atria-asi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ATRIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Atria-dawn-cmy2-v1",
    "messages": [{"role": "user", "content": "hi"}]
  }'

流式调用

适合聊天界面，模型生成的内容会持续返回。curl 会直接逐行显示结果。

curl -N -X POST https://api.atria-asi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ATRIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Atria-dawn-cmy2-v1",
    "messages": [{"role": "user", "content": "hi"}],
    "stream": true
  }'

Messages 接口

兼容 Anthropic Messages API，使用 x-api-key 鉴权。适合已有 Anthropic SDK 或工具链。

curl -X POST https://api.atria-asi.ai/v1/messages \
  -H "x-api-key: $ATRIA_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Atria-dawn-cmy2-v1",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "hi"}]
  }'

Responses 接口

兼容 OpenAI Responses API，使用 input 字段提交文本或结构化输入。

curl -X POST https://api.atria-asi.ai/v1/responses \
  -H "Authorization: Bearer $ATRIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Atria-dawn-cmy2-v1",
    "input": "hi"
  }'

理解返回结果

三种接口的字段结构不同。下面列出最常用的正文路径、结束原因和 token 用量位置，接入时无需遍历整个 JSON。

Chat Completions回答正文: choices[0].message.content结束原因: choices[0].finish_reasonToken 用量: usage.prompt_tokens / completion_tokens流式增量: choices[0].delta.content
Messages回答正文: content[0].text结束原因: stop_reasonToken 用量: usage.input_tokens / output_tokens流式增量: content_block_delta.delta.text
Responses回答正文: output[0].content[0].text结束原因: statusToken 用量: usage.input_tokens / output_tokens流式增量: response.output_text.delta

流式增量

流式响应使用 SSE。逐行读取 data: 事件并拼接增量文本；收到 [DONE] 或对应 completed/stop 事件后结束。不要把每个事件当作一条完整回答。

data: {"choices":[{"delta":{"content":"你"}}]}

data: {"choices":[{"delta":{"content":"好"}}]}

data: [DONE]

Token 用量

usage 用于控制台统计和成本观测。输入与输出 token 会在流结束后结算，因此流式请求进行中看到的用量可能暂未更新。

获取并选择模型

Atria Dawn Preview 面向真实、可执行的复杂任务：模型理解环境、选择工具、根据反馈调整行动，并将结果推进到可验证、可复现的成果。 查看 Atria Dawn Preview 官网 ↗

根据任务选择

DISCOVERY / RESEARCH科研与深度研究

官网展示了科研与深度研究能力：从问题拆解、资料检索和证据梳理，到代码实现、实验验证与结果分析。

CREATION / DELIVERY执行与成果交付

官网同时展示了 ML Coding、工具使用、软件工程、生产力与安全任务，强调产物由测试、指标、文件状态或来源证据验证。

当前 API 提供下列两个 model ID。官网未对它们做“质量版”或“速度版”的区分；建议用你的真实任务各运行一组样例，对比结果正确性、证据完整性和响应时间后再固定选型。

支持的接口

Chat CompletionsMessagesResponsesStreaming

切换模型

只需修改 model 的值；其他请求参数可以保持不变。模型名称区分大小写，请完整复制。

// Atria-dawn-cmy2-v1
"model": "Atria-dawn-cmy2-v1"

// Atria-dawn-v2
"model": "Atria-dawn-v2"

Atria-dawn-cmy2-v1

支持 256K 上下文，理解环境、选择工具并根据反馈持续调整，从问题拆解、证据梳理推进到代码、实验与可检查成果。

curl -X POST https://api.atria-asi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ATRIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Atria-dawn-cmy2-v1",
    "messages": [{"role": "user", "content": "hi"}]
  }'

Atria-dawn-v2

支持 256K 上下文，兼顾响应速度与输出质量，适合对话和批量生产任务。

curl -X POST https://api.atria-asi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ATRIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Atria-dawn-v2",
    "messages": [{"role": "user", "content": "hi"}]
  }'

接入 Agent 工具

只要 Agent 支持 OpenAI 或 Anthropic 兼容的自定义模型，就可以填入 Atria API 地址、API Key 和 model ID 接入。下面给出常用工具的最小配置。

接入前准备

先在控制台创建 API Key，并将其保存为 ATRIA_API_KEY 环境变量。示例使用 Atria-dawn-v2，你也可替换为已开通的其他 model ID。

export ATRIA_API_KEY=atr_xxx

Claude Code

Claude Code 通过 Messages 接口连接 Atria。Host 不要带 /v1，Claude Code 会自动请求 /v1/messages。

export ANTHROPIC_BASE_URL=https://api.atria-asi.ai
export ANTHROPIC_AUTH_TOKEN=$ATRIA_API_KEY
claude --model Atria-dawn-v2

Codex

在 ~/.codex/config.toml 中添加自定义 provider。Codex 使用 Responses 接口。

model = "Atria-dawn-v2"
model_provider = "atria"

[model_providers.atria]
name = "Atria"
base_url = "https://api.atria-asi.ai/v1"
env_key = "ATRIA_API_KEY"
wire_api = "responses"

WorkBuddy

在设置中选择自定义模型，然后填入：

Provider: Custom / OpenAI CompatibleBase URL: https://api.atria-asi.ai/v1API Key: atr_xxxModel: Atria-dawn-v2API: Chat Completions

保存后选中 Atria-dawn-v2，发送一条简短任务验证连接。

Qoder

在设置中选择自定义模型，然后填入：

Provider: Custom → OpenAI CompatibleAPI: Responses APIBase URL: https://api.atria-asi.ai/v1API Key: atr_xxxModel ID: Atria-dawn-v2

保存后选中 Atria-dawn-v2，发送一条简短任务验证连接。

OpenClaw

在 OpenClaw 配置中注册自定义 provider，并将默认模型指向 atria/Atria-dawn-v2。

{
  agents: { defaults: { model: { primary: "atria/Atria-dawn-v2" } } },
  models: { providers: { atria: {
    baseUrl: "https://api.atria-asi.ai/v1",
    apiKey: "${ATRIA_API_KEY}",
    api: "openai-responses",
    models: [{ id: "Atria-dawn-v2", name: "Atria Dawn v2" }]
  } } }
}

Hermes

运行 hermes model，选择 Custom endpoint，然后填入：

Base URL: https://api.atria-asi.ai/v1API Key: atr_xxxModel: Atria-dawn-v2Format: OpenAI

保存后选中 Atria-dawn-v2，发送一条简短任务验证连接。

常见状态码

401API Key 无效或已吊销
429请求频率过高或额度不足
5xx服务暂时不可用，请稍后重试