MANYAN / TEAM API
团队 API
仅用于已授权的自建 PopReels 渠道开发者。团队 Key 的余额、价格、退款和请求记录与普通用户完全隔离。
查询团队余额
Key 只用于本次浏览器请求，不会写入页面、URL 或服务器日志。余额不足时请联系管理员充值。
--当前余额（积分）
--累计充值
--累计使用
--进行中任务
鉴权
每个请求都必须携带团队 Key：
Authorization: Bearer sk_team_...
查询余额与用量
GET /team/v1/usage 返回当前余额、累计充值、累计使用、进行中任务，以及 balance_status、recharge_required 和 recharge_hint。状态为 low（余额 ≤ 10 积分）或 depleted（余额耗尽）时，应暂停提交并联系管理员。
cURL
curl -s -H "Authorization: Bearer $TEAM_API_KEY" https://manyanai.top/team/v1/usagePython
import requests
response = requests.get("https://manyanai.top/team/v1/usage", headers={"Authorization": f"Bearer {TEAM_API_KEY}"})
usage = response.json()
print(usage["balance"], usage["balance_status"], usage["recharge_required"])查询模型
GET /team/v1/models
响应中的 reference_limits 会返回当前模型的图片、音频和视频参考数量限制。
参考素材限制
| kind | 单类上限 | 要求 |
|---|---|---|
image | 30 | 公开可访问的 JPG/JPEG/PNG URL |
audio | 10 | 公开可访问的 MP3/WAV URL，2–30 秒 |
video | 10 | 公开可访问的 MP4 URL，2–30 秒 |
每个请求独立校验，单类上限为 30 图 / 10 音频 / 10 视频，三类合计最多 30 个；不会跨请求累计，也不会与普通 API 的长期素材库共享额度。公网 URL 必须能从 ManyanAI 服务器直接读取，不能使用 Base64 或 /api/assets 的 asset_id。
提交生成
POST /team/v1/video/generations
Content-Type: application/json
Idempotency-Key: unique-request-001
{"model":"popreels-self-seedance-2.5-480p-30s","prompt":"A cinematic city walk","duration":30,"aspect_ratio":"9:16","numberOfRuns":1,"references":[{"kind":"image","url":"https://example.com/reference.png"},{"kind":"audio","url":"https://example.com/voice.mp3"},{"kind":"video","url":"https://example.com/reference.mp4"}]}轮询任务
| 方法 | 路径 | 作用 |
|---|---|---|
| GET | /team/v1/video/generations/{job_id} | 查询状态、结果和本次扣费/退款 |
| GET | /team/v1/usage | 查询余额、累计充值、累计使用、进行中任务 |
下载结果
任务完成后，job.result_url 用于在线预览，job.download_url 是可直接请求的完整 HTTPS 下载地址。本地签名下载地址约 48 小时有效，无需再次携带团队 Key；服务端下载程序请直接请求 download_url，不要单独请求相对的 result_url。
失败任务会自动退回团队余额；重复的 Idempotency-Key 不会重复扣费。完整请求、响应、错误和调账记录仅管理员可见。团队余额不使用普通用户充值入口，请联系管理员充值。