媒体模型开放能力接口

本接口用于查询网关当前已开放的图片、视频模型，以及每个模型支持的参数和参考素材要求。

这是模型能力查询接口，不是图片或视频生成接口。

基本信息

基础地址：https://media.maomaotoken.com
请求方式：GET
鉴权：无需登录，无需 API Key
默认响应格式：application/json
缓存时间：最长 60 秒

1. 查询全部已开放模型

GET /v1/media/models

curl 'https://media.maomaotoken.com/v1/media/models'

响应示例：

{
  "success": true,
  "data": {
    "items": [
      {
        "model": "example-image-model",
        "media_type": "image",
        "modes": ["text_to_image", "image_edit"],
        "generation_modes": ["sync"],
        "parameters": {
          "imageSize": ["1K", "2K"],
          "aspectRatio": ["1:1", "16:9"]
        },
        "inputs": {
          "reference_images": {
            "max_count": 2,
            "max_size_mb": 10,
            "formats": ["jpg", "png"],
            "source_types": ["url", "base64"]
          }
        },
        "billing": {
          "unit": "request",
          "mode": "price",
          "value": 0.1
        },
        "note": "模型说明"
      }
    ],
    "total": 1
  }
}

2. 查询指定模型

GET /v1/media/models/{model_name}

curl 'https://media.maomaotoken.com/v1/media/models/example-image-model'

model_name 必须使用列表接口返回的 model 原值。如果模型名包含空格、中文或特殊字符，需要先进行 URL 编码。

响应示例：

{
  "success": true,
  "data": {
    "model": "example-image-model",
    "media_type": "image",
    "billing": {
      "unit": "request"
    }
  }
}

未开放、已停用或不存在的模型会返回 404：

{
  "success": false,
  "message": "模型能力未发布"
}

字段说明

字段	说明
`model`	调用生成接口时使用的模型名
`media_type`	媒体类型，当前主要为 `image` 或 `video`
`modes`	支持的任务模式，例如文生图、图片编辑
`generation_modes`	支持同步或异步生成
`parameters`	尺寸、比例、清晰度、时长等可用参数
`inputs`	参考图片、视频或音频的数量、大小和格式限制
`billing.unit`	计费单位：`request`、`second` 或 `image`
`billing.mode`	`price` 表示固定价格，`ratio` 表示计费倍率
`billing.value`	与 `billing.mode` 对应的价格或倍率
`note`	模型的补充说明

不同模型的能力不同，未启用或不适用的字段可能不会出现。接入时请将除 model、media_type 以外的字段按可选字段处理。

浏览器从其他站点直接请求时，该站点域名还需符合网关的 CORS 设置。curl 和服务端请求不受浏览器 CORS 限制。

人工查看 JSONC

调试时可以请求带中文注释的 JSONC：

curl 'https://media.maomaotoken.com/v1/media/models?format=jsonc'

也可以使用请求头：

curl -H 'Accept: application/jsonc' \
  'https://media.maomaotoken.com/v1/media/models'

JSONC 包含注释，不是标准 JSON。程序正式接入时请使用默认 JSON 响应。

快速测试

先请求 /v1/media/models，确认 success 为 true 且 data.items 不为空。
从 data.items 复制一个 model 值。
请求 /v1/media/models/{model_name}，确认返回的模型和能力配置一致。
在后台修改该模型能力并保存，最长等待 60 秒后再次请求。