Viite · Autentikointi

Photta API -autentikointi yksi avain, yksi otsake

Yhdellä lauseella

Lähetä avaimesi muodossa `Authorization: Bearer photta_live_xxx` jokaisessa Photta API -kutsussa. Avaimet luodaan hallintapaneelissa, ne eivät sisällä endpoint-kohtaisia scoppeja ja ne jakavat yhteisen credits-saldon.

Hanki API-avain Lue dokumentaatio

Autentikointi: Bearer-avain
Rajoitukset: 600 pyyntöä/min
Käsittely: asynkroninen, polling

Jokainen luku tällä sivulla on peräisin Photta-rajapinnan dokumentaatiosta · tarkistettu 2026-09-10

Mitä API odottaa

Autentikointi lyhyesti

Otsake: Authorization: Bearer photta_live_xxx
Avaimen etuliite: photta_live_
Base URL: https://api.photta.app/api/v1
Mistä avaimet luodaan: https://ai.photta.app
Skooppi: Yksi avain kattaa jokaisen endpointin ja yhden credits-saldon

Tarkista avain yhdellä kutsulla

Account-endpoint on maksuton, joten se on turvallinen tapa varmistaa avaimen toimivuus.

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

Avainten käsittely

Kierrätä epäilyksen herätessä
Dokumentaatio on yksiselitteinen: kierrätä avain välittömästi, jos epäilet sen vaarantuneen. Luo ensin korvaava avain, ota se käyttöön ja poista vasta sitten vanha käytöstä.
Pidä se palvelimella
Selaimeen päätyvä avain on kenen tahansa sivun avaavan saatavilla. Kutsu APIa taustajärjestelmästäsi ja välitä tulokset asiakasohjelmalle.
401 viittaa avaimeen, ei pyyntöön
Puuttuva, virheellinen tai vanhentunut avain palauttaa koodin `authentication_error`. Tarkista otsake kirjoitusvirheiden ja ylimääräisten välilyöntien varalta ennen kuin etsit vikaa muualta.
Yksi saldo jokaisen avaimen taustalla
Avaimia ei ole rajattu kykykohtaisesti. Useat avaimet useissa eri ympäristöissä kuluttavat silti samaa credits-saldoa, jonka GET `/api/v1/account` palauttaa.

Kysymyksiä autentikoinnista

Miten todennan pyynnön?

Lähetä avain Authorization-otsakkeessa Bearer-tokenina jokaisella kutsulla. Erillistä kirjautumis- tai tokeninvaihtovaihetta ei ole.

Missä luon avaimen?

Photta-hallintapaneelissasi. Samasta paikasta saat korvaavat avaimet, joihin dokumentaatio ohjaa virhekoodin 401 jälkeen.

Voinko kutsua rajapintaa selaimesta?

Et avaimellasi. Kaikki selaimeen toimitettu on kävijöiden luettavissa, joten sijoita kutsu oman palvelimesi taakse ja välitä tulos eteenpäin.

Mitä jos avain vuotaa?

Kierrätä se välittömästi — luo uusi avain, ota se käyttöön ja poista sitten vanha. Jo kulutettuja credits-yksiköitä ei voi palauttaa, joten kierrätä avain ensin ja tutki asia vasta sen jälkeen.

Endpointit ja viitteet

Jokainen luku tällä sivulla on peräisin Photta-rajapinnan dokumentaatiosta · tarkistettu 2026-09-10

Kokeile APIa viidessä minuutissa

Luo Photta-API-avain, liitä yllä oleva cURL-koodinpätkä, ja sinulla on ensimmäinen mallikuva ennen kuin kahvi ehtii tippua.

Luo tili ja hanki API-avain API

Bearer-avain
600 pyyntöä/min
asynkroninen, polling