跳转到主要内容

​
接入教程

本文页只写入 2026-03-23 已在 Crazyrouter 生产环境复核过的起步路径。 如果你要最快开始，先区分三类接法：
  • OpenAI 兼容：https://crazyrouter.com/v1
  • Anthropic 原生：https://crazyrouter.com
  • Gemini 原生：https://crazyrouter.com/v1beta/models/...

​
最短迁移原则

从 OpenAI 兼容客户端迁移到 Crazyrouter，通常只需要改两项：
  1. base_url 改成 https://crazyrouter.com/v1
  2. api_key 改成 Crazyrouter 的 sk-xxx

​
从 OpenAI 迁移

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxx",
    base_url="https://crazyrouter.com/v1"
)

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "Hello"}],
    max_tokens=64
)
本轮生产复核确认：
  • gpt-5.4 通过 /v1/chat/completions 可正常返回
  • 如果你需要 reasoning 摘要或 OpenAI 风格 web search，优先切到 /v1/responses
相关页面：

​
从 Anthropic 迁移

​
方案 A：继续走 OpenAI 兼容层

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxx",
    base_url="https://crazyrouter.com/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Hello"}],
    max_tokens=64
)

​
方案 B：走 Anthropic 原生 Messages

import anthropic

client = anthropic.Anthropic(
    api_key="sk-xxx",
    base_url="https://crazyrouter.com"
)

response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=128,
    messages=[{"role": "user", "content": "Hello"}]
)
如果你要：
  • 普通 Claude 对话：优先 claude-sonnet-4-6
  • 明确需要 thinking block：优先 claude-opus-4-6-thinking
相关页面：

​
从 Gemini 迁移

​
方案 A：OpenAI 兼容层

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxx",
    base_url="https://crazyrouter.com/v1"
)

response = client.chat.completions.create(
    model="gemini-3-pro-preview",
    messages=[{"role": "user", "content": "Hello"}],
    max_tokens=64
)

​
方案 B：Gemini 原生

curl "https://crazyrouter.com/v1beta/models/gemini-3-pro-preview:generateContent?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {"text": "Hello"}
        ]
      }
    ]
  }'
如果你要：
  • 只复用现有 OpenAI SDK 代码：先走兼容层
  • 需要结构化输出、Google Search、thinking：优先走 Gemini 原生
相关页面：

​
环境变量方式

如果你走 OpenAI 兼容层，推荐先配： 
export OPENAI_API_KEY=sk-xxx
export OPENAI_BASE_URL=https://crazyrouter.com/v1
然后代码里可直接： 
from openai import OpenAI
client = OpenAI()

​
起步建议

目标推荐起步方式
最快接入 GPTOpenAI 兼容 + gpt-5.4
最快接入 ClaudeAnthropic 原生 + claude-sonnet-4-6
最快接入 GeminiOpenAI 兼容或 Gemini 原生 + gemini-3-pro-preview
要 reasoning 摘要Responses API
要 Claude thinking blockclaude-opus-4-6-thinking
要 Gemini Google Search / thinking / responseSchemaGemini 原生
Crazyrouter 同时支持 OpenAI、Anthropic、Gemini 三种协议。更稳的做法通常不是“所有模型都强行走同一协议”，而是按能力选最合适的入口。