# 秘钥（key）生成

的首次登录后会自动跳转到[令牌页](https://one.ocoolai.com/token)令牌页面会有一个默认的初始秘钥，初始秘钥默认为全模型[分组](/site/readme/addkey.md#shen-me-shi-ling-pai-fen-zu)秘钥。

<figure><img src="/files/cLqbsn0wUQPkBaZMpwS8" alt="" width="563"><figcaption></figcaption></figure>

该分组可以使用绝大部分模型,当然如果你需要使用高质量模型或者新模型可以选择其他分组。

### 新建秘钥（key）

{% hint style="info" %}
说明:秘钥=Key=API Key=Token，都是一个东西，不同地方叫法不同。
{% endhint %}

{% stepper %}
{% step %}

#### 点击添加按钮

<figure><img src="/files/tMrBO4e0iWSgYOWYkTHD" alt="" width="287"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### 在弹出面板中设置令牌信息

详细设置说明查看下方[配置说明](#mi-yao-pei-zhi-shuo-ming)
{% endstep %}

{% step %}

#### 点击创建并复制令牌

<figure><img src="/files/SAXjuEVDYSoQwKPSwH0T" alt="" width="321"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

### 秘钥配置说明

当点击<mark style="color:blue;">添加</mark>按钮时会弹出秘钥配置窗口(如图)

<figure><img src="/files/EqYSiRLyGeFSNYnNgY8h" alt=""><figcaption></figcaption></figure>

***

说明导航:  · [<mark style="background-color:yellow;">令牌名称</mark>](#ling-pai-ming-cheng)  <mark style="background-color:yellow;">·</mark> [<mark style="background-color:yellow;">无限额度</mark>](#wu-xianedu) <mark style="background-color:yellow;">·</mark> [<mark style="background-color:yellow;">永不过期</mark>](#yong-bu-guo-qi) <mark style="background-color:yellow;">·</mark> [<mark style="background-color:yellow;">计费模式</mark>](#ji-fei-mo-shi) <mark style="background-color:yellow;">·</mark> [<mark style="background-color:yellow;">令牌分组</mark>](#ling-pai-fen-zu) <mark style="background-color:yellow;">·</mark> [<mark style="background-color:yellow;">令牌备注</mark>](#ling-pai-bei-zhu) <mark style="background-color:yellow;">·</mark> [<mark style="background-color:yellow;">高级选项</mark>](#gao-ji-xuan-xiang)

***

#### 令牌名称

令牌名称可随意设置,方便自己辨认即可，不设置会使用默认名称。

#### 无限额度

该设置是以额度来限制令牌的使用。

{% tabs %}
{% tab title="无限额度（关闭时）" %}
当无限额度关闭时需要为该令牌设置额度上限，一般在比较敏感的环境测试或者于他人分享时可设置额度上限以防泄漏造成损失或被滥用。

可在输入框手动输入额度或点击下方快捷按钮快捷输入。

<figure><img src="/files/hmuEWLrySZrXfwLwii8u" alt="" width="408"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="无限额度（开启时）" %}
当无限额度开启时该令牌将无额度限制，但其上限受限于您的账户余额。

<figure><img src="/files/aqcFrXWiO96mL1hX0gaO" alt=""><figcaption><p>无限额度开启时界面</p></figcaption></figure>
{% endtab %}
{% endtabs %}

***

#### 永不过期

该设置是从时间维度来限制令牌的使用。

{% tabs %}
{% tab title="开启时" %}
当永不过期开关打开时即不对使用期限做限制。

<figure><img src="/files/ZzClhs8PvvZvoIzfMg5X" alt="" width="458"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="关闭时" %}
当永不过期开关关闭时你需要为该令牌设置一个过期时间，一旦超过期间该令牌将自动变为不可用状态。

<figure><img src="/files/IIUO3zdmpquL33XvbBrt" alt="" width="513"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

***

#### 计费模式

计费模式共分5种，分别为按量计费、按次计费、混合计费、按量优先和按次优先。

本站系统计费共分为两种方式，一种是按使用量计费，另一种是按使用次数计费。可以通过设置计费模式来限制调用的优先级。默认是使用按量优先的模式计费。

<figure><img src="/files/Z3XTvBGSRWcWuMaNtlHd" alt="" width="470"><figcaption></figcaption></figure>

模式说明：

<table><thead><tr><th width="184" align="center">名称</th><th align="center">说明</th></tr></thead><tbody><tr><td align="center">按量计费</td><td align="center">即只使用token计费渠道，所选模型无按次计费渠道时会报错无可用渠道（普通 llm 模型本站无按次计费渠道），如mj-chat仅有按次计费渠道无按量计费渠道，使用该模式则无法使用mj-chat模型。</td></tr><tr><td align="center">按次计费</td><td align="center">即只使用按次计费渠道，所选模型无按量计费渠道时会报错无可用渠道，相反，该模式无法使用按量计费的渠道。</td></tr><tr><td align="center">混合计费</td><td align="center">如果同一模型同时存在按量计费和按次计费渠道，则随机选择渠道。</td></tr><tr><td align="center">按量优先（默认）</td><td align="center">如果同一模型同时存在按量计费和按次计费渠道，则优先使用按量计费渠道。</td></tr><tr><td align="center">按次优先</td><td align="center">如果同一模型同时存在按量计费和按次计费渠道，则优先使用按次计费渠道。</td></tr></tbody></table>

{% hint style="info" %}
如果没有特殊需求建议直接使用默认的按量优先计费方式。
{% endhint %}

***

#### 令牌分组

指定令牌使用的模型分组，不同分组对应着不如的价格和不同的模型，不选择时默认为全模型分组,具体可查看下方[令牌分组](#shen-me-shi-ling-pai-fen-zu)的说明。

***

#### 令牌备注

字面意思，对令牌的功能无任何影响。

***

#### 高级选项

对令牌其他的特殊限制，如批量生成令牌、对令牌的可用模型限制、IP限制、速率限制等。的即

{% tabs %}
{% tab title="生成数量" %}
批量生成令牌时设置该项，即一次生成令牌的数量。
{% endtab %}

{% tab title="可用模型" %}
即对令牌可以使用的模型做限制，该选项为白名单模式，仅被选中的模型支持调用。
{% endtab %}

{% tab title="IP白名单" %}
限制IP使用，如果你担心令牌泄漏或指定在某个地方使用（如公司内或办公室等）可以做IP限制。本机IP地址可以在一些IP查询网站获取，如[https://www.ip138.com](https://www.ip138.com/)。
{% endtab %}

{% tab title="限流器" %}
1对令牌使用速率做限制，当开关打开时：

* 限流周期即时间段
* 限流次数即上述时间段内可以使用的次数（如限流周期为1秒，限流次数为1时该令牌在一秒内只能被使用一次）
* 提示消息，当超过限流上限时提示的消息。

<figure><img src="/files/6l4h2kO2RzcUTSBAdRuB" alt="" width="446"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

***

## 什么是令牌分组

{% hint style="success" %}
如果不想了解该内容可以直接点击站点的价格或悬浮菜单的模型列表，选择分组后所展示的模型和价格即该分组的实际价格和所支持的模型列表。

分组所支持的模型也可以在个人信息页面点击分组名称选项卡查看。
{% endhint %}

随着大模型供应商的不断增加和国内外复杂的计费方式以及不同渠道参差不齐的价格，使得我们不得不对不同质量、不同渠道的模型进行分组分发。这样也可以让用户根据自己需求自主选择分组以更加优惠合理的价格使用不同的模型。

标准充值价格为1元/美元[^1]，不同的模型分组对应的模型和扣费倍率都有所不同，其实际价格为倍率×基础价格，如默认分组为1.5倍扣费，即默认分组的价格为1.5元/美元。

{% hint style="info" %}
如果您不想计算价格或者完全不想看复杂的计费模式，可以直接点击<mark style="background-color:blue;">价格</mark>按钮，在价格页面的下拉框选择不同分组即为当前分组下模型的实际价格。
{% endhint %}

<figure><img src="/files/HhtJBSkej1rhAConu0xV" alt="" width="563"><figcaption></figcaption></figure>

[^1]: 注意：这里的美元对应的不是实际汇率的美元，你可以直接将其理解为元。

    美元原本是针对国外模型计费的，随着国内模型和开源模型的兴起，为了方便统一计费，本站将美元和元的汇率设置为了1：1。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.ocoolai.com/site/readme/addkey.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.