Video ve materyaller

Materyal Varlığını Getir

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

GET
/v1/videos/assets/{assetId}

Bir materyal varlığını getirin ve işleme durumunu inceleyin: PROCESSING, ACTIVE, FAILED veya DELETED. Varlık, yalnızca ready değeri true ve status değeri ACTIVE olduğunda video oluşturma için kullanılabilir. İşleme başarısız olduğunda, error_message nedenini belirtir.

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ık id değerini gönderdiğinizden emin olun.

project_name, kuruluşunuz içindeki kaynakları kapsamlar ve varsayılan olarak default değerini alır. İlgili gruplar ve varlıklar için aynı büyük/küçük harfe duyarlı değeri kullanın. POST/PUT işlemleri için JSON gövdesinde, GET/DELETE işlemleri için ise sorgu dizisinde (query string) 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,
  "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}

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