Reference · Risorse

Endpoint delle risorse dell'API Photta gli id di cui ogni generazione ha bisogno

In sintesi

Gli endpoint delle risorse restituiscono gli id accettati da una chiamata di generazione: manichini, pose, sfondi, calzature, attributi dei capi ed etichette del brand, oltre al saldo del tuo account e all'utilizzo. L'elenco non costa nulla.

Ottieni una chiave API Leggi la documentazione

Endpoint delle risorse: 13 endpoint di risorse
Autenticazione: Chiave Bearer
Limiti: 600 richieste/min

Ogni dato in questa pagina proviene da la documentazione dell'API di Photta · verificato 2026-09-10

Tutti gli endpoint delle risorse, con la chiamata per leggerli

Ciascuna sezione rimanda alla funzionalità che utilizza quegli id.

GET/api/v1/mannequins

Manichini

Elenca i modelli disponibili per il try-on di capi d'abbigliamento: i manichini di sistema di Photta, i tuoi caricamenti e quelli generati con l'API per la creazione dei manichini. Effettua una POST sullo stesso path per caricare un manichino personalizzato, che rimarrà privato per il tuo account. L'id va inserito in `mannequin_id` durante una chiamata di try-on.

curl https://api.photta.app/api/v1/mannequins \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/mannequins", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/mannequins",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

API di Virtual try-on

POST/api/v1/mannequins/jewelry

Manichini per gioielli

Carica un primo piano del modello per il try-on di gioielli. Il rendering dei gioielli è inquadrato su décolleté, orecchio, polso o mano, richiedendo quindi un set dedicato di manichini invece di quello a figura intera per l'abbigliamento.

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/mannequins/jewelry \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "image": "https://cdn.yourstore.com/models/emma-neck.jpg",
  "jewelry_type": "necklace",
  "gender": "female",
  "name": "Emma"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

const res = await fetch("https://api.photta.app/api/v1/mannequins/jewelry", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "image": "https://cdn.yourstore.com/models/emma-neck.jpg",
    "jewelry_type": "necklace",
    "gender": "female",
    "name": "Emma"
  }),
});
const { data } = await res.json(); // data.id, data.status

import os, requests

res = requests.post(
    "https://api.photta.app/api/v1/mannequins/jewelry",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
    json={
      "image": "https://cdn.yourstore.com/models/emma-neck.jpg",
      "jewelry_type": "necklace",
      "gender": "female",
      "name": "Emma"
    },
)
data = res.json()["data"]  # data["id"], data["status"]

API try-on per gioielli

GET/api/v1/poses

Pose

Elenca le pose richiedibili per un try-on, filtrabili per categoria e per il tipo di prodotto a cui si adattano. Passa l'id come `pose_id`; omettilo e l'API sceglierà una posa adatta al capo.

curl https://api.photta.app/api/v1/poses \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/poses", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/poses",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

API di Virtual try-on

GET/api/v1/garment-attributes

Lunghezza e vestibilità del capo

Restituisce le chiavi di lunghezza e vestibilità accettate dal try-on di abbigliamento. Invia la chiave, non una descrizione testuale libera, affinché la stessa camicia venga renderizzata allo stesso modo in tutto il catalogo.

curl https://api.photta.app/api/v1/garment-attributes \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/garment-attributes", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/garment-attributes",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

API di Virtual try-on

GET/api/v1/backgrounds

Sfondi

Elenca gli sfondi di sistema e i tuoi caricamenti per il try-on di capi d'abbigliamento, con paginazione a cursore. Effettua una POST sullo stesso path per caricare uno sfondo personalizzato; rimarrà privato per il tuo account.

curl https://api.photta.app/api/v1/backgrounds \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/backgrounds", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/backgrounds",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

API di try-on virtuale per occhiali

POST/api/v1/brand-labels

Etichette del brand

Carica l'immagine riutilizzabile di un'etichetta per i lavori su manichino invisibile e restituisce un id da passare come `brand_label_id`, sia per singoli job che per batch. GET elenca quelle salvate; DELETE ne rimuove una al raggiungimento del limite dell'account.

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/brand-labels \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "file": "@/path/to/pribrand-label.png",
  "name": "Pribrand Collar Label"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

const res = await fetch("https://api.photta.app/api/v1/brand-labels", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "file": "@/path/to/pribrand-label.png",
    "name": "Pribrand Collar Label"
  }),
});
const { data } = await res.json(); // data.id, data.status

import os, requests

res = requests.post(
    "https://api.photta.app/api/v1/brand-labels",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
    json={
      "file": "@/path/to/pribrand-label.png",
      "name": "Pribrand Collar Label"
    },
)
data = res.json()["data"]  # data["id"], data["status"]

API Ghost mannequin

GET/api/v1/footwear

Calzature

Elenca le opzioni di calzature per il try-on di abbigliamento, filtrabili per tipo e genere, con paginazione a cursore. Usalo per applicare le scarpe allo stesso modello che indossa il capo.

curl https://api.photta.app/api/v1/footwear \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/footwear", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/footwear",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

API di Virtual try-on

GET/api/v1/account

Account

Restituisce il saldo dei crediti suddiviso per origine, il tuo piano attuale e il prossimo rinnovo dei crediti. Leggilo prima di un batch voluminoso invece di riscontrare la carenza tramite un 402.

curl https://api.photta.app/api/v1/account \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/account", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/account",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

Workflows API

GET/api/v1/account/usage

Utilizzo

Conteggio delle generazioni e spesa dei crediti per la finestra di fatturazione del mese di calendario corrente, suddivisi tra job completati ed errori. È questo l'endpoint su cui basare i grafici, non il conteggio locale delle tue richieste.

curl https://api.photta.app/api/v1/account/usage \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/account/usage", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/account/usage",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

API batch per ghost mannequin

Domande sugli endpoint delle risorse

A cosa servono gli endpoint delle risorse?

Restituiscono gli id richiesti dalle chiamate di generazione — un manichino, una posa, uno sfondo, un'etichetta del brand — oltre allo stato del tuo account. Nessuna chiamata di questo gruppo genera immagini.

Le chiamate alle risorse costano crediti?

No. Il recupero degli elenchi è gratuito e anche i caricamenti in questo gruppo — un manichino personalizzato, uno sfondo, un'etichetta del brand — sono gratuiti. Paghi solo per le generazioni.

Come si pagina un elenco esteso?

Gli endpoint di elenco accettano un limite e un cursore: passa l'ultimo id visualizzato come `starting_after` e leggi la pagina successiva. Memorizza i risultati in cache invece di richiamare l'elenco a ogni richiesta.

Posso caricare i miei manichini e sfondi personali?

Sì. POST `/api/v1/mannequins`, POST `/api/v1/mannequins/jewelry`, POST `/api/v1/backgrounds` e POST `/api/v1/brand-labels` accettano tutti immagini personalizzate, e tutto ciò che carichi rimane privato per il tuo account.

Dove vengono utilizzati questi id

Ogni dato in questa pagina proviene da la documentazione dell'API di Photta · verificato 2026-09-10

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.

Crea un account e ottieni una chiave API API

13 endpoint di risorse
Chiave Bearer
600 richieste/min