Referanse · Autentisering
Photta API-autentisering én nøkkel, én header
I én setning
Send nøkkelen din som `Authorization: Bearer photta_live_xxx` i hvert Photta API-kall. Nøkler opprettes i dashbordet, har ingen scopes per endpoint, og deler én kredittsaldo.
- Autentisering: Bearer-nøkkel
- Grenser: 600 forespørsler/min
- Prosessering: asynkron, polling
Hvert tall på denne siden er hentet fra dokumentasjonen for Photta-API-et · verifisert
Hva API-et forventer
Autentisering i et nøtteskall
- Header
- Authorization: Bearer photta_live_xxx
- Nøkkelprefiks
- photta_live_
- Base-URL
- https://api.photta.app/api/v1
- Hvor nøkler opprettes
- https://ai.photta.app
- Scope
- Én nøkkel når hvert endpoint og én felles kredittsaldo
Verifiser en nøkkel i ett kall
Konto-endpointet er gratis, så det er den trygge måten å bekrefte at en nøkkel fungerer på.
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 av nøkler
Roter ved mistanke
Dokumentasjonen er tydelig: roter en nøkkel umiddelbart hvis du mistenker at den er kompromittert. Generer erstatningen først, distribuer den, og trekk deretter tilbake den gamle.
Hold den på serveren
En nøkkel som når en nettleser, når alle som åpner siden. Gjør API-kall fra backend og videresend resultatene til klienten.
401 gjelder nøkkelen, ikke forespørselen
En manglende, ugyldig eller utløpt nøkkel returnerer `authentication_error`. Sjekk headeren for skrivefeil og ekstra mellomrom før du feilsøker noe annet.
Én saldo bak hver nøkkel
Nøkler har ikke scope per funksjon. Flere nøkler for ulike miljøer bruker likevel fra samme kredittsaldo, som rapporteres av GET `/api/v1/account`.
Spørsmål om autentisering
Hvordan autentiserer jeg en forespørsel?
Send nøkkelen i Authorization-headeren som et bearer-token ved hvert kall. Det finnes ingen separat innlogging eller tokenutveksling.
Hvor oppretter jeg en nøkkel?
I Photta-dashbordet ditt. Samme sted utsteder erstatningsnøkler, som er det dokumentasjonen henviser deg til etter en 401.
Kan jeg kalle API-et fra nettleseren?
Ikke med nøkkelen din. Alt som sendes til en nettleser kan leses av brukerne, så legg kallet bak din egen server og videresend resultatet.
Hva om en nøkkel lekker?
Roter den umiddelbart — generer en ny nøkkel, rull den ut, og slett deretter den gamle. Credits som allerede er brukt kan ikke refunderes, så roter først og undersøk etterpå.
Endpoints og referanser
Funksjoner
Virtuell try-on API for klær
REST API som plasserer klær på AI-mannequiner. Asynkront, 1,5–4 minutters generering, 5 credits i 2K, 6 i 4K. Eksempler for cURL, Node.js og Python.
LesFunksjoner
API for smykke-try-on for halskjeder, ringer, armbånd og øredobber
Plasser halskjeder, ringer, armbånd og øredobber på AI-modeller via REST. 5 credits ved 2K, innebygde nærbilde-mannekenger, refleksjonsbevisst rendering fra Photta-dokumentasjonen.
LesFunksjoner
Ghost mannequin-API for hollow-man-produktbilder
AI ghost mannequin-endepunkt. Fjern mannekengen fra et klesbilde og bevar innvendige detaljer. 3D eller flat-lay, batch-prosessering, 4 credits i 2K.
LesReferanse
Første Photta-bilde på under fem minutter.
Registrer deg, generer en API-nøkkel, kjør ditt første cURL-kall, utfør polling til det er fullført, lagre resultatet. Fem trinn, dokumentert fra start til slutt.
LesReferanse
Photta API-priser
Hva hvert Photta API-endepunkt koster i credits ved 2K og 4K, hvordan trekk og refusjoner fungerer, og hvilke endepunkter som er gratis. Ingen pengepris per bilde.
LesReferanse
Photta API rate limits
Photta API-ets rate limit, tidsvinduet, Retry-After-headeren, polling-intervallet og grensene for samtidighet per plan, alt hentet fra API-dokumentasjonen.
LesReferanse
Photta API-feil
Den fullstendige listen over Photta API-feiltyper med deres statuskoder, strukturen på en feilrespons, og hvilke feil det er verdt å prøve på nytt.
LesReferanse
Photta API-ressursendepunkter
List utstillingsdukker, positurer, bakgrunner, fottøy og merkevareetiketter, last opp dine egne og les av saldoen for credits. Oppslagene bak hver generering.
Les
Hvert tall på denne siden er hentet fra dokumentasjonen for Photta-API-et · verifisert
Prøv API-et på fem minutter
Generer en Photta API-nøkkel, lim inn cURL-kodesnutten ovenfor, og du har ditt første bilde på modell før kaffen er ferdig traktet.
- Bearer-nøkkel
- 600 forespørsler/min
- asynkron, polling