Material-Actions (Volcengine-kompatibel)

Diese Endpunkte unterstützen die unten aufgeführten Material-Actions und Felder mit TokenLab-Bearer-Authentifizierung und dem Format ResponseMetadata + Result.

Endpunkt und AuthentifizierungCopy 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 wird ebenfalls unterstützt. Alle Material-Actions akzeptieren nur POST. Requests nur mit AK/SK-Signatur liefern 401 InvalidCredential.

ProjectName ist standardmäßig default und bildet eine echte Isolationsgrenze innerhalb der authentifizierten Organisation. Verwenden Sie denselben Wert für zusammengehörige Requests.

Materialgruppen-ActionsCopy Anchor Link

CreateAssetGroup erstellt ausschließlich AIGC-Gruppen. Eine LivenessFace-Gruppe entsteht nach erfolgreicher Personenverifizierung; ListAssetGroups kann beide Typen filtern.

Materialgruppe erstellenCopy 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"}
}

Material-ActionsCopy Anchor Link

AssetType akzeptiert Image, Video und Audio. Die Zielgruppe bestimmt, ob es sich um normales AIGC-Material oder verifiziertes LivenessFace-Material handelt.

Verwenden Sie TokenLab-Material-IDs. CreateAsset liefert Result.Id vor Abschluss der Verarbeitung. Rufen Sie GetAsset ab, bis Result.Status auf Active oder Failed steht. ListAssets akzeptiert zusätzlich SortBy: "GroupId".

Material erstellenCopy 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"}'

ListenverhaltenCopy Anchor Link

PageNumber ist standardmäßig 1, PageSize standardmäßig 10 und maximal 100. SortBy akzeptiert CreateTime oder UpdateTime; SortOrder akzeptiert Desc oder Asc.

Asset-Statuswerte sind Active, Processing und Failed. Temporäre URLs von GetAsset und ListAssets sind zwölf Stunden gültig. Speichern Sie Id als dauerhafte Identität.

ListAssetGroups und ListAssets geben Ressourcen in Result.Items sowie TotalCount, PageNumber und PageSize zurück.

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

Materialien realer PersonenCopy Anchor Link

Erstellen Sie eine visuelle Verifizierungssitzung, schließen Sie die H5-Verifizierung ab, rufen Sie die GroupId ab und verwenden Sie diese Gruppe mit CreateAsset. Uploads werden mit dem verifizierten Gesicht abgeglichen.

1. Visuelle Verifizierungssitzung erstellen
2. Ergebnis der visuellen Verifizierung abrufen
3. CreateAsset mit der zurückgegebenen GroupId aufrufen

FehlerCopy Anchor Link

Fehler verwenden weiterhin den Volcengine-Response-Envelope; Code und Nachricht stehen unter 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-AlternativeCopy Anchor Link

Die REST-Endpunkte /v1/videos/assets* bleiben verfügbar. Neue Integrationen können snake_case REST wählen; bestehende Volcengine-Clients müssen ihre Bodies nicht umformen. Seedance-Materialien und Personenverifizierung.

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

{  "id": "string"}