快速开始

用任何 SDK 调任何模型, 无需修改代码

本平台是多协议 AI 网关。你已经用熟的 OpenAI / Anthropic / Google Gemini SDK, 可以直接调用 90+ 个模型 —— 70+ 文本模型覆盖 Claude / GPT / Gemini / Grok / DeepSeek / Kimi / 千问 / MiniMax / GLM 等 11 家厂商,另有图像 / 视频 / embedding 模型 (见 图像 / 视频 / Embedding API)。

1. 获取 API Key#

访问 model.dflop.top 注册并创建 API Key:

• 控制台路径: Dashboard → API Keys → Create Key
• 格式: sk-gpushare- + 64 位十六进制(总长 76 字符)
• 注册即送 $0.30 体验额度,足够跑通本页全部示例
• 充值: 主站 dflop.top/dashboard/billing(Stripe,最低 $1;与 model.dflop.top 同账号 SSO,余额共享)
• 所有 Key 共享同一账户余额;Key 级可设模型白名单(allowed_models)、有效期、启停 —— 用于权限隔离与审计,不是预算隔离
• 原始 Key 可在控制台 Key 详情页随时重新查看(服务端加密存储)

export PLATFORM_API_KEY=sk-gpushare-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

2. 选择你已经在用的 SDK#

2.1 OpenAI SDK#

from openai import OpenAI

client = OpenAI(
    base_url="https://api.dflop.top/v1",
    api_key="sk-gpushare-xxx",
)

# 调用任意模型 —— 包括非 OpenAI 家
response = client.chat.completions.create(
    model="claude-sonnet-4-6",  # 用 OpenAI SDK 调 Claude
    messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)

完整 Python / TypeScript / curl 示例见 OpenAI SDK 指南。

2.2 Anthropic SDK#

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.dflop.top",  # ⚠️ 不带 /v1
    api_key="sk-gpushare-xxx",
)

# 调用绝大多数模型 (例外见兼容矩阵) —— 包括非 Anthropic 家
message = client.messages.create(
    model="gpt-5.4",                    # 用 Anthropic SDK 调 GPT
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}],
)
print(message.content[0].text)

完整示例见 Anthropic SDK 指南。

2.3 Google Gemini SDK#

from google import genai

client = genai.Client(
    api_key="sk-gpushare-xxx",
    http_options={"base_url": "https://api.dflop.top"},
)

# 调用绝大多数模型 (例外见兼容矩阵) —— 包括非 Gemini 家
response = client.models.generate_content(
    model="glm-5.1",                    # 用 Gemini SDK 调 GLM
    contents="Hello",
)
print(response.text)

SDK 默认发送的 x-goog-api-key header 直接被网关识别,无需任何鉴权改造。 完整示例见 Gemini SDK 指南。

3. 它是怎么工作的?#

本平台内部有一套协议自适配引擎:

你的 SDK (OpenAI / Anthropic / Gemini)
        ↓
本网关: 自动翻译协议
        ├─ T1: OpenAI Chat   → Anthropic Messages
        ├─ T2: OpenAI Chat   → Gemini Native
        ├─ T3: Anthropic     → OpenAI Chat
        ├─ T4: Gemini Native → OpenAI Chat
        └─ T6: Gemini Native → Anthropic Messages
        ↓
上游 model (Claude / GPT / Gemini / GLM / DeepSeek / Grok / ...)
        ↓
响应翻译回你 SDK 期望的 shape
        ↓
你的代码无感知

绝大多数「SDK 协议 × 模型」组合要么原生直通(byte-faithful),要么自动走协议翻译, 仅少数组合暂未支持。你不需要了解走哪条 —— 网关自动选最优路径, 翻译路径会在响应的 X-Protocol-Translation header 中标注。 完整矩阵: 兼容矩阵。

4. 客户端集成#

本平台在主流 AI Coding 客户端里可作为 Custom API Provider 接入:

• Claude Code —— 把 ANTHROPIC_BASE_URL 指向本网关
• Cursor / Cline —— Custom OpenAI 接口
• Continue / Open WebUI

5. 模型推荐#

按厂商#

完整模型列表(含定价与上下文)见 模型列表; 图像 / 视频模型见 图像 / 视频 API。

按用途#

限制: Gemini 系列暂不支持 Anthropic Messages 端点 (Anthropic→Gemini 翻译在路线图中); GPT-5.x 暂不支持 Gemini Native 端点。调用未支持的组合会返回 503 no_channel_available。 其余组合全部可用,详见 兼容矩阵。

6. 计费#

• 预付费钱包: 充值进账户余额(USD),所有 API Key 共享同一余额,按实际用量扣减。Key 本身不带独立预算池 —— 想做预算隔离请在业务侧分账(用量日志按 Key 区分,便于审计)
• 计费单位: chat / embeddings 按 token;图像按张;视频按秒(按实际生成时长结算,失败全额退回)。详见 图像 / 视频 / Embedding API
• cached 价格: 上游返回 cached_tokens 时自动按该模型的「缓存输入」价计费,无需(也无法)显式开启。各模型缓存费率见 模型广场,未标注缓存价的模型与普通 input 同价。/v1/responses 多轮会话建议带稳定的 session_id 请求头(网关会透传给上游做会话粘连),可显著提高缓存命中率
• 错误统一返回: HTTP 4xx/5xx + 协议本家 JSON shape (OpenAI / Anthropic / Gemini 三种返回格式)
• 余额耗尽: HTTP 402 + code quota_exceeded(OpenAI 格式;Anthropic 格式为 type billing_error,Gemini 格式为 status RESOURCE_EXHAUSTED)。余额耗尽时所有 Key 同时失效,新建 Key 不能解决,请到 dflop.top/dashboard/billing 充值

最常见的四个错误码:

完整错误码、三协议错误体对照与重试建议见 错误码。

7. 下一步#

• 完整 API 参考: API 参考
• 鉴权细节: 鉴权
• 流式响应: 流式指南
• 工具调用: 工具调用
• 图像 / 视频 / Embedding: 媒体 API
• 知识库检索 (REST + MCP): 知识库 API & MCP
• 反馈渠道: dflop.top/community