参考 · 速率限制

Photta API 速率限制 以及如何合理进行轮询

一句话总结

Photta API 在固定窗口内允许每个 API key 每分钟发出 600 次请求。429 响应会返回 Retry-After: 30。每隔 3 秒轮询一次任务;并发处理量受套餐限制。

  • 限制: 600 次请求/分钟
  • Retry-After: Retry-After: 30s
  • 处理方式: 异步,轮询

本页所有数据均来自 Photta API 文档 · 已验证

公开的限制指标

速率、窗口、重试、图像尺寸和格式,均与文档规范一致。

限制

  • 每个 API 密钥每分钟 600 次请求 (固定窗口;各套餐限制相同)
  • 429 响应包含 Retry-After: 30 秒
  • 单张图片最大 10 MB
  • 格式:: JPEG, PNG, WebP
  • 各套餐并发批处理数:: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
  • 仅支持轮询 — API 不发送 Webhook。

各套餐的并发任务量

在提交返回 409 之前,最多可以同时处理多少个批次。

各套餐进行中的批次数

Free

并发数: 1

Hobby

并发数: 2

Seller

并发数: 3

Brand

并发数: 4

Studio

并发数: 6

保持在限制范围内

  • 固定窗口

    限制按固定窗口内的单个 API key 计算,且适用于所有套餐。两个 key 意味着两份配额额度。

  • 每隔 3 秒轮询一次

    轮询是唯一的完成状态信号——API 不发送 webhook。文档推荐的轮询间隔为每 3 秒一次;过高频的轮询只会在空结果上白白消耗你的配额。

  • 指数退避

    收到 429 后,等待 Retry-After 指定的秒数,随后若继续失败则逐步延长重试间隔,而不是以固定频率重试。

  • 批处理并发独立受限

    rate limit 统计请求次数;并发上限统计处理中的任务数。超出上限的批处理任务将返回 409,而非 429。

速率限制相关问题

rate limit 是多少?

每个 API key 每分钟 600 次请求,采用固定时间窗口。文档在每个 endpoint 上都标明了相同的数值。

应该以什么频率 polling 任务状态?

每 3 秒一次。目前不支持 webhook,因此 polling 是官方文档指定的获取任务完成状态的方式。

同时最多能渲染多少?

处理中的批处理任务受套餐限制:Free 为 1,Hobby 为 2,Seller 为 3,Brand 为 4,Studio 为 6。超出上限的提交将返回 409。

遇到 429 应该怎么处理?

读取 Retry-After 响应头,等待对应的秒数,然后以指数退避策略重试。应将任务排队处理,而不是直接丢弃。

端点与参考文档

本页所有数据均来自 Photta API 文档 · 已验证

五分钟内上手试用 API

生成 Photta API key,粘贴上方的 cURL 代码片段,咖啡还没煮好,你的第一张模特实穿图就已经生成完毕。

  • 600 次请求/分钟
  • Retry-After: 30s
  • 异步,轮询