本指南将带你从零开始接入 OpenPAI,并在 5 分钟内得到第一个模型回复。
第一步:注册账号
打开浏览器访问 https://openp.ai,点击右上角 注册。
支持以下几种方式注册或登录:
- 邮箱 + 密码
- GitHub 账号(OAuth)
- Telegram 账号
- LinuxDO 账号
注册成功后,新用户会自动获得初始体验额度,可立即用于测试调用。
第二步:创建 API 密钥
登录控制台后,进入左侧菜单的 令牌(Tokens) 页面,点击 添加新的令牌。
填写如下字段:
| 字段 | 含义 | 建议 |
|---|
| 名称 | 仅用于自己识别 | 例如 my-app-prod |
| 额度 | 该令牌允许消耗的最大金额(填 -1 表示不限制) | 生产环境建议限定单令牌额度 |
| 过期时间 | 留空表示永不过期 | 临时测试可设置较短期限 |
| 模型范围 | 允许该令牌调用的模型(留空表示全部) | 按需收紧权限 |
sk-XXXXXXXXXXXXXXXX 的 API Key,请立即复制并妥善保管——刷新页面后将无法再次完整查看。
第三步:选择模型
OpenPAI 接入了 OpenAI、Anthropic、Google、DeepSeek、Qwen、Midjourney、Suno 等多家厂商的模型。
完整列表请参考 模型总览,或在控制台 模型 页面查询可用模型与计费倍率。
常用模型 ID 示例:
| 用途 | 模型 ID |
|---|
| 对话(性价比) | gpt-5.4-mini claude-haiku-4-5 gemini-3.1-flash-lite |
| 对话(高质量) | gpt-5.5 claude-opus-4-8 gemini-3.1-pro-preview gemini-3.5-flash |
| 推理 | gpt-5.5 o4-mini claude-opus-4-8 gemini-3.1-pro-preview |
| 文本嵌入 | text-embedding-3-small text-embedding-3-large gemini-embedding-2 |
| 图像生成 | gpt-image-2 dall-e-3 mj_imagine nano-banana-pro |
第四步:发出第一个请求
OpenPAI 默认兼容 OpenAI 协议,你只需要把官方 SDK 的 base_url 改为 https://openp.ai/v1,API Key 改为 OpenPAI 颁发的 sk- 密钥即可。
curl https://openp.ai/v1/chat/completions \
-H "Authorization: Bearer $OPENPAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "用一句话介绍 OpenPAI"}
]
}'
from openai import OpenAI
client = OpenAI(
api_key="sk-XXXXXXXXXXXXXXXX",
base_url="https://openp.ai/v1",
)
resp = client.chat.completions.create(
model="gpt-5.5",
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "用一句话介绍 OpenPAI"},
],
)
print(resp.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.OPENPAI_API_KEY,
baseURL: "https://openp.ai/v1",
});
const resp = await client.chat.completions.create({
model: "gpt-5.5",
messages: [
{ role: "system", content: "You are a helpful assistant." },
{ role: "user", content: "用一句话介绍 OpenPAI" },
],
});
console.log(resp.choices[0].message.content);
package main
import (
"context"
"fmt"
"github.com/sashabaranov/go-openai"
)
func main() {
cfg := openai.DefaultConfig("sk-XXXXXXXXXXXXXXXX")
cfg.BaseURL = "https://openp.ai/v1"
client := openai.NewClientWithConfig(cfg)
resp, err := client.CreateChatCompletion(context.Background(),
openai.ChatCompletionRequest{
Model: "gpt-5.5",
Messages: []openai.ChatCompletionMessage{
{Role: openai.ChatMessageRoleUser, Content: "用一句话介绍 OpenPAI"},
},
})
if err != nil {
panic(err)
}
fmt.Println(resp.Choices[0].Message.Content)
}
{
"id": "chatcmpl-...",
"object": "chat.completion",
"created": 1715750400,
"model": "gpt-5.5",
"choices": [
{
"index": 0,
"message": { "role": "assistant", "content": "OpenPAI 是一个统一接入主流大模型的 API 网关。" },
"finish_reason": "stop"
}
],
"usage": { "prompt_tokens": 27, "completion_tokens": 19, "total_tokens": 46 }
}
下一步
模型与计费
详细的 Token / 倍率 / 缓存计费机制。
客户端集成
在 Cherry Studio、Cursor、Dify 等工具中接入。
