快速开始 — 3 分钟接入 100+ 大模型 | ClaudeYY Docs

来源: https://www.claudeyy.com/zh/docs/develop
说明: 3 分钟快速接入 ClaudeYY LLM Gateway，兼容 OpenAI/Anthropic/Gemini SDK，一个 API Key 调用 100+ 大模型

快速开始

本指南帮助你在 3 分钟内接入 ClaudeYY Gateway，开始调用 100+ 大模型。

前置要求

注册 ClaudeYY 控制台获取 API Key
准备开发环境（Python 3.8+ / Node.js 18+）

ClaudeYY 兼容 OpenAI / Anthropic / Gemini 三大协议，你可以使用任意官方 SDK 接入。

选择接入方式

OpenAI SDK（推荐）

OpenAI 兼容协议 — 最通用的接入方式。

cURL

Terminal

# ClaudeYY API 地址，API Key 在 https://claude.claudeyy.com 获取
curl https://claude.claudeyy.com/v1/chat/completions \
  -H "Authorization: Bearer <你的 CLAUDEYY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.4-mini",
    "messages": [
      {"role": "user", "content": "生命的意义是什么?"}
    ]
  }'

Python

quickstart.py

Terminal

from openai import OpenAI
 
client = OpenAI(
    # ClaudeYY API 地址
    base_url="https://claude.claudeyy.com/v1",
    # 在 https://claude.claudeyy.com 获取
    api_key="<你的 CLAUDEYY_API_KEY>"
)
 
response = client.chat.completions.create(
    model="openai/gpt-5.4-mini",
    messages=[
        {"role": "user", "content": "生命的意义是什么?"}
    ]
)
 
print(response.choices[0].message.content)

TypeScript

quickstart.ts

Terminal

import OpenAI from 'openai'
 
const client = new OpenAI({
  // ClaudeYY API 地址
  baseURL: 'https://claude.claudeyy.com/v1',
  // 在 https://claude.claudeyy.com 获取
  apiKey: '<你的 CLAUDEYY_API_KEY>'
})
 
async function main() {
  const response = await client.chat.completions.create({
    model: 'openai/gpt-5.4-mini',
    messages: [
      { role: 'user', content: '生命的意义是什么?' }
    ]
  })
 
  console.log(response.choices[0].message.content)
}
 
main()

Anthropic SDK

Anthropic 原生协议 — 直接使用 Anthropic SDK，完整支持 Claude 全部功能。

cURL

Terminal

# ClaudeYY API 地址，API Key 在 https://claude.claudeyy.com 获取
curl https://claude.claudeyy.com/anthropic/v1/messages \
  -H "x-api-key: <你的 CLAUDEYY_API_KEY>" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4.6",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "生命的意义是什么?"}
    ]
  }'

Python

quickstart_anthropic.py

Terminal

import anthropic
 
client = anthropic.Anthropic(
    # ClaudeYY API 地址
    base_url="https://claude.claudeyy.com/anthropic",
    # 在 https://claude.claudeyy.com 获取
    api_key="<你的 CLAUDEYY_API_KEY>"
)
 
message = client.messages.create(
    model="anthropic/claude-sonnet-4.6",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "生命的意义是什么?"}
    ]
)
 
print(message.content[0].text)

TypeScript

quickstart_anthropic.ts

Terminal

import Anthropic from '@anthropic-ai/sdk'
 
const client = new Anthropic({
  // ClaudeYY API 地址
  baseURL: 'https://claude.claudeyy.com/anthropic',
  // 在 https://claude.claudeyy.com 获取
  apiKey: '<你的 CLAUDEYY_API_KEY>'
})
 
async function main() {
  const message = await client.messages.create({
    model: 'anthropic/claude-sonnet-4.6',
    max_tokens: 1024,
    messages: [
      { role: 'user', content: '生命的意义是什么?' }
    ]
  })
 
  console.log(message.content[0].text)
}
 
main()

Gemini SDK

Gemini 原生协议 — 使用 Google GenAI SDK，支持 Gemini 全系模型。

cURL

Terminal

# ClaudeYY API 地址，API Key 在 https://claude.claudeyy.com 获取
curl "https://claude.claudeyy.com/gemini/v1beta/models/google/gemini-3.1-flash-lite-preview:generateContent" \
  -H "x-goog-api-key: <你的 CLAUDEYY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "生命的意义是什么?"}]}
    ]
  }'

Python

quickstart_gemini.py

Terminal

from google import genai
 
client = genai.Client(
    # 在 https://claude.claudeyy.com 获取
    api_key="<你的 CLAUDEYY_API_KEY>",
    # ClaudeYY API 地址
    http_options={
        "api_version": "v1beta",
        "base_url": "https://claude.claudeyy.com/gemini",
    }
)
 
response = client.models.generate_content(
    model="google/gemini-3.1-flash-lite-preview",
    contents="生命的意义是什么?"
)
 
print(response.text)

TypeScript

quickstart_gemini.ts

Terminal

import { GoogleGenAI } from '@google/genai'
 
const ai = new GoogleGenAI({
  // 在 https://claude.claudeyy.com 获取
  apiKey: '<你的 CLAUDEYY_API_KEY>',
  // ClaudeYY API 地址
  httpOptions: {
    apiVersion: 'v1beta',
    baseUrl: 'https://claude.claudeyy.com/gemini',
  }
})
 
async function main() {
  const response = await ai.models.generateContent({
    model: 'google/gemini-3.1-flash-lite-preview',
    contents: '生命的意义是什么?'
  })
 
  console.log(response.text)
}
 
main()

下一步

🔑 认证指南 📊 模型目录 🔧 API 参考 🛠️ 工具集成