Đọc trang này bằng tiếng Việt?Tiếng Việt
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 pathWhat it does
POST /v1/xac_nhan_18Confirm your organisation is 18+ (once).
POST /v1/nhan_vatCreate a character; the person in the photo must be an adult who agreed.
POST /v1/videoCreate a video from a script. Holds credits.
GET /v1/video/{id}Status, scene images, signed download link.
POST /v1/video/{id}/duyetApprove the key image of each scene.
POST /v1/video/{id}/suaRequest a fix at a second (and region).
POST /v1/video/{id}/duyet_cuoiApprove the final cut: unused credits are refunded.
GET /v1/tin_dungBalance and ledger.
POST /v1/napTop up credits.
GET /v1/khoa · POST /v1/khoa/xoay · /thu_hoiList, rotate, revoke keys.
DELETE /v1/tai_khoanDelete your account data.

Errors you may see

401Missing or invalid key
402Not enough credits
403 can_xac_nhan_18Confirm 18+ first
422 noi_dung_bi_camScript breaks the content policy (not charged)
422 can_thoa_thuanReal faces need a signed three-party agreement
429Too many requests