Photta API
Photta API virtual try-on, ghost mannequin e fotografia di prodotto via REST
In sintesi
La Photta API è una REST API a crediti: invia via POST la foto di un prodotto all'endpoint di una funzionalità, esegui il polling dell'endpoint di stato ogni pochi secondi, scarica l'immagine finale. 8 funzionalità, una chiave, un unico saldo crediti.
- Funzionalità: 8 funzionalità
- Rate limit: 600 richieste/min
- Autenticazione: Chiave Bearer
- Pattern: asincrono, polling
Ogni dato in questa pagina proviene da la documentazione dell'API di Photta · verificato
RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/tryon/apparel \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_type": "top",
"product_images": [
"https://cdn.yourstore.com/products/shirt-front.jpg"
],
"product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
"product_category": "t_shirt",
"mannequin_id": "mnk_f3a9b1",
"pose_id": "pose_c2d4e5",
"background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
"lock_background": true,
"resolution": "2K",
"aspect_ratio": "3:4",
"body_size": "M",
"expression": "neutral",
"user_instruction": "Keep the collar pattern crisp and centered."
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')const res = await fetch("https://api.photta.app/api/v1/tryon/apparel", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"product_type": "top",
"product_images": [
"https://cdn.yourstore.com/products/shirt-front.jpg"
],
"product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
"product_category": "t_shirt",
"mannequin_id": "mnk_f3a9b1",
"pose_id": "pose_c2d4e5",
"background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
"lock_background": true,
"resolution": "2K",
"aspect_ratio": "3:4",
"body_size": "M",
"expression": "neutral",
"user_instruction": "Keep the collar pattern crisp and centered."
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/tryon/apparel",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"product_type": "top",
"product_images": [
"https://cdn.yourstore.com/products/shirt-front.jpg"
],
"product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
"product_category": "t_shirt",
"mannequin_id": "mnk_f3a9b1",
"pose_id": "pose_c2d4e5",
"background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
"lock_background": True,
"resolution": "2K",
"aspect_ratio": "3:4",
"body_size": "M",
"expression": "neutral",
"user_instruction": "Keep the collar pattern crisp and centered."
},
)
data = res.json()["data"] # data["id"], data["status"]Funzionalità
Tutti gli endpoint, divisi per funzionalità
Metodo, path, crediti e tempistiche tipiche, direttamente dalla documentazione API. I dati di questa pagina sono verificati rispetto alla documentazione alla data indicata in calce.
- POST/api/v1/tryon/apparel
Virtual Try-On (Abbigliamento)
Applica un capo flat-lay su un manichino AI con l'espressione e la corporatura che preferisci. Quattro tipi di prodotto, cinque proporzioni.
5 credits a 2K · 6 credits a 4K1.5–4 min
Vedi l'endpoint - POST/api/v1/tryon/jewelry
Try-On di Gioielli
Primi piani stretti di collane, anelli, bracciali e orecchini su manichini dedicati per gioielli — con gestione accurata di riflessi e superfici minuscole.
5 credits a 2K · 6 credits a 4K1.5–4 min
Vedi l'endpoint - POST/api/v1/ghost-mannequin
Ghost Mannequin
Rimuovi il manichino dalla foto di un capo mantenendo intatta la struttura interna. Resa 3D o flat-lay, ideale per l'elaborazione in batch.
4 credits a 2K · 5 credits a 4K1.5–4 min
Vedi l'endpoint - POST/api/v1/ghost-mannequin/batch
Ghost Mannequin in Batch
Invia un'intera serie di foto di capi con una sola chiamata ed esegui il polling su un unico ID batch; ogni immagine viene tariffata e tracciata singolarmente.
4 credits a 2K · 5 credits a 4K1.5–4 min per image
Vedi l'endpoint - POST/api/v1/eyewear-studio
Eyewear Studio
Occhiali da vista e da sole renderizzati su modelli in primo piano, mantenendo la montatura fedele alla foto del tuo prodotto.
5 credits a 2K · 6 credits a 4K20–60 sec
Vedi l'endpoint - POST/api/v1/detail-photos
Foto dei Dettagli
Primi piani di cuciture, tessuti, minuterie metalliche ed etichette a partire da una sola foto del prodotto; un analizzatore suggerisce quali aree fotografare.
3 credits20–60 sec
Vedi l'endpoint - POST/api/v1/mannequins/generate
Generazione Manichini
Genera i tuoi manichini per abbigliamento o gioielli a partire da una serie di opzioni, quindi riutilizza i relativi ID in ogni chiamata di try-on.
4 credits30-60s
Vedi l'endpoint - POST/api/v1/workflows/{workflow_id}
Workflow
Esegui un workflow predefinito — ad esempio, un hero shot di gioielli — con una sola chiamata e ottieni un set completo di immagini finite.
4 credits a 2K · 5 credits a 4K20–60 sec / image
Vedi l'endpoint
Linguaggi
Nessun SDK per ora — e non ne hai bisogno.
Tre walkthrough pronti da incollare, perfettamente allineati con la documentazione ufficiale di Photta.
Node.js
Node.js
fetch nativo in Node 18+, helper di 20 righe, pronto per le server actions di Next.js.
LeggiPython
Python
Libreria requests + un wrapper di 30 righe. Funziona in Django, FastAPI, Celery, Lambda.
LeggicURL
cURL
Smoke test da 2 minuti per qualsiasi endpoint. Si integra con jq per le pipeline da terminale.
Leggi
Quickstart
Dalla registrazione alla prima immagine in 5 minuti.
Ogni funzionalità segue lo stesso schema: autenticazione, invio, polling. Lo impari una volta sola.
Passaggio 1: Registrati su ai.photta.app e genera una chiave API live dalla dashboard Developers.
Passaggio 2: Invia il job via POST con la tua chiave nell'header Authorization — l'API restituisce immediatamente un generation ID.
Passaggio 3: Esegui il polling dello stesso endpoint ogni 3 secondi finché lo status non passa a completed, poi scarica l'URL del risultato.
Domande frequenti
Cosa chiedono gli sviluppatori prima di registrarsi
Cos'è la Photta API?
La Photta API è un servizio REST a crediti che genera fotografie fashion professionali a partire dalle foto dei tuoi prodotti. È la stessa pipeline che alimenta le app consumer di Photta — virtual apparel try-on, try-on di gioielli ed estrazione ghost mannequin, esposta tramite 8 funzionalità su cui gli sviluppatori possono costruire i propri strumenti.
Come ottengo una chiave API?
Registrati su ai.photta.app, apri la sezione Developers della dashboard e clicca su Generate API key. La tua chiave live inizia con `photta_live_` seguito da 32 caratteri esadecimali. Conservala in una variabile d'ambiente — non committarla mai nel version control, non esporla mai nel browser.
Esiste un piano gratuito?
I nuovi account ricevono crediti di prova utilizzabili su qualsiasi funzionalità. Quando sarai pronto per la produzione, potrai sottoscrivere un piano con un monte crediti mensile più elevato. Il rate limit è identico per tutti i piani: 600 richieste al minuto per chiave API. Nessun minimo per singola chiamata.
Quanto è veloce la generazione?
I job di try-on e ghost mannequin richiedono tipicamente tra 1.5 e 4 minuti; scatti di occhiali, foto di dettaglio e immagini di workflow tra 20 e 60 secondi; la generazione di manichini tra 30 e 60 secondi. Ogni endpoint di generazione è asincrono: la chiamata POST restituisce subito un generation ID, dopodiché esegui il polling ogni 3-5 secondi fino al completamento del job. Nessuna connessione HTTP a lunga durata da gestire.
Esiste un SDK ufficiale di Photta?
Non ancora. Il percorso di integrazione supportato è REST puro tramite cURL, il fetch nativo di Node o la libreria requests di Python — tutti e tre documentati end-to-end su questo sito, per ogni funzionalità.
Riferimento
Le sezioni della documentazione che consulterai più di una volta.
Riferimento
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
Rate limit delle API Photta
Il rate limit delle API Photta, la relativa finestra, l'header Retry-After, l'intervallo di polling e i limiti di concorrenza per piano, tutti desunti dalla documentazione delle API.
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.
LeggiGuide
Cos'è un'API di virtual try-on?
Un'API di virtual try-on renderizza un capo su una modella o un modello a partire da una sola foto del prodotto. I parametri in ingresso, cosa restituisce, quanto costa e i tempi di esecuzione.
LeggiGuide
Che cos'è un'API di ghost mannequin?
Un'API di ghost mannequin rimuove il manichino dalla foto di un capo e ne ricostruisce la parte interna. Requisiti di input, output restituito e costi.
LeggiGuide
Migrazione da FASHN a Photta
Cosa cambia quando sposti un'integrazione di try-on virtuale da FASHN a Photta: autenticazione, request body, polling e addebito dei credits.
LeggiSviluppa
Crea con l'API di Photta
Otto guide pratiche end-to-end per l'API di Photta: un'app di try-on, un'app Shopify, un plugin WooCommerce, un worker Django, cataloghi in batch e automazione no-code.
LeggiConfronta
Le migliori API di virtual try-on
Come funzionano cinque API di virtual try-on — Photta, FASHN, FitRoom, Pixazo e Ayna. Cosa pubblica ciascuna, cosa omette e dove consultare i dettagli.
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.
- 8 funzionalità
- 600 richieste/min
- Chiave Bearer
- asincrono, polling