Reference · Autentifikation
Photta API-autentifikation én nøgle, én header
I én sætning
Send din nøgle som `Authorization: Bearer photta_live_xxx` ved hvert Photta API-kald. Nøgler oprettes i kontrolpanelet, har ingen scopes pr. endpoint og deler én credits-saldo.
- Autentifikation: Bearer key
- Grænser: 600 requests/min
- Behandling: async, polling
Hvert tal på denne side stammer fra Photta API-dokumentationen · tjekket
Hvad API'et forventer
Autentifikation i korte træk
- Header
- Authorization: Bearer photta_live_xxx
- Nøglepræfiks
- photta_live_
- Base-URL
- https://api.photta.app/api/v1
- Hvor nøgler oprettes
- https://ai.photta.app
- Scope
- Én nøgle giver adgang til hvert endpoint og én credits-saldo
Tjek en nøgle med ét kald
Konto-endpointet er gratis, så det er den sikre måde at bekræfte, at en nøgle virker.
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"]Håndtering af nøgler
Rotér ved mistanke
Dokumentationen er tydelig: Rotér en nøgle med det samme, hvis du har mistanke om, at den er kompromitteret. Opret erstatningen først, udrul den, og træk derefter den gamle tilbage.
Behold den på serveren
En nøgle, der når en browser, når alle, der åbner siden. Kald API'et fra din backend, og videresend resultaterne til klienten.
401 gælder nøglen, ikke anmodningen
En manglende, ugyldig eller udløbet nøgle returnerer `authentication_error`. Tjek headeren for slåfejl og overskydende mellemrum, før du leder andre steder.
Én saldo bag hver nøgle
Nøgler er ikke afgrænset pr. funktionalitet. Flere nøgler til flere miljøer bruger stadig den samme credits-saldo, som GET `/api/v1/account` rapporterer.
Spørgsmål om autentifikation
Hvordan godkender jeg en anmodning?
Send nøglen i Authorization-headeren som et bearer token på hvert kald. Der er intet separat login- eller token-exchange-trin.
Hvor opretter jeg en nøgle?
I dit Photta-dashboard. Samme sted udsteder erstatninger, hvilket er det, dokumentationen henviser til efter en 401.
Kan jeg kalde API'et fra browseren?
Ikke med din nøgle. Alt, der sendes til en browser, kan læses af dens besøgende, så læg kaldet bag din egen server og videresend resultatet.
Hvad hvis en nøgle bliver lækket?
Roter den med det samme — generer en ny nøgle, udrul den, og slet derefter den gamle. Credits, der allerede er brugt, kan ikke gendannes, så roter først og undersøg bagefter.
Endpoints og referencer
Funktioner
Virtuel try-on API til tøj
REST API, der placerer tøj på AI-mannequiner. Asynkront, 1.5–4 minutters generering, 5 credits ved 2K, 6 ved 4K. cURL-, Node.js- og Python-eksempler.
LæsFunktioner
Try-on-API til smykker til halskæder, ringe, armbånd og øreringe
Placér halskæder, ringe, armbånd og øreringe på AI-modeller via REST. 5 credits ved 2K, indbyggede close-up-mannequiner, refleksionsbevidst rendering fra Photta-dokumentationen.
LæsFunktioner
Ghost mannequin API til hollow-man-produktfotos
AI ghost mannequin-endpoint. Fjern mannequinen fra et tøjbillede og bevar indvendige detaljer. 3D eller flat-lay, batchbehandling, 4 credits ved 2K.
LæsReference
Første Photta-billede på under fem minutter.
Opret en konto, generer en API-nøgle, kør dit første cURL-kald, foretag polling indtil det er fuldført, gem resultatet. Fem trin, dokumenteret fra start til slut.
LæsReference
Photta API-priser
Hvad hvert Photta API-endpoint koster i credits ved 2K og 4K, hvordan debitering og refundering fungerer, og hvilke endpoints der er gratis. Ingen faste pengepriser pr. billede.
LæsReference
Photta API rate limits
Photta API-rate limit, dets vindue, Retry-After-headeren, polling-intervallet og lofterne for samtidighed pr. abonnement, alt sammen aflæst fra API-dokumentationen.
LæsReference
Photta API-fejl
Den komplette liste over Photta API-fejltyper med deres statuskoder, strukturen på fejlsvaret, og hvilke fejl det kan betale sig at prøve igen.
LæsReference
Photta API-ressource-endpoints
Oplist giner, poseringer, baggrunde, fodtøj og brandlabels, upload dine egne, og aflæs din credits-saldo. Opslagene bag enhver generering.
Læs
Hvert tal på denne side stammer fra Photta API-dokumentationen · tjekket
Prøv API'et på fem minutter
Generér en Photta API-nøgle, indsæt cURL-kodestykket ovenfor, og du har dit første billede på en model, før kaffen er færdigbrygget.
- Bearer key
- 600 requests/min
- async, polling