一、文档说明
本文档面向 api-zeno 个人用户,主要说明平台账户注册、额度购买、API Key 创建、参数配置、接入信息填写及故障排查等操作。
api-zeno 智能化平台提供 API Key 创建与删除、启用状态设置、有效期设置、余额及额度配置、调用用量查询、权限配置、API Key 批量创建与管理等能力。
- Codex 自动安装与升级脚本
- Claude 自动安装与升级脚本
- Codex 汉化脚本
- zeno 一键配置脚本
相关链接:https://api-zeno.com/zh-CN
入门配置
面向个人用户,说明账户注册、额度购买、API Key 创建、参数配置、接入信息填写及故障排查等操作。
方法
GUIDE接口
控制台 / API 密钥Base URL
https://api-zeno.com/v1鉴权
api-zeno 账户登录本文档面向 api-zeno 个人用户,主要说明平台账户注册、额度购买、API Key 创建、参数配置、接入信息填写及故障排查等操作。
api-zeno 智能化平台提供 API Key 创建与删除、启用状态设置、有效期设置、余额及额度配置、调用用量查询、权限配置、API Key 批量创建与管理等能力。
相关链接:https://api-zeno.com/zh-CN
API Key 的创建、配置和使用需要通过 api-zeno 智能化平台完成。使用相关功能前,个人用户需先注册 api-zeno 平台账户。
登录平台后,可根据实际使用需求选择套餐计费或按量计费。套餐计费用于购买固定规格额度,按量计费会根据接口实际调用量扣除账户余额。
个人用户可根据页面提示进行充值。具体充值金额、到账额度及计费规则,以平台页面展示的信息为准。
完成账户充值或套餐购买后,可在 api-zeno 智能化平台中创建 API Key。
| 配置项 | 是否必填 | 说明 |
|---|---|---|
| API Key 名称 | 是 | 用于识别当前 API Key |
| 分组 | 是 | 选择 API Key 所属分组 |
| 剩余额度 | 是 | 设置 API Key 的可用额度 |
| 过期时间 | 否 | 设置 API Key 的失效时间 |
| RPM | 否 | 设置每分钟请求次数限制 |
| TPM | 否 | 设置每分钟 Token 数量限制 |
| 模型白名单 | 否 | 设置该 API Key 可调用的模型 |
| IP 白名单 | 否 | 设置允许调用该 API Key 的 IP 地址 |
| 检查项 | 检查内容 |
|---|---|
| Key 状态 | API Key 是否处于启用状态 |
| 有效期 | 过期时间是否设置正确 |
| 余额 | 可用余额是否已配置 |
| 调用限制 | RPM、TPM 等限制是否符合配置要求 |
| 模型权限 | 模型白名单是否已设置 |
| IP 权限 | IP 白名单是否已设置 |
| 标识信息 | API Key 名称和分组是否填写正确 |
API Key 创建并配置完成后,系统会生成对应的 API Key。使用接口时,需要同时配置 API Key 和统一的 Base URL。
Base URL:
https://api-zeno.com/v1
API Key:
请填写平台生成的 API Key平台提供 API Key 的基础数据及状态信息。如需在平台外建立补充记录,可使用以下字段。相关额度、用量和状态数据以平台显示结果为准。
| 字段 | 内容 |
|---|---|
| Key 名称 | API Key 的名称或识别标记 |
| API Key | 平台生成的接口访问凭证 |
| 分组 | API Key 所属分组 |
| 创建时间 | API Key 的创建日期和时间 |
| 生效时间 | API Key 的开始生效时间 |
| 到期时间 | API Key 的失效时间 |
| 初始额度 | API Key 创建或充值时配置的额度 |
| 剩余额度 | API Key 当前可用额度 |
| 调用用量 | API Key 已产生的调用量 |
| RPM | 每分钟请求次数限制 |
| TPM | 每分钟 Token 数量限制 |
| 模型白名单 | API Key 可调用的模型范围 |
| IP 白名单 | 允许调用 API Key 的 IP 地址范围 |
| 当前状态 | 启用、停用或已过期 |
| 备注 | 其他补充说明 |
API Key 属于接口访问凭证,不应出现在公开网页、公开代码仓库、公开文档、未脱敏截图、客户端日志或故障记录中。
使用时如果遇到接口无法调用,可按照以下顺序进行检查:
调用时间:
使用工具或客户端:
请求地址:
请求接口:
模型名称:
HTTP 状态码:
错误信息:
API Key 名称:
API Key 末尾字符:API Key 标识可记录 Key 名称或末尾部分,不应在故障记录、截图或公开文档中填写完整 API Key。
入门配置
用一个 Chat Completions 请求确认 Key、额度、模型和渠道都可用。
方法
POST接口
/v1/chat/completionsBase URL
https://api.api-zeno.com/v1鉴权
Authorization: Bearer $API_ZENO_KEYcurl https://api.api-zeno.com/v1/chat/completions \
-H "Authorization: Bearer $API_ZENO_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o-mini",
"messages": [
{ "role": "user", "content": "Hello API-Zeno" }
]
}'入门配置
模型网关统一使用 API Key 鉴权;控制台接口使用用户会话或管理员会话。
方法
HEADER接口
AuthorizationBase URL
https://api.api-zeno.com/v1鉴权
Bearer API Key模型网关
兼容 OpenAI Chat Completions SDK,适合文本对话、工具调用、JSON 输出和常规应用接入。
方法
POST接口
/v1/chat/completionsBase URL
https://api.api-zeno.com/v1鉴权
Authorization: Bearer $API_ZENO_KEYimport OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.API_ZENO_KEY,
baseURL: "https://api.api-zeno.com/v1",
});
const result = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [{ role: "user", content: "Hello API-Zeno" }],
});
console.log(result.choices[0]?.message?.content);from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_ZENO_KEY",
base_url="https://api.api-zeno.com/v1",
)
result = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "Hello API-Zeno"}],
)
print(result.choices[0].message.content)模型网关
适合新式 Responses 调用、工具、多模态输入和需要保持 Responses 结构的客户端。
方法
POST接口
/v1/responsesBase URL
https://api.api-zeno.com/v1鉴权
Authorization: Bearer $API_ZENO_KEYcurl https://api.api-zeno.com/v1/responses \
-H "Authorization: Bearer $API_ZENO_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o-mini",
"input": "Summarize API-Zeno in one paragraph"
}'协议接口
保持 Claude Messages 请求结构,通过 API-Zeno 的 Key、额度、日志和渠道调度访问。
方法
POST接口
/v1/messagesBase URL
https://api.api-zeno.com/v1鉴权
Authorization: Bearer $API_ZENO_KEYcurl https://api.api-zeno.com/v1/messages \
-H "Authorization: Bearer $API_ZENO_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 256,
"messages": [
{ "role": "user", "content": "Hello Claude" }
]
}'协议接口
提供 Gemini 风格 generateContent 和 streamGenerateContent 入口,仍由 API-Zeno API Key 鉴权。
方法
POST接口
/v1beta/models/{model}:generateContentBase URL
https://api.api-zeno.com/v1beta鉴权
Authorization: Bearer $API_ZENO_KEYcurl https://api.api-zeno.com/v1beta/models/gemini-2.0-flash:generateContent \
-H "Authorization: Bearer $API_ZENO_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{ "role": "user", "parts": [{ "text": "Hello Gemini" }] }
]
}'协议接口
用于向量化文本、检索、RAG 入库和相似度计算前置处理。
方法
POST接口
/v1/embeddingsBase URL
https://api.api-zeno.com/v1鉴权
Authorization: Bearer $API_ZENO_KEYcurl https://api.api-zeno.com/v1/embeddings \
-H "Authorization: Bearer $API_ZENO_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "text-embedding-3-small",
"input": "API-Zeno protocol coverage"
}'多媒体
提供图像生成、图像编辑、图像变体等 OpenAI 风格路径。
方法
POST接口
/v1/images/generationsBase URL
https://api.api-zeno.com/v1鉴权
Authorization: Bearer $API_ZENO_KEYcurl https://api.api-zeno.com/v1/images/generations \
-H "Authorization: Bearer $API_ZENO_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-1",
"prompt": "A clean API gateway diagram",
"size": "1024x1024"
}'多媒体
支持语音合成、语音转文本和翻译类音频入口。
方法
POST接口
/v1/audio/speechBase URL
https://api.api-zeno.com/v1鉴权
Authorization: Bearer $API_ZENO_KEYcurl https://api.api-zeno.com/v1/audio/speech \
-H "Authorization: Bearer $API_ZENO_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tts-1",
"voice": "alloy",
"input": "API-Zeno is ready."
}' --output speech.mp3多媒体
提交视频生成任务,并通过任务状态接口查询结果。
方法
POST接口
/v1/video/generationsBase URL
https://api.api-zeno.com/v1鉴权
Authorization: Bearer $API_ZENO_KEYcurl https://api.api-zeno.com/v1/video/generations \
-H "Authorization: Bearer $API_ZENO_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-v1",
"prompt": "A clean product walkthrough video for an API gateway"
}'协议接口
用于检索结果重排、知识库召回排序和搜索增强。
方法
POST接口
/v1/rerankBase URL
https://api.api-zeno.com/v1鉴权
Authorization: Bearer $API_ZENO_KEYcurl https://api.api-zeno.com/v1/rerank \
-H "Authorization: Bearer $API_ZENO_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bge-reranker-large",
"query": "gateway billing trace",
"documents": [
"API logs include request_id and channel_id.",
"Frontend theme settings are stored locally."
]
}'控制台接口
用户登录后管理个人资料、API Key、额度、日志、钱包、订阅和创作任务。
方法
SESSION接口
/api/console/*Base URL
https://api.api-zeno.com鉴权
用户登录会话控制台接口
管理员维护渠道、账号池、模型价格、日志、风控、系统设置和运营数据。
方法
SESSION接口
/api/admin/*Base URL
https://api.api-zeno.com鉴权
管理员登录会话合作入口
面向 api-zeno 合作伙伴,说明账户注册、额度购买、API Key 创建、参数配置、接入信息分发及故障排查等操作。
方法
GUIDE接口
控制台 / API 密钥Base URL
https://apiway.top/v1鉴权
api-zeno 账户登录本文档面向 api-zeno 合作伙伴,主要说明平台账户注册、额度购买、API Key 创建、参数配置、接入信息分发及故障排查等操作。
api-zeno 智能化平台提供以下 API Key 管理功能:
相关链接:https://api-zeno.com/zh-CN
API Key 的创建、配置和分发需要通过 api-zeno 智能化平台完成。使用相关功能前,合作伙伴需先注册 api-zeno 平台账户。
登录平台后,可根据实际使用需求选择套餐计费或按量计费。
套餐计费适合购买平台提供的固定规格使用额度;按量计费会根据接口实际调用量扣除账户余额。
合作伙伴也可联系 zeno 专属客服进行充值。具体充值金额、到账额度及计费规则,以平台页面或客服提供的信息为准。
完成账户充值或套餐购买后,可在 api-zeno 智能化平台中创建 API Key。
| 配置项 | 是否必填 | 说明 |
|---|---|---|
| API Key 名称 | 是 | 用于识别当前 API Key |
| 分组 | 是 | 选择 API Key 所属分组 |
| 剩余额度 | 是 | 设置 API Key 的可用额度 |
| 过期时间 | 否 | 设置 API Key 的失效时间 |
| RPM | 否 | 设置每分钟请求次数限制 |
| TPM | 否 | 设置每分钟 Token 数量限制 |
| 模型白名单 | 否 | 设置该 API Key 可调用的模型 |
| IP 白名单 | 否 | 设置允许调用该 API Key 的 IP 地址 |
| 检查项 | 检查内容 |
|---|---|
| Key 状态 | API Key 是否处于启用状态 |
| 有效期 | 过期时间是否设置正确 |
| 余额 | 可用余额是否已配置 |
| 调用限制 | RPM、TPM 等限制是否符合配置要求 |
| 模型权限 | 模型白名单是否已设置 |
| IP 权限 | IP 白名单是否已设置 |
| 标识信息 | API Key 名称和分组是否填写正确 |
API Key 创建并配置完成后,系统会生成对应的 API Key。使用接口时,需要同时配置 API Key 和统一的 Base URL。
Base URL:
https://apiway.top/v1
API Key:
请填写平台生成的 API KeyBase URL 为 https://apiway.top/v1。该地址为 API 接口地址,不是普通网页地址,直接通过浏览器访问返回 404 属于正常情况,不表示 API 服务不可用。
不同工具中的字段名称可能有所不同,具体字段名称以实际工具或客户端页面为准。
平台提供 API Key 的基础数据及状态信息。如需在平台外建立补充记录,可使用以下字段。相关额度、用量和状态数据以平台显示结果为准。
| 字段 | 内容 |
|---|---|
| Key 名称 | API Key 的名称或识别标记 |
| API Key | 平台生成的接口访问凭证 |
| 分组 | API Key 所属分组 |
| 创建时间 | API Key 的创建日期和时间 |
| 生效时间 | API Key 的开始生效时间 |
| 到期时间 | API Key 的失效时间 |
| 初始额度 | API Key 创建或充值时配置的额度 |
| 剩余额度 | API Key 当前可用额度 |
| 调用用量 | API Key 已产生的调用量 |
| RPM | 每分钟请求次数限制 |
| TPM | 每分钟 Token 数量限制 |
| 模型白名单 | API Key 可调用的模型范围 |
| IP 白名单 | 允许调用 API Key 的 IP 地址范围 |
| 当前状态 | 启用、停用或已过期 |
| 备注 | 其他补充说明 |
API Key 属于接口访问凭证,不应出现在公开网页、公开代码仓库、公开文档、未脱敏截图、客户端日志或故障记录中。
使用方反馈接口无法调用时,可按照以下顺序进行检查:
调用时间:
使用工具或客户端:
请求地址:
请求接口:
模型名称:
HTTP 状态码:
错误信息:
API Key 名称:
API Key 末尾字符:API Key 标识可记录 Key 名称或末尾部分,不应在故障记录、截图或公开文档中填写完整 API Key。