Riferimento · Rate limit
Rate limit delle API Photta e come eseguire il polling in modo corretto
In sintesi
L'API Photta consente 600 richieste al minuto per API key in una finestra fissa. Un 429 include Retry-After: 30. Esegui il polling di un job ogni 3 secondi; i processi concorrenti sono limitati in base al piano.
- Limiti: 600 richieste/min
- Retry-After: Retry-After: 30s
- Elaborazione: asincrono, polling
Ogni dato in questa pagina proviene da la documentazione dell'API di Photta · verificato
I limiti pubblicati
Frequenza, finestra, retry, dimensione delle immagini e formati, esattamente come indicati nella documentazione.
Limiti
- 600 richieste al minuto per API key (Finestra fissa; il limite è lo stesso per ogni piano)
- Un 429 restituisce Retry-After: 30 secondi
- Fino a 10 MB per immagine
- Formati: JPEG, PNG, WebP
- Batch simultanei per piano: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
- Solo polling — l'API non invia webhook.
Lavoro concorrente per piano
Quanti batch possono essere in corso contemporaneamente prima che un invio restituisca 409.
Batch in corso per piano
Free
Concorrenti: 1
Hobby
Concorrenti: 2
Seller
Concorrenti: 3
Brand
Concorrenti: 4
Studio
Concorrenti: 6
Rimanere entro i limiti
Una finestra fissa
Il limite è conteggiato per API key in una finestra fissa, ed è identico per ogni piano. Due chiavi equivalgono a due budget.
Esegui il polling ogni 3 secondi
Il polling è l'unico segnale di completamento — l'API non invia webhook. L'intervallo documentato è ogni 3 secondi; eseguirlo più rapidamente consuma il tuo budget con risposte vuote.
Applica un backoff esponenziale
Dopo un 429, attendi i secondi indicati in Retry-After e poi aumenta l'intervallo a ogni ulteriore fallimento invece di riprovare a frequenza fissa.
I batch hanno un cap separato
Il rate limit conta le richieste; il cap di concorrenza conta i job in corso. Un batch che supera il cap restituisce 409, non 429.
Domande sui rate limit
Qual è il rate limit?
600 richieste al minuto per API key, su finestra fissa. La documentazione riporta la stessa cifra per ogni endpoint.
Ogni quanto dovrei fare il polling di un job?
Ogni 3 secondi. Non ci sono webhook, quindi il polling è il metodo documentato per sapere quando un job è completato.
Quanti elementi si possono renderizzare contemporaneamente?
I batch in corso sono limitati in base al piano: Free 1, Hobby 2, Seller 3, Brand 4 e Studio 6. Oltre il cap, l'invio restituisce 409.
Cosa dovrei fare in caso di 429?
Leggi l'header Retry-After, attendi quel numero di secondi e riprova con backoff esponenziale. Metti in coda il lavoro invece di scartarlo.
Endpoint e riferimenti
Funzionalità
API di Virtual try-on per abbigliamento
REST API per applicare capi di abbigliamento su manichini AI. Generazione asincrona in 1.5–4 minuti, 5 crediti a 2K, 6 a 4K. Esempi per cURL, Node.js e Python.
LeggiFunzionalità
API try-on per gioielli per collane, anelli, bracciali e orecchini
Applica collane, anelli, bracciali e orecchini su modelli AI tramite REST. 5 credits a 2K, manichini in primo piano integrati, rendering con gestione dei riflessi dalla documentazione di Photta.
LeggiFunzionalità
API Ghost mannequin per foto prodotto con manichino invisibile
Endpoint AI per ghost mannequin. Rimuovi il manichino dalla foto di un capo e preserva i dettagli interni. 3D o flat-lay, elaborazione in batch, 4 credits a 2K.
LeggiRiferimento
La prima immagine con Photta in meno di cinque minuti.
Registrati, genera una chiave API, esegui la tua prima chiamata cURL, fai polling fino al completamento, salva il risultato. Cinque passaggi, interamente documentati.
LeggiRiferimento
Autenticazione Photta API
Come autenticarsi con la Photta API: l'header Authorization, il prefisso della chiave, dove vengono create le chiavi e come effettuarne la rotazione in sicurezza.
LeggiRiferimento
Prezzi dell'API Photta
Il costo in crediti di ogni endpoint delle API di Photta a 2K e 4K, il funzionamento di addebiti e rimborsi, e quali endpoint sono gratuiti. Nessun prezzo monetario per immagine.
LeggiRiferimento
Errori delle API di Photta
L'elenco completo dei tipi di errore delle API di Photta con i relativi codici di stato, la struttura del payload di errore e quali fallimenti ha senso riprovare.
LeggiRiferimento
Endpoint delle risorse dell'API Photta
Elenca manichini, pose, sfondi, calzature ed etichette del brand, carica i tuoi e visualizza il saldo crediti. I lookup dietro ogni generazione.
Leggi
Ogni dato in questa pagina proviene da la documentazione dell'API di Photta · verificato
Prova l'API in 5 minuti
Genera una chiave API di Photta, incolla lo snippet cURL qui sopra e otterrai la tua prima immagine con modello prima ancora che il caffè sia pronto.
- 600 richieste/min
- Retry-After: 30s
- asincrono, polling