跳到正文
九维AI开放平台使用文档

开发指南

Python 调用九维 AI:标准库文本请求示例

用 Python 标准库读取环境变量、发送文本生成请求并处理 HTTP 错误,无需安装 SDK,适合验证接入配置。

成都九维数创科技有限公司 · 文档团队更新于 约 6 分钟阅读
本页目录
  1. 准备参数
  2. 最小可用代码
  3. 集成到业务程序
  4. 验证通过的标准

准备参数#

本示例使用 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 文件、没有报语法错误,不能说明上游生成已经正常。

准备好开始了吗?

在控制台选择账户可用模型,先用一条简单请求验证配置。

打开 Playground