Cho nhà phát triển
API của VON
Một REST API nhỏ gọn: khoá Bearer, tín dụng, chống trùng lặp và webhook.
Xác thực
Gửi khoá trong Authorization: Bearer vk_… Khoá chỉ hiện một lần, xoay và thu hồi được. Khoá sandbox tạo bản xem trước 360p mờ bằng tín dụng tặng.
Riêng tư mặc định: ba công tắc (thư viện, huấn luyện, giới thiệu) đều tắt. Ảnh mặt xoá sau khi giao; kịch bản và video xoá sau 90 ngày trừ khi lưu trong thư viện.
Ví dụ
curl -X POST "$VON_API/v1/video" \ -H "Authorization: Bearer vk_..." \ -H "Content-Type: application/json" \ -H "Idempotency-Key: 7f3c-01" \ -d '{"kich_ban": "Dawn. Mai opens her small café.", "thoi_luong_giay": 20, "do_phan_giai": "1080p"}'
Địa chỉ gốc sẽ công bố khi ra mắt.
Điểm cuối
| Phương thức và đường dẫn | Việc làm |
|---|---|
POST /v1/xac_nhan_18 | Xác nhận tổ chức của bạn đủ 18+ (một lần). |
POST /v1/nhan_vat | Tạo nhân vật; người trong ảnh phải là người lớn đã đồng ý. |
POST /v1/video | Tạo video từ kịch bản. Giữ chỗ tín dụng. |
GET /v1/video/{id} | Trạng thái, ảnh cảnh, liên kết tải có chữ ký. |
POST /v1/video/{id}/duyet | Duyệt ảnh chủ đạo từng cảnh. |
POST /v1/video/{id}/sua | Yêu cầu sửa tại một giây (và vùng). |
POST /v1/video/{id}/duyet_cuoi | Duyệt bản cuối: tín dụng dư được hoàn. |
GET /v1/tin_dung | Số dư và sổ cái. |
POST /v1/nap | Nạp thêm tín dụng. |
GET /v1/khoa · POST /v1/khoa/xoay · /thu_hoi | Xem, xoay, thu hồi khoá. |
DELETE /v1/tai_khoan | Xoá dữ liệu tài khoản. |
Mã lỗi thường gặp
401 | Thiếu hoặc sai khoá |
402 | Không đủ tín dụng |
403 can_xac_nhan_18 | Hãy xác nhận 18+ trước |
422 noi_dung_bi_cam | Kịch bản vi phạm chính sách nội dung (không tính tiền) |
422 can_thoa_thuan | Mặt thật cần thoả thuận 3 bên đã ký |
429 | Quá nhiều yêu cầu |