接口地址与身份认证¶
Genesis 模型 API 使用控制台「使用」页提供的 Base URL 和认证信息。当前环境中的所有 TaaS 模型接口共用这一个 Base URL；各接口的路径和请求体请以对应参考页为准。
配置 Base URL¶
Base URL 由当前环境的控制台「使用」页提供。不要把管理站点地址、别的环境地址或内部服务路径当作模型 API Base URL。将页面复制的完整值原样保存为环境变量：
<Genesis Base URL copied from the console>
各接口文档中的路径均相对于这个值。确认复制的 Base URL 是否已以 /v1 结尾；不要自行添加、删除或替换版本段。对话接口地址例如为：
<Genesis Base URL>/chat/completions
建议把 Base URL 原样放入环境变量：
export GENESIS_BASE_URL="<Genesis Base URL copied from the console>"
export GENESIS_ACCESS_TOKEN="<UC PAT 或 Genesis 服务账号 API Key>"
配置认证信息¶
原始 HTTP 请求只接受以下认证头：
Authorization: Bearer <API_KEY>
UC 个人访问令牌（PAT）和 Genesis 服务账号 API Key 都使用 Authorization: Bearer <ACCESS_TOKEN>。此规则适用于 /models、/chat/completions、/embeddings、/responses 和 /messages 等相对于 Genesis Base URL 的模型接口。一次请求只发送一个凭据。
curl "$GENESIS_BASE_URL/models" \
-H "Authorization: Bearer $GENESIS_ACCESS_TOKEN"
PAT 在 账号管理 → 访问凭据 中创建；Genesis 服务账号 API Key 通过服务账号或 Genesis「密钥」页创建，具体入口以当前部署为准。完整凭据可能只在创建或更新时显示一次，应立即保存到密钥管理服务，避免写入源码、镜像、日志或客户端应用。
SDK 配置¶
对于 OpenAI 兼容接口，将 SDK 的 api_key 设为 UC PAT 或 Genesis 服务账号 API Key，将 base_url 设为控制台中的完整 Base URL：
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["GENESIS_ACCESS_TOKEN"],
base_url=os.environ["GENESIS_BASE_URL"],
)
不要在 base_url 后手动附加具体接口路径，SDK 会自行添加 /chat/completions、/embeddings 等路径。Messages 使用原生 Anthropic 请求形态；其 SDK 配置见消息与流式调用。
权限、额度与轮换¶
Key 可以限制可用模型、有效期、总额度、日额度、并发数、RPM 和 TPM；具体选项以当前部署为准。常见失败原因如下：
状态 |
检查项 |
|---|---|
|
PAT 或 Key 是否正确、过期、禁用，认证头是否为 |
|
请求中的模型是否在凭据的可用模型范围内 |
|
Base URL 是否重复拼接版本段，模型 ID 是否存在 |
|
额度、并发、RPM 或 TPM 是否触顶 |
更新密钥后旧值会立即失效。轮换时先把新 Key 部署到所有调用方并验证，再停止使用旧 Key；密钥管理操作见Genesis 指南。