快速开始#
从选择一个具体模型，到发出第一条请求。下面的例子采用本站网关支持的 OpenAI Chat 兼容格式。
API 调用以服务端目录、密钥权限与可用额度为准，执行示例会发起真实计费请求。充值请登录个人工作台，或打开充值页面办理；图片、音视频及其他协议是否可用取决于实际型号与渠道配置，不因文档中有示例就视为开通。
1. 选择具体模型#
在模型广场查看已发布型号、协议与分组售价，复制完整模型 ID。首次调用请选择 openai-chat 协议的文本型号，并核对目录中的 maxOutputTokens。
- 日常文本与代码任务：查看「文本」分类。
- 图片创作与编辑：查看「图片」分类及实际支持的协议。
- 视频任务：仅在目录和供应商通道均已配置后使用，不承诺当前可用。
2. 准备地址与密钥#
登录个人工作台，按服务端配置与账户权限创建真实应用 Key。密钥仅按页面提示展示，不提供演示 Key。核对本人余额与冻结额度，将应用密钥放在自己服务端的环境变量中。
网页地址随业务域切换；下载 .md 使用 123ali.com 示例，请以工作台的 Base URL 为准。未知或预览域不提供接入地址。
cURL / Shell
# Base URL 使用当前业务域对应的 api 子域，含 /v1
export AI_RELAY_BASE_URL="https://api.123ali.com/v1"
# 在私有服务端环境设置 AI_RELAY_API_KEY，不要写进公开代码
# 将 AI_RELAY_MODEL 设为目录中支持 openai-chat 的真实型号
# 将 AI_RELAY_MAX_TOKENS 设为不超过该型号 maxOutputTokens 的正整数
AI_RELAY_BASE_URL 已包含 /v1，后续请求只追加接口路径，例如 /chat/completions。中转站可复制所选真实型号的代码示例，复制本身不会执行请求。
3. 发出第一条请求#
cURL / Shell
: "${AI_RELAY_API_KEY:?请在私有环境设置应用密钥}"
: "${AI_RELAY_MODEL:?请设置目录中的真实模型 ID}"
: "${AI_RELAY_MAX_TOKENS:?请设置目录允许的最大输出 Token}"
python3 -c 'import json, os; print(json.dumps({"model": os.environ["AI_RELAY_MODEL"], "messages": [{"role": "user", "content": "用一句话介绍你能做什么。"}], "max_tokens": int(os.environ["AI_RELAY_MAX_TOKENS"])}))' \
| curl --fail-with-body "$AI_RELAY_BASE_URL/chat/completions" \
-H "Authorization: Bearer $AI_RELAY_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @-
常规文本回答从 choices[0].message.content 读取。流式返回、图片和视频的响应结构不同，分别参考对应章节。请求中断或结果不确定时，先在调用记录核对状态、用量与费用，再决定是否重试。