中文 AI API 接入教程¶
持续更新 · 面向中文用户
一把 Key,接入你真正使用的 AI 工具¶
这里整理了 52 篇中文实操文档,覆盖 AI 编程工具、聊天客户端、开发框架、知识库、自动化平台与 API 调试。每篇教程都从安装讲到首次请求,并把 401、404、429、协议不匹配和流式输出等高频问题讲清楚。
52 篇中文文档 · 49 款工具与框架 · 安装、配置、验证、排错一页讲完
新手第一次接 API?¶
按这个顺序最省时间:
- 阅读 API 接入基础,弄清 Base URL、API Key、模型 ID 和三类常见协议。
- 打开 兼容性总表,确认你的工具需要 Chat Completions、Responses 还是 Messages。
- 从下方选择工具,照着教程完成一次最小请求。
- 遇到状态码或流式问题,直接查 通用排错手册。
按使用场景选择教程¶
⌨️ AI 编程工具 Claude Code、Codex CLI、Crush、OpenHands、AionUi 等
💬 聊天客户端 Cherry Studio、ChatWise、SillyTavern、LobeChat 等
🧑💻 SDK 与 Agent OpenAI SDK、Agents SDK、LangChain、PydanticAI、CrewAI
🏠 自托管与知识库 Dify、Open WebUI、RAGFlow、AnythingLLM、MaxKB
最常用的教程¶
| 教程 | 适合谁 | 关键协议 |
|---|---|---|
| Claude Code | 需要终端 Agent 写代码 | Anthropic Messages |
| Codex CLI | 使用终端编程代理 | OpenAI Responses |
| Cherry Studio | 第一次配置桌面客户端 | 多 Provider |
| Dify | 搭建知识库与工作流 | Chat / Embedding / Rerank |
| OpenAI SDK | Python / Node.js 开发者 | Responses / Chat |
| Apifox / Postman | 想先验证接口是否正常 | Models / Chat / Responses |
教程内容原则¶
- 真实可执行: 命令、路径和字段都尽量对照当前官方文档核验。
- 先讲兼容边界: 不把 Chat Completions、Responses 和 Messages 混为一谈。
- 先验证再扩展: 每篇先完成最小请求,再介绍流式、工具调用、RAG 等能力。
- 不泄露密钥: 示例使用明显占位符,提醒读者避免把完整 Key 发到 Issue 或截图里。
- 欢迎纠错: 发现界面或字段变化,可以直接提交教程纠错。
想一次看完全部分类?进入中文教程总目录。