Permintaan pertama dalam lima menit
Integrasikan API tanpa sensor kami ke dalam alur kerja AI NSFW Anda dengan memperbarui tiga nilai konfigurasi di klien kompatibel OpenAI Anda. Panduan singkat ini mencakup autentikasi, generasi teks, dan streaming tanpa dependensi tambahan.
URL Dasar dan Autentikasi
API kami meniru antarmuka OpenAI v1, memungkinkan Anda mengganti endpoint tanpa mengubah logika aplikasi. Gunakan https://api.groknsfw.top/v1 sebagai URL dasar. Autentikasi memerlukan kunci API valid yang diteruskan dalam header Authorization sebagai token Bearer. Anda dapat membuat kunci ini secara instan melalui masuk Google atau email di dasbor. Setiap akun mendukung satu kunci aktif pada satu waktu; menerbitkan kunci baru akan membuat kunci sebelumnya tidak berlaku segera. Model kunci tunggal ini menyederhanakan kontrol akses untuk sebagian besar lingkungan pengembangan dan QA.
Permintaan Pertama
Kirim permintaan penyelesaian chat standar untuk menguji konektivitas. Pengenal model adalah uncensored, yang menangani penolakan konten secara berbeda dari model standar. Di bawah ini adalah contoh dasar menggunakan alat baris perintah curl untuk memverifikasi kunci dan URL dasar Anda benar.
curl https://api.groknsfw.top/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."}]
}'
Jika Anda menerima respons JSON dengan choices dan usage, integrasi Anda aktif. Periksa objek usage untuk melihat konsumsi token guna pelacakan penagihan yang akurat.
Integrasi SDK Python
Gunakan paket Python openai resmi untuk berinteraksi dengan endpoint kami. Atur atribut base_url dan api_key sebelum melakukan panggilan. Pendekatan ini berfungsi dengan pustaka apa pun yang mendukung skema OpenAI, membuat migrasi dari penyedia lain menjadi mudah.
from openai import OpenAI
client = OpenAI(base_url="https://api.groknsfw.top/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)
Potongan kode ini mendemonstrasikan permintaan sinkron. Untuk generasi konten NSFW berkapasitas tinggi, pertimbangkan untuk menggunakan klien asinkron untuk menangani beberapa permintaan secara paralel tanpa memblokir utas utama Anda.
Pengaturan SDK Node.js
Untuk aplikasi JavaScript atau TypeScript, konfigurasikan SDK OpenAI untuk menunjuk ke URL dasar kami. Ini memastikan kode klien Anda yang ada berfungsi tanpa modifikasi. Ekosistem Node.js mendapat manfaat dari kompatibilitas ini, memungkinkan pembuatan prototipe cepat antarmuka chat NSFW.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.groknsfw.top/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);
Pastikan Anda menggunakan versi terbaru SDK yang mendukung URL dasar kustom. Objek konfigurasi harus secara ketat menyertakan properti apiKey dan baseURL untuk menghindari ketidakcocokan endpoint.
Respons Streaming (SSE)
Aktifkan generasi token waktu nyata dengan mengatur stream: true dalam permintaan Anda. API mengembalikan aliran Server-Sent Events (SSE), mengirimkan token saat dihasilkan. Ini mengurangi latensi yang dirasakan untuk pengguna akhir dalam aplikasi chat.
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)
Parse peristiwa SSE untuk mengekstrak konten delta. Potongan terakhir dalam streaming berisi statistik penggunaan total usage, yang harus Anda gunakan untuk rekonsiliasi penagihan yang akurat. Streaming tidak memengaruhi penghitungan token atau harga.
Batas, Kesalahan, dan Konteks
Permintaan Anda dibatasi hingga 300 per menit dan 8 permintaan paralel per kunci. Ukuran body permintaan maksimum adalah 8 MB, dan jendela konteks mendukung hingga 100.000 token total. Error dikembalikan dalam format HTTP standar: 401 untuk kunci tidak valid, 402 untuk saldo tidak cukup, dan 429 untuk batas laju. Error saldo gratis, tetapi batas laju mengharuskan Anda mengurangi laju permintaan. Output maksimum per permintaan adalah 32.000 token; jika max_tokens diabaikan, nilai defaultnya adalah 2.048 token.
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 |
| Base URL | https://api.groknsfw.top/v1 |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| ID model | uncensored |
| Mode JSON | response_format: {"type": "json_object"} |
| Output maksimal | hingga sisa jendela 100.000 token; max_tokens opsional (tanpa batas terpisah) |
| Parameter | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Function calling | ya — tools, tool_choice; balasan berisi tool_calls, juga saat streaming; hasil dikirim sebagai role: tool |
| Jendela konteks | 100.000 token (input + output) |
| Streaming | ya — server-sent events; potongan terakhir berisi penggunaan token |
| Header respons | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Batas laju | 300 permintaan per menit per kunci |
| Konkurensi | 8 permintaan bersamaan per kunci |
| Ukuran permintaan | hingga 8 MB |
| Penagihan | saldo prabayar sesuai pemakaian nyata; error dan penolakan gratis |
| 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 |
| Masa berlaku | saldo berbayar tidak kedaluwarsa, tanpa langganan |
| Bonus | +5% mulai $50, +10% mulai $100 |
| Harga | $0,25 per 1 juta token input · $1,00 per 1 juta token output |
| Isi saldo | USDT (TRC20) atau USDC (Base), nominal bulat berapa pun dari $10 sampai $500 |
| 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 ini API Grok resmi?
Tidak, kami adalah layanan independen yang menjalankan model bobot terbuka yang disesuaikan untuk respons tanpa sensor. Kami menggunakan protokol API yang sama dengan OpenAI, tetapi model kami bukan GPT-4, Grok, atau model vendor lain. Periksa dokumentasi vendor untuk detail model spesifik mereka.
Bagaimana cara mendapatkan lebih banyak kunci API?
Setiap akun dibatasi hanya untuk satu kunci API aktif pada satu waktu. Membuat kunci baru di dasbor akan segera membuat kunci sebelumnya tidak berlaku. Desain ini menyederhanakan manajemen akses untuk pengembang individu dan tim kecil.
Apakah Anda mendukung pemanggilan fungsi?
Ya, API mendukung pemanggilan fungsi standar melalui parameter <code>tools</code> dan <code>tool_choice</code>. Anda juga dapat memaksakan output JSON menggunakan <code>response_format: { "type": "json_object" }</code> untuk generasi data terstruktur.
Kunci Anda hanya selangkah lagi dari satu formulir
Buat akun, salin kunci, ubah URL dasar. Itu saja pengaturannya.