Video ve materyaller

Materyal Varlığını Getir

TokenLab materyal varlık kimliğini (ID) kullanarak bir Seedance materyal varlığını getirir.

GET
/v1/videos/assets/{assetId}

Bir materyal varlığını getirin ve işleme durumunu inceleyin. Varlık, yalnızca ready değeri true ve status değeri ACTIVE olduğunda video oluşturma için kullanılabilir.

Video oluşturma işlemi Seedance material asset not found or not accessible hatası döndürürse, materyal group_id değerini değil, bu materyal varlığının id değerini gönderdiğinizden emin olun.

project_name, kimliği doğrulanmış organizasyon içindeki kaynakları ayırır. Varsayılanı default değeridir; ilgili grup ve varlıklarda büyük/küçük harfe duyarlı aynı değeri kullanın. POST/PUT için JSON gövdesinde, GET/DELETE için sorgu parametresi olarak gönderin.

Örnek İstek

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

Örnek Yanıt

{
  "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
}
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}

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.

Konum: header

Yol parametreleri

assetId*string

Sorgu parametreleri

project_name?string

Materyal kaynağı için proje kapsamı.

Uzunluk1 <= length <= 128
varsayılan"default"

Yanıt

application/json

application/json

application/json

application/json

application/json