# API 文档

> 一个 API Key, 三种 SDK, 接入 124+ 主流大模型

来源：https://qd.zsopc.com/docs

本平台是多协议 AI 网关 —— 用你已经在用的 OpenAI / Anthropic / Google Gemini SDK,直接调用 124+ 个主流大模型 (Claude / GPT / Gemini / Grok / DeepSeek / 豆包 / Kimi / 千问 / MiniMax / GLM / 混元,截至 2026-08 覆盖 10 家厂商、57 个文本模型)。代码零改动。除聊天外,同一把 Key 还能调用图像生成(按张)、视频生成(异步按秒)、音乐与语音、知识库检索 —— 见下方「参考」。

## 一分钟要点

- **Base URL**: `https://qd.zsopc.com`
- **API Key**: 在 [qd.zsopc.com 控制台 → API Keys](https://qd.zsopc.com/dashboard/keys) 创建(控制台中显示为「子密钥」),注册即送 120 积分体验额度
- **三种 SDK 覆盖全部四个聊天协议**: OpenAI Responses 端点同样用 OpenAI SDK 访问

## 入门

- [Quickstart](./quickstart.md) — 5 分钟接入,3 SDK 速览

## SDK 指南

- [OpenAI SDK](./sdks/openai-sdk.md) — Python / TypeScript / curl 完整示例(`/v1/chat/completions` 与 `/v1/responses` 都用它)
- [Anthropic SDK](./sdks/anthropic-sdk.md) — 完整示例 + base URL 注意事项
- [Google Gemini SDK](./sdks/gemini-sdk.md) — 完整示例 + 多模态

## 客户端集成

- [Claude Code](./integrations/claude-code.md)
- [Codex CLI](./integrations/codex-cli.md)
- [Gemini CLI](./integrations/gemini-cli.md)
- [Cursor](./integrations/cursor.md)
- [Cline (VS Code)](./integrations/cline.md)
- [Roo Code (VS Code,已停止维护)](./integrations/roo-code.md)
- [Continue.dev](./integrations/continue.md)
- [Cherry Studio](./integrations/cherry-studio.md)
- [Chatbox](./integrations/chatbox.md)
- [LobeChat](./integrations/lobechat.md)
- [NextChat](./integrations/nextchat.md)
- [Open WebUI](./integrations/open-webui.md)
- [LangChain](./integrations/langchain.md)
- [LiteLLM](./integrations/litellm.md)
- [Vercel AI SDK](./integrations/vercel-ai-sdk.md)
- [FlopCode](./integrations/flopcode.md)

## 参考

- [完整模型列表](./reference/models.md) — 模型 × 定价 × 能力位
- [兼容矩阵](./reference/compatibility-matrix.md) — 模型 × SDK 支持一览
- [API 参考](./reference/api-reference.md) — 全部端点请求/响应格式
- [图像 / 视频 / 音乐 API](./reference/media-apis.md) — `/v1/images/generations` 按张计费 · `/v1/videos/generations` 异步按秒 · `/v1/music/generations` 按次 · `/v1/audio/*` 语音合成与克隆 · `/v1/transcripts/extract` 短视频提文案按次
- [数字人 / 剪辑 API](./reference/digital-human-apis.md) — 形象库 · 数字人出片 · 对口型 · 动作迁移 · 智能剪辑
- [调用日志 API](./reference/logs-api.md) — 用同一把 Key 拉逐笔调用记录(状态 / 报错原因 / 异步任务终态 / 实扣积分),可增量同步对账
- [知识库 API & MCP](./reference/wiki-api.md) — 知识库只读检索 REST + MCP server
- [鉴权](./reference/authentication.md) — Key 格式 + 4 种鉴权方式
- [错误码](./reference/errors.md) — 401 / 402 / 502 等含义 + 排查

## 指南

- [流式响应](./guides/streaming.md) — SSE 解析 + 中断处理
- [工具调用](./guides/tool-calling.md) — Function Tools / Tool Use / Function Calling
- [从 OpenAI 直连迁移](./guides/migrating-from-openai.md)
- [从 Anthropic 直连迁移](./guides/migrating-from-anthropic.md)
