OVHcloud AI Endpoints 免费开放 7 个模型：内容审核、SDXL 出图与多语语音合成

1. 端点与鉴权

平台提供 OpenAI 兼容端点，base_url 的形态为 https://oai.endpoints.kepler.ai.cloud.ovh.net/v1，具体路径以控制台模型详情页显示为准。鉴权方式与 OpenAI 一致：在请求头中带 Authorization: Bearer 你的令牌。令牌在 Public Cloud 项目的 AI Endpoints 页面生成。

export OVH_AI_BASE_URL="https://oai.endpoints.kepler.ai.cloud.ovh.net/v1"
export OVH_AI_API_KEY="你的访问令牌"

2. 模型名从哪里来

免费模型名可直接在控制台的模型目录里复制，当前清单包括 Qwen3Guard-Gen-0.6B、Qwen3Guard-Gen-8B（内容审核）、stable-diffusion-xl-base-1.0（图像生成），以及 NVIDIA Riva 的四个 TTS 音色（英、德、西、意）。请求里的 model 字段必须与控制台显示的名称完全一致，大小写错误会直接返回模型不存在的报错。

3. 调用内容审核模型

Qwen3Guard-Gen 属于生成式审核模型，走的是对话补全接口，把待审文本放进用户消息里，让它输出安全判定结论。

curl -s "$OVH_AI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $OVH_AI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Qwen3Guard-Gen-0.6B",
    "messages": [
      {"role": "user", "content": "请判断这句话是否包含违规内容：今晚八点老地方见。"}
    ],
    "temperature": 0,
    "max_tokens": 64
  }'

关键参数说明：model 选审核模型；messages 是标准的角色消息数组；temperature 设为 0 可让判定结果更稳定；max_tokens 限制输出长度，审核场景一般给几十个 token 就够，可以节省额度；stream 设为 true 可流式返回，但批量过审时通常不需要。

4. 调用 SDXL 出图

图像生成走图像接口，参数比对话更简单，主要是提示词与尺寸。

curl -s "$OVH_AI_BASE_URL/images/generations" \
  -H "Authorization: Bearer $OVH_AI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "stable-diffusion-xl-base-1.0",
    "prompt": "a quiet harbor at sunrise, soft light, photographic",
    "size": "1024x1024",
    "n": 1
  }'

返回体通常包含图片的链接或 base64 数据，具体字段以控制台文档为准；出图耗时明显长于文本请求，客户端超时时间建议调大。

5. Python 最小示例

如果服务端已经在环境变量里配置好 base_url 和令牌，可以直接用官方 SDK，把 base_url 换掉即可。

import os
from openai import OpenAI

client = OpenAI(
    base_url=os.environ["OVH_AI_BASE_URL"],
    api_key=os.environ["OVH_AI_API_KEY"],
)

resp = client.chat.completions.create(
    model="Qwen3Guard-Gen-0.6B",
    messages=[{"role": "user", "content": "请判断这句话是否包含违规内容：今晚八点老地方见。"}],
    temperature=0,
    max_tokens=64,
)
print(resp.choices[0].message.content)

6. 额度耗尽与限流的典型表现

• 401 未授权：令牌错误或未带上请求头，检查令牌是否属于当前项目、是否已复制完整。
• 403 禁止访问：项目未开通该模型或账号状态异常，回控制台确认模型是否在可用清单内。
• 404 模型不存在：model 名称拼写与大小写不符，或该模型不在免费清单里。
• 429 请求过多：触发每分钟请求数或免费额度的速率限制，应降低并发、加指数退避重试，并确认免费额度是否已用尽。
• 5xx 或超时：多为服务端瞬时问题，先重试一次，再检查出图这类长耗时请求的客户端超时设置。

排查顺序建议：核对 base_url 与令牌，再核对模型名，然后查看响应状态码与错误正文，最后到控制台的用量页确认剩余额度。免费额度用完通常表现为持续 429，并不会自动转成付费调用，是否升级需要自己在控制台确认。