Quickstart
Arctic 使用 OpenAI 兼容接口。把 Base URL 指向 Arctic,其余代码不用改。
5 分钟跑通第一个请求
- 注册登录,进入 Dashboard 创建一个 API Key(明文只显示一次)。
- 在客户端填入 Base URL 与 Key——OpenAI SDK / Anthropic SDK 换 base_url 即用。
- 用下面的 cURL / Python / Node 示例发出第一个请求。
错误响应为 OpenAI 标准 JSON:401 Key 无效 · 402 余额不足 · 404 模型不存在 · 429 触发限流。
Authentication
所有请求在 Header 里带上 Arctic API Key。
Base URL
https://api.serapi.cc/v1
Header
Authorization: Bearer sk-arctic-REPLACE_WITH_YOUR_KEY Content-Type: application/json
List Models
Request
curl https://api.serapi.cc/v1/models \ -H "Authorization: Bearer $ARCTIC_API_KEY"
Response
{
"object": "list",
"data": [
{
"id": "sera-fast",
"object": "model",
"owned_by": "serapi"
},
{
"id": "sera-flash",
"object": "model",
"owned_by": "serapi"
},
{
"id": "sera-pro",
"object": "model",
"owned_by": "serapi"
}
]
}Chat Completions
Request
curl https://api.serapi.cc/v1/chat/completions \
-H "Authorization: Bearer $ARCTIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sera-fast",
"messages": [{"role": "user", "content": "Hello"}]
}'Response
{
"id": "chatcmpl-9f2a...",
"object": "chat.completion",
"model": "sera-fast",
"usage": {
"prompt_tokens": 12,
"completion_tokens": 24,
"total_tokens": 36
}
}Responses
适用于 Codex 等使用 Responses API 的客户端。
Request
curl https://api.serapi.cc/v1/responses \
-H "Authorization: Bearer $ARCTIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sera-fast",
"input": "Write a haiku about the Arctic"
}'Errors
| Code | Meaning |
|---|---|
| 401 | API Key 无效或已吊销 |
| 402 | 余额不足 |
| 404 | 模型不存在或未开通 |
| 429 | 超过 RPM / TPM 限制 |
| 502 | 上游暂时不可用 |