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ẫnViệc làm
POST /v1/xac_nhan_18Xác nhận tổ chức của bạn đủ 18+ (một lần).
POST /v1/nhan_vatTạo nhân vật; người trong ảnh phải là người lớn đã đồng ý.
POST /v1/videoTạ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}/duyetDuyệt ảnh chủ đạo từng cảnh.
POST /v1/video/{id}/suaYêu cầu sửa tại một giây (và vùng).
POST /v1/video/{id}/duyet_cuoiDuyệt bản cuối: tín dụng dư được hoàn.
GET /v1/tin_dungSố dư và sổ cái.
POST /v1/napNạp thêm tín dụng.
GET /v1/khoa · POST /v1/khoa/xoay · /thu_hoiXem, xoay, thu hồi khoá.
DELETE /v1/tai_khoanXoá dữ liệu tài khoản.

Mã lỗi thường gặp

401Thiếu hoặc sai khoá
402Không đủ tín dụng
403 can_xac_nhan_18Hãy xác nhận 18+ trước
422 noi_dung_bi_camKịch bản vi phạm chính sách nội dung (không tính tiền)
422 can_thoa_thuanMặt thật cần thoả thuận 3 bên đã ký
429Quá nhiều yêu cầu