Ein Asset hochladen (Bild / Video / Audio)

curl --request POST \
  --url https://api.orcarouter.ai/v1/asset/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "GroupId": "group-20260318033332-ab12c",
  "URL": "https://your-cdn.com/zhang/full_body.jpg",
  "AssetType": "Image",
  "Name": "full_body_front"
}
'

{
  "Id": "asset-20260318071009-xy98z"
}

Seedance Assets

Ein Asset hochladen (Bild / Video / Audio)

Lade ein Asset in eine dir gehörende Gruppe hoch. Assets werden ausschließlich als öffentlich zugängliche URL bereitgestellt (kein base64, kein Datei-Body). Der Aufruf ist asynchron — frage GET /asset/files/{aid} ab, bis Status Active wird. Bei einer Echtmenschen-Gruppe wird das Gesicht des hochgeladenen Bildes mit der verifizierten Referenz verglichen; eine Nichtübereinstimmung führt zu Status: Failed mit Error.Code: FaceMismatch.

Unterliegt dem Asset-Upload-Limit (Standard 100).

POST

asset

files

Ein Asset hochladen (Bild / Video / Audio)

curl --request POST \
  --url https://api.orcarouter.ai/v1/asset/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "GroupId": "group-20260318033332-ab12c",
  "URL": "https://your-cdn.com/zhang/full_body.jpg",
  "AssetType": "Image",
  "Name": "full_body_front"
}
'

{
  "Id": "asset-20260318071009-xy98z"
}

Autorisierungen

Authorization

string

header

erforderlich

OrcaRouter-API-Schlüssel sehen aus wie sk-orca-.... Übergib sie im Authorization: Bearer sk-orca-...-Header.

Body

application/json

GroupId

string

erforderlich

Die ID einer dir gehörenden Gruppe.

URL

string

erforderlich

Öffentlich zugängliche Bild- / Video- / Audio-URL.

AssetType

enum<string>

erforderlich

Verfügbare Optionen:

Image,

Video,

Audio

Name

string

Optional; nur für die unscharfe Suche von ListAssets verwendet.

Moderation

object

Optional. {"Strategy":"Skip"}, um den Inhalts-Vorfilter zu überspringen.

Antwort

Asset angenommen (asynchron — GET /asset/files/{id} abfragen)

string

Assets auflisten Ein Asset abrufen (Status abfragen)