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

# 快速开始：3 步完成接入即刻API，迁移 OpenAI

> 即刻API完全兼容 OpenAI SDK，3 步快速接入：注册获取 API Key，更新 Base URL，运行现有代码即可调用 GPT-5、Claude 等大模型。

本页将引导您在 5 分钟内完成从 OpenAI 到 即刻API 的迁移。即刻API 与 OpenAI SDK 完全兼容——您只需更改 Base URL 和 API Key，无需重写任何代码，即可通过统一端点访问 GPT-5、Claude、Gemini 等主流大模型。

***

## 3 步完成接入

<Steps>
  <Step title="获取 API Key">
    访问 [https://geekapis.com](https://geekapis.com) 注册账号。注册完成后，前往[控制台 Dashboard](https://geekapis.com/dashboard/overview) 创建您的 API Key。

    请妥善保管您的 API Key，不要将其提交到公开的代码仓库中。
  </Step>

  <Step title="更新 Base URL">
    将您项目中原有的 OpenAI Base URL 替换为 即刻API 端点：

    ```text theme={null}
    https://geekapis.com/v1
    ```

    * **Python**：将 `base_url` 参数改为 `"https://geekapis.com/v1"`
    * **Node.js**：将 `baseURL` 参数改为 `'https://geekapis.com/v1'`
    * **其他语言**：同样只需修改对应的 Base URL 配置项

    您现有的 SDK 集成无需其他修改即可正常工作。
  </Step>

  <Step title="测试端点">
    使用以下 cURL 命令快速验证您的配置是否正确：

    ```bash theme={null}
    curl https://geekapis.com/v1/chat/completions \
      -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "claude-sonnet-4-6",
        "messages": [{"role": "user", "content": "你好，请介绍一下你自己"}]
      }'
    ```

    收到正常响应后，说明您已成功接入 即刻API。接下来可以在控制台 Dashboard 中查看延迟、用量和速率限制情况。
  </Step>
</Steps>

***

## 完整代码示例

<CodeGroup>
  ```python Python theme={null}
  from openai import OpenAI

  client = OpenAI(
      api_key="sk-xxxxxxxxxxxxxxxx",
      base_url="https://geekapis.com/v1"
  )

  response = client.chat.completions.create(
      model="claude-sonnet-4-6",
      messages=[{"role": "user", "content": "你好，请介绍一下你自己"}]
  )

  print(response.choices[0].message.content)
  ```

  ```javascript Node.js theme={null}
  import OpenAI from 'openai';

  const client = new OpenAI({
    apiKey: 'sk-xxxxxxxxxxxxxxxx',
    baseURL: 'https://geekapis.com/v1'
  });

  const response = await client.chat.completions.create({
    model: 'claude-sonnet-4-6',
    messages: [{ role: 'user', content: '你好，请介绍一下你自己' }]
  });

  console.log(response.choices[0].message.content);
  ```

  ```bash cURL theme={null}
  curl https://geekapis.com/v1/chat/completions \
    -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "claude-sonnet-4-6",
      "messages": [{"role": "user", "content": "你好，请介绍一下你自己"}]
    }'
  ```
</CodeGroup>

***

## 身份认证

所有 API 请求均需通过 HTTP 请求头携带 API Key 进行身份认证：

```text theme={null}
Authorization: Bearer YOUR_API_KEY
```

请将 `YOUR_API_KEY` 替换为您在控制台中创建的实际 Key。建议通过环境变量（如 `TOAPIS_API_KEY`）管理 Key，避免硬编码在代码中。

***

## 支持的模型

即刻API 支持数十种主流大模型，包括：

* **聊天模型**：GPT-5、Claude Sonnet/Haiku、Gemini 系列、DeepSeek、Qwen 等
* **图像生成**：GPT-4o Image、Flux 系列、Gemini 图像模型等
* **视频生成**：Sora 2、VEO3、Kling 系列等

模型列表根据您的 API Key 权限动态过滤。您也可以通过 API 查询当前 Key 可用的模型：

```bash theme={null}
curl https://geekapis.com/v1/models \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx"
```
