ID ▾
Dapatkan kunci API
API tanpa sensor yang kompatibel dengan OpenAI untuk pengembang.Diperbarui

Contoh curl API LLM yang Bisa Anda Salin dan Jalankan

Jika Anda ingin menguji API LLM dengan curl sebelum menulis kode, permintaan di bawah ini sudah cukup. Setiap permintaan menargetkan endpoint yang kompatibel dengan OpenAI, menggunakan ID model uncensored, dan dijalankan dari terminal biasa.

Panel terminal mengirim seberkas cahaya ke kubus server, mewakili permintaan curl ke API LLM

Siapkan shell Anda dan periksa endpoint

Dapatkan kunci dari halaman kunci API, lalu ekspor bersama URL dasar agar Anda tidak menempelkan rahasia ke setiap perintah.

export API_KEY="paste-your-key-here"
export BASE="https://api.uncensoredllmapi.com/v1"

Setiap permintaan mengirimkan kunci sebagai token bearer di header Authorization. Badan permintaan adalah JSON, jadi tambahkan Content-Type: application/json saat Anda melakukan POST. Ukuran badan maksimum adalah 8 MB, yang hanya penting jika Anda menempelkan dokumen sangat besar ke prompt.

Contoh menggunakan tanda kutip tunggal shell Unix. Di PowerShell Windows, letakkan JSON dalam file dan berikan dengan --data @body.json untuk menghindari masalah pengutipan.

Pemeriksaan kesehatan termurah adalah GET yang mencantumkan model. Ini mengonfirmasi kunci dan URL, dan tidak memakan biaya.

curl -s "$BASE/models" \
  -H "Authorization: Bearer $API_KEY"

Array data dalam balasan harus menyertakan ID uncensored. Status 401 berarti kunci tidak ada atau salah ketik. Jika curl sama sekali tidak dapat terhubung, periksa host di $BASE dan pastikan diakhiri dengan /v1 tanpa path tambahan.

1. Kirim penyelesaian obrolan

Ini adalah permintaan yang dikirim oleh setiap klien gaya OpenAI di balik layar.

curl -s "https://api.uncensoredllmapi.com/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Give me three names for a fantasy tavern."}
    ],
    "temperature": 0.8,
    "max_tokens": 200
  }'

Balasan berupa JSON. Teks berada di choices[0].message.content, dan jumlah token ada di usage. Salurkan output melalui jq -r '.choices[0].message.content' jika Anda telah menginstal jq dan hanya ingin teks. Bidang max_tokens bersifat opsional; jika tidak disertakan, respons mungkin menggunakan sisa dari jendela 100.000 token.

Endpoint POST /v1/responses yang lebih baru juga tersedia jika klien Anda menggunakan format itu. Untuk daftar lengkap parameter, lihat dokumentasi.

2. Alirkan jawaban

Tambahkan "stream": true dan beri tahu curl untuk tidak melakukan buffering dengan -N. Token akan dicetak saat dihasilkan.

curl -N "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "stream": true,
    "messages": [{"role": "user", "content": "Count from one to ten in words."}]
  }'

Setiap baris dimulai dengan data: dan berisi potongan JSON kecil dengan delta. Peristiwa terakhir membawa penggunaan, dan stream berakhir dengan data: [DONE]. Tanpa -N, curl menunggu buffer penuh, dan output terlihat seperti tiba sekaligus. Perhatikan bahwa permintaan streaming menyita satu slot konkurensi hingga selesai.

3. Minta JSON

Untuk output yang akan diparsing skrip, aktifkan mode JSON dengan response_format. Sebutkan kata JSON dalam prompt agar model mengetahui bentuk yang Anda harapkan.

curl -s "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "response_format": {"type": "json_object"},
    "messages": [{"role": "user",
      "content": "Return JSON with keys name and level for a fantasy character."}]
  }' | jq -r '.choices[0].message.content | fromjson'

Filter fromjson terakhir mengurai string di dalam content, sehingga jq gagal keras jika model mengembalikan sesuatu yang bukan JSON valid. Hal ini menjadikannya pengujian cepat yang berguna. Lebih banyak pola ada di halaman mode JSON.

4. Coba panggilan alat

Pemanggilan fungsi memungkinkan model meminta kode Anda menjalankan sebuah fungsi. Anda mendeskripsikan fungsi tersebut dalam array tools, dan jika model memutuskan untuk menggunakannya, balasan berisi entri tool_calls alih-alih teks.

curl -s "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the weather in Oslo?"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get current weather for a city",
        "parameters": {
          "type": "object",
          "properties": {"city": {"type": "string"}},
          "required": ["city"]
        }
      }
    }],
    "tool_choice": "auto"
  }' | jq '.choices[0].message.tool_calls'

Anda harus mendapatkan nama fungsi dan string JSON argumen. Kode Anda menjalankan fungsi tersebut, lalu mengirim permintaan kedua yang mengulangi pesan sebelumnya, menambahkan pesan asisten dengan panggilan alat, dan menambahkan pesan dengan role: "tool" yang berisi hasilnya. Model kemudian menulis jawaban akhir.

5. Periksa header dan saldo

Tambahkan -i untuk melihat header respons bersama badan. Anda akan menemukan X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests dan X-RateLimit-Limit-Concurrency.

curl -s -i "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":5}' \
  | grep -i "^x-"

curl -s "$BASE/balance" -H "Authorization: Bearer $API_KEY"

Panggilan kedua mengembalikan saldo Anda secara langsung. Alat bergaya OpenAI dapat menggunakan GET /v1/dashboard/billing/credit_grants sebagai gantinya. Permintaan kecil seperti di atas memakan biaya sepersekian sen: dengan 10 token input dan 5 token output, harganya adalah 10 x 0,15 / 1.000.000 + 5 x 0,50 / 1.000.000 = $0,000004. Lihat halaman harga untuk tarifnya.

Skrip uji asap yang dapat digunakan kembali

Setelah Anda mempercayai panggilan individu, bungkus dalam skrip pendek yang dapat Anda jalankan setelah deployment, rotasi kunci, atau perubahan jaringan apa pun. Skrip ini gagal pada masalah pertama, sehingga Anda melihat persis langkah mana yang rusak.

set -euo pipefail
BASE="https://api.uncensoredllmapi.com/v1"

echo "models:"
curl -sf "$BASE/models" -H "Authorization: Bearer $API_KEY" | jq -r '.data[].id'

echo "chat:"
curl -sf "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say ok."}],"max_tokens":5}' \
  | jq -r '.choices[0].message.content'

echo "balance:"
curl -sf "$BASE/balance" -H "Authorization: Bearer $API_KEY"

Flag -f membuat curl keluar dengan kesalahan pada kegagalan HTTP, dan set -e menghentikan skrip di sana. Letakkan dalam tugas cron atau langkah CI jika Anda menjalankan layanan di atas API ini dan ingin peringatan dini ketika sesuatu berubah. Simpan kunci di penyimpanan rahasia atau variabel lingkungan, bukan di file skrip itu sendiri.

Saat Anda memvariasikan permintaan, coba satu pengaturan pada satu waktu: temperature untuk keacakan, top_p untuk sampling nucleus, stop untuk urutan akhir kustom, dan seed untuk output yang dapat diulang. Semua itu diteruskan ke model, sehingga Anda dapat membandingkan efeknya dari riwayat terminal yang sama.

Membaca kesalahan dari curl

KodePenyebab yang mungkinPerbaikan
401Kunci hilang atau salahPeriksa header Authorization dan bahwa $API_KEY telah diekspor
400JSON tidak valid atau bidang burukValidasikan badan dengan jq . sebelum mengirim
429, kode rate_limitedLebih dari 300 permintaan per menit (60 pada kunci uji coba)Perlambat loop Anda
429, kode concurrencyLebih dari 8 permintaan sekaligus (2 pada kunci uji coba)Jalankan lebih sedikit pekerjaan paralel
429 dengan Retry-After: 5Beban berlebih sementaraTunggu 5 detik dan coba lagi

Tambahkan -w "\n%{http_code}\n" untuk mencetak kode status setelah badan respons, yang menghemat Anda dari menebak-nebak. Badan respons kesalahan berupa JSON dengan pesan dan kode, sehingga jq .error menampilkannya dengan rapi. Jika Anda melihat 429 dalam loop, jangan langsung mencoba lagi; jeda beberapa detik memungkinkan jendela per menit dan slot konkurensi kosong, dan loop percobaan ulang yang ketat hanya membuat Anda melebihi batas. Kunci uji coba memiliki batas yang lebih ketat daripada kunci penuh, sehingga skrip yang berhasil setelah isi saldo pertama Anda mungkin gagal pada kredit uji coba jika menjalankan pekerjaan secara paralel. Setelah permintaan berjalan lancar, beralihlah ke SDK; URL dan nama model yang sama tetap sama. Akun baru dapat mengklaim $0,50 kredit uji coba dengan satu klik, cukup untuk ratusan panggilan pengujian kecil. Isi saldo setelah itu dimulai dari $20 dan dibayar dengan kripto (USDT di TRC20 atau USDC di Base).

Tanya jawab

URL mana yang Anda gunakan untuk mengirim permintaan curl?

Gunakan https://api.uncensoredllmapi.com/v1 sebagai dasar, lalu tambahkan /chat/completions, /responses, /models atau /balance sesuai kebutuhan Anda.

Bagaimana Anda menguji panggilan alat dengan curl?

Tambahkan array tools dengan definisi fungsi ke badan penyelesaian obrolan. Jika model memutuskan untuk memanggilnya, balasan berisi tool_calls, dan Anda mengirim kembali hasilnya sebagai pesan dengan role tool.

Mengapa curl tidak menampilkan apa pun hingga respons selesai dikirim?

Anda mungkin melakukan streaming tanpa flag -N. Tambahkan -N agar curl mencetak setiap bagian saat tiba.

Apakah permintaan yang gagal memakan biaya?

Tidak. Permintaan yang gagal atau ditolak tidak dikenakan biaya.

Kunci Anda hanya selangkah lagi dari satu formulir

Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh pengaturannya.