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 头或完整提示词。涉及个人数据时确认数据处理条款。扩大使用规模前,核验小额成功请求、失败请求及其对应账单。