ビデオと素材

マテリアルアセットの作成

SeedanceマテリアルアセットをTokenLabマテリアルグループにアップロードします。

POST
/v1/videos/assets

公開されているソースURLをSeedanceマテリアルグループにインポートします。TokenLabは後で使用するためにマテリアルを保存します。生成にはソースURLではなく、返されたマテリアルアセットの id を使用してください。

library_type: "aigc_avatar" の場合、group_id は任意です。指定がない場合、TokenLabは組織のデフォルトのバーチャルアバターグループを使用または作成します。library_type: "liveness_face" の場合、group_id は必須であり、視覚的検証結果の取得によって返されたTokenLabグループである必要があります。また、project_name が default ではない場合も group_id は必須です。グループは同じ project_name および library_type に属している必要があり、そうでない場合は 400 エラーが返されます。

タイプサポートされている入力
画像jpeg, jpg, png, webp, bmp, tiff, gif, heic, heif; 30 MiB以下; 幅と高さ [300, 6000] px; アスペクト比 [0.4, 2.5]。
動画mp4, mov; 200 MiB以下。
音声aac, wav, mp3; 15 MiB以下。

TokenLabはリクエストを受け入れる前に、ソースURL、メディアタイプ、ファイルサイズ、および読み取り可能な画像の場合はその寸法をチェックします。これらのチェックに失敗したソースは、seedance_material_source_* コード(例:seedance_material_source_invalid(画像の寸法やアスペクト比が範囲外)、seedance_material_source_type_mismatch、seedance_material_source_too_large、または seedance_material_source_url_unreachable)とともに 400 エラーを返します。その他のメディアや顔に関する要件は処理中に評価されるため、受け入れられたからといってアセットがすぐに使用可能とは限りません。ACTIVE になるまで待ち、処理が失敗した場合は error_message を確認してください。

リクエストが成功すると、status: "PROCESSING" とともに 201 が返されます。status が ACTIVE になるまで マテリアルアセットの取得 をポーリングしてください。実在の人物グループの場合、1つのグループは1人の検証済み人物に対応します。複数の顔が含まれているアップロードや、検証済みの人物と一致しない顔が含まれているアップロードは失敗する可能性があります。

project_name は組織内のリソースをスコープし、デフォルトは default です。関連するグループやアセットには、大文字と小文字を区別して同じ値を指定してください。POST/PUTの場合はJSONボディに、GET/DELETEの場合はクエリ文字列に含めて送信します。

リクエスト例

curl https://api.tokenlab.sh/v1/videos/assets \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"library_type":"aigc_avatar","group_id":"group-20260720123456-vrt01","asset_url":"https://example.com/reference.png","asset_type":"Image","asset_name":"Front view","project_name":"default"}'

レスポンス例

{
  "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": "PROCESSING",
  "ready": false,
  "error_message": null,
  "metadata": null,
  "created_at": 1782998400000,
  "updated_at": 1782998400000
}
curl -X POST "https://example.com/v1/videos/assets" \  -H "Content-Type: application/json" \  -d '{    "asset_url": "https://example.com/reference.png",    "asset_name": "Front view",    "asset_type": "Image",    "library_type": "aigc_avatar",    "group_id": "group-20260720123456-vrt01"  }'
{  "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": "PROCESSING",  "ready": false,  "error_message": null,  "metadata": null,  "created_at": 1782998400000}

認証

BearerAuth
AuthorizationBearer <token>

APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。

場所: header

リクエストボディ

application/json

レスポンス

application/json

application/json

application/json

application/json

application/json

application/json