开发者接入文档

欢迎使用 OpenIPOS 全球大模型算力网关。我们提供完全兼容 OpenAI API 格式的通用接口，您可以使用现有的任意 OpenAI SDK (Python/Node.js/Java 等) 无缝接入全世界最聪明的 AI 模型。

核心优势：万剑归宗。 您无需再去阅读不同厂商的文档。在 OpenIPOS，所有的模型调用规则完全一致，您只需要修改请求中的 model 参数即可瞬间切换底层算力池。

基础端点 (Base URL)

所有的 API 请求都应发送至以下根地址：

Endpoint 
https://api.openipos.com/v1

获取认证令牌 (API Key)

请登录 OpenIPOS 控制台，进入左侧 「令牌管理」 菜单，添加并复制您的密钥。在发起请求时，请将其放入 HTTP Header 中：Authorization: Bearer sk-xxxx。

💻 代码接入示例

由于协议完全兼容，迁移工作仅需几秒钟。我们以最主流的两种语言为例：

Python

python 
import openai

client = openai.Client(
    api_key="您的_sk_密钥", 
    base_url="https://api.openipos.com/v1" 
)

response = client.chat.completions.create(
    model="claude-3-5-sonnet", 
    messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)

Node.js

javascript 
import OpenAI from 'openai';

const client = new OpenAI({
    apiKey: '您的_sk_密钥',
    baseURL: 'https://api.openipos.com/v1'
});

const chat = await client.chat.completions.create({
    model: 'gpt-4o',
    messages: [{ role: 'user', content: 'Hi!' }],
});

🧠 模型名称对照表

在请求时直接传入以下 model 参数即可。更多模型请查看「模型广场」。

提供商model 参数推荐场景
OpenAIgpt-4o最强多模态能力与逻辑推理
Anthropicclaude-3-5-sonnet代码编写与自然语言理解
DeepSeekdeepseek-chat极致性价比，国产之光
Googlegemini-1.5-pro超长上下文处理
阿里通义qwen-max中文指令遵循与专业领域应用

💰 计费与并发说明

Token 计费： 系统根据请求和回复的总 Token 数量实时扣费。价格透明，余额永久有效。

并发优势： OpenIPOS 聚合了多条物理线路。即便官方 API 拥堵，我们的智能路由也会自动寻找最快通道，确保您的业务不中断。

🐛 常见错误码对照

状态码含义解决建议
401密钥错误请检查 sk- 令牌是否正确，或是否已在后台被禁用
402余额不足请前往控制台及时充值，以免影响生产调用
429并发超限降低调用频次，或联系客服提升通道并发额度
500+上游报错此时底层节点可能波动，网关会自动切换，请稍后重试