# 简介

[OpenKEY.Cloud](https://openkey.cloud/) 是一个 OpenAI API 反代服务，它可以让用户直接调用 OpenAI 的人工智能 API，而无需自行申请 OpenAI API 的额度。在用户调用 API 时，OpenKEY 会将请求转发至自己的账号池中，然后再通过 OpenAI 的官方 API 接口将请求发送至 OpenAI 的服务器进行处理。

本平台采用多机部署，通过负载均衡的方式访问多个渠道，不断检测更新账号池，实现了系统的高可用性以及稳定性。

### 系统架构图

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FPUWp153tOVsUAfhAVQD1%2Fopenkey.png?alt=media&amp;token=eece5428-b525-457a-90b8-c0a16ba0416d" alt=""><figcaption><p>openkey系统架构图</p></figcaption></figure>

### 支持模型、接口速率、模型定价 <a href="#zhi-chi-mo-xing" id="zhi-chi-mo-xing"></a>

<figure><img src="https://s3.xbqx.com/aliyun/ok_rate.png" alt=""><figcaption></figcaption></figure>

常见问题

{% content-ref url="/pages/aA96KTBg2ZZxox6ktcWl" %}
[常见问题](/help/qa)
{% endcontent-ref %}

### 关于我们

牛爷爷团队成立于[2022年12月11日](https://51buygpt.net/)，深耕ChatGPT AI生态圈，提供[社区支持](https://gptocean.com/)以及可靠的质量保证。

我们的产品：<https://docs.51buygpt.net/about>

Telegram频道：<https://t.me/s/niuyeyegpt>

联系我们：<support@gptocean.com>


# 定价

本节将介绍OpenKey ChatGPT接口服务的模型价格以及套餐价格。

#### 1. 模型价格

<figure><img src="https://s3.xbqx.com/aliyun/ok_rate.png" alt=""><figcaption></figcaption></figure>

查看价格：<https://openkey.cloud/pricing>

#### 2. 套餐价格

查看套餐：<https://openkey.cloud/topup>

**注1：Token消耗额度 = 分组倍率 x 模型倍率 x （用户输入 token 数 + 模型输出 token 数 x 补全倍率），其中分组倍率均为1；模型倍率即为上表所述。**

注2：本站 Token 的统一定价是 $0.002 / 1 千 Tokens，因此每 50 万 Tokens 价值为 1 美元。

注3：本站使用美元金额描述只是为了便于理解，实际计费以 Token 形式计价，后台日志界面会自动转换为美元显示。

注4：额度有效期为3个月，到期后将自动清零。请按需采购，如有问题，随时联系我们。

注5：请在已知晓平台计价方式后选择性购买，不理解以上备注没有关系，消费明细可在“[日志](https://openkey.cloud/log)”页面查看。

注6：模型 4.0 的价格较高，无特殊需求情况下，建议购买Plus订阅账号。购买链接（14天质保，售后无忧）：[https://shop.51buygpt.net/](https://shop.51buygpt.com/)&#x20;

注7：系统所有模型费率均会浮动调整，我们有义务提前通知说明，但保留最终解释权力。

详细价格比照，参考[价格页面](https://openkey.cloud/pricing)

🔗使用计算器估算你的项目成本：[OpenKey ChatGPT API 成本计算器](https://cost.openkey.cloud/)


# 发票、对公、合同相关

### 1、可以开发票么？

可以的，请联系客服，提供发票的抬头和相关公司信息。

<mark style="color:red;">**需要注意：**</mark>

1. 目前需要开发票，订单金额需要超过500元；
2. 目前需要开发票，请联系客服人工发货；
3. 网页下单，将不再支持开票；
4. 目前项目名称仅支持“信息技术服务”；
5. 暂时不支持提供明细清单，或换开发票；
6. 如有疑问，可下单前，联系客服提供发票样例。

### 2、支持对公汇款以及采购合同吗？

可以的，请联系客服。

对公汇款，我们在确认订单后，将提供对公账户，汇款后请联系客服，以便及时为您充值。

如果您需要采购，请先添加团队联系方式，之后详细描述您的需求以便拟定合同。

### 3、联系方式

客服微信1：**echo\_20245**

客服微信2：**fd-xiaoguai**


# API 接口

OpenKey完全兼容OpenAI接口协议，本节将介绍各个类别接口的调用方式，接口速率以及错误码。


# 支持模型

OpenKey接口已支持的模型

<figure><img src="https://s3.xbqx.com/aliyun/ok_rate.png" alt=""><figcaption></figcaption></figure>

详细页面：<https://openkey.cloud/pricing>

注意：部分模型由于官方速率限制，无法大量供应，因此未上线。关注我们TG频道：<https://t.me/s/niuyeyegpt>


# 对话模型 调用示例

**本文中，我们将介绍如何使用 Python 调用** [**OpenKEY**](https://openkey.cloud/) **提供的ChatGPT API接口来调用 ChatGPT 对话模型，包括使用 OpenAI 库和 HTTP requests原始JSON请求两种方式。**

#### 1. 使用 OpenAI 库调用 ChatGPT （流式输出）

**系统环境：**

> Python 3.8.10
>
> Name: openai Version: 0.27.8

**`pip install openai`**

```python
import openai

# openai.api_base = "https://api.openai.com/v1" # 换成代理，一定要加v1
openai.api_base = "https://openkey.cloud/v1" # 换成代理，一定要加v1
# openai.api_key = "API_KEY"
openai.api_key = "sk-JdKYK4xHHVF6b40A6e724a8e497c442cB1A2B44a1c4768B7"

for resp in openai.ChatCompletion.create(
                                    model="gpt-3.5-turbo",
                                    messages=[
                                      {"role": "user", "content": "证明费马大定理"}
                                    ],
                                    # 流式输出
                                    stream = True):
    if 'content' in resp.choices[0].delta:
        print(resp.choices[0].delta.content, end="", flush=True)
```

**实现效果如下：**

<figure><img src="https://gptocean.com/assets/files/2023-07-12/1689165825-698477-openkey-0.gif" alt=""><figcaption></figcaption></figure>

#### 2. 使用 HTTP requests 请求调用 ChatGPT

```python
import requests

# url = "https://api.openai.com/v1/chat/completions"
url = "https://openkey.cloud/v1/chat/completions"

headers = {
  'Content-Type': 'application/json',
  # 填写OpenKEY生成的令牌/KEY，注意前面的 Bearer 要保留，并且和 KEY 中间有一个空格。
  'Authorization': 'Bearer sk-JdKYK4xHHVF6b40A6e724a8e497c442cB1A2B44a1c4768B7'
}

data = {
  "model": "gpt-3.5-turbo",
  "messages": [{"role": "user", "content": "你好呀"}]
}

response = requests.post(url, headers=headers, json=data)

print("Status Code", response.status_code)
print("JSON Response ", response.json())
```

**实现效果如下：**

<figure><img src="https://gptocean.com/assets/files/2023-07-12/1689165843-25184-openkey-1.gif" alt=""><figcaption></figcaption></figure>

OpenKey完全兼容OpenAI接口协议，具体调用方法参考官方文档：

<https://platform.openai.com/docs/introduction>

本文中的python openai包过于老旧，新版调用方式已经更新：

{% content-ref url="/pages/Rh9Vvx1QizEt2a2BDKIb" %}
[Python示范代码（最新）](/api/oai146)
{% endcontent-ref %}


# 绘画模型 调用示例

**本文中，我们将介绍如何使用 Python 调用** [**OpenKEY**](https://openkey.cloud/) **提供的ChatGPT API接口来调用 ChatGPT 两个绘画模型，即 dall-e-2 和 dall-e-3。**

**系统环境：**

> Python 3.8.10
>
> Name: openai Version: 0.27.8

```python
import requests
import json

# DALL-E 2的接口地址
url = 'https://openkey.cloud/v1/images/generations'
# 您的API密钥
api_key = 'sk-xxxx'

# 请求头部
headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json',
}
# 请求的数据
payload = {
    "model": "dall-e-3",
    'prompt': '想象一个充满活力的科幻世界，这里是“牛爷爷的彩色星球”。中心是一个仁慈、智慧的牛爷爷形象，他的外观类似于传统的中国智者，身穿宇航服，周围环绕着五颜六色的星球和星云。这些星球光彩夺目，各具特色，有的覆盖着翠绿的森林，有的环绕着蓝色的海洋，还有的散发着神秘的紫色光芒。海报的背景是深邃的宇宙，点缀着繁星和迷人的星云。整个画面应该流露出一种未来科技与自然和谐共存的感觉，充满神秘和梦幻的氛围。牛爷爷的面容慈祥，目光深邃，仿佛在诉说着宇宙的奥秘和生命的多彩。',
    'n': 1,
    'quality': "hd",
    'size': '1792x1024'  # 修改这里
}

# 发送POST请求
response = requests.post(url, headers=headers, data=json.dumps(payload))

# 打印响应结果
print(response.json())
```

**终端输出如下：**

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FqCoFmiuDhAGaVQYLxfaL%2F2023-12-07_153911.png?alt=media&amp;token=cffde5d0-384f-4641-97ca-86c207594f92" alt=""><figcaption></figcaption></figure>

```
root@vmi1152840:/web/openai/models# python3 dall-e-3.py 
{'created': 1701934687, 'data': [{'revised_prompt': "Imagine a vibrant sci-fi world named 'Grandpa Bull's Colorful Planet'. At the center is a benevolent and wise figure resembling a traditional Chinese sage, portrayed as Grandpa Bull in a spacesuit. Surrounding him are multicolored planets and nebulae. These Heavenly bodies are visually striking, each distinct from the next. Some are covered in lush green forests, others are surrounded by blue oceans, while others radiate a mystical purple light. The backdrop of the image is the depths of space, sprinkled with stars and enchanting nebulae. The entire scene should exude a feeling of future technology and nature coexisting harmoniously, filled with a sense of mystery and a dreamy atmosphere. Grandpa Bull's face is kind, his eyes deep, as if narrating the secrets of the universe and the vibrancy of life.", 'url': 'https://oaidalleapiprodscus.blob.core.windows.net/private/org-T97RC5fx0Oy4oBPrCS3W7Yz1/user-3TT738PAhNgKOU9XICWYPJum/img-kQHy5qs6yMVdswY7nVabUZt0.png?st=2023-12-07T06%3A38%3A07Z&se=2023-12-07T08%3A38%3A07Z&sp=r&sv=2021-08-06&sr=b&rscd=inline&rsct=image/png&skoid=6aaadede-4fb3-4698-a8f6-684d7786b067&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skt=2023-12-07T02%3A11%3A02Z&ske=2023-12-08T02%3A11%3A02Z&sks=b&skv=2021-08-06&sig=dJBaxWuHcr0suSAEBdVW2nqRnPk/U0TJie9M8CqICmU%3D'}]}
```

**其中生成的图片效果如下：**

{% embed url="<https://oaidalleapiprodscus.blob.core.windows.net/private/org-T97RC5fx0Oy4oBPrCS3W7Yz1/user-3TT738PAhNgKOU9XICWYPJum/img-kQHy5qs6yMVdswY7nVabUZt0.png?st=2023-12-07T06%3A38%3A07Z&se=2023-12-07T08%3A38%3A07Z&sp=r&sv=2021-08-06&sr=b&rscd=inline&rsct=image/png&skoid=6aaadede-4fb3-4698-a8f6-684d7786b067&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skt=2023-12-07T02%3A11%3A02Z&ske=2023-12-08T02%3A11%3A02Z&sks=b&skv=2021-08-06&sig=dJBaxWuHcr0suSAEBdVW2nqRnPk/U0TJie9M8CqICmU%3D>" %}

OpenKey完全兼容OpenAI接口协议，具体调用方法参考官方文档：

<https://platform.openai.com/docs/introduction>


# 语音模型 调用示例

**本文中，我们将介绍如何使用 Python 调用** [**OpenKEY**](https://openkey.cloud/) **提供的ChatGPT API接口来调用 ChatGPT 语音模型，即 Whisper 和 TTS。**

**系统环境：**

> Python 3.8.10
>
> Name: openai Version: 0.27.8

#### 1. Whisper 模型

Whisper 模型主要功能为转录和翻译，它们可以用于：

* 将音频转录为任何语言。
* 将音频翻译并转录成英语。

目前文件上传限制为 25 MB，并支持以下输入文件类型：mp3、mp4、mpeg、mpga、m4a、wav 和 webm。

{% hint style="info" %}
注意：接口返回格式仅支持json格式，其他尚未适配调用会报错。
{% endhint %}

**1.1 音频转文本**

```python
# 音频转文本
import requests

headers = {
    'Authorization': f'Bearer sk-xxxx', # 注：key为OpenKey创建的令牌
}
url = "https://openkey.cloud/v1/audio/transcriptions" # 注意这里是/transcriptions
file_path = r"./src/voice_250.mp3"  # 文件地址
files = {'file':open(file_path, "rb")}
query = {
            "model":"whisper-1",
            "language":"zh",  # 简体汉语
            "response_format":"json", # 注意：OpenKey接口目前仅支持json一种格式，否则会报错
        }
response = requests.post(url=url, data=query,files=files, headers=headers)
print(response.text)
```

终端输出如下：

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FZxnTs4NTicW64jHqWcwZ%2F2023-12-07_155021.png?alt=media&amp;token=c267ed04-1cd7-4564-94b0-a805d8edc2cb" alt=""><figcaption></figcaption></figure>

**1.2 音频转英文**

```
# 音频转英文
import requests

headers = {
    'Authorization': f'Bearer sk-xxxx', # 注：key为OpenKey创建的令牌
}
url = "https://openkey.cloud/v1/audio/translations" # 注意这里是/translations
file_path = r"./src/voice_250.mp3" # 文件地址
files = {'file':open(file_path, "rb")}
query = {
            "model":"whisper-1",
            "response_format":"json", # 注意：OpenKey接口目前仅支持json一种格式，否则会报错
            "prompt":"This is English"
        }
response = requests.post(url=url, data=query,files=files, headers=headers)
print(response.text)
```

终端输出如下：

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FnJjecUhkHV4Fesvb54BH%2F2023-12-07_155444.png?alt=media&amp;token=6a1a1963-e5fe-4bfe-a2f8-2a6860dd5c12" alt=""><figcaption></figcaption></figure>

#### 2. TTS 模型

TTS 模型主要的功能是将文字转语音，具体模型有以下两个：

* **tts-1**: 这是最新的TTS模型，主要针对实时文本转语音使用案例进行了性能优化，速度更快。
* **tts-1-hd**: 与tts-1类似，但更注重语音质量，适用于对语音质量要求更高的场景。

```python
import requests
import json

headers = {
    'Authorization': f'Bearer sk-xxxx', # 注：key为OpenKey创建的令牌
    'Content-Type':'application/json'
}
url = "https://openkey.cloud/v1/audio/speech"
input_text = "《三国演义》以东汉末年三国时期为背景，展现了刘备、关羽、张飞等英雄豪杰的壮丽故事。他们桃园结义，共同抵抗董卓、曹操等反动势力，最终形成了三足鼎立的局面。小说描写了忠义仁爱、智勇双全的形象，同时也展现了权谋斗争和人性的复杂性。《三国演义》是一部具有高历史价值和文学艺术价值的作品，塑造了许多永垂史册的英雄形象，对中国传统文化产生了深远影响。"
query = {
            "model":"tts-1-hd",
            "input":input_text,
            "voice":"alloy",
            "response_format":"mp3",
            "speed":1,
        }
response = requests.post(url=url, data=json.dumps(query), headers=headers)
# 保存文件
f = open("./src/tts-1-hd.mp3", "wb")
f.write(response.content)
f.close()
```

**实现效果如下：**

{% embed url="<https://terobox.oss-cn-hongkong.aliyuncs.com/openkey/tts-1-hd.mp3>" %}

OpenKey完全兼容OpenAI接口协议，具体调用方法参考官方文档：

<https://platform.openai.com/docs/introduction>


# 速率限制

OpenKey普通用户分组使用共享账号池，采用资源抢占型策略。速率限制以账户为标准，而非创建的APIKEY/Token。标准速率如下：

<figure><img src="https://s3.xbqx.com/aliyun/ok_rate.png" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
不会因为创建的令牌数量增加，而实现速率增加。每个账户的速率限制是固定的。
{% endhint %}

以上仅仅是理论上分配到的速率，实际的峰值速率可以达到标准速率的 2 倍。需要注意，请避免长时间占用峰值速率，可能会导致拉入黑洞池、IP短暂封禁等情况。

如果需要较高速率，请联系客服开通专享账号池。OpenKey提供高度定制化的服务，多级部署，DNS负载均衡等架构策略保证了系统的稳定运行。


# 错误代码

接口返回状态码对照表，错误码参考

<table><thead><tr><th width="176">错误代码</th><th>代码描述</th></tr></thead><tbody><tr><td>400 Bad Request</td><td>请求格式或请求参数不正确。这通常意味着你的请求参数或者语法有误，需要你检查并修正它后再次发送请求。</td></tr><tr><td>401 Unauthorized</td><td>API密钥无效或未提供。你需要检查你的API密钥是否正确使用，拥有权限并且未过期或者提供。</td></tr><tr><td>403 Forbidden</td><td>你是未授权访客。</td></tr><tr><td>404 Not Found</td><td>请求的资源未找到。你可能正在尝试访问一个不存在的端点。</td></tr><tr><td>413 Request Entity Too Large</td><td>请求体太大。你可能需要压缩/减小你的请求数据量。</td></tr><tr><td>429 Too Many Requests</td><td>由于发送的同类请求太多的话，你已经超过了你的连接限额。</td></tr><tr><td>500 Internal Server Error</td><td>服务器内部错误。这可能是由于服务器发生的问题，不是你的问题。</td></tr><tr><td>503 Service Unavailable</td><td>服务器暂时不可用。这可能是由于临时服务器维护/停机等服务器原因导致。</td></tr></tbody></table>


# 查询令牌余额（已废弃）

> <mark style="color:$warning;">当前端口已停止维护，请查看新版接口：</mark>[查询余额](/tool/balance)

#### 接口信息

* **接口路径**：`/api/token`
* **请求方法**：POST
* **部署地址**：`https://billing.openkey.cloud/api/token`

[注意：v1通道用户，接口路径为 /api/v1/token](#user-content-fn-1)[^1]

#### 请求参数

* **api\_key** (string): 用户的API令牌。

#### 请求示例

使用curl进行请求：

```bash
curl -X POST -H "Content-Type: application/json" -d '{"api_key":"your_api_key_here"}' https://billing.openkey.cloud/api/token
```

#### 响应格式

接口将返回JSON格式的响应。

**成功响应**

* **Status** (int): 状态码，1表示成功。
* **Total** (float): 令牌的总额度。
* **Used** (float): 已使用的金额。
* **Remaining** (float): 剩余的金额。

示例：

```json
code{
    "Remaining": 2.0,
    "Status": 1,
    "Total": 2.52949,
    "Used": 0.529906
}
```

**错误响应**

* **Status** (int): 状态码，0表示错误。
* **Error** (string): 错误信息。

示例：

```json
code{
    "Error": "查询失败，API Key已失效或不存在",
    "Status": 0
}
```

#### 错误处理

* 如果未输入API Key，将返回400状态码和错误信息。
* 如果API Key无效或不存在，将返回错误信息。

Web查询面板：<https://billing.openkey.cloud/>

[^1]:


# Anthropic Claude 模型

<figure><img src="https://terobox.oss-cn-hongkong.aliyuncs.com/openkey/claude-poster.png" alt=""><figcaption><p>OpenKey.Cloud Claude Poster</p></figcaption></figure>

### 1. 公告

2024年5月9日，OpenKey.Cloud 试验性支持Anthropic旗下Claude 3系列模型，具体如下：

> **Claude 3 Opus : `claude-3-opus-20240229`**
>
> **Claude 3 Sonnet : `claude-3-sonnet-20240229`**
>
> **Claude 3 Haiku : `claude-3-haiku-20240307`**

### 2. 价格/速率

<figure><img src="https://terobox.oss-cn-hongkong.aliyuncs.com/openkey/claude-price.png" alt=""><figcaption><p>price</p></figcaption></figure>

### 3. 使用方法

#### 3.1 配合 OpenKey 内置对话工具使用

第一步，访问工具网址：<https://openkey.cloud/chat> 或者 [https://chat1201.openkey.cloud](https://chat1201.openkey.cloud/)

第二步，输入OpenKey的API令牌，如下图：

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FfmtnKhzCwTd79EG3D5fi%2F2024-05-09_220739.png?alt=media&amp;token=01051f0c-ddd1-41bb-83c7-7293493eee59" alt=""><figcaption><p>输入令牌</p></figcaption></figure>

第三步，选择Claude模型，如下图：

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FPwvZdNCihi6ZJxOUsmmZ%2F2024-05-09_220709.png?alt=media&amp;token=d3a38032-731e-4d12-a057-9cc4d734e5f3" alt=""><figcaption><p>选择模型</p></figcaption></figure>

第四步，开始对话，如下图：

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FmPsOBTkAYVr61g2OLvIX%2F2024-05-09_221925.png?alt=media&amp;token=d2ca6972-02b2-45e0-a6f4-d6cad1da86ad" alt=""><figcaption><p>开始对话</p></figcaption></figure>

#### 3.2 配合 Chatbox 使用图片分析功能

第一步，访问：[https://web.chatboxai.app](https://web.chatboxai.app/)

第二步，选择 OpenAI API 接口模式，填入OpenKey的接口地址，再输入OpenKey的API令牌。如下图：

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FM6XWeI7jeIcZYfJDw3Hg%2F2024-05-09_222658.png?alt=media&amp;token=b9336b46-310e-414e-84b5-9d89ef26a17d" alt=""><figcaption><p>Chatbox</p></figcaption></figure>

注意，OpenKey.Cloud Claude 模型采用 OpenAI 接口协议调用，而非 Anthropic Claude 原有接口协议，所以这里选择OpenAI API。

第三步，选择Custom Model 自定义模型名称，输入你需要调用的模型，点击Save保存。如下图：

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FtEC0dWg158Y4hwtqFLQo%2F2024-05-09_222920.png?alt=media&amp;token=8330e99d-6914-4ab5-820d-e873131d61ad" alt=""><figcaption><p>自定义模型</p></figcaption></figure>

第四步，开始对话，这里上传一个BTC的价格图表让Claude来预测未来走势，如下图：

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FG30MWNsd6pYxglRk1CRQ%2F2024-05-09_223305.png?alt=media&amp;token=d34497a8-1888-4860-8c41-2aa6562707d5" alt=""><figcaption><p>Chatbox Claude对话</p></figcaption></figure>

#### 3.3 Python代码调用

请完全参考OpenAI接口协议进行调用，而非Claude官方。代码示例如下：

```python
import requests

url = "https://openkey.cloud/v1/chat/completions"

headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Bearer sk-e9EBGCdh5r1bqFx20eB8Fb8e3e194fFaAdE16c5e83033612'
}

data = {
  "model": "claude-3-haiku-20240307",
  "messages": [{"role": "user", "content": "hi"}]
}

response = requests.post(url, headers=headers, json=data)

print("Status Code", response.status_code)
print("JSON Response ", response.json())
```

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FSxtf8cNpCoJ0a7z8o1FO%2F2024-05-09_223915.png?alt=media&amp;token=eafdf87a-98ea-42f7-9c28-1b858b1f740d" alt=""><figcaption><p>输出</p></figcaption></figure>

### 4. 注意

当前 Claude 系列模型仍处于试验阶段，无法保证稳定供应。如有特别稳定性/速率需求，请联系客服定制方案。

联系我们：<https://openkey.cloud/> 或者 <support@gptocean.com>


# Python示范代码（最新）

### 系统环境

> MacOS
>
> Python 3.9.6
>
> OpenAI 1.46.0

### 演示代码

```python
from openai import OpenAI

client = OpenAI(api_key="sk-xxxx", base_url="https://openkey.cloud/v1")

completion = client.chat.completions.create(
    model="gpt-3.5-turbo",
    stream=False,
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"}
    ]
)

print(completion.choices[0].message)python
```

### 输出结果

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2F5BxXOkFnJxUtI7pnynlZ%2F%E6%88%AA%E5%B1%8F2024-09-18%2022.15.02.png?alt=media&amp;token=c8930484-4e32-4b7b-9c5d-07411e503450" alt=""><figcaption></figcaption></figure>


# 工具接口

本节将展示 OpenKey.Cloud 系统级别的 API 端口使用用例，路径通常以 `/v2` 开头。


# 查询余额

> 本节将介绍如何通过 OpenKey.Cloud 提供的系统内部 API 接口来查询**账号/令牌**的余额信息。
>
> ```bash
> # 查询账户余额
> GET /v2/account/balance
>
> # 查询令牌余额
> GET /v2/token/balance
> ```

***

### 1. 查询账号余额（Account Balance）

#### 请求

```
GET /v2/account/balance
Host: https://openkey.cloud
Authorization: Bearer {token}
Content-Type: application/json
```

**请求头（Headers）**

| 名称            | 必须 | 类型     | 说明                |
| ------------- | -- | ------ | ----------------- |
| Authorization | ✅  | string | Bearer token，用于鉴权 |
| Content-Type  | ✅  | string | 格式说明              |

#### 响应

```json
{
  "type": "account",
  "balance": {
    "remained_cash": 8161.976,
    "used_cash":     274584.265,
    "currency":      "USD"
  },
  "timestamp": 1762259843
}
```

**字段说明**

| 字段                     | 类型      | 说明                      |
| ---------------------- | ------- | ----------------------- |
| type                   | string  | 本次查询对象类型，应为 `"account"` |
| balance.remained\_cash | float64 | 可用余额（单位：USD）            |
| balance.used\_cash     | float64 | 已使用余额（单位：USD）           |
| balance.currency       | string  | 币种，一般为 `"USD"`          |
| timestamp              | int64   | Unix 秒级时间戳              |

***

### 2. 查询令牌余额（Token Balance）

#### 请求

```
GET /v2/token/balance
Host: https://openkey.cloud
Authorization: Bearer {token}
Content-Type: application/json
```

**请求头（Headers）**

| 名称            | 必须 | 类型     | 说明                |
| ------------- | -- | ------ | ----------------- |
| Authorization | ✅  | string | Bearer token，用于鉴权 |
| Content-Type  | ✅  | string | 格式说明              |

#### 响应

```json
{
  "type": "token",
  "balance": {
    "remained_cash": 500.000,
    "used_cash":     0.000,
    "currency":      "USD"
  },
  "timestamp": 1762259865
}
```

**字段说明**

字段与“账号余额”一致，但 `type` 值为 `"token"`，表示查询的是当前令牌的余额。

***

### 3. 错误码与说明

* `401 Unauthorized`：鉴权失败或令牌非法。
* `429 Too Many Requests`：超过限流规则。
* `500 Internal Server Error`：服务器内部错误。
* `400 Bad Request`：请求头或参数有误。

***

### 4. 限流与使用说明

* 每个令牌每 60 秒最多允许 60 次调用，所有 `/v2` 共享容量，超出则返回 `429`。
* 保留 3 位小数显示余额，单位为 USD。

***

### 5. 示例 cURL

#### 查询账号余额

```bash
curl -H "Authorization: Bearer sk-XXXX" \
     -H "Content-Type: application/json" \
     https://openkey.cloud/v2/account/balance
```

#### 查询令牌余额

```bash
curl -H "Authorization: Bearer sk-XXXX" \
     -H "Content-Type: application/json" \
     https://openkey.cloud/v2/token/balance
```

***

### 6. 注意事项

* 确保 `Authorization` 使用正确的 Bearer token。
* 返回中的 `timestamp` 为客户端获取响应时的 Unix 秒级时间戳，可用于同步或对账。
* 余额数值保留 3 位小数，便于前端展示小额单位。


# 查询模型

本节将介绍如何通过 OpenKey.Cloud 提供的 API 接口来查询当前所支持的模型列表。

## 查询可用模型

GET /v1/models

#### 1. 查询可用模型 (List Models)

此接口用于获取当前令牌（`token`）可用的大语言模型列表。

**请求**

```http
GET /v1/models
Host: https://openkey.cloud
Authorization: Bearer {token}
Content-Type: application/json
```

**请求头（Headers）**

| Key             | Value                   | 描述                       |
| --------------- | ----------------------- | ------------------------ |
| `Host`          | `https://openkey.cloud` | API 服务器地址。               |
| `Authorization` | `Bearer {token}`        | 您的 API 令牌，`{token}` 需替换。 |
| `Content-Type`  | `application/json`      | 请求体格式。                   |

**响应**

```json
{
  "object": "list",
  "data": [
    {
      "id": "gpt-3.5-turbo",
      "object": "model",
      "created": 1706037600,
      "owned_by": "openkey.cloud"
    },
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1683758102,
      "owned_by": "openkey.cloud"
    },
    {
      "id": "gpt-5",
      "object": "model",
      "created": 1687882411,
      "owned_by": "openkey.cloud"
    }
  ]
}
```

**字段说明**

| 字段              | 类型      | 描述                         |
| --------------- | ------- | -------------------------- |
| `object`        | string  | 响应对象的类型，固定为 `list`。        |
| `data`          | array   | 包含模型对象的数组。                 |
| `data.id`       | string  | 模型的唯一标识符，可在 API 调用中直接使用。   |
| `data.object`   | string  | 模型对象的类型，固定为 `model`。       |
| `data.created`  | integer | 模型创建或引入平台的 Unix 秒级时间戳。     |
| `data.owned_by` | string  | 模型提供方，此处为 `openkey.cloud`。 |

#### 2. 错误码与说明

| 状态码                         | 说明         |
| --------------------------- | ---------- |
| `401 Unauthorized`          | 鉴权失败或令牌非法。 |
| `429 Too Many Requests`     | 超过限流规则。    |
| `500 Internal Server Error` | 服务器内部错误。   |
| `400 Bad Request`           | 请求头或参数有误。  |

#### 3. 限流与使用说明

* 每个令牌每 60 秒最多允许 60 次调用，所有 API 接口共享此限制，超出则返回 `429`。
* 此接口遵循 OpenAI 的 `v1/models` 格式，便于客户端兼容。

#### 4. 示例 cURL

**查询可用模型**

```bash
curl -H "Authorization: Bearer sk-XXXX" \
     -H "Content-Type: application/json" \
     https://openkey.cloud/v1/models
```

#### 5. 注意事项

* 确保 `Authorization` 请求头中使用的是正确的 `Bearer token`。
* 返回的模型列表是动态的，可能会随平台更新而增加或调整。建议客户端动态获取此列表。


# 使用说明

#### 本站接口支持市面上 90% 的 ChatGPT 应用，将官方接口地址替换成本站接口地址，再填入本站的API Key即可。 <a href="#ben-zhan-jie-kou-zhi-chi-shi-mian-shang-90-de-chatgpt-ying-yong-jiang-guan-fang-jie-kou-di-zhi-ti-hu" id="ben-zhan-jie-kou-zhi-chi-shi-mian-shang-90-de-chatgpt-ying-yong-jiang-guan-fang-jie-kou-di-zhi-ti-hu"></a>

> **本站接口地址（BASE\_URL）：**
>
> [**https://openkey.cloud**](https://openkey.cloud/)
>
> **令牌（API Key）：**
>
> **sk-09rSZn7f7QgUHtZ7Ff0e916a3bC6404392Dc20Abxxxxxxxx**

#### 详细教程如下： <a href="#xiang-xi-jiao-cheng-ru-xia" id="xiang-xi-jiao-cheng-ru-xia"></a>

第一步：若没有账号，请先注册并登录账号，也可以前往“[Box小铺](https://shop.terobox.com/)”或“[51BuyGPT](https://shop.51buygpt.com/)”直接购买。

第二步：在“[充值](https://openkey.cloud/topup)”页面输入兑换码（需要购买），获取Token额度。

第三步：在“[令牌](https://openkey.cloud/token)”页面点击“添加新的令牌”，设置名称、过期时间及额度（额度是指Token数，建议设置为无限额度）后点击提交，回到“令牌”页面，点击绿色的“复制”按钮，即可得到一串“sk-”开头的API Key。

第四步：使用令牌及接口

* 若用于开发场景，如 LangChain 等，接口使用方式与 OpenAI API 一致，仅需调整2步：第1步，修改API BASE URL，把原接口地址 [https://api.openai.com](https://api.openai.com/) 修改为本站的接口地址 [https://openkey.cloud](https://openkey.cloud/) ；第2步，把 API KEY 修改为 OpenKEY 平台生成的令牌KEY，即可正常调用API。
* 若用于网页对话网站（如ChatGPT Next），浏览器插件（如OpenAI Translator）及客户端（如ChatBox）等场景，把 API 调用接口的网址由 [https://api.openai.com](https://api.openai.com/) 更改为 本站的接口地址 [https://openkey.cloud](https://openkey.cloud/) ，再填入API Key（即令牌），选择模型即可。

最后，消费明细可在“[日志](https://openkey.cloud/log)”页面查看。

#### [代码示例：如何调用OpenKEY API实现ChatGPT对话 | Python代码](https://gptocean.com/d/1241) <a href="#dai-ma-shi-li-ru-he-tiao-yong-openkeyapi-shi-xian-chatgpt-dui-hua-python-dai-ma" id="dai-ma-shi-li-ru-he-tiao-yong-openkeyapi-shi-xian-chatgpt-dui-hua-python-dai-ma"></a>

### 适用网站 <a href="#kuo-yong-wang-zhan" id="kuo-yong-wang-zhan"></a>

**Web聊天平台**

51Buy对话网 - <https://vip.51buygpt.com/>

ChatBox - <https://web.chatboxai.app/>

以上仅列举部分，OpenKEY API完全兼容OpenAI接口协议，支持无缝对接各种支持OpenAi接口的应用。


# 如何充值

打开[**充值**](https://openkey.cloud/topup)页面，选择适合的套餐，点击跳转购买，之后你会获得一个套餐兑换码；

将兑换码填入上方的输入框内，点击兑换即可。

{% hint style="info" %}
注意：必须要使用兑换码兑换额度后，账户才会显示对应金额。
{% endhint %}

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FnWY97MPaf7t4f6grRZT9%2F2023-11-17_193341.png?alt=media&amp;token=22faaf57-609d-45f3-a5a2-e6c9c668e4f2" alt=""><figcaption></figcaption></figure>


# 如何使用兑换码

打开[**充值**](https://openkey.cloud/topup)页面，输入套餐兑换码，点击兑换。

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2Fgx7jWfwaGFkF0xpQI1rx%2F2023-11-18_065849.png?alt=media&amp;token=479490a2-8848-49d9-8c98-27679fce2f05" alt=""><figcaption></figcaption></figure>


# 额度有效期

OpenKey平台的充值额度自充值之日起有效期限为3个月。建议根据实际需求进行充值，避免不必要的损失。

自2024年4月12日起，此规定正式生效。对于4月12日之前已进行充值的用户，其额度的有效期将从4月12日起算的后三个月内有效。若有疑问，请及时联系客服。


# 如何创建令牌

打开[**令牌**](https://openkey.cloud/token)页面，点击添加新的令牌，输入令牌的名称、过期时间、额度。

{% hint style="info" %}
注意：额度的单位是tokens，可以按照$1.00 : 500,000 tokens来推出你需要设置的数量。
{% endhint %}

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FpItkUwbHdrNbBVpYSyeU%2F1-1.png?alt=media&amp;token=37dcbd5a-b4a9-4a9f-a102-95f6d14e8441" alt=""><figcaption><p>1-1</p></figcaption></figure>

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FOQqdwObvFZ4LBchbNFRv%2F1-2.png?alt=media&amp;token=ae99ac21-ee17-4589-ba38-844e4c9d27f6" alt=""><figcaption><p>1-2</p></figcaption></figure>

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FyBjs6KtIbiyJCuHv7Qbg%2F2023-10-24_223415.png?alt=media&amp;token=7d593662-0a0c-45a9-9a97-6fc56f73f2d0" alt=""><figcaption><p>1-3</p></figcaption></figure>

点击复制，即可复制对应的令牌，接口地址统一是：[https://openkey.cloud](https://openkey.cloud/chat)


# 注意事项

本节将讨论使用OK接口过程中，需要注意的事项

## 1.系统风控

OpenKey系统有严格的风控机制，任何滥用行为导致的封号、冻结、IP封禁、限制登录等等情况，我们将视作你违反了使用条例，并拒绝提供任何支持。

以下行为是你需要避免的：

#### 1.1 禁止发送大量非法请求

对接使用OpenKey接口的程序应该具备健壮性，当检测到接口无法处理请求的时候，可能是因为请求方法错误，可能是因为余额不足，都应该中断程序而不是继续发送大量的请求。针对这种情况，系统会首先尝试封禁IP。

如果出现IP被封禁的情况，请联系客服申请解封。

#### 1.2 禁止多线程长时间占用资源

如果你的程序长时间以峰值速率运行，将可能触发风控，拉进黑洞分组强制限制速率。

对速率有特殊要求的客户请联系客服，团队可以为你定制独享账号池，独享速率。

## 2.强制中断请求，时间限制100秒

请注意，OpenKey系统有个强制限制，请求响应的时间不得超过100秒。

如果你的问题需要GPT模型使用超过100秒的时间来处理，那么在它给你返回结果之前，这个请求将被OpenKey系统中断，并产生对应扣费。

这种情况通常出现在使用GPT-4模型的过程中，并且未采用流式传输。我们可以通过采用流式传输的方式来提前建立连接，接受返回数据，这样可以不受100秒的时间限制。

## 3.关于技术支持

OpenKey提供全天的售前售后技术支持，有任何问题可以联系我们。但是请注意，以下的问题我们将无法给到你帮助。客服不会回答你。

* VPN相关的工具推荐，教程使用；
* ChatGPT对话，对话窗口为人工客服，非GPT；
* 营销推广的垃圾广告；
* 无关平台业务的主题，以及帮助文档中已涵盖的问题。


# 常见问题

**1.支持开发票吗？**

支持的，详情见：

{% content-ref url="/pages/UfFgi8FAwmF0yliuHMXv" %}
[发票、对公、合同相关](/invoice)
{% endcontent-ref %}

**2.为什么令牌名称过长？**

减短名称。

**3.为什么显示余额不足？**

首先检查账户余额，这个页面查看：<https://openkey.cloud/topup>

如果余额充足，则需要查看令牌设置的额度，这个页面查看：<https://openkey.cloud/token>

如果账户余额和令牌余额都充足，仍然存在报错，请联系技术客服。

如果账户余额不足，请注意：你下单付款后，得到的仅仅是兑换码，需要前往充值页面兑换额度才可以。

**4.为什么我的历史日志不见了？**

系统会定期清理日志，通常1个月进行一次。

关注公告：<https://t.me/s/niuyeyegpt>

查看历史日志快照：<https://v2.openkey.cloud/>

**5.为什么我的余额和已用额度对不上？**

系统会定期清理日志，每次清理过后都会重置[日志页面](https://openkey.cloud/log)的已用额度。如果需要查询旧日志，请前往：<https://v2.openkey.cloud/>

**6.为什么我的余额突然归零/减少？**

请第一时间联系客服人员检查处理，同时停止正在调用接口的程序。原因可能是你的接口调用方法存在问题，导致隐形扣费。

**7.为什么我问 GPT-4 是哪个模型，它会说它是 GPT-3？**

首先，我们承诺 OpenKey 提供的所有模型均于官方对应，不存在弄虚作假。

GPT-4 这样回答是因为 GPT-4 并不知道它自己是哪个模型（除非你告诉它它是哪个模型），如果要测试的话，只能通过推理能力评估测试，可以通过问一些较为复杂的问题，和 GPT-3.5 进行对比，是可以明显看出这俩模型的差距的。

**8.充值的额度有效期多久？**

3个月。到期后将自动清零，如有问题请随时联系客服。


# 备用接口地址

近期，OpenKey主站接口地址在大陆局部地区出现了不稳定情况，原因在于地区运营商对域名实施了限制，而非OpenKey系统问题。

针对以上情况，我们部署了另外两个镜像网站/接口，域名如下：

> 备用接口：[https://openkey.red](https://openkey.red/)

备用接口的使用方法与主站接口完全相同，直接替换即可。需要注意的是，我们只对主站接口地址做了高可用性。如果你的业务对稳定性有较高的要求，请使用主站接口。

> 主站接口：[https://openkey.cloud](https://openkey.cloud/)

另外，通过代理人计划的接口也是可以使用OpenKey服务的，如下：

> 接口地址/查余额：[https://gegelv.com](https://gegelv.com/)
>
> 后台管理地址：[https://openkey.cloud](https://openkey.cloud/)

如果你在使用过程中遇到任何问题，请联系我们。


# 请求超时问题

由于 **openkey.cloud** 主站接入了 **Cloudflare CDN**，在网络边缘层会存在一个**强制请求超时上限**（通常在 **100–120 秒** 左右）。这意味着：当上游模型需要较长时间“思考/生成”时，请求可能会在到达上限时被 Cloudflare **直接中断**，即使模型端仍在处理，也可能出现 **报错但已扣费** 的情况（尤其是带推理/思考的模型，如 GPT-5、Gemini 2.5 等）。

为满足长耗时任务，我们提供了一个不经过 Cloudflare 的备用入口 **openkey.red**，用于尽可能避免 100–120 秒的边缘超时限制。

***

### 两个接入点的区别

#### 1) 主站点：`https://openkey.cloud/`

**特点**

* ✅ 高可用、自动故障迁移
* ✅ 更适合常规请求、稳定性优先的场景
* ⚠️ 受 Cloudflare 影响，存在 **100–120 秒强制超时中断**（请求可能被提前终止）

**适用场景**

* 大多数普通对话、短输出、低延迟调用
* 对可用性要求高、能接受“单次请求不要太久”的业务

***

#### 2) 备用站点（裸节点）：`https://openkey.red/`

**特点**

* ✅ 不走 Cloudflare CDN，**无 100–120 秒强制超时限制**
* ✅ 理论最大超时可到 **600 秒**（取决于你的客户端/网关/上游配置）
* ⚠️ 无高可用与自动迁移，若节点异常需要人工介入修复

**适用场景**

* 长文本生成、复杂推理、慢模型
* 单次请求可能超过 100 秒的任务（例如长链路 Agent、长报告、超长上下文等）

***

### 常见现象与报错

当你看到类似以下错误时，通常意味着请求在边缘层超时被中断：

* `524: A timeout occurred`
* `cf-error`
* 请求在 \~100–120 秒附近结束，但上游仍可能已处理/计费

如果你的业务确实需要更长处理时间，建议将该类请求切换到 **openkey.red**。

***

### 如何切换到 openkey.red

你只需要把“Base URL / Endpoint”从 `openkey.cloud` 换成 `openkey.red`：

* `https://openkey.cloud/` → `https://openkey.red/`

例如（OpenAI 兼容接口风格）：

```bash
curl https://openkey.red/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{
    "model": "gpt-5",
    "messages": [{"role":"user","content":"..."}]
  }'
```

> 你的客户端/SDK 也请同时检查自身的超时设置（例如 HTTP client timeout），避免客户端先于服务端超时。

***

### 用日志“耗时”栏目辅助判断是否需要切换

我们已在 OpenKey 的日志页面新增了 **“耗时”** 栏目（单位：秒）。你可以用它来快速判断：

* 如果耗时经常接近或超过 **100–120s**：建议将该类请求迁移到 `openkey.red`
* 如果耗时通常在几十秒内：继续使用 `openkey.cloud` 更合适（高可用 + 自动迁移）

***

### 建议的迁移策略

* **默认走 `openkey.cloud`**（高可用优先）
* 对“长耗时请求”做**分流**：
  * 例如：带思考/推理模型、长报告生成、长上下文任务 → `openkey.red`
  * 其余常规请求 → `openkey.cloud`

***

### 需要帮助？

如果你在切换或使用过程中遇到任何问题（例如仍超时、日志显示异常耗时、扣费与返回不一致等），请把**请求时间点**与**日志记录**发给我们，我们会协助定位与优化。


# 应用场景

本章节将介绍OpenKey ChatGPT API接口的应用场景，以帮助客户更好地学习使用ChatGPT接口。


# 在线对话工具

本节将介绍如何使用Web对话工具，配合使用OpenKey的接口进行ChatGPT对话。

对话网页：<https://chat.openkey.cloud/>

## 1. 创建令牌

请前往[令牌](https://openkey.cloud/token)页面，创建一个新令牌。

{% hint style="info" %}
注意：如果你是水龙头领取的令牌，请跳过这一步，领取的令牌是直接可以使用的。
{% endhint %}

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FpItkUwbHdrNbBVpYSyeU%2F1-1.png?alt=media&amp;token=37dcbd5a-b4a9-4a9f-a102-95f6d14e8441" alt=""><figcaption><p>1-1</p></figcaption></figure>

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FOQqdwObvFZ4LBchbNFRv%2F1-2.png?alt=media&amp;token=ae99ac21-ee17-4589-ba38-844e4c9d27f6" alt=""><figcaption><p>1-2</p></figcaption></figure>

## 2. 配置对话

打开[设置](https://chat.openkey.cloud/#/settings)页面，找到API KEY一栏，输入即可使用。

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FjwBx0q2Cq73GGHCJMvSA%2F2-1.png?alt=media&amp;token=6de3fa19-830a-4ec3-8428-809fabf15090" alt=""><figcaption><p>2-1</p></figcaption></figure>

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2F5jYbZI0Y2pgxKjtgerbc%2Fimage.png?alt=media&amp;token=3be6ec15-070d-48c0-b934-51596c338f75" alt=""><figcaption></figcaption></figure>

## 3. 开始对话

完成以上步骤后就可以正常对话了，快来试试吧。

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FXVTykpjTUUQ4dpnswUdj%2FVideo_2023-10-19_112444.gif?alt=media&amp;token=b8c38f44-d591-47d8-9d2a-adbf61d11a43" alt=""><figcaption><p>3</p></figcaption></figure>

OpenKey平台自2023年7月初开始运营，保持着99%的高可用性和稳定性，欢迎大家选购。

选购地址：<https://openkey.cloud/topup>

价格对照：<https://openkey.cloud/pricing>


# 沉浸式翻译

本节将介绍如何使用热门翻译工具——沉浸式翻译，配合使用OpenKey的接口进行翻译。

## 沉浸式翻译介绍

沉浸式翻译：最受欢迎的双语对照网页翻译插件

你可以完全免费地使用它来实时翻译外语网页，[PDF文档](https://immersivetranslate.com/docs/usage/#pdf-%E6%96%87%E4%BB%B6%E7%BF%BB%E8%AF%91)，[ePub 电子书](https://immersivetranslate.com/docs/usage/#epub-%E7%94%B5%E5%AD%90%E4%B9%A6%E9%98%85%E8%AF%BB%E5%92%8C%E5%8F%8C%E8%AF%AD%E5%AF%BC%E5%87%BA)，字幕文件等。

网站：<https://immersivetranslate.com/>

## 如何接入OK

OpenKey是一个无限调用 ChatGPT API 的账号池，提供企业级专业稳定的 ChatGPT 接口集成分发服务。完全兼容OpenAI接口协议，支持无缝对接多种支持自定义OpenAI接口的应用。

网站：<https://openkey.cloud/>

本节中的沉浸式翻译工具是支持自定义接口的，所以下面将介绍如何接入OK的接口。

### 第一步：下载Chrome插件

沉浸式翻译应用支持多种平台，这里以Chrome浏览器插件为例，其他的操作方法类比即可。

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2Fhpq8Jin4dzb2XsI7VR2F%2F2023-10-24_222516.png?alt=media&amp;token=edc5880a-81f2-4b82-8063-b9155ff99488" alt=""><figcaption><p>沉浸式翻译支持的平台</p></figcaption></figure>

### 第二步：创建OpenKey令牌

参考教程：

{% content-ref url="/pages/ppdmDVQZYBCoqmYx1WJX" %}
[如何创建令牌](/help/how-create-token)
{% endcontent-ref %}

这里我们获取到的OK接口信息如下：

> 接口地址：[https://openkey.cloud](https://openkey.cloud/chat)
>
> APIKEY/令牌：sk-iuzuDxad94QAQzm5D42280EdE45947858a0dA1355c11Fed

### 第三步：配置选项

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FF2VC25e4Cd1a3pevx6xJ%2F2023-10-24_222645.png?alt=media&amp;token=5cde9c03-d58f-4d9e-ac1e-7c03018c477f" alt=""><figcaption><p>打开设置</p></figcaption></figure>

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FCGydCpE1OlyAZi8ewoop%2F2023-10-24_222851.png?alt=media&amp;token=b5425474-e2f9-41c0-8fe3-79ee078de1f2" alt=""><figcaption><p>选择自定义API Key</p></figcaption></figure>

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FjukDnegxvSBUWV3e7ENj%2F2023-10-24_223132.png?alt=media&amp;token=fe973411-c7fe-4c33-9234-d4e6a285edd3" alt=""><figcaption><p>自定义接口</p></figcaption></figure>

按照以上箭头指引的操作，并填入对应的OK接口地址以及APIKEY。

### 效果展示

{% embed url="<https://terobox.oss-cn-hongkong.aliyuncs.com/openkey/translator_show.mp4>" %}

OpenKey接口购买地址：<https://openkey.cloud/topup>


# ChatBox

本节将介绍如何使用开源对话工具——ChatBox，配合使用OpenKey的接口进行对话。

## ChatBox介绍

Chatbox支持多种全球最先进的AI大模型服务，支持Windows、Mac和Linux。AI提升工作效率，深受全世界专业人士的好评。

网站：<https://chatboxai.app/zh>

## 如何接入OK

OpenKey是一个无限调用 ChatGPT API 的账号池，提供企业级专业稳定的 ChatGPT 接口集成分发服务。完全兼容OpenAI接口协议，支持无缝对接多种支持自定义OpenAI接口的应用。

网站：<https://openkey.cloud/>

本节中的ChatBox是支持自定义接口的，所以下面将介绍如何接入OK的接口。

### 第一步：访问ChatBox网页版

ChatBox支持多种平台，这里以Web网页版为例，其他的操作方法类比即可。

访问：<https://web.chatboxai.app/>

### 第二步：创建OpenKey令牌

参考教程：

{% content-ref url="/pages/ppdmDVQZYBCoqmYx1WJX" %}
[如何创建令牌](/help/how-create-token)
{% endcontent-ref %}

这里我们获取到的OK接口信息如下：

> 接口地址：[https://openkey.cloud](https://openkey.cloud/chat)
>
> APIKEY/令牌：sk-iuzuDxad94QAQzm5D42280EdE45947858a0dA1355c11Fed

### 第三步：配置选项

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FlRBqi9Ty2KfXfAhlzu7H%2F1.png?alt=media&amp;token=14a1d6e2-04bf-46fd-a442-5fbf1e31b405" alt=""><figcaption><p>chatbox配置</p></figcaption></figure>

按照以上箭头指引的操作，并填入对应的OK接口地址、APIKEY以及选择模型。

{% hint style="info" %}
注意：ChatBox是严格区分"/"符号的，请注意OK接口地址最后没有”/“。否则会报错。
{% endhint %}

### 效果展示

{% embed url="<https://terobox.oss-cn-hongkong.aliyuncs.com/openkey/chatbox.mp4>" %}
chatbox对话
{% endembed %}

OpenKey接口购买地址：<https://openkey.cloud/topup>


# 新版在线对话工具

本节将介绍如何使用新版Web对话工具，配合使用OpenKey的接口进行ChatGPT对话。

对话网址1：<https://openkey.cloud/chat>

对话网页2：<https://chat1201.openkey.cloud/>

## 1. 创建令牌

请前往[令牌](https://openkey.cloud/token)页面，创建一个新令牌。

{% hint style="info" %}
注意：如果你是水龙头领取的令牌，请跳过这一步，领取的令牌是直接可以使用的。
{% endhint %}

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FpItkUwbHdrNbBVpYSyeU%2F1-1.png?alt=media&amp;token=37dcbd5a-b4a9-4a9f-a102-95f6d14e8441" alt=""><figcaption><p>1-1</p></figcaption></figure>

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FOQqdwObvFZ4LBchbNFRv%2F1-2.png?alt=media&amp;token=ae99ac21-ee17-4589-ba38-844e4c9d27f6" alt=""><figcaption><p>1-2</p></figcaption></figure>

## 2. 调整配置项

### 2.1 配置接口

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FO0MvrWPmjXldvLlFaKXV%2F2023-12-01_124343.png?alt=media&amp;token=b680fcfd-05b5-4b7a-8ff3-903b05a20611" alt=""><figcaption></figcaption></figure>

### 2.2 选择模型

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2Fpk3x0oHoc8KhswOyNRHA%2F2023-12-01_124447.png?alt=media&amp;token=ed1921e7-3998-4bcc-8a21-68b67076dac6" alt=""><figcaption></figcaption></figure>

## 3. 开始对话

完成以上步骤后就可以正常对话了，快来试试吧。

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FuNcIuv2tRGSFuEe6b8GA%2Fnew-chat.gif?alt=media&amp;token=5c81dc65-b582-4ef5-9a0d-ff41307b56d3" alt=""><figcaption></figcaption></figure>

OpenKey平台自2023年7月初开始运营，保持着99%的高可用性和稳定性，欢迎大家选购。

选购地址：<https://openkey.cloud/topup>

价格对照：<https://openkey.cloud/pricing>


# 售后须知

* 平台有专业客服，提供 12/24 \* 7 售前咨询和售后保障服务。
* 考虑到 API 商品的特殊性，无法二次销售，售出概不退款；若遇不可抗力平台无法继续提供服务，将妥善制定方案以弥补用户损失。
* 本站接口价格可能随美元汇率、市场供需关系波动，接口如有涨价/降价将通过官网发布公告（一般提前24小时左右会发布公告），恕不另行通知。价格一旦变动，即按新价格计算接口消耗。


# 隐私政策

本站不存储任何用户调用API的对话数据，我们严格遵守OpenAI API的使用协议，保障用户隐私和数据安全。


# OK代理人计划

OpenKey.Cloud 提供多种合作方式，欢迎加入我们！

**方式1 创建令牌分销**

我们提供有一个代理专用的接口地址：[~~https://giegie.green~~](https://giegie.green/) <https://gegelv.com/>

后台管理地址：<https://openkey.cloud/>

这个地址隐藏前台，并附带余额查询功能。你只需要在OK后台创建api令牌，并按照自己的销售计划去开拓市场即可。OK团队会保证系统的稳定运行。\
\
注意：**2024年9月5日起，我们计划迁移旧的代理接口（.green）至新的域名（.com）。所有使用旧接口的用户，应在2024年10月5日前，完成备份迁移。**

如需了解更多，请联系我们。


# OK合伙人计划（新）

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2Fq6UbsJ9NnRPAqZcamDDQ%2Fposter-0.png?alt=media&amp;token=7945c941-b042-4056-8be8-bfe02bbf746f" alt=""><figcaption><p>OpenKey.Cloud 合伙人计划 海报</p></figcaption></figure>

**加入 OpenKey.Cloud 合伙人计划，双重返佣规则，最多可获得 10% 返佣比例！**

✨后台管理页面：<https://openkey.cloud/partnerplan>

**规则1. 基于邀请关系，返现金（可提现）**\
用户A邀请B成功注册，B充值额度，则A可收到现金奖励 = B充值额度 x 0.5 x 5%（即最大 5% 返现）。\
\
**规则2. 基于额度赠送码，返额度（可平台内使用）**\
用户B使用A的【额度赠送码】完成充值，则A用户和B用户可同时收到额度奖励 = B充值额度 x 5%（即双方各赠 5% 额度）。

**举例演示**\
用户A分享邀请链接给用户B，B成功注册后，花费￥500元购买了一个$1000刀额度兑换码。\
接着，用户B在兑换额度的时候，使用了A的【额度赠送码】。此时：\
\
1\. 用户A将获得：现金奖励 = ￥500 x 5% = **25元**，同时获得赠送额度奖励 = $1,000 x 5% = **50刀**；\
2\. 用户B将获得：充值额度 $1000美金，同时获得赠送额度 = $1,000 x 5% = **50刀**。

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FiFCnBsS5rg1DiPQT4A0U%2Finvite_0.png?alt=media&amp;token=199a42ed-c80f-4644-8f92-3338b464c3fa" alt=""><figcaption><p>合伙人计划 - 返佣日志</p></figcaption></figure>

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FJ4Z6VerL2BZw6xV0tyXX%2Finvite_1.png?alt=media&amp;token=584ad7d0-509c-4185-8792-4afca7c59780" alt=""><figcaption><p>合伙人计划 - 我的收入</p></figcaption></figure>

**注意事项**\
1\. 两个返佣规则各自独立，可重叠生效；\
2\. 返佣收入明细可查看日志页面，选择【系统】标签进行筛选；\
3\. 仅建立邀请关系，而不填写【额度赠送码】，好友用户充值额度时，规则2不会生效；\
4\. 若A的邀请链接为：<https://openkey.cloud/register?aff=OPENK>，则【额度赠送码】对应邀请链接后五位为：**OPENK**；\
5\. 禁止邀请自身或进行任何形式的套利活动。我们将保留撤回已发放返佣奖励的权利，并在严重违规情况下，考虑停用相关账户；\
6\. 联系我们：网页右下角在线客服（12h x 7d）或 <support@gptocean.com>。


# 2024.4.12 条款更新

### 1. 更新公告

OpenKey平台的充值额度自充值之日起的有效期限已被设定为\~\~**3个月**\~\~**&#x20;9个月**。我们建议您根据实际需求进行充值，以避免不必要的损失。

请注意，对于2024年4月12日**之前已充值额度的用户，其有效期将于4月12日起开始计算，顺延3个月**。若您有任何疑问，欢迎随时联系我们的客服团队。

### 2.补充说明

近期官方政策调整，API成本增加很多。同时因为风控不断升级，风险成本变得不可估算。因此，为了OpenKey平台的继续运营，我们不得不通过设置额度有效期3个月的方式来降低成本。

如果您已经采购了额度，但无法接受本次更新的条款，我们可以为您处理退款。请网页右下角联系客服处理。

联系团队：<https://openkey.cloud/>

### 3.关于我们

牛爷爷团队成立于2022年12月11日，于2023年7月份完成OpenKey平台的构建，在2024年1月份将此业务交由美国注册公司TeroBox, LLC运营管理。

我们的产品矩阵已基本覆盖大部分领域，可以很好地满足用户使用需求，具体如下：

#### 51BuyGPT <a href="#id-51buygpt" id="id-51buygpt"></a>

网址：[https://shop.51buygpt.net/](https://shop.51buygpt.com/)

介绍：AI 综合产品/账号 购买平台，提供：OpenAI/ChatGPT 官方账号、API Key、GPT-4.0 Plus 订阅账号，以及 OpenKey 账号池等商品/服务。

#### Box小铺 <a href="#box-xiao-pu" id="box-xiao-pu"></a>

网址：<https://shop.terobox.com/>

介绍：AI 综合产品/账号 购买平台，提供：OpenAI/ChatGPT 官方账号、API Key、GPT-4.0 Plus 订阅账号，以及 OpenKey 账号池等商品/服务（备用购买地址）。

#### OpenKey账号池 <a href="#openkey-zhang-hao-chi" id="openkey-zhang-hao-chi"></a>

网址：<https://openkey.cloud/>

介绍：无限调用 ChatGPT API 的账号池，提供企业级专业稳定的 ChatGPT 接口集成分发服务。

#### Poe.Monster <a href="#poe.monster" id="poe.monster"></a>

网址：[https://poe.monster/](https://poe.monster/#/)

介绍：中文版Poe，提供专业稳定的人工智能机器人对话的大型平台。

#### GPTocean AI论坛 <a href="#gptocean-ai-lun-tan" id="gptocean-ai-lun-tan"></a>

网址：<https://gptocean.com/>

介绍：一个专门用于讨论OpenAI旗下ChatGPT机器人技术的论坛。这里有专业的开发人员和爱好者，他们致力于推动这项技术的发展，并分享最新的技术进展和应用案例。

#### TeroBox共享账号 <a href="#terobox-gong-xiang-zhang-hao" id="terobox-gong-xiang-zhang-hao"></a>

网址：<https://terobox.com/>

介绍：ChatGPT免费账号Plus订阅账号分享平台。

#### ChatGPT API 水龙头 <a href="#chatgpt-api-shui-long-tou" id="chatgpt-api-shui-long-tou"></a>

网址：<https://faucet.openkey.cloud/>

Github链接：<https://github.com/terobox/ChatGPT-API-Faucet>

介绍：每24小时可领取一个 $1.00 令牌用于开发测试 AI 产品。

#### OpenAI ChatGPT API 成本计算器（中文版） <a href="#openai-chatgpt-api-cheng-ben-ji-suan-qi-zhong-wen-ban" id="openai-chatgpt-api-cheng-ben-ji-suan-qi-zhong-wen-ban"></a>

网址：<https://ccc.openkey.cloud/>

Github链接：<https://github.com/terobox/ChatGPT-Cost-Calculator>

介绍：这是一款专门为团队和开发者设计的工具，可以帮助用户准确预算和规划他们在项目中使用ChatGPT API的成本。

#### ChatGPT对话网 <a href="#chatgpt-dui-hua-wang" id="chatgpt-dui-hua-wang"></a>

网址：<https://chat.openkey.cloud/>

介绍：专业的ChatGPT接口对话工具。

#### ChatGPT对话网 新版 <a href="#chatgpt-dui-hua-wang-xin-ban" id="chatgpt-dui-hua-wang-xin-ban"></a>

网址：<https://chat1201.openkey.cloud/>

介绍：专业而简洁的 ChatGPT 接口对话工具。

Telegram频道：<https://t.me/s/niuyeyegpt>

联系我们：<support@gptocean.com>


# 2024.4.22 倍率及折扣调整

### 1. 模型倍率调整

2024年4月22日起，OpenKey.Cloud 平台 OpenAI ChatGPT 系列模型均调整为 **12 倍率**，原倍率为：

> 3.5系列原 10倍 -> 现 12 倍（涨价20%）
>
> 4.0系列原 16倍 -> 现 12 倍（降价25%）

最新模型价格请前往：[价格页面（如未更新，请清除浏览器缓存）](https://openkey.cloud/pricing)

### 2. 套餐折扣调整

即日起，OpenKey.Cloud 全部套餐 **6 折起**！$5.00 套餐兑换码仅需 3 元，另加 5% 额度赠送！

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2FtVLrTTOwtXbsRho1rWT0%2Fok-package.png?alt=media&amp;token=178db42b-aef3-4df3-848d-be42f3e7c563" alt=""><figcaption><p>OpenKey.Cloud 套餐</p></figcaption></figure>

购买套餐兑换码可前往：

> 1. OpenKey.Cloud：<https://openkey.cloud/topup> （推荐）
> 2. 51BuyGPT：[https://shop.51buygpt.net](https://shop.51buygpt.net/) （免翻墙）
> 3. Box小铺：[https://shop.terobox.com](https://shop.terobox.com/) （需翻墙）

在最新的折扣下，OpenKey.Cloud 接口的使用成本如下：

> **若 6 折条件下，购买 $120 美金**，则
>
> 成本￥72 元，实际可用 OpenAI 官方额度为 $120 / 12 = $10 美金。换算下来，<mark style="color:green;">￥7.2 元购买 $1 官方额度</mark>
>
> **若 5 折条件下，购买 $120 美金**，则
>
> 成本￥60 元，实际可用 OpenAI 官方额度为 $120 / 12 = $10 美金。换算下来，<mark style="color:green;">￥6 元购买 $1 官方额度</mark>
>
> **若 定制套餐，享受更低折扣**，则
>
> 使用成本将 <mark style="color:green;">< ￥6 元 / $1 官方额度</mark>

### 3. 补充说明

关于模型倍率调整，即刻生效，如有任何疑问，请网页右下角联系客服处理。OpenKey.Cloud 提供 12 h x 7 d 的客服服务，全售后保障。

关于套餐折扣调整，新折扣即刻生效，近日的充值可<mark style="color:green;">**联系客服按最新折扣补额度**</mark>。注意，仅限于2024年4月12日以来的订单。

**举例说明：**

4月15日（近日），用户 A 在 8 折（原折扣）条件下，花费 ￥96 元购买了一个 $120 刀OK额度兑换码。

那么按照 最新折扣 5折，用户花费的 ￥96 元可充值 $192 刀。

现在，用户 A 可以联系客服，提供相应订单信息，我们将免费提供一个 $192 - $120 = $72 刀额度兑换码。

*2024年4月22日*

**牛爷爷团队**

[**https://openkey.cloud/**](https://openkey.cloud/)


# 2025.7.15 最新支持模型

近期，OpenKey.Cloud 新增一批次高性能 AI 大模型，截止 2025 年 7 月 15 日，平台已支持模型如下：

### 1. ChatGPT 系列

```
- gpt-3.5-turbo
- gpt-3.5-turbo-0125
- gpt-3.5-turbo-1106
- gpt-4
- gpt-4-0125-preview
- gpt-4-0613
- gpt-4-1106-preview
- gpt-4-turbo
- gpt-4-turbo-2024-04-09
- gpt-4.1
- gpt-4.1-2025-04-14
- gpt-4.1-mini
- gpt-4.1-mini-2025-04-14
- gpt-4.1-nano
- gpt-4.1-nano-2025-04-14
- gpt-4o
- gpt-4o-2024-05-13
- gpt-4o-2024-08-06
- gpt-4o-2024-11-20
- gpt-4o-mini
- gpt-4o-mini-2024-07-18
- o1
- o1-2024-12-17
- o1-mini
- o1-mini-2024-09-12
- o1-preview-2024-09-12
- o3
- o3-2025-04-16
- o3-mini
- o3-mini-2025-01-31
- o4-mini
- o4-mini-2025-04-16
```

### 2. Claude 系列

```
- claude-3-5-haiku-20241022
- claude-3-5-sonnet-20240620
- claude-3-5-sonnet-20241022
- claude-3-7-sonnet-20250219
- claude-3-haiku-20240307
- claude-3-opus-20240229
- claude-opus-4-20250514
- claude-sonnet-4-20250514
```

### 3. Gemini 系列

```
- gemini-1.5-flash
- gemini-1.5-flash-8b
- gemini-1.5-pro
- gemini-2.0-flash
- gemini-2.0-flash-lite
- gemini-2.5-flash-preview-04-17
- gemini-2.5-pro
- gemini-2.5-pro-preview-03-25
- gemini-2.5-pro-preview-05-06
- gemini-2.5-pro-preview-06-05
```

### 4. DeepSeek 系列

```
- deepseek-chat
- deepseek-v3
- deepseek-reasoner
- deepseek-r1
```

### 5. Grok 系列

```
- grok-2-1212
- grok-2-vision-1212
- grok-3
- grok-3-beta
- grok-3-fast
- grok-3-fast-beta
- grok-3-mini
- grok-3-mini-beta
- grok-3-mini-fast
- grok-3-mini-fast-beta
- grok-4
- grok-4-0709
- grok-4-latest
```

### 6. Doubao 系列

```
- doubao-1-5-lite-32k-250115
- doubao-1-5-pro-256k-250115
- doubao-1-5-pro-32k-250115
- doubao-1-5-pro-32k-character-250228
- doubao-1-5-thinking-pro-250415
- doubao-1-5-thinking-vision-pro-250428
- doubao-1-5-vision-pro-32k-250115
- doubao-1.5-vision-lite-250315
- doubao-1.5-vision-pro-250328
- doubao-seed-1-6-250615
- doubao-seed-1-6-flash-250615
- doubao-seed-1-6-thinking-250615
```

### 7. Qwen 系列

```
- qwen-long
- qwen-long-2025-01-25
- qwen-long-latest
- qwen-max
- qwen-max-2025-01-25
- qwen-max-latest
- qwen-plus
- qwen-plus-2025-04-28
- qwen-plus-latest
- qwen-turbo
- qwen-turbo-2025-04-28
- qwen-turbo-latest
- qwen3-0.6b
- qwen3-1.7b
- qwen3-14b
- qwen3-235b-a22b
- qwen3-30b-a3b
- qwen3-32b
- qwen3-4b
- qwen3-8b
- qwq-plus
- qwq-plus-2025-03-05
- qwq-plus-latest
```

### 写在最后

OpenKey.Cloud AI 大模型接口转发平台已稳定运营超2年时间，拥有丰富经验，提供可靠的售前售后服务。如果您正在构建自己的 AI 产品，我们期待与您共同成长。

> 官网：[https://openkey.cloud](https://openkey.cloud/)
>
> 文档：[https://docs.openkey.cloud](https://docs.openkey.cloud/)
>
> 对话工具：[https://chat.openkey.cloud](https://chat.openkey.cloud/)


# 2025.8.15 关于日志消耗和额度有效期

关于 OK 的日志消耗以及额度有效期，两个常见问题：

### 1. 为什么充值的100刀突然没了，后台却只显示消耗20刀？

OpenKey.Cloud 后台日志页面显示的“**总消耗额度**”，仅为当前尚存在的全部日志之和，并非实际的用户历史总消耗。

平台每天有大量的请求日志，系统无法全部做永久保留，因此采取不定时**滚动清理**的方式来减轻系统压力。每次清理过后，会将清理掉的日志备份在独立的日志站点。

> 日志站：<https://v2.openkey.cloud/>

所以，用户充值的`100刀`并不是凭空消失，是已经消耗完，而系统仅能查询到最近的日志（总计`20刀`），统计出现差异。

**注意事项：**

1. 用户的充值记录将永久保留，不会被清理；
2. 管理员可以查看到每个用户准确的历史消耗额度，如有疑问，可以联系管理员核查；
3. V2.OK 日志站数据也具有实效性，每次主站点清理日志，都将覆盖日志站。

<figure><img src="https://3504179993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfsS5hEXki2PLFCSvxXud%2Fuploads%2F4vKeFiiIV9u8ljKeuGi8%2F%E6%88%AA%E5%B1%8F2025-08-15%2023.45.30.png?alt=media&amp;token=593245f8-e131-470d-8ebd-2923676cfd3f" alt=""><figcaption></figcaption></figure>

### 2. 我很久前充值的额度，因为有效期，你们是不是给我清零了？

OpenKey.Cloud 充值时会提醒额度存在有效期，目前为9个月。但需要注意：

> 自该条款于2024年4月12日生效以来，平台从未清理过任何一位用户的任何余额。

设置该条款的目的在于，**引导用户按需充值**。部分用户习惯囤积额度，比如在平台推出优惠活动时进行大量充值，而无法及时使用。

因为市场的价格是波动的，大量的“**懒额度**”会给平台带来负担，因此我们推荐大家按需采购。

**注意事项：**

1. 平台不会在没有任何通知的情况下，擅自清理用户的账户余额；
2. 平台的资源相对稳定，目前没有清理用户过期额度的计划；
3. 最后，按需充值，放心使用。