AI API 指南中心:82 篇模型接入、价格与选型实战

小鱼API 的 AI API 指南栏目,共收录 82 篇原创实用内容,覆盖 Gemini、Claude、GPT、Grok、DeepSeek 等主流模型的接入方法、真实价格对比、选型建议、报错排查与密钥安全。每篇都由实际接入经验整理,不是拼凑的模板文。

如果你是第一次接入:建议先看 什么是 API快速开始;如果你在比价:先看 最便宜的 AI API2025 价格表;如果你遇到报错:直接看「报错与问题排查」分组。

怎么用这个栏目

新手入门:先把概念和第一步搞明白

5分钟快速上手AI API(小白友好版)

5分钟快速接入AI API!零基础也能看懂,从注册到调用的完整流程,支持Gemini/Claude/GPT,国内用户友好。

2025年AI大模型快速一览

2025年最全的AI大模型列表,涵盖Gemini、Claude、GPT、Grok、DeepSeek等主流模型,含能力评级和价格参考。

AI API Key购买渠道推荐与避坑指南

想买API Key但不知道去哪?本文推荐最靠谱的API Key购买渠道,Gemini/Claude/GPT全系列,国内用户支付宝即可购买。

API调用 vs 网页版:开发者为什么应该选API?

用API调用AI模型和用网页版ChatGPT/Claude有什么区别?开发者必看,一文讲清API的优势和适用场景。

ChatGPT API vs Playground:哪个适合你?

ChatGPT API和网页版Playground有什么区别?开发者应该用API还是网页版?价格、功能、适用场景全面对比。

API是什么?看完这篇你就懂了

API是什么?这篇文章用最通俗的比喻和例子,让完全零基础的人也能理解API的概念,尤其聚焦AI API。

模型接入指南(按模型选)

Claude API 国内接入指南

国内稳定接入Claude API,支持Claude Opus 4/Sonnet 4.6/Haiku 4.5全系列。编程能力业界顶尖,国内直连,支付宝付款。

DeepSeek API接入指南:国产AI的性价比之王

DeepSeek API完整接入指南,国产AI模型的性价比之王。支持DeepSeek V3、R1等模型,价格极低,适合大规模调用。

Gemini API 国内接入方案

国内稳定接入Gemini API,支持Gemini 3.1 Pro/3 Flash/3 Flash Lite全系列。稳定接口不降智,国内直连,支付宝/微信即可付款。

GPT API 国内接入方案

国内稳定接入OpenAI GPT API,支持GPT-5、GPT-4全系列。无需海外信用卡,国内直连速度极快。

Grok API接入指南:xAI的独特魅力

马斯克xAI推出的Grok API国内接入指南。Grok模型特点、价格、调用方法,国内用户如何稳定调用Grok API。

报错与问题排查(按报错定位)

API 报了 connection refused 或者连接超时?按这五层往下敲,哪层断了就只查哪层

curl 报 connection refused 或连接超时?按 DNS、TCP、TLS、HTTP、客户端五层逐层敲命令,一次定位到根源。

API 报 model not found / 模型不存在 / invalid model?按这个顺序排查,十分钟找到是哪一步写错了

接口返回 model not found 或模型不存在,先别急着换 Key:拉清单对名字、查前缀和大小写,三步定位到真正原因并改对模型 ID。

API 报 SSL 证书错误怎么解决?先对时间再验证书链,六种报错原文一次查到根因

curl 和 requests 报 SSL 证书错误时,先对系统时间再验证书链,按六种报错原文定位到 certifi、Node CA 或企业根证书。

AI API调用超时?这份完整解决方案请收好

调用AI API时频繁超时?本文分析超时的根本原因并提供完整解决方案,包括优化请求、选择合适模型、使用国内中转等。

Claude API 400错误完整解决方案

遇到Claude API返回400 Bad Request错误?本文汇总所有常见400错误原因及解决方法,含代码示例,快速排查修复。

Claude API 401 报错:先别急着换 Key,从这三处查起

Claude API 返回 401 的三种鉴权失败原因逐一拆解,附 curl 与 Python 排查代码、请求头对照表和修复步骤清单。

Claude API 429 限流:怎么判断、怎么退避、怎么不再撞墙

Claude API 429 限流的判断方法、退避重试代码与并发控制参数,区分限流和过载,附错误原文与按次计费价格表。

Claude API 超时:哪些超时该改代码,哪些该改配置

Claude API 超时的三类表现、报错原文和超时参数配置,含流式改造、客户端设置与重试判断,附排查命令。

Claude 流式输出中断:断在哪、怎么接回来

Claude 流式输出中断的原因定位:SSE 事件缺失、缓冲设置、UTF-8 截断,附可运行的增量解析与续写处理代码。

Claude 工具调用报错:schema、配对、ID 三件事

Claude 工具调用报错的常见原因:schema 不合法、tool_use 与 tool_result 不配对、ID 对不上,附两套协议对照与代码。

Gemini API 401 报错:API key not valid 的成因与修法

Gemini API 返回 401、提示 API key not valid 怎么修?拆解八种成因、三条排查命令与可直接运行的 Python 代码。

Gemini API 429 配额超限:从报错原文到降速方案

Gemini API 返回 429、RESOURCE_EXHAUSTED 怎么办?讲清 RPM、TPM、RPD 三种配额区别,给出退避与限流写法。

Gemini API常见问题与报错解决指南

Gemini API调用报错怎么办?汇总Gemini API所有常见错误代码及解决方案,包括限流、认证失败、超时等问题。

Gemini API 超时排查:ReadTimeout 与 504 的正确处理方式

Gemini API 调用超时、ReadTimeout、504 Deadline exceeded 怎么办?分档超时配置、流式写法与网关参数全给。

Gemini 生图接口报错:图片生成失败的排查与修复

Gemini 生图接口报错怎么修?覆盖参数报错、图片返回空、IMAGE_SAFETY 拦截与超时,附可直接运行的解析代码。

Gemini 内容被安全策略拦截:SAFETY 报错的判断与处理

Gemini 返回 SAFETY 或 content_filter、内容为空怎么办?分清各类 finishReason,给出改写与代码兜底写法。

GPT API 报 401 认证失败?先跑这三条命令,别再瞎猜 Key 有问题

GPT API 报 401 认证失败怎么排查?三条命令分清 Key 没带、Key 写错、Key 被停用,含可直接复制的诊断步骤。

GPT API 报 429 rate limit 到底怎么办:先分清限流、并发还是额度用光,再动手改代码

GPT API 报 429 rate limit 怎么排查:区分 RPM、TPM、并发和额度耗尽四类原因,附 curl 诊断命令、退避重试代码与速查表。

价格与成本(怎么算、怎么省)

2025 AI API价格大全(完整对比表)

2025年所有主流AI API的价格汇总对比表,Gemini/Claude/GPT/Grok/DeepSeek各模型完整定价,帮你选出性价比最高的方案。

AI API 成本优化实战方法论

AI API 成本优化方法论:按次与按量计费怎么换算、模型怎么分档、缓存与批量合并的边界在哪,附可直接复算的月度账单和监控告警脚本。

2025更划算的AI API推荐:省钱才是硬道理

想要更划算的AI API?Gemini/Claude/GPT哪个最省钱?本文对比各大模型价格,推荐性价比最高的API方案,帮你省到极致。

Claude API 2025最新价格完整指南

Claude API 2025最新价格一览,包括Claude Opus 4、Sonnet 4.6、Haiku 4.5各版本定价。国内用户怎么买最划算?

DeepSeek 全系按次价格怎么算:四个在售型号与 thinking 隐藏成本

DeepSeek 四款模型按次单价拆解:thinking 推理 token 的按量隐藏成本、批量任务月度预算与 Python 脚本。

Gemini 全系按次价格怎么算

小鱼API Gemini 全系按次价格拆解:三档 0.031/0.05/0.09 元每次怎么选,超长文档与生图成本逐项算清,最低 7 元起充。

GPT API 2025:最新价格与国内购买指南

OpenAI GPT API 2025最新价格,GPT-5/GPT-4收费标准,国内用户如何购买GPT API最划算?支付宝/微信均可。

Grok API 价格:grok-4.1 / 4.5 / 4.6 按次计费三档怎么选

小鱼API 按次计费:grok-4.1 每次 0.05 元,grok-4.5 / grok-4.6 每次 0.09 元,附三档价格表与升级判断方法。

AI API Token 成本怎么算:从单次请求到月度预算的完整算法

Token 成本怎么算?按量与按次两套算式、全系单价表、Python 计算脚本,附每天 150 次请求的月度成本细算。

开发接入与代码实战

AI API 并发控制怎么做:从 429 报错到信号量、令牌桶和自适应并发,一次讲清楚

用 asyncio.Semaphore、令牌桶和 AIMD 自适应并发摁住 429,附可直接运行的批量脚本与成本账。

Go 语言调用小鱼API:从最小示例到流式输出

Go 调用 AI API 的完整教程:标准库发请求、go-openai 库配置 base_url、SSE 流式输出完整代码、超时重试、并发控制与常见坑。

JavaScript/Node.js调用AI API完整教程

前端/Node.js开发者如何调用AI API?JavaScript接入Gemini、Claude、GPT的完整教程,适合Web开发者的AI API指南。

LangChain 接入小鱼API:从 ChatOpenAI 到 RAG 与 Agent

LangChain 接入小鱼API 教程:安装、ChatOpenAI 的 base_url 配置、流式与结构化输出、RAG 和 Agent 实战,附常见坑排查。

多 API Key 轮询与故障切换怎么实现?从 Key 池状态机到换 Key 重试的完整过程

多 API Key 轮询怎么做才不出错?Key 池状态机、冷却与 dead 标记、线程安全实现,附可直接运行的 Python 代码。

OpenAI SDK 迁移:只改 base_url 就能接入小鱼API

OpenAI SDK 迁移教程:只改 api_key 与 base_url 两处即可接入小鱼API,含 Python、Node.js 对比代码与报错排查。

Python调用AI API完全指南(附代码)

Python调用AI API的完整教程,从环境配置到实战代码,支持Gemini、Claude、GPT等主流模型,复制即用。

AI API 报错了到底要不要重试?指数退避加抖动,手写一个能直接套上去的 retry 装饰器

AI API 报错别急着重试:429、5xx、超时该退避重试,400/401/403/404/422 直接失败,附抖动、总时限与成本核算的完整代码。

AI API 流式输出(SSE)怎么正确实现:从 SDK 判空到 nginx 缓冲,一次讲透

流式输出卡住、中文乱码、回答一次性蹦出来,多是自己写的 SSE 解析或反向代理缓冲没配好,附可运行代码与排查表。

对比与评测(选型前先看这些)

2025年AI API全面对比:四大巨头谁与争锋?

2025年最热门的四大AI API全面对比:Google Gemini、Anthropic Claude、OpenAI GPT、xAI Grok。从性能、价格、适用场景多个维度评测。

Claude Opus 4深度评测:编程之王名副其实吗?

Claude Opus 4深度评测,实测编程能力、推理能力、中文支持。对比GPT-5和Gemini 3.1 Pro,看看适合什么场景。

Claude vs GPT 2025全面对比:哪个AI模型更适合你?

Claude Opus 4 vs GPT-5全方位对比:编程能力、推理能力、价格、中文支持、适用场景。看完就知道该选哪个。

DeepSeek 和 Claude 写代码到底选哪个?单文件、跨文件重构、bug 定位、agent 改多文件,一项一项实测给你看

DeepSeek 和 Claude 写代码逐项实测:单文件改动、跨文件重构、bug 定位、单元测试、agent 多文件的通过率与真实成本,直接给选型结论。

国产大模型API横评:六个型号到底该填哪个,价格、场景、并发实测一次讲透

六个国产大模型API逐项拆解:单价、thinking开销、适用场景、按次与按量计费成本对比、并发压测方法,附可直接运行的Python横评脚本与选型结论。

Gemini 3.1 Pro深度评测:多模态AI的新标杆

Gemini 3.1 Pro全面评测,重点测试多模态识别、推理能力、编程能力。国内用户如何接入Gemini API完整指南。

Gemini vs Claude:两大AI模型家族的全面对决

Google Gemini 3.1 Pro vs Anthropic Claude Opus 4全方位对比:多模态能力、价格、速度、中文支持,帮你选最合适的AI API。

Gemini 和 GPT 到底哪个适合你?从百万上下文、多模态到按次计费,一次算清楚

Gemini 和 GPT 到底选哪个:百万级上下文、多模态、结构化输出、按次计费成本逐项对比,附可运行脚本与接口报错排查。

GPT-5全面评测:OpenAI的新一代王者

GPT-5全面评测报告,实测编程、写作、推理、多模态能力。GPT-5比GPT-4强多少?值不值得升级?看完就知道。

GPT-5.5 和 Claude Opus 4 到底怎么选?按版本号和价格梯度一步步挑省钱方案

把同一份代码分别交给 GPT-5.5 和 Claude Opus 4,比延迟、比漏改、算清成本,直接告诉你怎么按版本号选。

Kimi 和 DeepSeek 的中文到底谁更能打?50 条任务盲评加价格算账,一次说清

同一套 50 条中文任务跑完 Kimi 与 DeepSeek 盲评,给出长文写作、实体抽取、中文推理的选型结论和真实价格对比。

客户端与平台部署(照抄配置即可)

浏览器扩展怎么接自己的 AI 接口:划词翻译和划词总结的配置、判据与踩坑全记录

讲清浏览器划词翻译、划词总结类扩展怎么接自己的 OpenAI 兼容接口:配置三项、能否自定义的判据、五个必踩坑、并发与成本。

Chatbox 怎么接上小鱼API?地址、密钥、模型名一次填对

从零把 Chatbox 接上小鱼API:API 域名填什么、sk- 令牌怎么粘、模型名手填,含移动端差异、参数调优与 401/404/429 报错对照表。

Cherry Studio 怎么接小鱼API:地址、密钥、模型三步填完就能用

Cherry Studio 添加 OpenAI 兼容提供方,填 https://xyuapi.top/v1 与 sk- 令牌,手填模型名并排查报错。

Cline + VSCode 怎么接 AI API:地址、Key、模型一次填对

VSCode 里 Cline 插件接入 AI API 的完整配置:Base URL、Key、Model ID、上下文窗口怎么填,Plan/Act 与报错排查。

Cursor编辑器接入AI API完整教程

Cursor编辑器中接入Claude、Gemini、GPT等AI API的详细配置教程,提升代码效率,国内开发者适用。

Dify 配置小鱼API:docker 部署到模型接入全流程

Dify 自托管部署与模型配置教程:docker compose 启动、.env 关键项、界面填写 OpenAI 兼容供应商,附知识库、工作流与报错排查要点。

FastGPT 配置小鱼API:docker 部署与模型接入

FastGPT 自托管部署与模型配置教程:docker 命令、覆盖配置、界面添加 OpenAI 兼容渠道、知识库检索调优与常见报错处理。

LobeChat 怎么接小鱼API:接口代理地址、密钥、模型名一次填对

LobeChat 填接口代理地址 https://xyuapi.top/v1 与 sk- 令牌,讲清 /v1 写法、模型 ID 报错与 Docker 环境变量。

手机端 AI 客户端怎么接自定义 OpenAI 兼容接口?四个值填对就能用

手机上把 AI 客户端接上小鱼API:四项参数照抄、自定义入口怎么找、/v1 带不带、输入法与代理导致的 401/404 全给报错原文。

NextChat 接入小鱼API:Docker 与环境变量配置全流程

NextChat接入小鱼API的完整配置教程:Docker环境变量、自定义接口手填、CUSTOM_MODELS写法与常见报错。

Obsidian 笔记怎么接上 AI API?插件填自定义 OpenAI 接口的完整配置步骤

Obsidian 没有内置 AI,得靠社区插件。本文给出可直接照抄的接口地址、令牌、模型名,讲清插件自动补 /v1 的坑、报错原文和按次计费。

Open WebUI 怎么接小鱼API:管理员面板加连接、环境变量、报错排查一次讲完

Open WebUI 填 https://xyuapi.top/v1 加令牌接上模型,讲清连接配置、环境变量与报错排查。

RooCode + VSCode 怎么接 AI API:地址、Key、模型一步步填

Roo Code 插件接小鱼API:Base URL、Key、Model ID 怎么填,Profile 档案与 Modes 分模型配置,附报错对照。

平台选择与密钥安全

API Key安全指南:泄露检测与最佳实践

API Key泄露是严重的安全风险。本文教你如何保护API Key、检测泄露、紧急处理步骤,以及密钥安全管理的最佳实践。

AI API中转服务评测:国内调用AI的桥梁

AI API中转服务评测,国内使用AI API的最佳方案。对比价格、速度、稳定性,推荐最靠谱的API中转平台。

AI API聚合平台推荐:选对平台省心又省钱

2025年最全AI API聚合平台(中转站)推荐对比。从价格、稳定性、模型覆盖、支付便捷度等维度深度评测,帮你选到靠谱平台。

2025年最好的AI API平台怎么选?

推荐2025年最好的AI API聚合平台,一站式接入Gemini、Claude、GPT、Grok等主流模型,国内直连,稳定访问。

2025年免费AI API大盘点(省流版)

2025年免费AI API大盘点!Gemini免费额度、Claude免费额度、各种免费试用方案汇总,以及免费API的注意事项。

应用场景实战(拿去就能用)

AI API的10个实用场景(附代码)

AI API的实际应用场景大全,从智能客服到代码生成,从内容创作到数据分析,每个场景都附调用示例。

用 AI API 批量处理 10 万条文本:一份能断点续跑、撞了 429 也能自己缓过来的完整脚本

用 ThreadPoolExecutor 并发调 AI API 批量处理文本,附断点续跑、失败重试、切块与成本核算脚本。

用 AI API 做代码审查自动化:从 git diff 到 PR 评论的完整脚本

用 AI API 做代码审查自动化:git diff 取变更、结构化输出、GitHub Actions 评论与真实成本算例,附完整可运行脚本。

把 AI 客服机器人接到自己网站上(完整代码 + 成本核算)

手把手把AI客服机器人接到自己网站上:完整后端与前端代码、转人工触发规则、防乱说话约束,以及每天真实花费核算,复制即可运行。

用 AI API 把一堆脏数据洗成结构化表格:规则先上、AI 兜底、成本算清楚

用 Python 调 AI API 做数据清洗与结构化抽取,含规则先清洗、JSON Schema 抽取、断点续跑与按次计费成本核算。

文档问答(RAG)怎么接 AI API:从 PDF 解析到可运行代码

从PDF解析、切块到检索和问答接口,给出可直接运行的RAG完整代码,并算清每天500次提问的真实成本。

常见问题

小鱼API 的指南内容是原创吗?

是。本站指南共 82 篇,均由实际接入过程整理,包含真实价格、可运行示例代码与踩坑记录,不使用模板批量生成。

指南里的价格是实时的吗?

指南里的价格用于横向对比,可能滞后;实时价格与库存以产品中心页面为准。

接入需要海外信用卡或代理吗?

不需要。小鱼API 提供国内直连的 OpenAI 兼容接口,付款支持支付宝与微信,无需海外信用卡,也不需要任何代理工具。

🚀 想直接上手?注册小鱼API,最低 7 元起充

查看全部产品

支持 Gemini / Claude / GPT / Grok / DeepSeek · 国内直连 · 支付宝/微信