ai-api-integration

通过统一的 OpenAI 兼容协议接入 GPT-5、Claude Opus 4.7、Gemini 3.1、Sora 2、Suno 等主流大模型 API 的实战教程。

示例

python

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxx",
    base_url="http://xdhdancer.top/v1",
)

resp = client.chat.completions.create(
    model="claude-opus-4-7",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

只需要修改 model 参数即可切换到其他模型（gpt-5、gemini-3.1-pro、deepseek-v3.2 等），代码其他部分不变。

模型清单

精选条目。完整列表和模型说明见 docs/modalities/。

模型 ID	厂商	上下文	说明
`gpt-5`	OpenAI	128k	通用推理、代码
`gpt-5-mini`	OpenAI	128k	速度快、价格低
`o3-pro`	OpenAI	200k	深度推理
`claude-opus-4-7`	Anthropic	200k	长上下文编程
`claude-sonnet-4-6`	Anthropic	200k	性价比
`claude-haiku-4-5`	Anthropic	200k	延迟最低
`gemini-3.1-pro`	Google	2M	长文档
`deepseek-v3.2`	DeepSeek	128k	中文强、价格低
`kimi-k2`	Moonshot	200k	中文长文档
`gpt-image-2`	OpenAI	—	图片生成
`sora-2`	OpenAI	—	视频生成
`suno-v4`	Suno	—	音乐生成

工具接入

Cursor —— AI 优先的 IDE
Cline —— VS Code AI 代理插件
Claude Code —— Anthropic 官方 CLI
ChatBox —— 跨平台桌面客户端
Dify —— 低代码 LLM 工作流
LobeChat —— 自部署 Chat UI
Open WebUI —— 自部署 Web UI
Continue —— VS Code 编程助手
LangChain —— LLM 应用框架
LlamaIndex —— RAG / 数据框架

多模态教程

文本 · 代码 · 图片 · 视频 · 音频 · 视觉 · Embeddings

代码示例

Python · Node.js · curl

常见问题

为什么用统一网关而不直接调各家 API？ 统一计费、统一 Key、切换模型只需改一行代码。适合需要对比多个模型或在多家厂商之间做容错的场景。

可以用自己的网关吗？ 可以。把 base_url 替换成你自己运行的 OpenAI 兼容 endpoint 即可。本仓库的示例代码不依赖任何特定的 provider。

没有示例里那个网关的账号也能跑吗？ 能。所有示例使用标准 OpenAI 兼容协议——直接指向 https://api.openai.com/v1 或任何兼容服务都能运行。

新手应该从哪个模型开始？ 日常对话和编程任务推荐 claude-sonnet-4-6。长文档场景用 gemini-3.1-pro。中文且预算敏感用 deepseek-v3.2 或 kimi-k2。

说明

本仓库示例使用产灵 API 作为网关 provider。任何 OpenAI 兼容的服务都能以相同方式接入。

ai-api-integration ​

示例 ​

模型清单 ​

工具接入 ​

多模态教程 ​

代码示例 ​

常见问题 ​

说明 ​