Skip to main content
GET
取得 Seedance 素材資產
檢索單一素材資源並檢查其處理狀態。僅當 ready 為 true 且 status 為 ACTIVE 時,該資源才能用於影片生成。 如果影片生成回傳 Seedance material asset not found or not accessible,請確認您傳入的是此素材資源的 id,而非素材的 group_id。 project_name 用於同一組織內的資源隔離,預設為 default。相關素材群組和素材須使用相同且區分大小寫的值;POST/PUT 在 JSON 請求主體中傳入,GET/DELETE 在查詢參數中傳入。

請求範例

回應範例

授權

Authorization
string
header
必填

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

路徑參數

assetId
string
必填

查詢參數

project_name
string
預設值:default

素材資源的專案範圍。

Required string length: 1 - 128

回應

素材資產

id
string
必填

TokenLab 素材資源 ID。在資源變為 ACTIVE 後,請將此作為 material_asset_id 使用。

object
enum<string>
必填
可用選項:
seedance.material_asset
library_type
enum<string>
必填
可用選項:
aigc_avatar,
liveness_face
asset_type
enum<string>
必填
可用選項:
Image,
Video,
Audio
status
enum<string>
必填
可用選項:
PROCESSING,
ACTIVE,
FAILED,
DELETED
ready
boolean
必填

當資源為啟用且未刪除時為 True。

group_id
string | null

擁有此素材資源的 TokenLab 素材群組 ID。

project_name
string

此素材資源的專案範圍。

asset_name
string | null
error_message
string | null

可公開顯示的終端處理錯誤。永久性來源驗證失敗包含被拒絕的尺寸限制。

metadata
object | null
created_at
integer

建立素材資源記錄時的 Unix 時間戳記。

updated_at
integer

最後更新素材資源記錄時的 Unix 時間戳記。