EastToken

EASTTOKEN / RESOURCES

接入指南

通过聊天补全 API 接入服务端应用。先用小请求核对用量,再逐步扩大规模。

本站暂未开放 API 使用和充值。 以下指南说明开通后的接入方式,并未提供已经可用的公开 API 地址。

1. 准备账户

登录后在“API 密钥”创建专用密钥,在“模型与价格”选择可用模型,复制完整模型 ID(含 HC 后缀)。HC 表示高缓存线路,不保证某个请求必然命中缓存。

以下基础地址仅包含一次 /v1。请使用向账户实际提供的 API 地址,不要根据网站域名猜测。远程连接使用 HTTPS,API 密钥仅保存在服务端。

2. 发起小请求

在服务端环境变量设置 EASTTOKEN_BASE_URL、EASTTOKEN_API_KEY 和 EASTTOKEN_MODEL。以下 Python 3 示例仅使用标准库,不打印密钥。连接真实服务时会调用计费接口,确认费率和余额后再执行。

import json
import os
import urllib.request

base = os.environ["EASTTOKEN_BASE_URL"].rstrip("/")
if not base.endswith("/v1"):
    raise ValueError("EASTTOKEN_BASE_URL must end with /v1")
body = {
    "model": os.environ["EASTTOKEN_MODEL"],
    "messages": [{"role": "user", "content": "Reply with hello."}],
    "max_tokens": 32,
    "stream": False,
}
request = urllib.request.Request(
    base + "/chat/completions",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": "Bearer " + os.environ["EASTTOKEN_API_KEY"],
        "Content-Type": "application/json",
    },
    method="POST",
)
with urllib.request.urlopen(request, timeout=60) as response:
    result = json.load(response)
print(result["choices"][0]["message"]["content"])
print(result.get("usage", {}))

3. 限制、流式与重试

示例使用 POST /v1/chat/completions 及 Bearer API 密钥。必要参数及支持能力因模型而异。流式请求设为 stream=true,并使用兼容客户端解析事件流;此非流式示例不是流解析器。

401:检查密钥;403:检查账户/分组权限;429:降低速率,并在存在时遵守 Retry-After;400:检查模型 ID 与参数。遇到 5xx 或超时,请记录请求 ID 并核对用量后再重试:未收到响应不代表模型未执行,不要盲目重试计费请求。

输出 token 上限可能影响请求准入及余额预留,请合理设置。负载测试后逐步提高并发;仅凭网站服务器大小无法确定模型服务容量。在控制台核对用量及美元价格类别。

4. 安全接入

每个应用使用独立密钥,泄露后轮换,设置应用侧预算,避免记录 Authorization 头或完整提示词。涉及个人数据时确认数据处理条款。扩大使用规模前,核验小额成功请求、失败请求及其对应账单。

support@easttokenapi.com