五分钟，接入所有前沿模型
APIArc 把不同供应商的模型收拢到一个 API 端点。保留你熟悉的 OpenAI SDK，只需替换 Base URL、API 密钥和模型 ID。
最短接入路径
如果你已经在使用 OpenAI SDK，只需要完成这三步。
创建密钥
在控制台生成一把 API 密钥
替换端点
将 Base URL 指向 APIArc
选择模型
从模型目录复制模型 ID
发出第一个请求
下面的示例使用 Chat Completions 协议。它兼容常见的 OpenAI 客户端，适合验证密钥、网络和模型是否都已就绪。
写入环境变量
把密钥放在服务端环境变量中。不要提交到 Git，也不要写进浏览器端代码。
export APIARC_API_KEY="your_api_key_here"发送请求
任选一种语言运行下面的代码。示例会向 DeepSeek Chat 发送一句简单问候。
curl https://api.apiarc.dev/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $APIARC_API_KEY" \
-d '{
"model": "deepseek-chat",
"messages": [
{"role": "user", "content": "Say hello in one sentence."}
]
}'成功响应： HTTP 状态码为 200，并在 choices[0].message.content 中返回模型文本。
每个请求都使用 Bearer Token
APIArc 使用 API 密钥识别项目并计量用量。将密钥放入 Authorization 请求头，不需要额外签名。
Authorization: Bearer $APIARC_API_KEY密钥代表你的账户权限
任何拿到密钥的人都可以消耗账户余额。若密钥出现在日志、截图或公开仓库中，请立即撤销并重新创建。
- 服务端读取环境变量，不把密钥发送到浏览器。
- 按应用或环境拆分密钥，便于定位用量和单独撤销。
- 定期轮换生产密钥，并先部署新密钥再撤销旧密钥。
一个 Base URL，多种兼容协议
大多数应用从 Chat Completions 开始即可。需要原生能力时，可以选择模型支持的 Responses、Anthropic Messages 或 Gemini generateContent 协议。
https://api.apiarc.dev| 端点 | 用途 | 适合场景 |
|---|---|---|
| /v1/chat/completions | 多轮文本与工具调用 | 现有 OpenAI 兼容应用 |
| /v1/responses | OpenAI Responses 协议 | 使用 Responses 原生能力 |
| /v1/messages | Anthropic Messages 协议 | Claude 原生客户端 |
| /v1/models | 查询可用模型 | 动态模型选择与健康检查 |
兼容不等于每个模型能力完全相同
端点格式可以统一，但上下文长度、工具调用、图像输入和结构化输出仍由具体模型决定。上线前请在模型详情页确认能力与价格。
切换模型，只改一个字符串
请求中的 model 字段决定实际调用的模型。端点、鉴权和响应解析保持不变，因此可以在同一套集成里比较多个供应商。
deepseek-chat模型目录会持续更新。请复制详情页显示的准确 ID，不要根据展示名称自行拼写。
生产环境建议
先为主模型设定质量与成本基线，再准备一个同协议的备用模型。供应商故障时，你可以快速切换而不改业务代码。
让用户更早看到第一个 Token
在请求体中加入 stream: true，APIArc 会用 Server-Sent Events（服务器推送事件）逐段转发上游输出。
const stream = await client.chat.completions.create({
model: "deepseek-chat",
messages: [{ role: "user", content: "Explain API gateways." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}客户端应逐行读取 data: 事件、拼接增量内容，并在收到 [DONE] 后结束。网络中断时，不要把半段回答当作完整结果保存。
把错误分成可修复与可重试两类
先看 HTTP 状态码，再记录响应中的错误信息和请求 ID。客户端配置错误应立即修复；短暂的上游或网络错误可以退避重试。
| 状态码 | 常见原因 | 建议处理 |
|---|---|---|
| 400 | 请求字段或模型 ID 无效 | 修正请求，不要原样重试 |
| 401 | 密钥缺失、错误或已撤销 | 检查 Authorization 请求头 |
| 402 | 账户余额不足 | 充值后再发起请求 |
| 429 | 请求过快或达到配额 | 指数退避，并降低并发 |
| 5xx | 网关或上游暂时不可用 | 短暂退避后重试或切换模型 |
保留请求 ID
联系支持时提供请求 ID、时间、模型和端点即可。不要发送 API 密钥、完整提示词或支付信息。
生产环境检查清单
一次成功调用只能证明接入可用。上线前还需要明确超时、重试、密钥和成本边界。
设置超时
分别限制连接时间和整次生成时间。
谨慎重试
仅重试 429、网络错误和部分 5xx，并使用指数退避。
保护密钥
密钥只保存在服务端密钥管理系统或环境变量中。
记录请求 ID
日志保留模型、耗时、状态码和请求 ID，避免记录敏感正文。
监控成本
按密钥和模型查看用量，为异常消耗设置提醒。
准备降级
为核心流量验证备用模型与非流式兜底路径。