Tài liệu API

Endpoint REST của Anivva

Xác thực bằng token phiên Supabase. Mọi phản hồi dùng dạng { success: boolean, data, error } để giữ UI nhất quán.

POST

/api/projects

Tạo dự án

Tạo bản ghi dự án trước khi tạo khung hình. Trả về projectId dùng trên các endpoint.

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

/api/projects/generate/first-frame

Tạo khung đầu

Khởi chạy tạo AI. Cần projectId và đường dẫn ảnh tham chiếu tùy chọn.

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

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

Trạng thái tạo

Thăm dò kết quả dự đoán. Bước: first-frame, last-frame, video.

Webhook

Cấu hình URL webhook trong dashboard. Sự kiện được ký bằng secret HMAC có thể xoay vòng bất cứ lúc nào.

generation.succeeded

Khung hình hoặc video đã xử lý xong.

generation.failed

Replicate hoặc hàng đợi nội bộ trả lỗi. Thử lại sau khi kiểm tra payload.error.

project.created

Xác nhận metadata đã được lưu vào Supabase, hữu ích cho đồng bộ CRM.

Tài liệu API | Anivva