Carica un asset (immagine / 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

Carica un asset (immagine / video / audio)

Carica un asset in un gruppo di cui sei proprietario. Gli asset vengono forniti solo come URL accessibile pubblicamente (nessun base64, nessun corpo di file). La chiamata è asincrona — esegui il polling di GET /asset/files/{aid} finché Status non diventa Active. Per un gruppo con persona reale, il volto dell’immagine caricata viene confrontato con il riferimento verificato; una mancata corrispondenza si risolve in Status: Failed con Error.Code: FaceMismatch.

Soggetto al limite di caricamento degli asset (predefinito 100).

POST

asset

files

Carica un asset (immagine / 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"
}

Autorizzazioni

Authorization

string

header

obbligatorio

Le chiavi API di OrcaRouter hanno la forma sk-orca-.... Passale nell'header Authorization: Bearer sk-orca-....

Corpo

application/json

GroupId

string

obbligatorio

L'id di un gruppo di cui sei proprietario.

URL

string

obbligatorio

URL immagine / video / audio accessibile pubblicamente.

AssetType

enum<string>

obbligatorio

Opzioni disponibili:

Image,

Video,

Audio

Name

string

Opzionale; usato solo per la ricerca fuzzy di ListAssets.

Moderation

object

Opzionale. {"Strategy":"Skip"} per saltare il pre-filtro dei contenuti.

Risposta

Asset accettato (asincrono — esegui il polling di GET /asset/files/{id})

string

Elenca gli asset Recupera un asset (polling dello stato)