Bangun dengan konteks.

API pemeriksa publik

Pemeriksa situs gratis memanggil endpoint yang aman untuk browser tanpa kunci API tenant. Gambar dan video sampel tidak memiliki kuota pemindaian harian atau bulanan. Batas ukuran media, piksel terdekode, jumlah bingkai, dan validasi tetap berlaku. Permintaan memerlukan izin tepat berupa Origin.

curl --fail-with-body -sS https://api.isthisaigenerated.app/v1/public/image-check \
  -H 'Origin: https://isthisaigenerated.app' \
  -F 'file=@./photo.jpg'

# A fresh image queues. The reply then carries job_id and job_token; poll with the
# token in the header until status is "completed", starting about a second later.
curl --fail-with-body -sS https://api.isthisaigenerated.app/v1/public/jobs/JOB_ID \
  -H 'Origin: https://isthisaigenerated.app' \
  -H 'X-Job-Token: JOB_TOKEN'

Hasilnya adalah sinyal peringatan, bukan bukti asal-usul. Lihat referensi Swagger langsung, atau unduh OpenAPI JSON untuk skema permintaan dan respons, header, serta kode kesalahan.

Akun tanpa kata sandi dan kunci API

POST /v1/auth/magic-links menerima sebuah email dan selalu mengembalikan teks penerimaan yang umum. Pakai token sekali-pakainya dengan POST /v1/auth/magic-links/consume; responsnya memasang cookie sesi HTTP-only dan mengembalikan token CSRF. Simpan CSRF di sessionStorage, kirim credentials: include, dan sertakan X-CSRF-Token beserta Origin tepercaya pada penulisan dari browser.

Integrasi server mengirim Authorization: Bearer $API_KEY. Jangan pernah menaruh kunci di kode browser, localStorage, URL, log, atau atribut data.

Token dan penagihan prabayar

Setiap akun menerima 100 token gratis tiap bulan UTC. Token berbayar tidak hangus. Paketnya 1.000 seharga €5, 5.000 seharga €25 , dan 20.000 seharga €100: €0,005/token, pembayaran Stripe sekali bayar, tanpa langganan dan tanpa tagihan kelebihan otomatis.

HTTP 402 berarti token habis, 409 berarti kunci idempotensi bentrok, dan 503 berarti penagihan sedang tidak tersedia.

Pemeriksaan gambar

POST /v1/assets/check menerima JSON dengan JPEG base64 atau multipart dengan berkas JPEG/PNG.

curl "$BASE_URL/assets/check" \
  -H "Authorization: Bearer $API_KEY" \
  -F "file=@./sample.jpg" \
  -F "client_asset_id=asset-001" \

{
  "client_asset_id": "asset-001",
  "thumb_jpeg_base64": "<base64 omitted>",
  
}

Kolom permintaan

Contoh respons

{
  "asset_id": "asset_example", "job_id": null, "status": "known",
  "label": "possible_synthetic_indicators", "score": 0,84,
  "confidence": null, "thresholds": {"possible_synthetic_indicators": 0,8},
  "source": "model", "model": "active-model-version",
  "cached": false, "ttl_seconds": 86400
}

Penanda dan angka di sini menggambarkan skemanya; itu bukan hasil tolok ukur dan bukan keluaran yang dijamin.

Video sampel

POST /v1/videos/check-frames menerima hingga 8 objek permintaan gambar ditambah sebuah penanda stabil video_footprint. Gunakan 5–8 bingkai yang mewakili. Ini bukan analisis deepfake temporal.

{
  "video_footprint": "stable-footprint",
  "frames": [{"thumb_jpeg_base64": "[BASE64_OMITTED]"}],
  
}

Contoh respons gabungan

{
  "status": "known", "label": "possible_synthetic_indicators",
  "score": 0,83, "median_score": 0,83, "mean_score": 0,82,
  "max_score": 0,86, "frame_count": 6, "scored_frame_count": 6,
  "pending_frame_count": 0, "frames": [], "cached": false,
  "source": "video_aggregate"
}

Respons sungguhan memuat objek respons per bingkai. Ulangi dengan footprint yang sama dan tanpa bingkai untuk mencari di cache. Bila tidak ditemukan, ia mengembalikan unknown.

Pekerjaan dan aset tersimpan

Inferensi gambar berjalan asinkron: respons awalnya berisi status: processing dan sebuah job_id. Tidak ada mode sinkron — dulu ada kolom sync yang didokumentasikan di sini, tetapi tidak pernah ada yang membacanya.

{"job_id":"job_example","status":"completed","result":{"asset_id":"asset_example","status":"known","label":"possible_synthetic_indicators"}}

Kebijakan klien yang dianjurkan: polling setelah 1, 2, 4, 8 lalu 10 detik; batasi setiap jeda berikutnya pada 10 detik dan berhenti setelah 60 detik atau saat completed/failed. Saat ini server tidak menjamin batas waktu itu dan tidak menyediakan webhook atau kontrak Retry-After .

Siklus peninjauan manusia

curl "$BASE_URL/reviews" \
  -H "Authorization: Bearer $API_KEY" \
  -F "file=@./sample.jpg" \
  -F "declared_ai_use=unknown" \
  -F "supplier=Example supplier"

{"decision":"disclose","reviewer":"reviewer@example.invalid","rationale":"Disclosure selected after source and detector review."}

Respons tinjauan memuat review_id, status pending/completed, hash konten, nama berkas, pernyataan, asal-usul, detektor, keputusan opsional, kebijakan, serta cap waktu dibuat/diperbarui. Ia tidak pernah menolak atau menerbitkan konten secara otomatis.

Status HTTP

Kesalahan memakai {"detail":"error_code"}; misalnya {"detail":"invalid_api_key"}. Setiap respons memuat X-Request-ID. Pengiriman gambar asinkron saat ini tetap mengembalikan respons endpoint biasa dengan status: processing; jangan berasumsi HTTP 202.