---
title: "Upload file input"
method: POST
path: "/uploads"
tags: ["Uploads"]
---

# Upload file input

`POST /uploads`

## Request

- Base URL: `https://getrun.id/v1`
- URL: `https://getrun.id/v1/uploads`
- Auth: HTTP bearer

Upload file untuk parameter model bertipe file (image_urls, first_frame_url, reference_video_urls, video_list, dsb). Kirim multipart/form-data dengan field `file` — bukan JSON/base64. Gambar/audio maksimum 25 MB, video 50 MB; file disimpan 7 hari. Pakai `url` dari respons sebagai nilai parameter file di task. Video referensi WAJIB dari endpoint ini — durasinya diukur saat upload dan menjadi dasar harga per detik (URL video eksternal ditolak 400).

## Response `201`

File tersimpan.

- object
  - `url` string
  - `type` 'image' | 'video' | 'audio'
  - `size` integer
  - `duration_seconds` number, nullable: Durasi video/audio (detik); null untuk gambar.

## Other responses

- `default`: Error envelope standar.

---

[API](https://skmtc.dev/getrun/apis/getrun-api.md) · [All operations](https://skmtc.dev/getrun/apis/getrun-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getrun/apis/getrun-api/revisions/2e80f8b28c48?raw)
