素材 Action（Volcengine 互換）

これらのエンドポイントは、下記の素材 Action とフィールドをサポートし、TokenLab Bearer 認証と ResponseMetadata + Result 形式を使用します。

エンドポイントと認証Copy Anchor Link

POST https://api.tokenlab.sh/?Action=<ACTION>&Version=2024-01-01
Authorization: Bearer <TOKENLAB_API_KEY>
Content-Type: application/json

POST /api/v3?Action=<ACTION>&Version=2024-01-01 も利用できます。素材 Action はすべて POST 専用です。AK/SK 署名だけのリクエストは 401 InvalidCredential を返します。

ProjectName の既定値は default で、認証済み組織内の実際の分離境界です。関連する作成、一覧、取得、更新、削除で同じ値を使ってください。

素材グループ ActionCopy Anchor Link

CreateAssetGroup が作成できるのは AIGC グループだけです。LivenessFace グループは実在人物の認証成功時に作成されます。ListAssetGroups は両方を絞り込めます。

素材グループを作成Copy Anchor Link

curl 'https://api.tokenlab.sh/?Action=CreateAssetGroup&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"Name":"Product references","Description":"Reusable product shots","GroupType":"AIGC","ProjectName":"default"}'

{
  "ResponseMetadata": {
    "RequestId": "req-id",
    "Action": "CreateAssetGroup",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {"Id":"group-20260720123456-abc12"}
}

素材 ActionCopy Anchor Link

AssetType は Image、Video、Audio を受け付けます。対象グループによって通常の AIGC 素材か、認証済み LivenessFace 素材かが決まります。

TokenLab の素材 ID を使用してください。CreateAsset は処理完了前に Result.Id を返します。Result.Status が Active または Failed になるまで GetAsset をポーリングしてください。ListAssets は SortBy: "GroupId" にも対応します。

素材を作成Copy Anchor Link

curl 'https://api.tokenlab.sh/?Action=CreateAsset&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"GroupId":"group-20260720123456-abc12","URL":"https://example.com/reference.png","Name":"Front view","AssetType":"Image","ProjectName":"default"}'

一覧の動作Copy Anchor Link

PageNumber の既定値は 1、PageSize は 10 で最大 100 です。SortBy は CreateTime または UpdateTime、SortOrder は Desc または Asc を受け付けます。

素材状態は Active、Processing、Failed です。GetAsset と ListAssets の一時 URL は 12 時間有効です。永続的な識別子として Id を保存してください。

ListAssetGroups と ListAssets は Result.Items にリソースを返し、TotalCount、PageNumber、PageSize も含みます。

{
  "ResponseMetadata": {
    "RequestId": "req-id",
    "Action": "ListAssets",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {"Items":[],"TotalCount":0,"PageNumber":1,"PageSize":10}
}

実在人物の素材Copy Anchor Link

視覚認証セッションを作成して H5 認証を完了し、結果の GroupId を取得してから、そのグループで CreateAsset を呼び出します。アップロードは認証済みの顔と照合されます。

1. 視覚認証セッションを作成
2. 視覚認証結果を取得
3. 返された GroupId で CreateAsset を呼び出す

エラーCopy Anchor Link

エラーも Volcengine レスポンスエンベロープを使用し、コードとメッセージは ResponseMetadata.Error に入ります。

{
  "ResponseMetadata": {
    "RequestId": "req-id",
    "Action": "CreateAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing",
    "Error": {"Code":"InvalidParameter","Message":"GroupId is required"}
  }
}

InvalidCredential, InvalidVersion, InvalidParameter, NotFound, Conflict, OperationDenied, MethodNotAllowed, InternalError.

REST の代替Copy Anchor Link

TokenLab の /v1/videos/assets* REST API も引き続き利用できます。新しい統合は snake_case REST を選べ、既存の Volcengine クライアントは本文を変更する必要がありません。 Seedance 素材と実在人物の認証.

curl -X POST "https://example.com/api/v3" \  -H "Content-Type: application/json" \  -d '{    "CallbackURL": "http://example.com"  }'

{  "id": "string"}