计费规则与用量限制 | transcript1 docs

transcript1按音视频时长计费。先确认套餐的分钟额度和用量限制，再查看分钟数的计算、扣除和重置规则。

套餐价格与额度

	Free	Monthly	Annual
价格	$0，无需信用卡	每月$9	每年$90
分钟额度	60分钟，发放一次	每月1,000分钟	每月1,000分钟
充值价格	不支持充值	$6购买1,000分钟	$5购买1,000分钟
每分钟请求上限	30	200	300
活跃任务上限	2	10	20

管理套餐或充值，请打开控制台的“Billing”页面。

一次转录扣多少分钟

每1分钟音视频消耗1积分，不足1分钟按1分钟算。例如61秒的视频扣2分钟，单次至少扣1分钟。
上传文件、YouTube、X、TikTok、Instagram、Facebook、Bluesky链接及其他受支持的视频来源，每分钟价格都相同。时长以实际测量为准：提取平台字幕按视频时长计费，语音转文字按音频时长计费。YouTube和X字幕的计费规则与TikTok、Bluesky相同。
同一个视频即使已经处理过，再次提交转录仍会扣费。如果只是要取回自己最近生成的转录文本，设置reuse_recent=true，就不会重复扣费。具体用法见API参考。
如果转录失败或被取消，不会扣费；已经扣除的分钟数会退还。

如何领取免费分钟

每个账号有60分钟免费额度，验证邮箱后发放；用Google或Microsoft注册则直接发放。这份额度只发一次，Free套餐不会定期补充分钟数。邮箱尚未验证时，调用POST /v1/transcriptions会返回403 email_not_verified。

套餐额度与充值分钟怎么扣

可用分钟数分为两部分：

周期分钟数是套餐自带的额度，每个周期开始时重置，没用完的部分不累积到下个周期。Monthly和Annual都是每月1,000分钟。
充值分钟数需要另外购买，每包1,000分钟，每次可买1到20包。只有付费套餐支持充值。转录会先扣周期分钟数，用完后再扣充值分钟数。只要付费套餐有效，充值分钟数就不过期。

取消付费套餐后，账号回到Free，不再有周期分钟数。已充值的分钟仍会保留，但要重新开通付费套餐才能使用。从Free升级时，没用完的免费分钟会转为充值分钟数。

查询剩余分钟数

调用GET /v1/account即可查询余额，查询本身不扣费：

curl https://api.transcript1.com/v1/account \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY"

字段	含义
`minutes.remaining`	当前可用分钟数。等于`cycle`；`topup_usable`为`true`时，再加上`topup`。
`minutes.cycle`	本周期还剩多少套餐分钟。
`minutes.topup`	账号保留的充值分钟数。
`minutes.topup_usable`	充值分钟数是否可用；付费套餐有效时为`true`。
`minutes.resets_at`	下次重置周期分钟数的时间；没有则为`null`。
`limits`	包含请求上限`requests_per_minute`和活跃任务上限`max_active_jobs`。

响应还会返回套餐plan和续费时间renews_at。

分钟数用完后，POST /v1/transcriptions会返回402 insufficient_minutes，可通过其中的action_url打开“Billing”页面。余额降到0时还会收到邮件提醒，每个周期最多发送一次。

每分钟能发多少请求

请求上限按账号计算。同一账号的API密钥、控制台会话和MCP连接共用这份额度。

每分钟请求上限：Free为30次，Monthly为200次，Annual为300次。每个计数窗口为1分钟。
通过认证的/v1请求，响应头都会包含X-RateLimit-Limit和X-RateLimit-Remaining，分别表示请求上限和当前窗口剩余次数。
超出上限会返回429 rate_limited。按Retry-After响应头给出的秒数等待，到下个窗口再试。
上传分块用上传Token认证，不占用这份请求额度。

同时可以运行多少任务

状态为queued、fetching或transcribing的转录都算活跃任务。Free最多2个，Monthly最多10个，Annual最多20个。达到上限后再创建转录，会返回429 too_many_active_jobs和Retry-After响应头。等现有任务完成后再试。

分块上传还处于awaiting_upload时，不算活跃任务。不过每个团队最多同时保留20个未完成的上传，超出也会返回429 too_many_active_jobs。完成上传会让任务进入队列，因此这一步仍会检查活跃任务上限。

各类错误的处理方法见错误说明。