Jawaban singkat
Error apa saja yang bisa dikembalikan API LLMwithCrypto, dan apakah dikenakan biaya?
API menjawab error dengan status HTTP dan body bergaya OpenAI: {"error": {"message", "type", "param", "code"}}. LLMwithCrypto memakai 400 untuk permintaan yang salah, 401 untuk API key yang salah, 402 ketika kredit tidak cukup, 404 untuk model yang tidak dikenal, 429 untuk rate limit dan 500 atau 503 di sisi kami. Panggilan yang berakhir dengan error tidak memakan biaya, sebagaimana didokumentasikan pada 23 Oktober 2026.
Error apa saja yang ada?
Tidak ada error yang memakai kredit. code adalah nilai stabil untuk diuji dalam kode Anda; message untuk manusia dan bisa berubah.
| HTTP | code | Penyebab | Retry? |
|---|---|---|---|
| 400 | invalid_parameter | Field wajib tidak ada, atau nilainya di luar rentang atau bertipe salah | Tidak: perbaiki permintaannya |
| 400 | context_length_exceeded | Messages ditambah max_tokens tidak muat dalam context window model | Tidak: perpendek input atau turunkan max_tokens |
| 400 | unsupported_parameter | Field yang tidak didukung model ini, seperti response_format pada model tanpa mode JSON | Tidak: hapus field itu atau ganti model |
| 401 | invalid_api_key | API key tidak ada, salah ketik atau sudah dicabut | Tidak: periksa API key |
| 402 | insufficient_balance | Kredit yang tersisa tidak cukup untuk membayar panggilan ini | Tidak: beli pak kredit |
| 404 | model_not_found | ID model tidak ada di daftar kami | Tidak: gunakan ID dari GET /api/v1/models |
| 429 | rate_limit_exceeded | Permintaan atau token per menit melebihi batas akun | Ya, setelah jeda |
| 500 | server_error | Ada yang gagal di sisi kami | Ya, dengan backoff |
| 503 | model_overloaded | Model sedang penuh untuk sementara | Ya, dengan backoff, atau coba model lain |
{
"error": {
"message": "The model `gpt-4o` does not exist or is not available to your key.",
"type": "invalid_request_error",
"param": "model",
"code": "model_not_found"
}
}
Kenapa saya dapat 404 untuk gpt-4o atau claude?
Karena model tersebut tidak dijual di sini. Kami tidak menjual akses ke GPT, Claude, Gemini, atau Grok: pembuatnya melarang penjualan kembali akses API tanpa persetujuan mereka, dan kami tidak memilikinya. Kode yang ditulis untuk OpenAI API sering menyebut nama model di beberapa tempat; cari nama lama di proyek Anda dan ganti dengan ID dari halaman models, misalnya deepseek-v4-pro atau gpt-oss-120b.
Kapan kode saya harus retry?
Retry 429, 500 dan 503, serta error jaringan seperti timeout atau koneksi yang terputus. Jangan pernah retry 400, 401, 402 atau 404: permintaan yang sama akan gagal dengan cara yang sama.
Tunggu sebelum setiap percobaan baru. Jika respons memiliki header Retry-After, tunggu selama itu dalam detik; jika tidak, gandakan jeda setiap kali (1, 2, 4, 8 detik…) dan tambahkan sedikit waktu acak, agar banyak worker tidak retry bersamaan. Berhenti setelah beberapa percobaan dan catat error-nya. SDK OpenAI sudah melakukan retry sendiri; contoh di bawah mematikannya untuk menunjukkan logikanya secara lengkap.
import os
import random
import time
from openai import APIConnectionError, APIStatusError, OpenAI
client = OpenAI(
base_url="https://llmwithcrypto.com/api/v1",
api_key=os.environ["LLMWITHCRYPTO_API_KEY"],
max_retries=0,
)
RETRY = {429, 500, 503}
def chat(messages, model="deepseek-v4-pro", attempts=5):
for attempt in range(attempts):
try:
return client.chat.completions.create(model=model, messages=messages, max_tokens=500)
except APIStatusError as err:
if err.status_code not in RETRY or attempt == attempts - 1:
raise
wait = err.response.headers.get("retry-after")
delay = float(wait) if wait else min(30, 2**attempt) + random.random()
except APIConnectionError:
if attempt == attempts - 1:
raise
delay = min(30, 2**attempt) + random.random()
time.sleep(delay)
Apa yang harus saya lakukan pada 402 insufficient_balance?
Isi ulang saldo. Panggilan tersebut tidak ditagih, dan tidak ada hal lain di akun yang berubah: API key Anda tetap berfungsi begitu ada kredit lagi. Setelah top-up kripto Anda terkonfirmasi dan pack kredit dibeli, API key Anda sudah menunggu di dashboard.
Agar tidak kaget di produksi, baca GET https://llmwithcrypto.com/api/v1/credits dari waktu ke waktu dan pasang alert di bawah ambang pilihan Anda; halaman models dan credits menunjukkan biaya panggilan. Kredit tidak memiliki tanggal kedaluwarsa: yang tidak Anda belanjakan bulan ini tetap ada tahun depan, jadi pak yang lebih besar yang dibeli lebih awal tidak menambah biaya.
Bagaimana cara tetap di bawah rate limit?
Setiap akun memiliki batas permintaan dan token per menit yang ditampilkan di dashboard; hubungi support dan batas itu dapat dinaikkan.
- Batasi konkurensi. Jalankan sejumlah permintaan secara paralel dengan jumlah tetap, bukan mengirim seluruh batch sekaligus.
- Batasi output. Batas token juga menghitung apa yang ditulis model, jadi
max_tokensyang wajar membuat lebih banyak permintaan masuk dalam batas. - Sebar batch. Untuk pekerjaan offline besar, atur laju permintaan sepanjang menit, bukan mengirimnya sekaligus.
Error: pertanyaan umum
Apakah saya dikenakan biaya untuk panggilan yang gagal?
Tidak. Anda membayar per token dari saldo Anda: token input dan output dihitung oleh tokenizer model itu sendiri dan ditagih sesuai harga model tersebut per 1M token. Panggilan yang berakhir dengan error tidak dikenai biaya.
Di mana saya bisa melihat apakah ada gangguan?
Di status page. Rangkaian error 500 atau 503 pada beberapa model biasanya berarti ada insiden di sisi kami; tulis ke [email protected] jika berlangsung lama.
Bisakah saya melihat permintaan yang gagal?
Tidak di sisi kami. Kami tidak menyimpan prompt Anda atau jawaban model: setelah respons terkirim, teksnya hilang. Setiap panggilan meninggalkan satu baris log berisi waktu, akun, model, dan jumlah token, yang dihapus setelah 30 hari. Catat error code dan ID permintaan Anda sendiri di aplikasi Anda.