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
| Kode | Penyebab yang mungkin | Perbaikan |
|---|---|---|
| 401 | Kunci hilang atau salah | Periksa header Authorization dan bahwa $API_KEY telah diekspor |
| 400 | JSON tidak valid atau bidang buruk | Validasikan badan dengan jq . sebelum mengirim |
429, kode rate_limited | Lebih dari 300 permintaan per menit (60 pada kunci uji coba) | Perlambat loop Anda |
429, kode concurrency | Lebih dari 8 permintaan sekaligus (2 pada kunci uji coba) | Jalankan lebih sedikit pekerjaan paralel |
429 dengan Retry-After: 5 | Beban berlebih sementara | Tunggu 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).
