OpenAI 兼容 API 接入山猫云：先核对分组和价格，再发最小请求

产品方说明：山猫云是本人参与开发的产品，本文包含自荐入口，由 AI 辅助整理。页面信息核对于 2026 年 10 月 4 日；下方代码是接入示例，本次没有用新客户账户完成付费调用，不是性能评测。

如果你已经有使用 OpenAI Python SDK 的程序，接入一个多模型平台时，最容易漏掉的往往不是 URL，而是令牌分组、模型权限和计费单位。这里用山猫云说明一次小额试接应该检查什么。

1. 先选任务，再选入口

你要完成的事	入口	先核对什么
在自己的程序里调用模型	模型价格页、控制台令牌管理	模型名、所属分组、输入/输出价格
不写代码，生成一张创意海报	图片工作台	单次报价、商品细节是否改变
试作一首音乐	音乐工作台	每日/月度免费额度、付费按钮选择
生成口播视频	数字人工作台	免费模式与按文稿对口型模式的区别

应用生成价格和底层 API 价格不是同一项费用，不能把图片工作台的报价直接当作图片 API 的单价。

音乐页当前显示每日最多 1 首、每月总量 10 首免费额度，付费生成 0.79 元/首。数字人免费模式不按文稿对口型；付费对口型页面显示 0.45 元/秒。实际提交前仍以对应任务页面报价为准。

2. 令牌分组会影响能调用什么

登录后进入控制台的令牌管理，新建令牌时选择分组。山猫文档说明，分组决定可用模型和计费路径。同一个模型名出现在多个分组里，也不代表所有分组价格相同。

建议先在价格页找到要用的模型及分组，再创建对应令牌。页面某些线路比列出的官方价格更高，所以这里不作"全平台最低价"的承诺；多模型接入是否方便，应结合你的实际项目判断。

查看模型和价格

3. Python SDK 最小请求示例

本地已有 openai Python SDK 时，可以用下面的配置。SANMAO_MODEL 填你选定分组实际可用的模型名；令牌放在本机环境变量里，不写进源码。

python 复制代码

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://www.sanmao.fun/v1",
    api_key=os.environ["SANMAO_API_KEY"],
    timeout=30.0,
    max_retries=0,
)

response = client.chat.completions.create(
    model=os.environ["SANMAO_MODEL"],
    messages=[{"role": "user", "content": "只回复：你好"}],
    max_tokens=32,
)
print(response.choices[0].message.content)
print(response.usage)

这是针对支持 Chat Completions 的模型的最小示例，不适用于所有模型和端点。部分模型对参数有额外要求，应按对应模型文档调整。限制输出长度是为了降低首次试接用量，不表示请求免费；max_retries=0 用于避免 SDK 在排错期间自动重试。

不要把真实令牌贴进评论区、截图或代码仓库。确认返回内容后，再检查控制台使用日志中的模型、渠道、用量和实际扣费。

4. 请求不通时，分四层检查

地址层：base_url 包含 /v1，但不要把 /chat/completions 再拼进 SDK 的 base_url。
身份层：检查令牌是否正确、有效；分享错误信息时去掉 Authorization 和令牌。
权限层：检查令牌分组是否支持这个模型，模型名是否完全一致。
业务层：检查余额、模型可用性、限流提示和请求参数。超时后先检查任务或使用日志，再决定是否重试，尤其是按次收费的生成任务。

HTTP 返回成功、模型正常回答、费用符合预期，是三个不同的检查点。先用一个小请求确认，再把它接入批量任务。

5. 适合怎样试用

对开发者，建议拿自己已有的一个小任务试接，比较实际输出、接入时间和账单，而不是只比较模型数量。对不想写代码的内容创作者，可以先看应用工作台的免费额度和样例，再决定是否使用收费任务。

欢迎在评论中说明你要接入的客户端、模型和具体报错，或者需要完成的素材任务；请不要发送密钥。本文不承诺生成效果、商业收益或素材商用授权，使用前请核对实际用途所需的条款。