ビデオと素材
マテリアルアセットの取得
TokenLabマテリアルアセットIDを使用して、Seedanceマテリアルアセットを1つ取得します。
マテリアルアセットを1つ取得し、その処理ステータス(PROCESSING、ACTIVE、FAILED、または DELETED)を確認します。アセットは、ready が true であり、かつ status が ACTIVE の場合にのみ動画生成に使用できます。処理が失敗した場合、error_message にその理由が示されます。
動画生成時に Seedance material asset not found or not accessible というエラーが返される場合は、マテリアル group_id ではなく、このマテリアルアセットの 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キー認証。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