Photta API

Photta API virtual try-on, ghost mannequin en productfotografie via REST

In één zin

De Photta API is een op credits gebaseerde REST API: POST een productfoto naar een capability-endpoint, poll het status-endpoint elke paar seconden, download de voltooide afbeelding. Acht capabilities, één sleutel, één creditsaldo.

API-sleutel ophalen Lees de documentatie

Functionaliteiten: 8 functionaliteiten
Rate limit: 600 requests/min
Authenticatie: Bearer key
Patroon: async, polling

Elk getal op deze pagina is afkomstig uit de Photta-API-documentatie · gecontroleerd 2026-09-10

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.status

import 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"]

Functionaliteiten

Elk endpoint, per capability

Methode, pad, credits en typische duur, rechtstreeks uit de API-documentatie. Feiten op deze pagina zijn gecontroleerd aan de hand van de documentatie op de datum onderaan.

Talen

Nog geen SDK — en je hebt er geen nodig.

Drie kant-en-klare handleidingen die exact overeenkomen met wat de Photta-documentatie vandaag aanbeveelt.

Quickstart

Van registratie tot eerste afbeelding in vijf minuten.

Elke capability volgt hetzelfde patroon: authenticeren, versturen, pollen. Eén keer leren.

Stap 1: Meld je aan op ai.photta.app en genereer een live API-sleutel vanuit het Developers-dashboard.
Stap 2: POST de taak met je sleutel in de Authorization-header — de API retourneert direct een generatie-ID.
Stap 3: Poll hetzelfde endpoint elke 3 seconden totdat de status verandert in completed, download vervolgens de resultaat-URL.

Snelstartgids

Vragen

Dingen die developers vragen voor het aanmelden

Wat is de Photta API?

Photta's API is een op credits gebaseerde REST-service die professionele modefotografie genereert op basis van je productfoto's. Het is dezelfde pipeline die Photta's consumenten-apps aandrijft — virtual apparel try-on, jewelry try-on en ghost mannequin-extractie, beschikbaar gemaakt als acht capabilities waarop developers hun eigen tools kunnen bouwen.

Hoe kom ik aan een API-sleutel?

Meld je aan op ai.photta.app, open het Developers-gedeelte van het dashboard en klik op Generate API key. Je live sleutel begint met `photta_live_` gevolgd door 32 hex-tekens. Bewaar deze in een omgevingsvariabele — commit deze nooit naar versiebeheer en stuur deze nooit naar de browser.

Is er een gratis tier?

Nieuwe accounts ontvangen proef-credits die je aan elke capability kunt besteden. Zodra je klaar bent voor productie, neem je een abonnement met een hoger maandelijks creditsaldo. De rate limit is op elk abonnement gelijk: 600 requests per minuut per API-sleutel. Geen minimum per call.

Hoe snel is de generatie?

Try-on- en ghost mannequin-taken zijn doorgaans binnen 1.5 tot 4 minuten voltooid; brillenfoto's, detailfoto's en workflow-afbeeldingen in 20 tot 60 seconden; mannequin-generatie in 30 tot 60 seconden. Elk generatie-endpoint is asynchroon: POST retourneert direct een generatie-ID, en je pollt elke 3 tot 5 seconden totdat de taak gereed is. Er is geen langdurige HTTP-verbinding om te beheren.

Is er een officiële Photta-SDK?

Nog niet. Het ondersteunde integratiepad is pure REST via cURL, Node's native fetch of Python's requests-bibliotheek — alle drie zijn end-to-end gedocumenteerd op deze site, voor elke capability.

Referentie

De delen van de documentatie die je vaker dan eens zult openen.

Elk getal op deze pagina is afkomstig uit de Photta-API-documentatie · gecontroleerd 2026-09-10

Probeer de API in vijf minuten

Genereer een Photta API-sleutel, plak het bovenstaande cURL-fragment en je hebt je eerste afbeelding op een model voordat de koffie klaar is.

API-sleutel ophalen Snelstartgids

8 functionaliteiten
600 requests/min
Bearer key
async, polling