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

# 调用 Global AI 接口：OpenAI、Claude 与 Gemini 格式

> 获取 Global AI 的 API 地址，使用 OpenAI SDK、Claude 与 Gemini 原生格式调用，并查看支持的接口端点列表。

Global AI 提供 OpenAI 兼容的 API 接口，同时支持 Claude 与 Gemini 原生格式。将平台地址作为 `base_url`，把 [令牌](/usage/tokens) 作为 `api_key`，即可开始调用。

## 操练场在线测试

操练场是控制台内置的在线测试工具，无需编写代码即可直接与模型对话，适合快速验证令牌与模型是否可用。

<Steps>
  <Step title="打开操练场">
    左侧导航点击「游乐场」，或直接访问 [https://globalai.vip/playground](https://globalai.vip/playground)。
  </Step>

  <Step title="选择模型">
    在页面右下方的模型选择器中选择要测试的模型。
  </Step>

  <Step title="发起对话">
    在输入框输入消息内容，点击发送。右侧对话区域会显示模型的回复结果。
  </Step>
</Steps>

<Tip>
  游乐场消耗的配额与代码调用相同，会记录在 [日志](/usage/logs) 里，方便对照真实用量。
</Tip>

## 获取 API 地址

<Steps>
  <Step title="复制 Base URL">
    访问平台首页，在页面中部找到 API Base URL 显示区域，点击复制按钮把地址复制到剪贴板，例如 `https://globalai.vip/v1`。
  </Step>

  <Step title="填入客户端">
    把复制的地址作为客户端或代码中的 `base_url`，配合令牌 Key 即可开始调用。
  </Step>
</Steps>

<Note>
  `base_url为https://globalai.vip/v1`
</Note>

## 代码示例

### Python（OpenAI SDK）

```python app.py icon=python theme={null}
from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxx",              # 平台颁发的令牌
    base_url="https://globalai.vip/v1",
)

response = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)
```

### 流式输出

```python stream.py icon=python theme={null}
from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxx",
    base_url="https://globalai.vip/v1",
)

stream = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[{"role": "user", "content": "用一句话介绍量子计算"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)
```

### JavaScript / Node.js

```javascript app.js icon=js theme={null}
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-xxxxxxxx",
  baseURL: "https://globalai.vip/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-5.6-sol",
  messages: [{ role: "user", content: "你好" }],
});

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

### Shell / curl

```bash chat.sh icon=terminal theme={null}
curl https://globalai.vip/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role": "user", "content": "你好"}]
  }'
```

### Claude 原生格式

```bash Claude icon=terminal theme={null}
curl https://globalai.vip/v1/messages \
  -H "x-api-key: sk-xxxxxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'
```

### Gemini 原生格式

```bash Gemini icon=terminal theme={null}
curl "https://globalai.vip/v1beta/models/gemini-3.7-flash:generateContent?key=sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Hello"}]}]
  }'
```

## 支持的接口端点

Global AI 兼容 OpenAI 生态最常用的接口。具体可用模型以控制台 [模型定价](/billing/pricing) 页面为准。

| 接口            | 路径                                            | 说明                  |
| ------------- | --------------------------------------------- | ------------------- |
| 聊天补全          | `POST /v1/chat/completions`                   | 对话生成，支持流式输出         |
| 文本补全          | `POST /v1/completions`                        | 传统补全接口              |
| 向量嵌入          | `POST /v1/embeddings`                         | 文本向量化               |
| 图像生成          | `POST /v1/images/generations`                 | 文生图                 |
| 图像编辑          | `POST /v1/images/edits`                       | 图像编辑                |
| 语音转文字         | `POST /v1/audio/transcriptions`               | Whisper 等           |
| 文字转语音         | `POST /v1/audio/speech`                       | TTS                 |
| 重排序           | `POST /v1/rerank`                             | 文档重排序               |
| Responses API | `POST /v1/responses`                          | OpenAI Responses 格式 |
| 实时对话          | `GET /v1/realtime`（WebSocket）                 | OpenAI Realtime API |
| Claude 消息     | `POST /v1/messages`                           | Anthropic 原生格式      |
| Gemini 生成     | `POST /v1beta/models/{model}:generateContent` | Google 原生格式         |
| 模型列表          | `GET /v1/models`                              | 查询可用模型              |

Global AI 提供余额查询接口，可用于自动化脚本或第三方看板。

```bash 余额查询 icon=terminal theme={null}
curl -X GET "https://globalai.vip/api/user/self" \
  -H "new-api-user: [你的用户ID，在个人资料用户名旁边的小数字即为ID]" \
  -H "Authorization: Bearer [在个人资料-安全-访问令牌 取得]" \
  -H "Accept: */*" \
  -H "Host: globalai.vip" \
  -H "Connection: keep-alive"
```

返回 JSON 中的 `quota / 500000` 字段即为当前帐户剩余额度。

## 常见错误

<AccordionGroup>
  <Accordion title="401 Unauthorized / invalid api key">
    检查令牌 Key 是否正确、是否已过期、是否被删除。可以在 [令牌管理](/usage/tokens) 里查看令牌状态。
  </Accordion>

  <Accordion title="403 Forbidden / model not allowed">
    令牌配置了模型限制或 IP 白名单，当前请求不满足限制。可以编辑令牌调整设置，或切换到符合限制的模型/网络环境。
  </Accordion>

  <Accordion title="余额不足">
    账户或令牌的剩余配额已用完。请到 [配额与充值](/billing/topup) 补充配额，或提高对应令牌的配额上限。
  </Accordion>

  <Accordion title="429 Too Many Requests">
    触发了平台限流。稍等片刻后重试，或降低并发度。
  </Accordion>
</AccordionGroup>


## Related topics

- [在 Dify 中接入 Global AI 作为模型提供商](/clients/dify.md)
- [欢迎](/index.md)
- [Global AI 令牌管理：创建、限额与安全保管](/usage/tokens.md)
- [Cherry Studio 接入 Global AI：Claude、GPT、Gemini 配置](/clients/cherry-studio.md)
- [Global AI 快速开始：从注册到首次 API 调用](/quickstart.md)