🚀 快速开始

Proxy 提供与 OpenAI 完全兼容的 API 接口。只需修改 base_url 和 api_key，即可访问所有主流 AI 模型。

📍 Base URL: https://proxy.yoga/v1

三步接入

1. 注册账号 获取 API Key
2. 将客户端 base_url 指向 https://proxy.yoga/v1
3. 选择模型，开始调用

curl Python JavaScript
# 测试你的第一个 API 请求
curl https://proxy.yoga/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role": "user", "content": "你好，介绍一下 Proxy 平台"}]
  }'

🔐 认证

所有 API 请求需要在 HTTP Header 中携带你的 API Key：

# 认证方式
Authorization: Bearer sk-your-api-key-here

API Key 可在 控制台 中生成和管理。

⚠️ 安全提醒：请勿将 API Key 暴露在客户端代码或公开仓库中。建议通过环境变量管理密钥。

🔗 API 端点

对话补全

POST /v1/chat/completions

发送多轮对话请求，支持文本、图像输入，兼容 OpenAI Chat Completions API。

列出模型

GET /v1/models

获取当前可用的所有模型列表及其详细信息。

💬 对话补全参数

参数类型必填说明
modelstring✅模型 ID，如 gpt-4o、deepseek-chat
messagesarray✅对话消息列表，每条含 role 和 content
streamboolean—是否流式输出 SSE，默认 false
temperaturenumber—采样温度 0-2，默认 1。越高越随机
max_tokensnumber—最大输出 token 数
top_pnumber—核采样参数 0-1
frequency_penaltynumber—频率惩罚 -2.0 到 2.0
presence_penaltynumber—存在惩罚 -2.0 到 2.0

⚡ 流式输出 (SSE)

设置 stream: true 即可启用 Server-Sent Events 流式输出：

Python JavaScript curl
from openai import OpenAI
client = OpenAI(
  api_key="sk-your-api-key",
  base_url="https://proxy.yoga/v1"
)
stream = client.chat.completions.create(
  model="deepseek-chat",
  messages=[{"role": "user", "content": "写一首关于AI的诗"}],
  stream=True
)
for chunk in stream:
  if chunk.choices[0].delta.content:
    print(chunk.choices[0].delta.content, end="")

📋 模型列表

模型 ID提供商输入价格输出价格特性
gpt-4o OpenAIOpenAI¥0.015 / 1K¥0.04 / 1K多模态 · 推理 · 128K
gpt-4.1-mini OpenAIOpenAI¥0.003 / 1K¥0.008 / 1K快速 · 低成本 · 128K
claude-3.5-sonnet AnthropicAnthropic¥0.018 / 1K¥0.05 / 1K推理 · 写作 · 200K
claude-3-haiku AnthropicAnthropic¥0.005 / 1K¥0.015 / 1K快速 · 轻量 · 200K
deepseek-chat DeepSeekDeepSeek¥0.005 / 1K¥0.015 / 1K性价比 · 中文 · 编码
deepseek-reasoner DeepSeekDeepSeek¥0.012 / 1K¥0.03 / 1K深度推理 · 数学 · 科学
gemini-2.0-flash GoogleGoogle¥0.003 / 1K¥0.006 / 1K速度 · 多模态 · 1M
gemini-2.5-pro GoogleGoogle¥0.01 / 1K¥0.025 / 1K旗舰推理 · 编码 · 1M

* 价格单位为每 1K tokens。实际以控制台显示为准。

💻 更多语言示例

Go

package main
import (
  "context"
  "fmt"
  "github.com/openai/openai-go"
  "github.com/openai/openai-go/option"
)
func main() {
  client := openai.NewClient(
    option.WithAPIKey("sk-your-api-key"),
    option.WithBaseURL("https://proxy.yoga/v1"),
  )
  chatCompletion, err := client.Chat.Completions.New(
    context.TODO(),
    openai.ChatCompletionNewParams{
      Model: openai.F("deepseek-chat"),
      Messages: openai.F([]openai.ChatCompletionMessageParamUnion{
        openai.UserMessage("你好"),
      }),
    },
  )
  if err != nil { panic(err) }
  fmt.Println(chatCompletion.Choices[0].Message.Content)
}

Ruby

require 'openai'
client = OpenAI::Client.new(
  access_token: 'sk-your-api-key',
  uri_base: 'https://proxy.yoga/v1'
)
response = client.chat.completions.create(
  model: 'deepseek-chat',
  messages: [{ role: 'user', content: '你好' }]
)
puts response.choices[0].message.content

⏱ 速率限制

套餐请求/分钟Token/分钟
免费105,000
基础 (¥19.9)6050,000
专业 (¥49.9)200200,000
企业 (¥199)1,0001,000,000

超出限制时将返回 429 Too Many Requests。响应头中包含 X-RateLimit-Remaining 和 X-RateLimit-Reset 字段。

🔌 场景接入指南

以下教程覆盖 12 个主流 AI 开发工具，只需修改 API 地址和 Key 即可接入 proxy。

🖥️ Cursor

  1. 打开 Cursor → Settings → Models
  2. API Key: sk-your-key
  3. Base URL: https://proxy.yoga/v1

🤖 Claude Code

  1. npm i -g ...
  2. export ANTHROPIC_BASE_URL=https://proxy.yoga/v1
  3. export ANTHROPIC_API_KEY=sk-your-key

🍒 Cherry Studio

  1. 设置 → 模型服务
  2. 类型: OpenAI 兼容
  3. API: https://proxy.yoga/v1

🌐 Open WebUI

  1. Settings → Connections
  2. API: https://proxy.yoga/v1
  3. Key: sk-your-key

💻 Cline (VS Code)

  1. VS Code → Cline → 设置
  2. Provider: OpenAI Compatible
  3. Base URL: https://proxy.yoga/v1

📱 ChatGPT-Next-Web

  1. 设置 → 自定义接口
  2. 地址: https://proxy.yoga/v1
  3. Key: sk-your-key

📚 LangChain

llm = ChatOpenAI(
    model="deepseek-chat",
    openai_api_key="sk-your-key",
    openai_api_base="https://proxy.yoga/v1"
)

🐍 OpenAI SDK

client = OpenAI(
    api_key="sk-your-key",
    base_url="https://proxy.yoga/v1"
)

📦 Node.js SDK

const client = new OpenAI({
  apiKey: "sk-your-key",
  baseURL: "https://proxy.yoga/v1"
});

🖼️ LobeChat

  1. 设置 → 语言模型
  2. 添加 OpenAI 兼容提供商
  3. API: https://proxy.yoga/v1

💬 Dify

  1. 设置 → 模型供应商
  2. API Base: https://proxy.yoga/v1
  3. Key: sk-your-key

🛠️ Bolt.new / v0

  1. 设置自定义 API 端点
  2. https://proxy.yoga/v1
  3. 选择任意模型

❌ 错误码

状态码含义说明
200成功请求已处理
400请求错误参数格式有误，检查消息结构
401认证失败API Key 无效或已过期
402余额不足账户积分不足，请充值
429速率限制超出套餐请求限制，稍后重试
500服务器错误上游模型暂时不可用
503服务不可用模型暂时离线，系统将自动回退

错误响应格式均遵循 OpenAI API 标准，包含 error.message 和 error.type 字段。