开发指南
Python 调用九维 AI:标准库文本请求示例
用 Python 标准库读取环境变量、发送文本生成请求并处理 HTTP 错误,无需安装 SDK,适合验证接入配置。
准备参数#
本示例使用 Python 3 标准库,不依赖某个 SDK 版本。先在控制台创建密钥,从账户模型列表复制精确文本模型 ID,并确认余额。
bash
export AI_ROUTER_API_BASE='https://9weisc.cn/v1'
export AI_ROUTER_API_KEY='sk-ar-请替换为你的完整密钥'
export AI_ROUTER_MODEL='请替换为你的精确模型ID'环境变量里的密钥不要提交到源码。以下代码发送一次生成请求,会产生实际费用。
最小可用代码#
python
import json
import os
import urllib.error
import urllib.request
base = os.environ["AI_ROUTER_API_BASE"].rstrip("/")
key = os.environ["AI_ROUTER_API_KEY"]
model = os.environ["AI_ROUTER_MODEL"]
payload = {
"model": model,
"messages": [{"role": "user", "content": "列出周报应包含的三个部分。"}],
"max_tokens": 256,
"stream": False,
}
request = urllib.request.Request(
base + "/chat/completions",
data=json.dumps(payload, ensure_ascii=False).encode("utf-8"),
headers={
"Authorization": "Bearer " + key,
"Content-Type": "application/json",
},
method="POST",
)
try:
with urllib.request.urlopen(request, timeout=120) as response:
result = json.load(response)
print("request_id:", response.headers.get("X-Request-ID", ""))
print(result.get("choices", [{}])[0].get("message", {}).get("content", ""))
except urllib.error.HTTPError as error:
print("HTTP:", error.code)
print("request_id:", error.headers.get("X-Request-ID", ""))
print(error.read().decode("utf-8", errors="replace"))
except urllib.error.URLError as error:
print("连接失败;请先核对原请求状态再决定是否重新提交。", error.reason)输出字段按 OpenAI 兼容文本接口举例;使用其他协议时,应按其响应结构处理结果。
集成到业务程序#
把请求封装为后端函数,并设置输入长度、输出上限和超时。日志保留请求 ID、模型 ID和状态,不要输出完整 Authorization 请求头。
对 429 或明确的容量拒绝,可以读取 Retry-After 控制重试节奏。对网络中断和不确定的生成执行,不要直接无限重试付费 POST。
验证通过的标准#
收到真实模型内容,在平台用量中看到对应记录,并正确处理一次失败响应。只运行了 Python 文件、没有报语法错误,不能说明上游生成已经正常。
准备好开始了吗?
在控制台选择账户可用模型,先用一条简单请求验证配置。