Tài liệu API
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.
/api/projects
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"
}/api/projects/generate/first-frame
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"
}/api/projects/generate/:step?predictionId=<id>&projectId=<id>
Thăm dò kết quả dự đoán. Bước: first-frame, last-frame, video.
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.