AINode 使用说明与接口文档
统一接入主流大语言模型、图片生成、语音与向量嵌入。三步极速接入，支持任意 OpenAI SDK 及常用客户端（NextChat、ChatBox、Cherry Studio、Cursor 等）。
网关参数与鉴权
兼容标准 OpenAI 协议规范，无需修改业务逻辑即可无缝切换接入点。
https://api.ainode.run/v1
兼容 OpenAI SDK 与各类第三方客户端填写的 API Base URL。
sk-ainode-••••••••••••••••
在用户中心创建的密钥，以 sk-ainode- 开头。
Bearer sk-ainode-xxxx
标准 HTTP Bearer 认证格式，放入请求头中。
OpenAI-Compatible & Anthropic-Compatible
支持 /v1/chat/completions、/v1/models、/v1/embeddings 等标准端点。
三步快速上手
只需短短几分钟，即可将全球前沿大模型能力接入你的应用或客户端。
常用客户端与工具配置
支持市面上几乎所有主流 AI 客户端与开发插件，开箱即用。
NextChat / ChatBox
在客户端设置中选择「OpenAI」服务商，填写接口地址与 API 密钥即可开始聊天。
Cherry Studio
设置中添加「OpenAI 兼容」供应商，填入 Base URL 与密钥，支持自动拉取模型列表。
Cursor / VS Code (Cline / Continue)
在 AI 设置中选择 OpenAI-Compatible，覆盖 Base URL 并填入 API Key，支持智能代码补全与 Agent 编程。
Claude Code CLI
原生支持 Anthropic 协议接入，终端设置环境变量直接启动：
Dify / FastGPT 知识库
添加模型供应商选择「OpenAI API-compatible」，填入 API 域名与 Key，快速构建企业级 RAG 应用。
常用开发语言集成
支持标准 OpenAI SDK 与 HTTP 请求，提供开箱即用的多语言调用示例。
curl https://api.ainode.run/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-ainode-your-api-key" \
-d '{
"model": "gpt-4o",
"messages": [
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello AINode!"}
],
"stream": false
}'支持的模态与特有接口
多模态能力全覆盖，满足文本生成、推理推导、图像创作、向量检索与语音交互全流程。
对话与文本补全
/v1/chat/completions支持 /v1/chat/completions。涵盖主流 GPT、Claude、DeepSeek、Qwen 等模型，支持流式传输与系统提示词注入。
深度推理与思考链
DeepSeek R1 / o1 / o3-mini支持 DeepSeek R1、o1、o3-mini 等推理大模型，原生返回 reasoning_content 思维链过程，助力高难度推导。
图像生成与创作
/v1/images/generations支持 /v1/images/generations。兼容 DALL-E 3、FLUX、Midjourney 等模型，按次固定扣费，实时生成高分辨率图片。
向量嵌入与重排序
/v1/embeddings支持 /v1/embeddings 与 /v1/rerank。提供 text-embedding-3、BGE、Jina 等高维向量模型，赋能私有知识库搜索与 RAG。
语音识别与语音合成
/v1/audio/*支持 /v1/audio/transcriptions (Whisper) 与 /v1/audio/speech (TTS)，实现精准语音转文字与逼真语音播报。
计费机制与额度规则
透明、严谨的毫秒级计费引擎，绝不透支、绝不漏计、杜绝资源浪费。
双余额体系（赠送额度 + 充值余额）
系统自动管理两套钱包：系统赠送额度（有有效期）与现金充值余额（永久有效）。调用产生消费时，优先扣除赠送额度；赠送额度用尽后自动扣除充值余额，确保服务无缝可用。
模型倍率与官方基准折扣
扣费金额 = 官方基准费率 × 模型倍率。倍率低于 1.0x 即享折扣（例如 0.8x 相当于八折）；加权专线与特惠渠道按广场公示倍率实时结算。
长上下文提示词缓存 (Prompt Caching)
支持 Prompt Caching 的模型在命中缓存时，输入 Token 享受高达 10% ~ 50% 的折后单价，大幅降低多轮长对话与代码审查成本。
流式断连自动止损
客户端网络中断或主动取消流式请求时，网关立即向底层上游发送取消信号，并仅按已生成的 Token 精确扣费，零额度浪费。
常见问题与排错指南
开发者与用户常见调用问题解答，帮助您快速定位并解决异常。
Q: 调用接口返回 401 Unauthorized 错误？
通常是因为 Authorization 请求头缺失、格式错误或 API Key 无效。请确认请求头为「Authorization: Bearer sk-ainode-...」，并检查 API Key 是否在控制台中处于启用状态且没有多余空格。
Q: 调用接口返回 402 Payment Required 或额度不足？
代表您的账户赠送额度和充值余额均已耗尽。请前往「套餐订阅」进行充值或续费，额度充值实时到账，完成后即可继续调用。
Q: 调用接口返回 404 Model Not Found？
说明请求的模型名称不存在或未配置对应渠道。请在「模型广场」中查找确切的模型代码（例如 gpt-4o, claude-3-7-sonnet, deepseek-v3, deepseek-r1），确保大小写与字符完全一致。
Q: 遇到 429 Rate Limit Exceeded 报错？
这表示您的调用触发了每分钟请求数 (RPM) 或每分钟 Token 数 (TPM) 限制。系统设计了自适应限流保护，建议在客户端加入指数退避重试，或联系平台客服提升并发配额。
Q: 调用大模型速度慢或超时怎么办？
大模型（尤其是长文本或复杂推理模型）耗时较长，建议开启流式输出（stream=true）以获得首字毫秒级响应体验。网关内置了多渠道自动重试与故障转移机制，上游节点异常时会自动切换。
准备好接入全球顶级 AI 模型了吗？
仅需几行代码，即可解锁 Claude 3.7、GPT-4o、DeepSeek R1 等百款前沿模型能力。