Meldport

Panduan API Meldport

Mulai dengan satu request kecil, periksa hasil dan pemakaian token, lalu tingkatkan workload setelah konfigurasi dan penagihannya jelas.

Isi panduan

Read the full API reference in English · Kuota dan model gratis

Kirim request pertama dengan batas 64 token output

Verifikasi email, lalu buat key khusus melalui dashboard API Keys. Simpan key sebagai variabel lingkungan MELDPORT_API_KEY. Pilih ID persis dari katalog model.

Contoh memakai model aktif deepseek-v4.1-flash-1017:free. Kuota bersama dan pengaturan fallback tetap berlaku.

curl 'https://dev-api.meldport.com/v1/chat/completions' \
  -H "Authorization: Bearer $MELDPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4.1-flash-1017:free","messages":[{"role":"user","content":"Jelaskan fungsi API gateway dalam satu kalimat."}],"max_tokens":64,"stream":false}'

Periksa status HTTP, choices dan usage. Catat request ID untuk investigasi. Ulangi percobaan dengan konteks kecil terlebih dahulu; respons HTTP sukses tidak otomatis berarti hasil model sesuai kebutuhan aplikasi Anda.

Perkirakan biaya sebelum mengirim

Contoh simulasi model berbayar: 128 token input dengan tarif $1 per juta dan 64 token output dengan tarif $6 per juta menghasilkan subtotal $0.000512. Terapkan minimum per request bila lebih tinggi. Ganti angka contoh dengan tarif untuk ID yang dipilih di kalkulator biaya. Pada model :free, matikan fallback di key jika Anda ingin request berhenti ketika kuota tidak cukup.

Kebijakan free terbaru dibaca dari backend: satu pool bulanan untuk seluruh model :free dan key milik akun. Reset menggunakan bulan UTC. Jika kuota tidak mencukupi, fallback wallet memerlukan izin akun, izin key dan saldo yang cukup. Jika syarat tidak terpenuhi, request berhenti.

Model berbayar memakai tarif input, cached input jika didukung, output dan minimum yang dipublikasikan. Gunakan kalkulator biaya untuk simulasi yang menyebut asumsi. Tool loop dan retry dapat menambah request serta pemakaian token.

Tambahkan saldo melalui Wallet melalui metode yang tersedia di checkout. Wallet mencatat kredit dalam USD. Jika QRIS ditawarkan, checkout menampilkan jumlah bayar dalam rupiah (IDR) beserta konversi dan biaya sebelum pembayaran.

Bedakan protokol dan alur media

Kontrak bahasa yang didokumentasikan adalah Chat Completions. Client yang mengharuskan Anthropic Messages atau OpenAI Responses tidak menjadi kompatibel hanya dengan mengganti base URL. Lihat catatan coding agents dan contoh workflow n8n.

Image, video dan audio memakai alur konfigurasi, quote, lalu job asinkron. Ambil konfigurasi yang dipublikasikan, periksa quote dan batas reservasi, buat job dengan persetujuan yang diperlukan, lalu cek status sampai hasil dan tagihan final tersedia. Durasi, resolusi dan kebutuhan input mengikuti konfigurasi model; jangan menggunakan satu body JSON untuk semua media. Rujukan kontrak media lengkap tersedia dalam Bahasa Inggris.

Tangani kegagalan sebelum mengulang request

Untuk 401, periksa key dan lingkungan. Untuk model tidak ditemukan, periksa ID aktif. Untuk kuota atau saldo tidak cukup, lihat allowance dan Wallet. Untuk 429, baca limit dan Retry-After jika disediakan. Setelah timeout, disconnect atau status rekonsiliasi, periksa Usage terlebih dahulu karena provider mungkin sudah menjalankan request. Jangan berasumsi bahwa semua retry aman atau semua kegagalan langsung direfund.

Laporkan referensi request, waktu dan kode error lewat kontak support, tanpa mengirim API key atau prompt pribadi. Panduan ini adalah pilot dokumentasi Bahasa Indonesia; referensi Inggris memuat rincian endpoint dan parameter lanjutan.