Video & materi

Membuat Material Asset

Mengunggah material asset Seedance ke dalam grup material TokenLab.

POST
/v1/videos/assets

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.

TipeInput yang didukung
Gambarjpeg, jpg, png, webp, bmp, tiff, gif, heic, heif; ≤30 MiB; lebar dan tinggi [300, 6000] px; rasio aspek [0.4, 2.5].
Videomp4, mov; ≤200 MiB.
Audioaac, 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
AuthorizationBearer <token>

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