额度查询(预警用 · 免费)
查询各已购产品剩余点数 / 包月剩余天数与今日用量,便于客户端提前告警。 不扣点;建议轮询间隔 ≥ 1 分钟(限流约 30 次/分钟)。
| 接口地址 | https://syapi.chuangye.site/home/api/quota |
|---|---|
| 请求方式 | GET(推荐) / POST |
| 计费 | 免费(charge=0) |
| 名称 | 必填 | 说明 |
|---|---|---|
uid | 是 | 用户 UID |
key | 是 | 接口密钥 |
product | 否 | 产品编码;不传则返回全部已购产品(也可用 code) |
成功响应要点(code=0)
| data.balance | 账户余额(元) |
|---|---|
| data.warn_count | 需关注的产品数(额度紧张 / 将过期 / 用尽等) |
| data.products[].remain | 包点=剩余点数;包月=剩余天数 |
| data.products[].used_today | 今日已用(成功计次) |
| data.products[].limit_today | 包月日限;0 或不适用时为 0;不限见 today_remain=-1 |
| data.products[].today_remain | 今日剩余;包月日限不限时为 -1 |
| data.products[].expire_at | 包月到期时间;包点为空 |
| data.products[].status | ok / expiring / expired / empty |
| data.products[].warn | 1 建议告警,0 正常 |
{
"code": 0,
"msg": "ok",
"charge": 0,
"data": {
"balance": 10.5,
"warn_count": 1,
"summary": {"total": 2, "ok": 1, "expiring": 1, "expired": 0, "empty": 0},
"products": [
{
"code": "dsp",
"name": "短视频解析",
"type": 1,
"spec": "包点",
"remain": 80,
"remain_text": "80 点",
"used_today": 12,
"limit_today": 0,
"today_remain": 80,
"expire_at": "",
"dckd": 1,
"status": "ok",
"status_text": "正常",
"warn": 1,
"is_default": 1
}
]
}
}
常见问题
如何获取 UID / KEY? 注册并登录后,本页「在线调试」会自动填入;也可在控制台查看。
是不是 GET? 不是。请 POST JSON 到业务地址 https://syapi.chuangye.site/api/inpaint/v1,不要走短视频的 /home/api?url=。
要传什么? 必填 uid、key;原图三选一(image_base64 / image_url / image_id);蒙版至少一种(常用 rectangles)。详见「API 文档 / 示例代码」。
如何计费? 成功调用扣 1 点,失败不扣;可在本页「立即购买」开通包点或包月。
有免费额度吗? 新用户注册即可免费测试:每个独立计费产品赠送 20 次调用额度(失败不扣点),用完后需购买套餐。「共用默认池」产品与短视频共用同一份额度。