Upload Files

Upload images, videos, and audio files for use with Infron models.

Supported Formats

Type	Formats
Images	JPG, JPEG, PNG, WebP, GIF, BMP, TIFF
Videos	MP4, AVI, MOV, WMV, FLV, WebM, MKV, 3GP, OGV
Audio	MP3, WAV, OGG, AAC, FLAC, WebM, M4A, Opus

Note: For files larger than 50MB, we recommend using a URL input instead of uploading directly.

Note: A single account is permitted to upload up to 1,000 assets, if you require a higher limit, please contact [e-mail].

1. Upload resources

Field	Required	Type	Default	Description
model	True	string	-	Model id
file	True	file/string	-	Local file stream or remote resource URL (only http/https supported).

multipart/form-data

curl -X POST 'https://media.onerouter.pro/v1/upload/resources' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'model=bytedance/seedance-2.0/virtual-portrait-reference-to-video' \
  -F 'file=@/tmp/person-front.png;type=image/png'

application/json

Response

{
  "code": 200,
  "data": {
    "id": 2,
    "upstream_asset_uri": "asset://asset-20260606170356-s9vrz",
    "upstream_status": "Processing",
    "asset_type": "Image",
    "description": "",
    "upload_source": "remote_url",
    "source_url": "https://storage.googleapis.com/infron_gcs/image%2Fplayground-inputs%2F15%2F20260606%2Fcde00456-aebc-453b-a1e3-8cafebe0a457.jpg",
    "gcs_url": "https://storage.googleapis.com/infron_gcs/image%2Fmodel-assets%2Fseedance%2F13%2F20260606%2Fb97f550f-7309-41ba-b7a4-585bb43d97e9.jpg",
    "file_name": "cde00456-aebc-453b-a1e3-8cafebe0a457.jpg",
    "content_type": "image/jpeg",
    "file_ext": ".jpg",
    "file_size_bytes": 39383,
    "sha256_hash": "e7d916a106671814609f2ecb3b57ae1afd048df21a8c7c131f4035918cef2cdc",
    "status": "processing",
    "last_polled_at": "2026-06-06T09:03:55.754111989Z",
    "created_at": "2026-06-06T09:03:55.755Z",
    "updated_at": "2026-06-06T09:03:55.755Z"
  },
  "message": "success"
}

2. List resources

Field	Required	Type	Default	Description
page	False	number	1	Page index
page_size	False	number	20	Number of items per page, maximum 100

cURL

curl 'https://media.onerouter.pro/v1/list/resources?page=1&page_size=20' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Response

{
  "code": 200,
  "data": {
    "items": [
      {
        "id": 2,
        "upstream_asset_uri": "asset://asset-20260606170356-s9vrz",
        "upstream_status": "Active",
        "asset_type": "Image",
        "description": "",
        "upload_source": "remote_url",
        "source_url": "https://storage.googleapis.com/infron_gcs/image%2Fplayground-inputs%2F15%2F20260606%2Fcde00456-aebc-453b-a1e3-8cafebe0a457.jpg",
        "gcs_url": "https://storage.googleapis.com/infron_gcs/image%2Fmodel-assets%2Fseedance%2F13%2F20260606%2Fb97f550f-7309-41ba-b7a4-585bb43d97e9.jpg",
        "file_name": "cde00456-aebc-453b-a1e3-8cafebe0a457.jpg",
        "content_type": "image/jpeg",
        "file_ext": ".jpg",
        "file_size_bytes": 39383,
        "sha256_hash": "e7d916a106671814609f2ecb3b57ae1afd048df21a8c7c131f4035918cef2cdc",
        "status": "active",
        "last_polled_at": "2026-06-06T09:05:01Z",
        "active_at": "2026-06-06T09:05:01Z",
        "created_at": "2026-06-06T09:03:56Z",
        "updated_at": "2026-06-06T09:05:01Z"
      },
      {
        "id": 1,
        "upstream_asset_uri": "asset://asset-20260606170301-mfcb4",
        "upstream_status": "Active",
        "asset_type": "Image",
        "description": "",
        "upload_source": "remote_url",
        "source_url": "https://storage.googleapis.com/infron_gcs/image%2Fplayground-inputs%2F15%2F20260606%2Fcde00456-aebc-453b-a1e3-8cafebe0a457.jpg",
        "gcs_url": "https://storage.googleapis.com/infron_gcs/image%2Fmodel-assets%2Fseedance%2F13%2F20260606%2F522c8572-b290-4e82-978a-1998ea5ac5c5.jpg",
        "file_name": "cde00456-aebc-453b-a1e3-8cafebe0a457.jpg",
        "content_type": "image/jpeg",
        "file_ext": ".jpg",
        "file_size_bytes": 39383,
        "sha256_hash": "e7d916a106671814609f2ecb3b57ae1afd048df21a8c7c131f4035918cef2cdc",
        "status": "active",
        "last_polled_at": "2026-06-06T09:05:01Z",
        "active_at": "2026-06-06T09:05:01Z",
        "created_at": "2026-06-06T09:03:01Z",
        "updated_at": "2026-06-06T09:05:01Z"
      }
    ],
    "total": 2,
    "page": 1,
    "page_size": 20
  },
  "message": "success"
}

3. Check resource status

Field	Required	Type	Default	Description
id	True	number	-	Resource id

cURL

curl 'https://media.onerouter.pro/v1/status/resources/{id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Response

status=Active

{
  "code": 200,
  "data": {
    "id": 2,
    "upstream_asset_uri": "asset://asset-20260606170356-s9vrz",
    "upstream_status": "Active",
    "asset_type": "Image",
    "description": "",
    "upload_source": "remote_url",
    "source_url": "https://storage.googleapis.com/infron_gcs/image%2Fplayground-inputs%2F15%2F20260606%2Fcde00456-aebc-453b-a1e3-8cafebe0a457.jpg",
    "gcs_url": "https://storage.googleapis.com/infron_gcs/image%2Fmodel-assets%2Fseedance%2F13%2F20260606%2Fb97f550f-7309-41ba-b7a4-585bb43d97e9.jpg",
    "file_name": "cde00456-aebc-453b-a1e3-8cafebe0a457.jpg",
    "content_type": "image/jpeg",
    "file_ext": ".jpg",
    "file_size_bytes": 39383,
    "sha256_hash": "e7d916a106671814609f2ecb3b57ae1afd048df21a8c7c131f4035918cef2cdc",
    "status": "active",
    "last_polled_at": "2026-06-06T09:05:01Z",
    "active_at": "2026-06-06T09:05:01Z",
    "created_at": "2026-06-06T09:03:56Z",
    "updated_at": "2026-06-06T09:05:01Z"
  },
  "message": "success"
}

status=Processing

status=Failed

Real-life portrait footage needs to be authorized, uploaded, and undergo a consistency check before it can be made usable.

4. Delete resources

Field	Required	Type	Default	Description
id	True	number	-	Resource id

cURL

curl -X DELETE 'https://media.onerouter.pro/v1/delete/resources/{id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Response

{
  "code": 200,
  "data": {
    "deleted": true
  },
  "message": "success"
}

5. Referencing assets in model calls

The upstream_asset_uri returned from the upload or query operation can be used directly for video generation:

curl -X POST 'https://media.onerouter.pro/v1/videos/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "{MODEL}",
    "prompt": "Generate a 4-second video using @Image1.",
    "image_urls": [
      "{upstream_asset_uri}"
    ]
  }'

Retention

Uploaded files are stored for 7 days and then automatically deleted.