快速开始

5 分钟内完成你的第一次 API 调用。

前提条件

一个 Routic 账户和有效的 API Key。还没有的话，先注册并创建密钥。
你的 Base URL：https://api.routic.ai/v1
任意 HTTP 客户端（curl、Python、Node.js 等）

第 1 步 — 选择模型

浏览模型目录，选择一个标准模型名。第一次调用推荐通用对话模型：

场景	模型名
日常对话	`deepseek-v3`
复杂推理	`deepseek-r1`
性价比优先	`deepseek-r1-distill-qwen-14b`

也可以用智能路由名如 auto/chat 或 auto/reasoning，Routic 会自动选最优模型。

第 2 步 — 发送请求

curl

curl -sS "https://api.routic.ai/v1/chat/completions" \
  -H "Authorization: Bearer $ROUTIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v3",
    "messages": [{"role": "user", "content": "ping"}]
  }'

运行前先设置环境变量 ROUTIC_API_KEY 为你的 API Key。

Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    base_url="https://api.routic.ai/v1",
    api_key="sk-xxxxxxxx",   # 你的 Routic API Key
)

response = client.chat.completions.create(
    model="deepseek-v3",
    messages=[{"role": "user", "content": "ping"}],
)

print(response.choices[0].message.content)

Node.js（OpenAI SDK）

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.routic.ai/v1",
  apiKey: "sk-xxxxxxxx",   // 你的 Routic API Key
});

const response = await client.chat.completions.create({
  model: "deepseek-v3",
  messages: [{ role: "user", content: "ping" }],
});

console.log(response.choices[0].message.content);

第 3 步 — 验证响应

成功的响应长这样：

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "deepseek-v3",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "pong"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 2,
    "total_tokens": 10
  }
}

如果收到错误，检查以下常见问题：

现象	可能原因	解决方式
`401 invalid_api_key`	API Key 错误或缺失	确认 Key 以 `sk-` 开头且与控制台一致
`401 missing_api_key`	没有携带 Authorization 头	添加 `Authorization: Bearer sk-xxx`
`400 invalid_model`	模型名不认识	查看模型目录确认有效名称
`402 insufficient_balance`	账户余额不足	在控制台充值

完整错误码见 HTTP 语义与错误载荷。

下一步

跑通之后，建议按顺序阅读：

了解计费 — 模型名、计费与 SKU
正确处理错误 — 错误与重试
探索功能 — 流式输出、工具调用、思维链模式
接入你的工具 — Cursor、Claude Code、Aider