Panduan Cepat untuk Pengguna Unhinged Grok

Autentikasi dan URL Dasar

API kami kompatibel dengan OpenAI, artinya Anda tidak perlu perpustakaan baru. Anda hanya perlu memperbarui dua nilai dalam konfigurasi Anda: base_url dan api_key. Kunci API Anda dibuat segera setelah pendaftaran melalui Google atau email. Simpan kunci ini dengan aman; ini adalah satu-satunya kredensial yang diperlukan untuk autentikasi.

Ganti URL dasar OpenAI standar dengan endpoint kami. Perubahan ini mengarahkan semua permintaan berikutnya ke server model tanpa sensor kami. Tidak ada perubahan kode lain yang diperlukan untuk generasi teks dasar.

Contoh Konfigurasi

• Base URL: https://api.unhingedgrok.com/v1
• Kunci API: Kunci unik Anda dari dasbor

Verifikasi koneksi Anda dengan mencantumkan model yang tersedia. Ini mengonfirmasi bahwa autentikasi Anda berfungsi dengan benar sebelum mengirim permintaan generasi.

Permintaan Pertama

Mulai dengan mengirim permintaan penyelesaian teks sederhana. Contoh ini menggunakan curl untuk menunjukkan struktur HTTP mentah. Permintaan menargetkan endpoint /v1/chat/completions dengan ID model uncensored. Respons mengembalikan teks yang dihasilkan dalam array choices.

Pendekatan langsung ini berfungsi untuk bahasa atau alat apa pun yang mendukung format HTTP OpenAI standar. Anda dapat mengujinya segera setelah membuat kunci Anda.

Permintaan HTTP Langsung

Salincurl https://api.unhingedgrok.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

Gunakan library Python resmi OpenAI untuk mengintegrasikan API kami. Instal paket melalui pip. Inisialisasi klien dengan kunci Anda dan URL dasar kustom. Metode SDK lainnya, seperti chat.completions.create, bekerja persis seperti yang didokumentasikan untuk OpenAI.

Metode ini ideal untuk layanan backend, skrip pemrosesan data, atau alur kerja otomatis. SDK menangani serialisasi JSON dan parsing respons secara otomatis.

Contoh Kode Python

Salinfrom openai import OpenAI

client = OpenAI(base_url="https://api.unhingedgrok.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 atau TypeScript, gunakan paket npm openai resmi. Konfigurasikan klien dengan base URL dan kunci yang sama. SDK Node mendukung pola berbasis callback dan promise.

Konfigurasi ini memungkinkan Anda menyisipkan generasi teks tanpa sensor langsung ke aplikasi web, fungsi serverless, atau alat otomatisasi berbasis Node. Penanganan kesalahan tetap konsisten dengan perilaku SDK OpenAI standar.

Contoh Kode Node.js

Salinimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.unhingedgrok.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 generasi token waktu nyata dengan mengatur stream: true. API mengembalikan aliran Server-Sent Events (SSE). Setiap potongan berisi respons parsial. Potongan terakhir mencakup statistik penggunaan token.

Streaming mengurangi latensi yang dirasakan oleh pengguna akhir. Ini penting untuk antarmuka obrolan dan aplikasi interaktif. Tangani setiap potongan secara inkremental untuk memperbarui UI segera.

Contoh Kode Streaming

Salinstream = 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, dan Konteks

Pahami batasan operasional untuk menghindari gangguan layanan. Jendela konteks mendukung 100,000 token total, dan jika max_tokens tidak diatur, respons dapat berjalan hingga akhir jendela.

Batas laju mengizinkan 300 permintaan per menit per kunci. Permintaan paralel dibatasi hingga 8. Badan permintaan tidak boleh melebihi 8 MB. Tangani kode kesalahan HTTP standar: 401 menunjukkan kunci tidak valid, 402 menandakan kredit tidak cukup, dan 429 menandakan batas laju. Error tidak mengonsumsi kredit.