Video & materi

Mendapatkan Aset Material

Mengambil satu aset material Seedance berdasarkan ID aset material TokenLab.

GET
/v1/videos/assets/{assetId}

Ambil satu aset material dan periksa status pemrosesannya: PROCESSING, ACTIVE, FAILED, atau DELETED. Aset tersebut hanya dapat digunakan untuk pembuatan video jika ready bernilai true dan status bernilai ACTIVE. Jika pemrosesan gagal, error_message akan menjelaskan alasannya.

Jika pembuatan video mengembalikan pesan Seedance material asset not found or not accessible, pastikan Anda telah memasukkan id aset material ini, bukan group_id material tersebut.

project_name mencakup sumber daya di dalam organisasi Anda dan secara default bernilai default. Gunakan nilai yang peka huruf besar-kecil (case-sensitive) yang sama untuk grup dan aset terkait. Kirimkan nilai tersebut di dalam body JSON untuk POST/PUT dan di dalam query string untuk GET/DELETE.

Contoh Permintaan

curl "https://api.tokenlab.sh/v1/videos/assets/asset-20260720123456-qn7wr?project_name=default" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

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": "ACTIVE",
  "ready": true,
  "error_message": null,
  "metadata": null,
  "created_at": 1782998400000,
  "updated_at": 1782998400000
}
curl -X GET "https://example.com/v1/videos/assets/asset-20260720123456-qn7wr"
{  "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": "ACTIVE",  "ready": true,  "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

Parameter path

assetId*string

Parameter query

project_name?string

Cakupan proyek untuk sumber daya materi.

Panjang1 <= length <= 128
bawaan"default"

Respons

application/json

application/json

application/json

application/json

application/json