Video & materi
Membuat Material Asset
Mengunggah material asset Seedance ke dalam grup material TokenLab.
Impor satu URL sumber yang dapat diakses publik ke dalam grup material Seedance. TokenLab menyimpan material tersebut untuk digunakan nanti; gunakan id material asset yang dikembalikan untuk pembuatan, bukan URL sumbernya.
Untuk library_type: "aigc_avatar", group_id bersifat opsional; tanpanya, TokenLab akan menggunakan atau membuat grup virtual-avatar default organisasi. Untuk library_type: "liveness_face", group_id wajib diisi dan harus berupa grup TokenLab yang dikembalikan oleh Mendapatkan hasil validasi visual. group_id juga wajib diisi jika project_name bukan default. Grup tersebut harus termasuk dalam project_name dan library_type yang sama, atau permintaan akan mengembalikan 400.
| Tipe | Input yang didukung |
|---|---|
| Gambar | jpeg, jpg, png, webp, bmp, tiff, gif, heic, heif; ≤30 MiB; lebar dan tinggi [300, 6000] px; rasio aspek [0.4, 2.5]. |
| Video | mp4, mov; ≤200 MiB. |
| Audio | aac, wav, mp3; ≤15 MiB. |
TokenLab memeriksa URL sumber, tipe media, ukuran file, dan dimensi gambar (jika dapat dibaca) sebelum menerima permintaan. Sumber yang gagal dalam pemeriksaan ini akan mengembalikan 400 dengan kode seedance_material_source_*, contohnya seedance_material_source_invalid (dimensi gambar atau rasio aspek di luar jangkauan), seedance_material_source_type_mismatch, seedance_material_source_too_large, atau seedance_material_source_url_unreachable. Persyaratan media dan wajah lainnya dievaluasi selama pemrosesan, jadi penerimaan tidak berarti aset sudah siap: tunggu hingga status menjadi ACTIVE dan periksa error_message jika pemrosesan gagal.
Permintaan yang berhasil akan mengembalikan 201 dengan status: "PROCESSING". Lakukan polling pada Mendapatkan Material Asset hingga status menjadi ACTIVE. Untuk grup orang asli, satu grup dipetakan ke satu orang yang terverifikasi; unggahan dengan banyak wajah atau wajah yang tidak cocok dengan orang yang terverifikasi dapat gagal.
project_name mencakup sumber daya di dalam organisasi Anda dan secara default bernilai default. Gunakan nilai yang sama (peka huruf besar-kecil) untuk grup dan aset terkait. Kirimkan dalam body JSON untuk POST/PUT dan dalam query string untuk GET/DELETE.
Contoh Permintaan
curl https://api.tokenlab.sh/v1/videos/assets \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"library_type":"aigc_avatar","group_id":"group-20260720123456-vrt01","asset_url":"https://example.com/reference.png","asset_type":"Image","asset_name":"Front view","project_name":"default"}'Contoh Respons
{
"id": "asset-20260720123456-qn7wr",
"object": "seedance.material_asset",
"project_name": "default",
"group_id": "group-20260720123456-vrt01",
"library_type": "aigc_avatar",
"asset_name": "Front view",
"asset_type": "Image",
"status": "PROCESSING",
"ready": false,
"error_message": null,
"metadata": null,
"created_at": 1782998400000,
"updated_at": 1782998400000
}curl -X POST "https://example.com/v1/videos/assets" \ -H "Content-Type: application/json" \ -d '{ "asset_url": "https://example.com/reference.png", "asset_name": "Front view", "asset_type": "Image", "library_type": "aigc_avatar", "group_id": "group-20260720123456-vrt01" }'{ "id": "asset-20260720123456-qn7wr", "object": "seedance.material_asset", "group_id": "group-20260720123456-vrt01", "library_type": "aigc_avatar", "asset_name": "Front view", "asset_type": "Image", "status": "PROCESSING", "ready": false, "error_message": null, "metadata": null, "created_at": 1782998400000}Otorisasi
BearerAuth Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.
Lokasi: header
Body permintaan
application/json
Respons
application/json
application/json
application/json
application/json
application/json
application/json