Upload an asset (image / 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" } '

Authorizations

Authorization

string

header

required

OrcaRouter API keys look like sk-orca-.... Pass them in the Authorization: Bearer sk-orca-... header.

Body

application/json

GroupId

string

required

The id of a group you own.

URL

string

required

Publicly accessible image / video / audio URL.

AssetType

enum<string>

required

Available options:

Image,

Video,

Audio

Name

string

Optional; used only for ListAssets fuzzy search.

Moderation

object

Optional. {"Strategy":"Skip"} to skip content pre-filter.

Response

Asset accepted (async — poll GET /asset/files/{id})

string