URL Dasar & Autentikasi
Mulai dengan membuat akun di halaman Dapatkan kunci API. Anda hanya memerlukan email dan kata sandi; tidak diperlukan nomor telepon atau kartu kredit untuk mengaktifkan kredit uji coba gratis. Setelah terdaftar, kunci API Anda ditampilkan segera. Salin kunci ini dan simpan dengan aman. Gunakan dalam header Authorization sebagai token Bearer untuk semua permintaan. URL dasar untuk semua endpoint adalah https://api.gemma4api.com/v1. URL ini berfungsi dengan klien OpenAI-compatible standar apa pun, memungkinkan Anda mengubah penyedia hanya dengan mengubah URL dasar dan kunci API dalam konfigurasi Anda.
Permintaan Pertama
Kirimkan prompt pertama Anda menggunakan curl untuk memverifikasi konektivitas. Ganti YOUR_API_KEY dengan kunci aktual Anda. Pengenal model adalah uncensored. Permintaan teks masuk, teks keluar sederhana ini mengonfirmasi bahwa autentikasi Anda benar dan model merespons. Jika Anda menerima respons JSON dengan array choices, pengaturan Anda telah selesai. Anda sekarang dapat melanjutkan untuk mengintegrasikan SDK untuk alur kerja yang lebih kompleks.
curl https://api.gemma4api.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."}]
}'
Integrasi SDK Python
Instal paket Python OpenAI resmi. Atur variabel lingkungan URL dasar dan kunci API atau teruskan secara langsung ke konstruktor klien. Gunakan ID model uncensored untuk memastikan Anda memanggil instance khusus kami. Pendekatan ini memastikan kode Anda tetap kompatibel dengan pola OpenAI standar sambil memanfaatkan model tanpa sensor kami untuk pembuatan konten. SDK menangani coba ulang dan parsing JSON secara otomatis.
from openai import OpenAI
client = OpenAI(base_url="https://api.gemma4api.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)
Integrasi SDK Node.js
Untuk lingkungan JavaScript, instal paket Node.js OpenAI. Konfigurasikan klien dengan URL dasar https://api.gemma4api.com/v1 dan kunci API Anda. Gunakan ID model uncensored dalam panggilan penyelesaian Anda. Pengaturan ini memungkinkan Anda mempertahankan struktur kode kompatibel OpenAI standar sambil mendapatkan manfaat dari perilaku model spesifik yang dihosting di server kami. Pastikan Anda menangani respons asinkron dengan benar dalam loop acara Node.js Anda.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.gemma4api.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);
Respons Streaming
Aktifkan streaming dengan menetapkan parameter stream menjadi true dalam permintaan API Anda. Ini mengembalikan aliran Event yang Disajikan Server (SSE), memungkinkan Anda menampilkan token saat dihasilkan. Ini ideal untuk antarmuka obrolan di mana latensi sangat penting. Setiap bagian berisi delta parsial dari respons. Tangani peristiwa akhir aliran untuk mengetahui kapan generasi selesai. Metode ini secara signifikan mengurangi latensi yang dirasakan dibandingkan menunggu respons penuh.
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)
Batas, Kesalahan & Jendela Konteks
Permintaan Anda mendukung jendela konteks 100.000 token untuk prompt dan penyelesaian secara gabungan. Batas laju adalah 300 permintaan per menit per kunci, dengan ukuran badan permintaan maksimum 8 MB. Kesalahan umum termasuk 401 untuk kunci tidak valid, 402 jika saldo prabayar Anda habis, dan 429 jika Anda melebihi batas per menit. Membuat ulang kunci API Anda mencabut kunci lama tetapi tidak mengatur ulang penghitung laju. Pastikan klien Anda menangani kode status HTTP ini dengan tepat untuk menjaga kelancaran operasi.
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 |
| Autentikasi | Authorization: Bearer YOUR_KEY |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.gemma4api.com/v1 |
| ID model | uncensored |
| Jendela konteks | 100.000 token (input + output) |
| Streaming | ya — server-sent events; potongan terakhir berisi penggunaan token |
| Function calling | ya — tools, tool_choice; balasan berisi tool_calls, juga saat streaming; hasil dikirim sebagai role: tool |
| Output maksimal | hingga sisa jendela 100.000 token; max_tokens opsional (tanpa batas terpisah) |
| Mode JSON | response_format: {"type": "json_object"} |
| Parameter | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Batas laju | 300 permintaan per menit per kunci |
| Ukuran permintaan | hingga 8 MB |
| Header respons | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Konkurensi | 8 permintaan bersamaan per kunci |
| Harga | $0,25 per 1 juta token input · $1,00 per 1 juta token output |
| 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 |
| Bonus | +5% mulai $50, +10% mulai $100 |
| Penagihan | saldo prabayar sesuai pemakaian nyata; error dan penolakan gratis |
| Masuk | Google atau email dan kata sandi |
| Kunci | satu kunci aktif per akun; kunci baru menggantikan yang lama |
| Konten | konten dewasa diizinkan; konten seksual yang melibatkan anak di bawah umur ditolak |
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
Apakah membuat ulang kunci API saya akan mereset penghitung batas laju saya?
Tidak. Membuat ulang kunci Anda mencabut kunci sebelumnya dan menerbitkan kredensial baru, tetapi batas laju berlaku per akun dan tetap ada terlepas dari perubahan kunci. Anda harus menunggu jendela menit untuk direset jika Anda mencapai batas 300 permintaan/menit.
Model apa yang berjalan di balik ID 'uncensored'?
Ini adalah model bahasa besar bobot terbuka yang dihosting di server GPU kami sendiri. Ini bukan GPT, Claude, Gemini, atau model vendor lain. Model ini disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah.
Bisakah saya menggunakan API ini untuk pemanggilan alat?
Ya. Endpoint <code>/v1/chat/completions</code> mendukung pemanggilan alat dan fungsi. Anda dapat meneruskan definisi alat dalam permintaan, dan model akan mengembalikan output JSON terstruktur yang kompatibel dengan implementasi SDK OpenAI standar.
Kunci Anda hanya selangkah lagi dari satu formulir
Buat akun, salin kuncinya, ubah URL dasar. Itu saja seluruh pengaturannya.