Panduan Cepat untuk Pengguna Grok NSFW

Autentikasi & URL Dasar

API kami mengimplementasikan protokol yang kompatibel dengan openai. Anda mengautentikasi dengan meneruskan kunci API unik Anda di header Authorization. URL dasar untuk semua permintaan adalah https://api.groknsfw.cc/v1. Berbeda dengan penyedia standar, kami tidak memerlukan ID organisasi tertentu. Cukup buat kunci Anda melalui dasbor atau halaman pendaftaran cepat. Simpan kunci Anda dengan aman; kunci ini memberikan akses penuh ke saldo prabayar Anda. Tidak ada biaya bulanan atau langganan, hanya harga per token tanpa masa berlaku.

Setiap permintaan harus menyertakan pengenal model uncensored. Model ini adalah model bahasa besar bobot terbuka yang dihosting di infrastruktur kami, berbeda dari vendor lain. Model ini disesuaikan untuk memberikan respons tanpa sensor untuk konten dewasa yang sah sambil mempertahankan akurasi faktual yang tinggi. Anda tidak perlu mengubah versi pustaka klien; SDK OpenAI standar berfungsi langsung.

Penyelesaian Chat Dasar

Kirimkan permintaan penyelesaian chat standar untuk menghasilkan teks. Endpoint menerima daftar pesan, termasuk peran sistem, pengguna, dan asisten. Struktur ini memungkinkan Anda menentukan konteks, instruksi, dan riwayat percakapan. Model mengembalikan respons teks berdasarkan prompt yang diberikan. Anda dapat mengontrol kreativitas output menggunakan parameter seperti temperature dan top_p. Jika tidak ada max_tokens yang ditentukan, batas output default adalah 2.048 token. Anda dapat meningkatkan ini hingga 32.000 token per permintaan, dalam jendela konteks total 100.000 token.

Kesalahan dikembalikan dalam format JSON standar. Masalah umum termasuk kunci tidak valid atau kredit tidak cukup. API tidak menangani tokenisasi untuk Anda; Anda mengirimkan teks, dan model memprosesnya secara internal. Anda menerima teks yang dihasilkan akhir atau aliran parsial jika diaktifkan.

Respons Streaming

Pemanggilan Fungsi & Alat

API mendukung pemanggilan fungsi, memungkinkan model mengeluarkan data terstruktur alih-alih teks biasa. Tentukan alat Anda di parameter tools, menentukan nama fungsi, deskripsi, dan skema parameter. Ketika model menentukan panggilan alat diperlukan, model mengembalikan nama fungsi dan argumen dalam format JSON. Aplikasi Anda kemudian menjalankan fungsi dan memasukkan hasilnya kembali ke percakapan. Ini memungkinkan alur kerja kompleks, ekstraksi data, dan tindakan otomatis. Tetapkan tool_choice untuk mengontrol apakah model harus menggunakan alat atau dapat memilih secara bebas.

Mode JSON

Untuk aplikasi yang memerlukan format output ketat, gunakan mode JSON. Tetapkan parameter response_format ke {"type": "json_object"}. Model akan membatasi outputnya menjadi JSON yang valid. Ini sangat ideal untuk mengurai data ke sistem backend Anda atau menghasilkan konfigurasi terstruktur. Perhatikan bahwa mode JSON mungkin sedikit mengurangi fleksibilitas penalaran model dibandingkan teks bebas-form. Pastikan prompt Anda secara jelas menginstruksikan model untuk hanya menghasilkan JSON. Fitur ini bekerja berdampingan dengan pemanggilan fungsi tetapi menyediakan antarmuka yang lebih sederhana ketika Anda hanya membutuhkan data terstruktur tanpa definisi alat.

Penggunaan & Batas Token

Akun Anda dibatasi hingga 300 permintaan per menit dan 8 permintaan paralel per kunci. Ukuran badan permintaan maksimum adalah 8 MB. Jika Anda melebihi batas ini, API mengembalikan kode status 429. Kesalahan autentikasi mengembalikan 401, dan kredit tidak cukup mengembalikan 402. Biaya adalah $0,25 per juta token input dan $1,00 per juta token output. Kesalahan dan penolakan tidak mengonsumsi kredit. Jendela konteks adalah 100.000 token total, termasuk prompt dan penyelesaian. Kelola penggunaan token Anda dengan hati-hati untuk menghindari biaya tak terduga. Saldo tidak pernah habis, dan Anda dapat mengisi saldo kapan saja menggunakan kripto.

cURL

Copycurl https://api.groknsfw.cc/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."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.groknsfw.cc/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)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.groknsfw.cc/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);

Streaming

Copystream = 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)