Referensi API

Endpoint REST Anivva

Autentikasi menggunakan token sesi Supabase. Semua respons memakai bentuk { success: boolean, data, error } agar UI konsisten.

POST

/api/projects

Buat Proyek

Buat catatan proyek sebelum menghasilkan frame. Mengembalikan projectId yang digunakan di seluruh endpoint.

{
  "title": "Product teaser",
  "textPrompt": "Hero stands on cliff at dawn",
  "description": "Keep outfit consistent with uploaded still"
}
POST

/api/projects/generate/first-frame

Hasilkan Frame Pertama

Mulai generasi AI. Membutuhkan projectId plus jalur gambar referensi opsional.

{
  "projectId": "<projectId>",
  "referenceImagePath": "projects/ref.png"
}
GET

/api/projects/generate/:step?predictionId=<id>&projectId=<id>

Status Generasi

Polling hasil prediksi. Tahap: first-frame, last-frame, video.

Webhook

Konfigurasikan URL webhook di dashboard. Event ditandatangani dengan secret HMAC yang bisa Anda rotasi kapan saja.

generation.succeeded

Frame atau video selesai diproses.

generation.failed

Replicate atau antrean internal mengembalikan error. Coba lagi setelah memeriksa payload.error.

project.created

Konfirmasi bahwa metadata tersimpan di Supabase, berguna untuk sinkronisasi CRM.

Referensi API | Anivva