ビデオと素材

マテリアルアセットの取得

TokenLabマテリアルアセットIDを使用して、Seedanceマテリアルアセットを1つ取得します。

GET
/v1/videos/assets/{assetId}

マテリアルアセットを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