Langsung ke konten utama
POST
Unggah media referensi dan terima URL publik langsung saat berhasil; polling tidak diperlukan. Unggah gratis, tetapi saldo akun harus positif. Ketiga endpoint berbagi kuota per pengguna, secara default 2000 file dalam 72 jam.
Playground dokumentasi tidak mendukung unggah file. Gunakan contoh cURL, Python, atau JavaScript. Contoh JavaScript memerlukan <input type="file"> dengan file yang telah dipilih.

Autentikasi

string
wajib
Gunakan APIMart API Key yang valid, aktif, dan belum kedaluwarsa sebagai Bearer <token>. Akun tidak boleh diblokir dan saldonya harus positif. Kuota Key yang habis tidak mencegah unggah. Dapatkan Key di Pengelolaan API Key.

Parameter permintaan

file
wajib
Kirim satu file beserta namanya melalui bidang file dalam multipart/form-data. Jangan mengganti bagian file dengan JSON, string base64, atau URL. Bidang formulir lain diabaikan; jika beberapa bagian file dikirim, hanya yang pertama diproses.Format yang didukung: MP3 (.mp3), WAV (.wav), M4A (.m4a)Batas ukuran file default: 15MB. Batas ukuran dapat dikonfigurasi. Ikuti konfigurasi aktif dan batas pada pesan kesalahan ukuran.
Dengan cURL --form, Python files, atau JavaScript FormData, biarkan klien membuat Content-Type beserta boundary. Jangan atur header ini secara manual.

Validasi file

Tipe dideteksi dari isi, bukan ekstensi atau MIME yang dinyatakan klien. Isi harus cocok dengan endpoint. Mengganti nama tidak mengonversi format; tipe yang salah menghasilkan HTTP 400. Struktur kontainer atau frame audio diperiksa. Header palsu dan file rusak ditolak. OGG, FLAC, serta AAC sebagai aliran ADTS mentah tidak didukung.

Respons berhasil

HTTP 200 mengembalikan informasi file. url ada di tingkat teratas JSON, tanpa pembungkus data atau ID tugas pembuatan.
string
URL publik untuk parameter referensi yang sesuai pada API pembuatan. Setiap model tetap memiliki batas format, ukuran, jumlah, dan durasi sendiri. Unggah berhasil tidak menjamin kecocokan dengan model.
string
Nama file asli.
string
Tipe MIME yang dideteksi server dari isi file, bukan nilai yang dinyatakan klien.
string
Kategori file. Endpoint ini mengembalikan audio.
integer
Ukuran file sebenarnya dalam byte.
integer
Waktu unggah sebagai timestamp Unix dalam detik.
object
Informasi kuota unggah opsional. Bidang pengguna dengan batas ada di bawah. Struktur dapat berbeda untuk akses tanpa batas atau statistik yang tidak tersedia.

Kuota bersama dan batas permintaan

Gambar, video, dan audio berbagi kuota per pengguna. Beberapa Key milik pengguna yang sama tidak menambah kuota. Jendela bergeser setiap pergantian jam dan secara default menghitung unggah berhasil selama sekitar 71–72 jam terakhir. File tidak valid, terlalu besar, atau gagal disimpan tidak memakai kuota file. Respons dengan kuota terbatas biasa menyertakan X-Upload-Quota-Limit, X-Upload-Quota-Remaining, dan X-Upload-Quota-Reset, sesuai limit, remaining, dan reset_at. Reset memakai detik Unix. Pengguna tanpa batas menerima quota: {"unlimited": true} tanpa ketiga header tersebut. Saat statistik sementara tidak tersedia, respons berhasil dapat menghilangkan quota. Jangan mengartikannya sebagai nol atau tanpa batas, atau mengunggah ulang hanya karena statistik tidak ada. Kuota file habis menghasilkan HTTP 429, error.type: rate_limit_exceeded, quota dengan remaining: 0, dan Retry-After. Tunggu jumlah detik yang diberikan. Batas terpisah sebesar 1000 permintaan per Key per 60 detik memakai rate_limit_error.

Penanganan kesalahan

Kesalahan ada dalam objek error di tingkat teratas JSON. Periksa status HTTP, error.type / error.code, dan error.message.

Penggunaan URL dan penyimpanan file

72 jam adalah jendela kuota default, bukan jaminan masa penyimpanan file. Masa simpan mengikuti kebijakan penyimpanan. Simpan file asli dan segera gunakan URL untuk pembuatan; jangan anggap URL berlaku permanen.

Endpoint unggah lainnya