Action material kompatibel Volcengine

Endpoint ini mendukung Action dan field material di bawah dengan autentikasi Bearer TokenLab dan envelope ResponseMetadata + Result.

Endpoint dan autentikasiCopy 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 juga didukung. Semua Action material hanya menerima POST. Request dengan tanda tangan AK/SK saja mengembalikan 401 InvalidCredential.

ProjectName default adalah default dan menjadi batas isolasi nyata di dalam organisasi terautentikasi. Gunakan nilai yang sama untuk request terkait.

Action grup materialCopy Anchor Link

CreateAssetGroup hanya membuat grup AIGC. Grup LivenessFace dibuat setelah verifikasi orang asli berhasil; ListAssetGroups dapat memfilter keduanya.

Membuat grup materialCopy 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"}
}

Action materialCopy Anchor Link

AssetType menerima Image, Video, dan Audio. Grup tujuan menentukan apakah material termasuk AIGC biasa atau LivenessFace terverifikasi.

Gunakan ID material TokenLab. CreateAsset mengembalikan Result.Id sebelum pemrosesan selesai; lakukan polling GetAsset hingga Result.Status menjadi Active atau Failed. ListAssets juga menerima SortBy: "GroupId".

Membuat materialCopy 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"}'

Perilaku daftarCopy Anchor Link

PageNumber default 1; PageSize default 10 dan maksimum 100. SortBy menerima CreateTime atau UpdateTime; SortOrder menerima Desc atau Asc.

Status material adalah Active, Processing, dan Failed. URL sementara dari GetAsset dan ListAssets berlaku 12 jam. Simpan Id sebagai identitas permanen.

ListAssetGroups dan ListAssets mengembalikan resource dalam Result.Items, bersama TotalCount, PageNumber, dan PageSize.

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

Material orang asliCopy Anchor Link

Buat sesi verifikasi visual, selesaikan verifikasi H5, ambil GroupId, lalu panggil CreateAsset dengan grup tersebut. Upload dicocokkan dengan wajah terverifikasi.

1. Buat sesi verifikasi visual
2. Ambil hasil verifikasi visual
3. Panggil CreateAsset dengan GroupId yang dikembalikan

ErrorCopy Anchor Link

Error mempertahankan envelope respons Volcengine; kode dan pesan berada di 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.

Alternatif RESTCopy Anchor Link

Endpoint REST /v1/videos/assets* tetap tersedia. Integrasi baru dapat memilih REST snake_case; klien Volcengine tidak perlu mengubah body. Material Seedance dan verifikasi orang asli.

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

{  "id": "string"}