Referens · Autentisering
Photta API-autentisering en nyckel, en header
I en mening
Skicka din nyckel som `Authorization: Bearer photta_live_xxx` vid varje anrop till Photta API. Nycklar skapas i kontrollpanelen, har inget omfång per endpoint och delar på samma saldo av credits.
- Autentisering: Bearer-nyckel
- Gränser: 600 requests/min
- Bearbetning: asynkron, polling
Varje siffra på den här sidan kommer från Photter API-dokumentationen · kontrollerad
Vad API:et förväntar sig
Autentisering i korthet
- Header
- Authorization: Bearer photta_live_xxx
- Nyckelprefix
- photta_live_
- Bas-URL
- https://api.photta.app/api/v1
- Var nycklar skapas
- https://ai.photta.app
- Omfång
- En nyckel når varje endpoint och ett gemensamt saldo av credits
Validera en nyckel med ett anrop
Konto-endpointen är gratis, så det är det säkra sättet att bekräfta att en nyckel fungerar.
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"]Hantera nycklar
Rotera vid misstanke
Dokumentationen är tydlig: rotera en nyckel omedelbart om du misstänker att den har komprometterats. Generera ersättaren först, distribuera den, och avaktivera sedan den gamla.
Håll den på servern
En nyckel som når en webbläsare når alla som öppnar sidan. Anropa API:et från din backend och skicka resultaten vidare till klienten.
401 beror på nyckeln, inte anropet
En saknad, ogiltig eller utgången nyckel returnerar `authentication_error`. Kontrollera headern efter stavfel och oönskade blanksteg innan du letar någon annanstans.
Ett saldo bakom varje nyckel
Nycklar har inte begränsat omfång per funktion. Flera nycklar för flera miljöer förbrukar fortfarande samma saldo av credits, vilket GET `/api/v1/account` rapporterar.
Frågor om autentisering
Hur autentiserar jag en förfrågan?
Skicka nyckeln i Authorization-headern som en bearer-token vid varje anrop. Det finns inget separat inloggnings- eller tokenutbytessteg.
Var skapar jag en nyckel?
I din Photta-dashboard. Samma ställe utfärdar ersättningsnycklar, vilket är vad dokumentationen hänvisar till efter en 401.
Kan jag anropa API:et från webbläsaren?
Inte med din nyckel. Allt som skickas till en webbläsare kan läsas av dess besökare, så lägg anropet bakom din egen server och vidarebefordra resultatet.
Vad händer om en nyckel läcker?
Rotera den omedelbart — generera en ny nyckel, driftsätt den och ta sedan bort den gamla. Förbrukade credits kan inte återfås, så rotera först och undersök efteråt.
Endpoints och referenser
Funktioner
API för virtuell try-on för apparel
REST API som placerar kläder på AI-mannekänger. Asynkron, 1,5–4 minuters generering, 5 credits vid 2K, 6 vid 4K. Exempel för cURL, Node.js och Python.
LäsFunktioner
API för smyckes-try-on för halsband, ringar, armband och örhängen
Placera halsband, ringar, armband och örhängen på AI-modeller via REST. 5 credits vid 2K, inbyggda närbildsprovdockor, reflexmedveten rendering från Photta-dokumentationen.
LäsFunktioner
Ghost mannequin-API för hollow-man-produktfoton
AI ghost mannequin-endpoint. Ta bort dockan från ett plaggfoto och bevara detaljerna på insidan. 3D eller flat-lay, batchbearbetning, 4 credits i 2K.
LäsReferens
Första Photta-bilden på under fem minuter.
Skapa konto, generera en API-nyckel, kör ditt första cURL-anrop, polla tills det är klart, spara resultatet. Fem steg, dokumenterade från början till slut.
LäsReferens
Photta API-prissättning
Vad varje Photta API-endpoint kostar i credits i 2K och 4K, hur debitering och återbetalning fungerar, samt vilka endpoints som är gratis. Inget fast pris i pengar per bild.
LäsReferens
Photta API rate limits
Photta API:s rate limit, dess fönster, Retry-After-headern, polling-intervallet och taken för samtidighet per abonnemang, allt hämtat från API-dokumentationen.
LäsReferens
Photta API-fel
Den fullständiga listan över feltyper i Photta API med deras statuskoder, strukturen på ett felmeddelande, och vilka fel som är värda att försöka igen.
LäsReferens
Photta API-resursendpoints
Lista mannekänger, poser, bakgrunder, skor och varumärkesetiketter, ladda upp dina egna och läs av ditt credits-saldo. Uppslagningarna bakom varje generering.
Läs
Varje siffra på den här sidan kommer från Photter API-dokumentationen · kontrollerad
Testa API:et på fem minuter
Generera en Photta API-nyckel, klistra in cURL-kodfragmentet ovan, och du har din första bild på en modell innan kaffet har bryggts klart.
- Bearer-nyckel
- 600 requests/min
- asynkron, polling