For developers
The VON API
A small REST API: bearer keys, credits, idempotency and webhooks.
Authentication
Send your key as Authorization: Bearer vk_… Keys are shown once and can be rotated or revoked. Sandbox keys make blurred 360p previews using free credits.
Privacy by default: three switches (library, training, showcase) are off. Face photos are deleted after delivery; scripts and videos after 90 days unless kept in your library.
Example
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"}'
The base URL is shared at launch.
Endpoints
| Method and path | What it does |
|---|---|
POST /v1/xac_nhan_18 | Confirm your organisation is 18+ (once). |
POST /v1/nhan_vat | Create a character; the person in the photo must be an adult who agreed. |
POST /v1/video | Create a video from a script. Holds credits. |
GET /v1/video/{id} | Status, scene images, signed download link. |
POST /v1/video/{id}/duyet | Approve the key image of each scene. |
POST /v1/video/{id}/sua | Request a fix at a second (and region). |
POST /v1/video/{id}/duyet_cuoi | Approve the final cut: unused credits are refunded. |
GET /v1/tin_dung | Balance and ledger. |
POST /v1/nap | Top up credits. |
GET /v1/khoa · POST /v1/khoa/xoay · /thu_hoi | List, rotate, revoke keys. |
DELETE /v1/tai_khoan | Delete your account data. |
Errors you may see
401 | Missing or invalid key |
402 | Not enough credits |
403 can_xac_nhan_18 | Confirm 18+ first |
422 noi_dung_bi_cam | Script breaks the content policy (not charged) |
422 can_thoa_thuan | Real faces need a signed three-party agreement |
429 | Too many requests |