TokenLab

視頻與素材

取得素材資源

透過 TokenLab 素材資源 ID 檢索單一 Seedance 素材資源。

GET
/v1/videos/assets/{assetId}

檢索單一素材資源並檢查其處理狀態:PROCESSING、ACTIVE、FAILED 或 DELETED。僅當 ready 為 true 且 status 為 ACTIVE 時,該資源才能用於影片生成。當處理失敗時,error_message 會說明原因。

如果影片生成回傳 Seedance material asset not found or not accessible,請確認您傳遞的是此素材資源的 id,而非素材的 group_id。

project_name 用於界定組織內的資源範圍,預設值為 default。請針對相關群組與資源使用相同的大小寫敏感值。在 POST/PUT 的 JSON 本文中傳送,並在 GET/DELETE 的查詢字串中傳送。

請求範例

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

回應範例

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

授權

BearerAuth
AuthorizationBearer <token>

API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。

位置: header

路徑參數

assetId*string

查詢參數

project_name?string

素材資源的專案範圍。

長度1 <= length <= 128
預設值"default"

回應

application/json

application/json

application/json

application/json

application/json