API Kompatibel OpenAI: Alihkan klien Anda dalam tiga baris
Alihkan klien Anda dalam tiga baris: ubah URL dasar dan kunci API, lalu pertahankan kode Anda yang ada. API openai compatible ini yang drop-in memberikan pengalaman api llm tanpa sensor dengan harga per-token yang transparan.
- URL dasar
- https://api.openaicompatibleapi.com/v1
- Model
- tanpa sensor
Prasyarat: Instal OpenAI SDK
Sebelum membuat permintaan, pastikan lingkungan pengembangan Anda memiliki OpenAI SDK resmi yang terinstal untuk bahasa pilihan Anda. Ini adalah cara standar pengembang berinteraksi dengan api openai compatible, memastikan Anda mendapatkan pengetikan dan penanganan kesalahan yang konsisten. Untuk Python, gunakan pip install openai. Untuk Node.js, jalankan npm install openai. Perpustakaan ini menangani detail HTTP di bawahnya, sehingga Anda dapat fokus pada pengiriman prompt dan menerima output teks.
Konfigurasikan URL Dasar dan Kunci API
Keuntungan utama layanan kami adalah Anda hanya perlu memperbarui dua nilai konfigurasi. Arahkan klien Anda ke URL dasar kami: https://api.openaicompatibleapi.com/v1. Kemudian, buat kunci API Anda di halaman pendaftaran; kunci ini ditampilkan segera setelah pendaftaran tanpa memerlukan kartu kredit. Tetapkan base_url dan api_key dalam inisialisasi klien Anda. Ini menjadikan kami alternatif api gpt langsung untuk proyek Anda yang ada tanpa menulis ulang logika.
Buat Permintaan Pertama Anda
Kirimkan permintaan penyelesaian chat standar menggunakan ID model uncensored. Model ini adalah model bahasa besar bobot terbuka yang disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah. Ini bukan GPT, Claude, atau model vendor lain. Anda dapat menguji konektivitas segera dengan prompt teks sederhana. Respons akan mengembalikan teks yang dihasilkan di bidang content.
curl https://api.openaicompatibleapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Aktifkan Respons Streaming
Untuk pengalaman pengguna yang lebih baik, aktifkan streaming untuk menerima token saat token tersebut dihasilkan. Tetapkan stream=True dalam permintaan Anda. SDK akan menghasilkan potongan saat potongan tersebut tiba, memungkinkan Anda menampilkan hasil parsial secara instan. Ini sangat berguna untuk jendela konteks panjang hingga 100.000 token. Streaming bekerja secara identik dengan klien OpenAI standar, mempertahankan kompatibilitas dengan logika penanganan kesalahan Anda yang ada.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Gunakan Pemanggilan Alat (Pemanggilan Fungsi)
API kami mendukung pemanggilan alat terstruktur. Definisikan fungsi Anda dalam parameter tools, dan model akan mengembalikan panggilan alat dalam respons. Anda kemudian dapat menjalankan alat tersebut dan mengirimkan hasilnya kembali ke model untuk penalaran lebih lanjut. Fitur ini bekerja dengan klien openai compatible apa pun yang mendukung format pemanggilan alat standar. Ini ideal untuk membangun agen atau mengotomatisasi alur kerja tanpa mengelola proxy llm yang kompleks.
from openai import OpenAI
client = OpenAI(base_url="https://api.openaicompatibleapi.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
Periksa Model yang Tersedia
Kueri endpoint GET /v1/models untuk memverifikasi model yang tersedia. Anda akan melihat model uncensored tercantum. Ini mengonfirmasi kunci API dan URL dasar Anda dikonfigurasi dengan benar. Anda juga dapat menggunakan endpoint ini untuk mendebug masalah autentikasi. Jika endpoint mengembalikan daftar, koneksi Anda ke api ai untuk pengembang aktif. Tidak ada model lain yang ditawarkan, menjaga konfigurasi tetap sederhana.
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openaicompatibleapi.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);Spesifikasi teknis
Semua batas dan fitur API yang sebenarnya di satu tempat — cek dulu sebelum isi saldo.
| Item | Nilai |
|---|---|
| Format | kompatibel OpenAI: SDK OpenAI apa pun bisa dipakai, cukup ganti base URL dan kunci |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| ID model | uncensored |
| Autentikasi | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.openaicompatibleapi.com/v1 |
| Streaming | ya — server-sent events; potongan terakhir berisi penggunaan token |
| Mode JSON | response_format: {"type": "json_object"} |
| Function calling | ya — tools, tool_choice; balasan berisi tool_calls, juga saat streaming; hasil dikirim sebagai role: tool |
| Parameter | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Output maksimal | hingga sisa jendela 100.000 token; max_tokens opsional (tanpa batas terpisah) |
| Jendela konteks | 100.000 token (input + output) |
| Header respons | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Batas laju | 300 permintaan per menit per kunci |
| Ukuran permintaan | hingga 8 MB |
| Konkurensi | 8 permintaan bersamaan per kunci |
| Harga | $0,25 per 1 juta token input · $1,00 per 1 juta token output |
| Bonus | +5% mulai $50, +10% mulai $100 |
| Penagihan | saldo prabayar sesuai pemakaian nyata; error dan penolakan gratis |
| Masa berlaku | saldo berbayar tidak kedaluwarsa, tanpa langganan |
| Isi saldo | USDT (TRC20) atau USDC (Base), nominal bulat berapa pun dari $10 sampai $500 |
| Uji coba gratis | $0,50 selama 7 hari, tanpa kartu · Kunci uji coba: 2 permintaan paralel, 60 per menit; batas penuh (8 dan 300) setelah isi saldo pertama |
| Konten | konten dewasa diizinkan; konten seksual yang melibatkan anak di bawah umur ditolak |
| Kunci | satu kunci aktif per akun; kunci baru menggantikan yang lama |
| Masuk | Google atau email dan kata sandi |
Kode error
Error dikirim sebagai JSON dengan type tetap; permintaan gagal atau ditolak tidak ditagih.
| Kode | Tipe | Arti |
|---|---|---|
400 | bad_request | JSON tidak valid, pesan kosong, parameter salah, atau konteks terlalu panjang |
401 | missing_key · invalid_key · key_revoked | kunci tidak ada, salah, atau sudah diganti |
402 | no_credit | saldo habis — isi ulang dan lanjut seketika |
403 | content_blocked | konten seksual dengan anak di bawah umur — ditolak, tidak ditagih |
404 | not_found | endpoint tidak dikenal |
413 | request_too_large | body lebih dari 8 MB |
429 | rate_limited · concurrency | lebih dari 300/menit atau 8 paralel — tunggu lalu coba lagi |
503 | upstream_busy | model sibuk — coba lagi beberapa detik lagi |
Tanya jawab
Berapa batas laju?
Anda dibatasi hingga 300 permintaan per menit per kunci API. Ukuran badan permintaan dibatasi hingga 8 MB. Jika Anda melebihi batas, Anda akan menerima kesalahan 429. Anda dapat membuat ulang kunci Anda kapan saja untuk mengatur ulang asosiasi, meskipun batas laju berlaku untuk kuncinya sendiri.
Mengapa saya mendapatkan kesalahan 401 atau 402?
Kesalahan 401 menunjukkan kunci API tidak valid atau kedaluwarsa. Kesalahan 402 berarti saldo prabayar Anda telah habis. Kami tidak menawarkan tier gratis tanpa batas; Anda harus isi saldo untuk terus menggunakan api llm tanpa sensor. Saldo prabayar tidak pernah kedaluwarsa, sehingga Anda dapat isi saldo mulai dari $10 menggunakan kripto (USDT atau USDC).
Apakah jendela konteks benar-benar 100k?
Ya, model mendukung jendela konteks token 100.000 yang ketat untuk prompt dan completion gabungan. Ini memungkinkan pemrosesan dokumen ekstensif atau percakapan panjang. Pastikan input Anda sesuai dengan batas ini untuk menghindari pemotongan atau kesalahan.
Kunci Anda hanya selangkah lagi dari satu formulir
Buat akun, salin kuncinya, ubah URL dasar. Itu saja seluruh pengaturannya.