> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openp.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 快速开始

> 5 分钟内完成注册、创建密钥并发出第一个 API 请求

本指南将带你从零开始接入 OpenPAI,并在 5 分钟内得到第一个模型回复。

## 第一步:注册账号

打开浏览器访问 [https://openp.ai](https://openp.ai),点击右上角 **注册**。
支持以下几种方式注册或登录:

* 邮箱 + 密码
* GitHub 账号(OAuth)
* Telegram 账号
* LinuxDO 账号

<Tip>注册成功后,新用户会自动获得初始体验额度,可立即用于测试调用。</Tip>

## 第二步:创建 API 密钥

登录控制台后,进入左侧菜单的 **令牌(Tokens)** 页面,点击 **添加新的令牌**。

填写如下字段:

| 字段   | 含义                         | 建议               |
| ---- | -------------------------- | ---------------- |
| 名称   | 仅用于自己识别                    | 例如 `my-app-prod` |
| 额度   | 该令牌允许消耗的最大金额(填 `-1` 表示不限制) | 生产环境建议限定单令牌额度    |
| 过期时间 | 留空表示永不过期                   | 临时测试可设置较短期限      |
| 模型范围 | 允许该令牌调用的模型(留空表示全部)         | 按需收紧权限           |

保存后,系统会生成一个形如 `sk-XXXXXXXXXXXXXXXX` 的 API Key,**请立即复制并妥善保管**——刷新页面后将无法再次完整查看。

## 第三步:选择模型

OpenPAI 接入了 OpenAI、Anthropic、Google、DeepSeek、Qwen、Midjourney、Suno 等多家厂商的模型。
完整列表请参考 [模型总览](/models/overview),或在控制台 **模型** 页面查询可用模型与计费倍率。

常用模型 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-` 密钥即可。

<CodeGroup>
  ```bash cURL theme={null}
  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"}
      ]
    }'
  ```

  ```python Python (openai SDK) theme={null}
  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)
  ```

  ```javascript Node.js theme={null}
  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);
  ```

  ```go Go theme={null}
  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)
  }
  ```
</CodeGroup>

请求成功后将返回类似如下结构的 JSON:

```json theme={null}
{
  "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 }
}
```

## 下一步

<CardGroup cols={2}>
  <Card title="充值与额度" icon="wallet" href="/getting-started/top-up">
    了解充值方式、最低金额与发票申请。
  </Card>

  <Card title="模型与计费" icon="coins" href="/pricing/billing">
    详细的 Token / 倍率 / 缓存计费机制。
  </Card>

  <Card title="客户端集成" icon="puzzle-piece" href="/integrations/overview">
    在 Cherry Studio、Cursor、Dify 等工具中接入。
  </Card>

  <Card title="完整 API 参考" icon="code" href="/api-reference/introduction">
    全部接口字段、错误码与示例。
  </Card>
</CardGroup>