接口地址与身份认证¶
接口用途¶
所有 Genesis 模型请求都从控制台「使用」页显示的 Base URL 开始，并使用 Genesis API Key 进行 Bearer 认证。不要根据示例域名推断生产地址。
请求方式¶
按具体接口页为准。本页说明共用基址与鉴权；下方示例使用 GET /models。
组成请求地址¶
Base URL 的示意形态如下，实际值以控制台为准：
https://moi.matrixorigin.cn/taas/v1
各接口文档中的路径均相对于 Base URL。例如，Base URL 已以 /v1 结尾时，对话接口地址为：
https://moi.matrixorigin.cn/taas/v1/chat/completions
不要再额外拼接 /v1，否则会形成重复版本段。建议把 Base URL 原样放入环境变量：
export GENESIS_BASE_URL="https://moi.matrixorigin.cn/taas/v1"
export GENESIS_API_KEY="<your-api-key>"
发送认证信息¶
原始 HTTP 请求只接受以下认证头：
Authorization: Bearer <API_KEY>
X-API-Key、UC Control API Key、AI Studio 个人访问令牌和浏览器 Cookie 都不能替代 Genesis API Key。一次请求只发送一个凭据。
curl "$GENESIS_BASE_URL/models" \
-H "Authorization: Bearer $GENESIS_API_KEY"
Genesis Key 通常通过统一账户的服务账号签发；部分部署也会在 Genesis「密钥」页提供本地签发入口。完整 Key 可能只在创建或更新时显示一次，应立即保存到密钥管理服务，不要写入源码、镜像、日志或客户端应用。
SDK 配置¶
对于 OpenAI 兼容接口，将 SDK 的 api_key 设为 Genesis API Key，将 base_url 设为控制台中的 Base URL：
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["GENESIS_API_KEY"],
base_url=os.environ["GENESIS_BASE_URL"],
)
不要在 base_url 后手动附加具体接口路径，SDK 会自行添加 /chat/completions、/embeddings 等路径。Messages 使用原生 Anthropic 请求形态，配置方式见消息与流式调用。
权限、额度与轮换¶
Key 可以限制可用模型、有效期、总额度、日额度、并发数、RPM 和 TPM；具体选项以当前部署为准。常见失败原因如下：
状态 |
检查项 |
|---|---|
|
Key 是否正确、过期、禁用，认证头是否为 |
|
请求中的模型是否在 Key 的可用模型范围内 |
|
Base URL 是否重复拼接版本段，模型 ID 是否存在 |
|
额度、并发、RPM 或 TPM 是否触顶 |
更新密钥后旧值会立即失效。轮换时先把新 Key 部署到所有调用方并验证，再停止使用旧 Key；密钥管理操作见Genesis 指南。