Cara Menggunakan API yang Kompatibel dengan OpenAI dalam 5 Langkah
Menggunakan API bergaya OpenAI membutuhkan lima langkah: dapatkan kunci, instal SDK, arahkan ke base URL yang benar, tentukan model, dan kirim pesan. Berikut adalah setiap langkah dengan kode yang dapat Anda salin.

Poin utama
- SDK OpenAI apa pun berfungsi di sini setelah Anda mengubah base URL menjadi https://api.uncensoredaiapis.com/v1 dan menggunakan kunci Anda sendiri.
- ID modelnya adalah uncensored; rute utamanya adalah POST /v1/chat/completions dan GET /v1/models.
- Streaming, mode JSON, dan pemanggilan fungsi menggunakan parameter yang sama dengan API resmi.
- Harga adalah $0,15 per 1 juta token input dan $0,50 per 1 juta token output, dan Anda dapat memulai dengan kredit uji coba senilai $0,50.
Versi singkatnya
Jika Anda ingin mengetahui cara menggunakan panggilan API OpenAI dengan layanan yang bukan OpenAI, jawabannya adalah format permintaannya adalah konvensi bersama. Klien yang mendukungnya membutuhkan tiga nilai: tempat mengirim permintaan (base URL), identitas Anda (kunci), dan model yang akan dijalankan. Ubah ketiga hal tersebut dan kode yang sama akan berfungsi. Situs ini mengikuti konvensi tersebut, sehingga paket Python dan Node.js OpenAI standar, serta curl biasa, semuanya berfungsi melawannya.
Pahami dengan jelas apa artinya dan apa yang tidak. Kompatibel berarti antarmuka cocok. Ini bukan berarti ini adalah layanan OpenAI resmi atau menjalankan model OpenAI. Backendnya adalah satu model bobot terbuka, dijalankan oleh penyedia independen dan disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah, dan Anda memilihnya dengan ID model uncensored. Ini hanya menangani teks: tidak ada gambar, audio, embedding, atau fine-tuning.
Lima langkah di bawah ini membutuhkan waktu sekitar sepuluh menit. Jika Anda lebih suka membaca cuplikan jadi dalam beberapa bahasa, lihat halaman contoh kode.
Langkah 1: dapatkan kunci
Daftar dengan Google, atau dengan email dan kata sandi, dan buka halaman kunci API. Pengguna baru dapat mengklaim kredit uji coba senilai $0,50 dengan satu klik. Kredit ini berlaku selama 7 hari, terbatas satu per orang, dan tidak memerlukan kartu. Salin kunci dan simpan sebagai variabel lingkungan daripada menempelkannya ke dalam kode:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
export API_KEY="paste-your-key-here"Kunci uji coba terbatas pada 2 permintaan paralel dan 60 permintaan per menit. Kunci yang terisi memungkinkan 8 permintaan paralel dan 300 per menit. Detail apa yang termasuk dalam uji coba ada di FAQ uji coba gratis.
Langkah 2: instal SDK dan kirim permintaan pertama
Instal paket resmi untuk bahasa Anda. Keduanya adalah pustaka yang sama yang akan Anda gunakan untuk layanan bergaya OpenAI:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
pip install openai
npm install openaiSekarang panggilan pertama dalam Python. Satu-satunya perbedaan dari pengaturan default adalah argumen base_url:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredaiapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise writing assistant."},
{"role": "user", "content": "Give me three titles for a noir short story."},
],
)
print(resp.choices[0].message.content)Dan panggilan yang sama di Node:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredaiapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three titles for a noir short story." }],
});
console.log(resp.choices[0].message.content);Langkah 3: pahami array pesan
Model percakapan tidak mengingat apa pun di antara panggilan. Setiap permintaan membawa seluruh percakapan sebagai daftar pesan, dan setiap pesan memiliki peran.
systemmenetapkan perilaku dan gaya. Masukkan persona, aturan format, dan batasan di sini.userberisi apa yang ditanyakan orang.assistantberisi balasan sebelumnya dari model. Anda menambahkannya sendiri saat melanjutkan percakapan.toolmembawa hasil pemanggilan fungsi, dibahas di bawah.
Untuk melanjutkan percakapan, tambahkan balasan asisten dan pesan pengguna berikutnya ke daftar yang sama, lalu kirimkan semuanya lagi. Inilah sebabnya percakapan panjang lebih mahal: setiap panggilan membayar untuk riwayat lengkap sebagai token masukan. Jendela konteks menampung total 100.000 token, baik prompt maupun hasil, sehingga memangkas riwayat lama adalah bagian normal dari pembuatan aplikasi obrolan.
Bidang sampling yang berguna diteruskan: temperature, top_p, stop, seed dan penalti frekuensi serta kehadiran. max_tokens bersifat opsional. Tetapkan saat Anda ingin membatasi panjang balasan dan pengeluaran.
Langkah 4: streaming, mode JSON, dan alat
Streaming
Tambahkan stream: true untuk menerima token sebagai peristiwa dikirim server. Hal ini membuat antarmuka terasa cepat karena teks muncul saat model masih menulis, dan penggunaan dilaporkan di akhir streaming.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredaiapis.com/v1", apiKey: process.env.API_KEY });
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a short toast for a retirement party." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}Mode JSON
Gunakan response_format: {"type": "json_object"} saat kode Anda mem-parsing balasan. Jelaskan kunci yang diinginkan dalam prompt juga.
curl https://api.uncensoredaiapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "system", "content": "Reply with JSON: {\"mood\": string, \"score\": number}"},
{"role": "user", "content": "Rate this line: the rain finally stopped."}
]
}'Pemanggilan alat
Lewatkan daftar tools dengan skema fungsi, dan opsional tool_choice. Ketika model ingin menjalankan fungsi, balasan berisi tool_calls. Anda menjalankan fungsi dalam kode Anda sendiri dan mengirimkan hasilnya kembali sebagai pesan dengan peran tool. Panggilan fungsi juga mendukung streaming. Ini adalah blok bangunan untuk agen; halaman kasus penggunaan menunjukkan di mana hal ini menguntungkan.
Langkah 5: pahami batas, biaya, dan kesalahan
Melebihi batas, API mengembalikan HTTP 429. Kode error adalah rate_limited untuk terlalu banyak permintaan per menit dan concurrency untuk terlalu banyak sekaligus. Beban berlebih sementara juga memberikan 429, dengan header Retry-After: 5. Permintaan streaming mempertahankan slot konkurensinya hingga stream berakhir, jadi tutup stream yang tidak Anda baca lagi. Batas body adalah 8 MB. Setiap respons membawa header X-Request-Id dan X-Balance-USD, dan yang pertama adalah yang Anda kutip untuk dukungan.
Biaya sangat sederhana. Panggilan obrolan dengan 3.000 token masukan dan 700 token keluaran berharga 3.000 kali $0,15 per juta, yaitu $0,00045, ditambah 700 kali $0,50 per juta, yaitu $0,00035, sehingga totalnya $0,0008. Seribu panggilan seperti itu berharga $0,80. Permintaan yang gagal atau ditolak tidak dikenakan biaya, dan saldo tidak pernah kedaluwarsa. Halaman harga mencantumkan isi saldo mulai dari $20 hingga $500 dengan bonus +5% dari $50, +10% dari $100, dan +15% dari $200. Anda dapat membayar dengan kripto (USDT di TRC20, USDC di Base).
Perbedaannya dengan API resmi
Tiga perbedaan layak direncanakan. Pertama, nama model: gunakan uncensored, bukan nama model OpenAI. Kedua, ruang lingkup: Anda hanya mendapatkan chat completions dan daftar model, jadi fitur seperti pembuatan gambar, suara, embedding, dan fine-tuning tidak ada di sini. Ketiga, perilaku: model disesuaikan untuk tidak menolak permintaan dewasa yang sah, sehingga output dapat berbeda dari asisten yang banyak filter. Satu aturan tidak pernah berubah: tidak ada konten seksual yang melibatkan anak di bawah umur.
Beberapa kebiasaan membantu di hari pertama. Simpan kunci di variabel lingkungan, log X-Request-Id dari setiap panggilan, dan atur max_tokens saat Anda bereksperimen agar balasan yang tidak terkendali tidak menghabiskan lebih dari yang Anda rencanakan. Saat Anda membangun antarmuka obrolan, alirkan balasan dan memangkas riwayat lama saat riwayat berkembang. Saat Anda membangun pipeline yang mengurai output, gunakan mode JSON dan tetap jaga proses penguraian, karena balasan yang terpotong pada batas token bukanlah JSON yang valid. Dan ketika dua bagian program Anda memanggil API secara bersamaan, hitung mereka terhadap batas 8 permintaan paralel yang diizinkan kunci penuh.
Jangan lupa biaya pengujian. Beberapa lusin eksperimen dengan prompt pendek berharga jauh kurang dari satu sen secara total, sehingga kredit uji coba $0,50 sangat membantu saat Anda mempelajari format permintaan.
Jika Anda memindahkan aplikasi yang ada, panduan migrasi menelusuri perubahan secara berurutan. Prompt yang dikirim di sini tidak digunakan untuk pelatihan. Untuk sebagian besar aplikasi, migrasi adalah tiga nilai dari awal halaman ini dan nama model.
Panduan lainnya
Tanya jawab
Apakah Anda memerlukan SDK OpenAI resmi?
Anda dapat menggunakannya, dan itu adalah cara termudah. Klien yang kompatibel dengan OpenAI atau HTTP biasa juga berfungsi, selama mendukung base URL kustom.
Nama model apa yang saya kirim?
Kirim uncensored. Base URL adalah https://api.uncensoredaiapis.com/v1.
Apakah ini API OpenAI resmi?
Tidak. Ini mengikuti format permintaan yang sama, tetapi modelnya adalah model bobot terbuka yang dijalankan oleh penyedia independen, dan layanannya terpisah dari OpenAI.
Berapa biaya satu permintaan?
Token input berharga $0,15 per 1M dan token output $0,50 per 1M. Permintaan dengan 3.000 input dan 700 token output berharga sekitar $0,0008.
Bisakah saya mencobanya sebelum membayar?
Ya. Setelah pendaftaran Anda dapat mengklaim $0,50 kredit uji coba dengan satu klik. Kredit ini berlaku selama 7 hari dan tidak memerlukan kartu.
Kunci Anda hanya selangkah lagi dari satu formulir
Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh proses pengaturannya.