Version=2024-01-01, JSON PascalCase, filter, pengurutan, paginasi, dan envelope ResponseMetadata + Result. TokenLab hanya mengganti endpoint dan autentikasi.
Endpoint dan autentikasi
POST /api/v3?Action=<ACTION>&Version=2024-01-01 juga didukung. Semua Action material hanya menerima POST. Request dengan tanda tangan AK/SK saja mengembalikan 401 InvalidCredential.
ProjectName default adalah default dan menjadi batas isolasi nyata di dalam organisasi terautentikasi. Gunakan nilai yang sama untuk request terkait.
Action grup material
CreateAssetGroup hanya membuat grup AIGC. Grup LivenessFace dibuat setelah verifikasi orang asli berhasil; ListAssetGroups dapat memfilter keduanya.
Membuat grup material
Action material
AssetType menerima Image, Video, dan Audio. Grup tujuan menentukan apakah material termasuk AIGC biasa atau LivenessFace terverifikasi.
Membuat material
Perilaku daftar
PageNumber default 1; PageSize default 10 dan maksimum 100. SortBy menerima CreateTime atau UpdateTime; SortOrder menerima Desc atau Asc.
Status material adalah Active, Processing, dan Failed. URL sementara dari GetAsset dan ListAssets berlaku 12 jam. Simpan Id sebagai identitas permanen.
ListAssetGroups dan ListAssets mengembalikan resource dalam Result.Items, bersama TotalCount, PageNumber, dan PageSize.
Material orang asli
Buat sesi verifikasi visual, selesaikan verifikasi H5, ambilGroupId, lalu panggil CreateAsset dengan grup tersebut. Upload dicocokkan dengan wajah terverifikasi.
- Buat sesi verifikasi visual
- Ambil hasil verifikasi visual
- Panggil
CreateAssetdenganGroupIdyang dikembalikan
Error
Error mempertahankan envelope respons Volcengine; kode dan pesan berada diResponseMetadata.Error.
InvalidCredential, InvalidVersion, InvalidParameter, NotFound, Conflict, MethodNotAllowed, InternalError.
Alternatif REST
Endpoint REST/v1/videos/assets* tetap tersedia. Integrasi baru dapat memilih REST snake_case; klien Volcengine tidak perlu mengubah body. Material Seedance dan verifikasi orang asli.