参考 · 速率限制
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 响应头,等待对应的秒数,然后以指数退避策略重试。应将任务排队处理,而不是直接丢弃。
端点与参考文档
功能特性
虚拟 try-on API 适用于服装
将服装穿在 AI 模特身上的 REST API。异步处理,1.5–4 分钟生成耗时,2K 分辨率 5 credits,4K 分辨率 6 credits。提供 cURL、Node.js 与 Python 示例代码。
阅读功能特性
首饰试穿 API 适用于项链、戒指、手链和耳环
通过 REST 将项链、戒指、手链和耳环穿戴至 AI 模特身上。2K 规格单次 5 credits,内置特写模特,具备 Photta 文档所述的反光感知渲染能力。
阅读功能特性
幽灵模特 API 适用于镂空模特商品图
AI 幽灵模特 endpoint。从服装照片中移除模特,完整保留内部细节。支持 3D 或平铺效果,支持批量处理,2K 分辨率 4 credits。
阅读参考
5 分钟内生成第一张 Photta 图像。
注册、生成 API 密钥、运行第一个 cURL 调用、轮询直至完成、持久化保存结果。共五个步骤,端到端完整记录。
阅读参考
Photta API 身份验证
如何通过 Photta API 进行身份验证:Authorization 请求头、密钥前缀、密钥创建位置以及如何安全轮换密钥。
阅读参考
Photta API 定价
Photta API 各个 endpoint 在 2K 和 4K 分辨率下的 credits 成本、扣费与退款机制,以及哪些 endpoint 是免费的。没有按单张图片收取的货币价格。
阅读参考
Photta API 错误
Photta API 错误类型的完整列表及其状态码、错误响应体的结构,以及哪些失败情况值得重试。
阅读参考
Photta API 资源 endpoint
列出人体模型、姿势、背景、鞋履及品牌标签,上传自定义资产,并读取您的 credits 余额。每次生成背后的查询基础。
阅读
本页所有数据均来自 Photta API 文档 · 已验证
五分钟内上手试用 API
生成 Photta API key,粘贴上方的 cURL 代码片段,咖啡还没煮好,你的第一张模特实穿图就已经生成完毕。
- 600 次请求/分钟
- Retry-After: 30s
- 异步,轮询