余额与价格

用 API Key 查询这个 Key 能调用的模型与参数定义、我的价格、点数余额，以及开通需要开通的场景应用。这些查询接口都不扣点。

模型目录

GEThttps://api.miaozuo.cn/v1/models

GEThttps://api.miaozuo.cn/v1/models/{id}

返回这个 Key 能调用的模型（已按渠道等级可见范围、Key 的「可调用的模型」过滤），价格是我的价格。列表返回 {"object": "list", "data": [模型]}；单个模型不可见或不存在时返回 404 model_unavailable。

cURL

# 这个 Key 能调用的模型（含参数定义与我的价格）
curl https://api.miaozuo.cn/v1/models \
  -H "Authorization: Bearer $MIAOZUO_API_KEY"

# 单个模型
curl https://api.miaozuo.cn/v1/models/qwen-image-3.0 \
  -H "Authorization: Bearer $MIAOZUO_API_KEY"

单个模型（params_schema 节选）

{
  "id": "qwen-image-3.0",
  "object": "model",
  "created": 1791534856,
  "owned_by": "miaozuo",
  "name": "千问图像 3.0",
  "summary": "文字一键出图，支持参考图改图，商品主图、种草配图都拿手",
  "category": "image",
  "category_name": "生图",
  "output_kind": "image",
  "interface": "tasks",
  "params_schema": {
    "type": "object",
    "required": [
      "prompt"
    ],
    "properties": {
      "prompt": {
        "type": "string",
        "title": "画面描述",
        "minLength": 1,
        "maxLength": 1500
      },
      "…": "…"
    }
  },
  "pricing": [
    {
      "unit": "image",
      "unit_name": "张",
      "sku": "resolution=1k",
      "unit_price": "33.000",
      "base_unit_price": "33.000",
      "price_label": "原价"
    },
    {
      "unit": "image",
      "unit_name": "张",
      "sku": "resolution=2k",
      "unit_price": "33.000",
      "base_unit_price": "33.000",
      "price_label": "原价"
    }
  ],
  "settle": "quote",
  "billing": {
    "mode": "per_unit",
    "unit": "image",
    "dims": [
      "resolution"
    ],
    "quantity": {
      "from": "param",
      "field": "count"
    },
    "settle": "quote"
  },
  "timeout_minutes": 15,
  "requires_activation": false
}

字段	说明
`id`	模型编码，提交任务、调用文本接口时填它
`name` / `summary`	模型名称与一句话简介
`category` / `category_name` / `output_kind`	能力类型与产出类型（image / video / audio / text 等）
`interface`	调用方式：`tasks` 用异步任务，`chat` 用文本模型接口
`params_schema`	参数定义（JSON Schema），`input` 按它校验；文本模型为 `null`。各模型文档页的参数表就是从它生成的
`pricing`	价格列表，每项：`unit` / `unit_name`（计价单位）、`sku`（规格，`*` 表示全部规格）、`unit_price`（我的单价）、`base_unit_price`（原价）、`price_label`（价格名称，如「原价」「月度会员价」「金牌渠道价」）
`billing`	计价方式：`mode`、计价单位、按哪些参数分规格（`dims`）、数量从哪里来（`quantity`）、结算方式，见计费与点数
`settle`	`quote`：按提交时的报价扣点；`actual`：按实际用量结算
`timeout_minutes`	最长处理时间（分钟），超时的任务按失败处理、全额退点
`requires_activation` / `activation`	是否需要先开通；需要开通时多一个 `activation`：是否已开通、到期时间、开通价、有效天数

我的价格

GEThttps://api.miaozuo.cn/v1/pricing

一次拿到这个 Key 能调用的全部模型、全部规格的价格。会员看到会员价，渠道看到所属等级价，没有优惠时与原价相同。文本模型的单位是 m_in_token / m_out_token（每百万输入 / 输出 Token）。

cURL

curl https://api.miaozuo.cn/v1/pricing \
  -H "Authorization: Bearer $MIAOZUO_API_KEY"

返回示例（金牌渠道，节选）

{
  "object": "list",
  "currency": "points",
  "data": [
    {
      "model": "qwen-image-3.0",
      "name": "千问图像 3.0",
      "unit": "image",
      "unit_name": "张",
      "sku": "resolution=1k",
      "unit_price": "28.050",
      "base_unit_price": "33.000",
      "price_label": "金牌渠道价"
    },
    {
      "model": "deepseek-v4-flash",
      "name": "DeepSeek V4 Flash",
      "unit": "m_in_token",
      "unit_name": "百万输入 Token",
      "sku": "*",
      "unit_price": "127.500",
      "base_unit_price": "150.000",
      "price_label": "金牌渠道价"
    },
    {
      "model": "deepseek-v4-flash",
      "name": "DeepSeek V4 Flash",
      "unit": "m_out_token",
      "unit_name": "百万输出 Token",
      "sku": "*",
      "unit_price": "255.000",
      "base_unit_price": "300.000",
      "price_label": "金牌渠道价"
    }
  ]
}

点数余额

GEThttps://api.miaozuo.cn/v1/balance

cURL

curl https://api.miaozuo.cn/v1/balance \
  -H "Authorization: Bearer $MIAOZUO_API_KEY"

返回示例

{
  "object": "balance",
  "available": "106877.784",
  "frozen": "0.000",
  "owed": "0.000",
  "credit_limit": "0.000",
  "credit_available": "0.000",
  "spendable": "106877.784",
  "key": {
    "name": "生产环境",
    "quota": "500.000",
    "quota_period": "day",
    "quota_used": "33.000",
    "quota_remaining": "467.000",
    "quota_reset_at": "2026-10-10T00:00:00+08:00",
    "expires_at": null
  }
}

字段	说明
`available`	可用点数
`frozen`	进行中的任务与文本调用已冻结的点数
`owed`	已用授信（欠款加进行中调用占用的授信），充值入账时优先归还
`credit_limit` / `credit_available`	授信额度与剩余可用授信（渠道账户才有，其他为 `"0.000"`）
`spendable`	现在最多还能花的点数（可用点数加剩余授信），低于一次调用的冻结额时返回 402 `insufficient_points`
`key`	当前 Key 的额度：`quota`（额度上限，`null` 为不限）、`quota_period`（`none` / `day` / `week` / `month`，按周期自动重置）、`quota_used`、`quota_remaining`、`quota_reset_at`（下次重置时间）、`expires_at`（Key 到期时间）。额度用完返回 402 `key_quota_exceeded`

充值请登录秒做账户。

开通场景应用

POSThttps://api.miaozuo.cn/v1/apps/{model}/activate

requires_activation 为 true 的模型要先开通才能通过开放 API 调用，否则返回 403 app_not_activated，不扣点。开通也可以在开放平台操作。

开通价从点数里扣，有效期见模型的 activation.days；已开通未到期时再调用即续期，从当前到期时间往后顺延。
不需要开通的模型调用此接口返回 422 invalid_params；点数不足返回 402 insufficient_points。

cURL

# 开通（或续期）一个需要开通的场景应用，开通价从点数里扣
curl -X POST https://api.miaozuo.cn/v1/apps/<模型编码>/activate \
  -H "Authorization: Bearer $MIAOZUO_API_KEY"

返回示例

{
  "object": "app_activation",
  "model": "<模型编码>",
  "activated": true,
  "starts_at": "2026-10-09T17:20:00+08:00",
  "expires_at": "2026-11-08T17:20:00+08:00",
  "forever": false,
  "price_paid": "99.000"
}