Referensi · Autentikasi

Autentikasi Photta API satu key, satu header

Ringkasan singkat

Kirim key Anda sebagai `Authorization: Bearer photta_live_xxx` pada setiap panggilan Photta API. Key dibuat di dashboard, tidak memiliki scope per-endpoint, dan berbagi satu saldo credits.

Dapatkan API key Baca dokumentasi

Autentikasi: Bearer key
Batasan: 600 requests/min
Pemrosesan: async, polling

Setiap angka di halaman ini bersumber dari dokumentasi API Photta · diperiksa 2026-09-10

Apa yang diharapkan API

Sekilas tentang autentikasi

Header: Authorization: Bearer photta_live_xxx
Prefiks key: photta_live_
Base URL: https://api.photta.app/api/v1
Tempat key dibuat: https://ai.photta.app
Scope: Satu key mengakses setiap endpoint dan satu saldo credits

Periksa key dalam satu panggilan

Endpoint akun bersifat gratis, sehingga ini adalah cara aman untuk memastikan key berfungsi.

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

Pengelolaan key

Rotasi jika dicurigai bocor
Dokumentasi menyatakan secara eksplisit: segera rotasi key jika Anda mencurigai key tersebut telah disusupi. Buat penggantinya terlebih dahulu, deploy, lalu nonaktifkan key yang lama.
Simpan di sisi server
Key yang sampai ke browser bisa diakses oleh siapa saja yang membuka halaman tersebut. Panggil API dari backend Anda dan teruskan hasilnya ke klien.
401 merujuk pada key, bukan request
Key yang tidak ada, tidak valid, atau kedaluwarsa akan mengembalikan `authentication_error`. Periksa header untuk typo dan spasi berlebih sebelum mencari penyebab lainnya.
Satu saldo di balik setiap key
Key tidak dibatasi scope-nya per kapabilitas. Beberapa key untuk beberapa environment tetap menggunakan saldo credits yang sama, yang dilaporkan oleh GET `/api/v1/account`.

Pertanyaan seputar autentikasi

Bagaimana cara mengautentikasi request?

Kirim key di header Authorization sebagai bearer token pada setiap panggilan. Tidak ada langkah login atau token-exchange terpisah.

Di mana saya membuat key?

Di dasbor Photta Anda. Tempat yang sama juga menerbitkan pengganti, yang dirujuk oleh dokumentasi setelah terjadi 401.

Bisakah saya memanggil API dari browser?

Tidak dengan key Anda. Apa pun yang dikirim ke browser dapat dibaca oleh pengunjungnya, jadi tempatkan panggilan di balik server Anda sendiri dan teruskan hasilnya.

Bagaimana jika key bocor?

Segera lakukan rotasi — buat key baru, deploy, lalu hapus key yang lama. Credits yang sudah terpakai tidak dapat dipulihkan, jadi lakukan rotasi terlebih dahulu dan selidiki setelahnya.

Endpoint dan referensi

Setiap angka di halaman ini bersumber dari dokumentasi API Photta · diperiksa 2026-09-10

Coba API dalam lima menit

Buat Photta API key, tempel cuplikan cURL di atas, dan Anda akan mendapatkan gambar on-model pertama sebelum kopi selesai diseduh.

Buat akun dan dapatkan API key API

Bearer key
600 requests/min
async, polling