快速上手
几分钟内接入 Corion AI。一个 base URL、一把密钥，用你的客户端本来就会说的那套 API：OpenAI 或 Anthropic 都可以。
Corion AI 目前处于 MVP 预览阶段。模型可用性与商业条款仍以正式上线配置为准。
1. 创建账户
注册，然后如果你的工作区要求确认，请验证你的邮箱。
2. 添加额度
每个新账户都附带一笔欢迎额度。打开 Dashboard → Billing 查看余额或购买可用的额度包。额度包用于支付调用费用，并非订阅。测试部署使用 Stripe 测试模式，不会产生真实扣款。余额用尽时，playground 会提示你添加额度。
3. 创建 API 密钥
打开 Dashboard → API keys，为密钥命名，然后点击 Create key。请立即复制完整密钥。Corion 仅存储密钥标识符和显示前缀，完整密钥无法再次查看。
请将密钥保存在服务端的密钥存储中。切勿将其嵌入浏览器代码或提交到版本控制系统。
4. 选择 API 接口形态
下面所有接口都在 https://api.corion.ai 之下，使用同一把密钥，从同一份额度中扣费。选你的客户端本来就会说的那一种即可。中间不需要任何适配层或转换层。
| 接口形态 | 端点 | 何时使用 |
|---|---|---|
| OpenAI Chat Completions | POST /v1/chat/completions | 使用 OpenAI SDK、LangChain 或任何 OpenAI 兼容客户端 |
| OpenAI Responses | POST /v1/responses | 客户端原生使用 Responses，例如 Codex CLI |
| Anthropic Messages | POST /v1/messages | 使用 Anthropic SDK 或 Claude Code |
| 模型列表 | GET /v1/models | 确认密钥可用，以及它能访问哪些模型 |
每个接口都同时接受 Authorization: Bearer <key> 和 Anthropic 的 x-api-key: <key>，因此各家 SDK 的默认行为无需修改即可使用。
可用的模型标识符为 kimi-k3、deepseek-v4-pro-0813 和 deepseek-v4-flash-0731。各模型从额度中扣除的费率参见定价。
5. 发起第一个请求
export CORION_BASE_URL="https://api.corion.ai"
export CORION_API_KEY="your-key"
curl "$CORION_BASE_URL/v1/chat/completions" \
-H "Authorization: Bearer $CORION_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kimi-k3",
"messages": [{"role": "user", "content": "Write a two-line launch announcement."}]
}'
同一把密钥走 Anthropic Messages。注意该 API 要求的 anthropic-version 请求头和 max_tokens 字段：
curl "$CORION_BASE_URL/v1/messages" \
-H "x-api-key: $CORION_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "kimi-k3",
"max_tokens": 256,
"messages": [{"role": "user", "content": "Write a two-line launch announcement."}]
}'
返回 200 且响应体为 Anthropic 结构（type: "message"、content: [{type: "text", ...}]），说明鉴权与路由都已打通。
6. 流式输出响应
两家官方 SDK 都支持自定义 base URL，所以把它们指向 Corion 只是改一行的事。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["CORION_API_KEY"],
base_url=f'{os.environ["CORION_BASE_URL"]}/v1',
)
stream = client.chat.completions.create(
model="kimi-k3",
messages=[{"role": "user", "content": "Explain speculative decoding simply."}],
stream=True,
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="", flush=True)
Anthropic SDK 通过 /v1/messages 访问同样的模型。base URL 不要带 /v1，SDK 会自己补上：
import os
import anthropic
client = anthropic.Anthropic(
api_key=os.environ["CORION_API_KEY"],
base_url=os.environ["CORION_BASE_URL"],
)
with client.messages.stream(
model="kimi-k3",
max_tokens=1024,
messages=[{"role": "user", "content": "Explain speculative decoding simply."}],
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)
System 提示词、工具调用与流式输出的行为，都与各自官方文档一致。Corion 提供的就是同一套线上协议格式。
7. 接入编程 Agent
大多数 Agent 只需两行配置，也不需要适配层，因为 Corion 直接提供了它们各自期待的协议：
# Claude Code：Anthropic Messages
export ANTHROPIC_BASE_URL=https://api.corion.ai
export ANTHROPIC_API_KEY=$CORION_API_KEY
export ANTHROPIC_MODEL=kimi-k3
claude
# Kimi Code：从我们的 registry 导入 Corion 的全部模型
kimi provider add https://corion.ai/kimi-registry/api.json --api-key $CORION_API_KEY
kimi -m corion/kimi-k3
Codex 则需要在 ~/.codex/config.toml 里加一段配置，因为它对自定义 provider 只使用 Responses API：
model_provider = "corion"
model = "kimi-k3"
[model_providers.corion]
base_url = "https://api.corion.ai/v1"
env_key = "CORION_API_KEY"
各 Agent 的完整配置、模型切换与排错：Claude Code、Codex、Kimi Code、Hermes、OpenClaw、OpenCode。
不论用哪个 Agent，都建议先跑一个只读任务（例如"总结这个仓库"），确认回复和工具调用都正常，再授予它修改文件的权限。
8. 试用 playground
Playground 使用你已登录的账户和可用额度。它不会将你的虚拟 API 密钥暴露给浏览器 JavaScript。