Panduan Cepat untuk Pengguna Grok

URL Dasar dan Autentikasi

API kami sepenuhnya kompatibel dengan SDK OpenAI. Anda hanya perlu memperbarui base_url dan memberikan kunci Anda di header Authorization. Daftar melalui Google atau email untuk menerima kunci Anda secara instan. Tidak diperlukan nomor telepon atau kartu kredit untuk memulai. Gunakan ID model uncensored untuk semua permintaan.

Autentikasi ditangani melalui token Bearer. Pastikan kunci Anda dikirim di setiap header permintaan. Jika Anda menerima error 401, kunci Anda tidak valid atau telah kedaluwarsa. Layanan kami independen dan tidak menjual kembali model vendor lain.

Penyelesaian Obrolan Dasar

Kirim permintaan POST standar ke /v1/chat/completions. API menerima input teks dan mengembalikan output teks. Anda dapat menentukan prompt sistem untuk mengarahkan perilaku model. Model merespons tanpa penolakan untuk konten dewasa yang sah, fiksi, atau topik kontroversial.

Tentukan model sebagai uncensored dalam payload Anda. Jendela konteks mendukung hingga 100.000 token secara total. Output maksimum adalah 32.000 token per permintaan. Kesalahan dan penolakan tidak mengonsumsi saldo.

Respons Streaming

Aktifkan streaming dengan mengatur stream: true. API mengembalikan Server-Sent Events (SSE). Setiap chunk berisi pembaruan teks inkremental. Chunk terakhir mencakup statistik penggunaan token untuk transparansi penagihan.

Streaming sangat ideal untuk pembaruan UI waktu nyata. Parse stream SSE untuk menampilkan teks saat dihasilkan. Ini mengurangi latensi yang dirasakan pengguna. API menangani protokol streaming secara otomatis.

Pemanggilan Fungsi

Definisikan alat dalam parameter tools. Model dapat mengembalikan panggilan alat terstruktur. Gunakan tool_choice untuk memaksa perilaku tertentu. Ini memungkinkan integrasi dengan sistem dan alur kerja eksternal.

Pemanggilan fungsi bekerja dengan format OpenAI standar. Parse respons untuk mengeksekusi alat yang diminta. Model mempertahankan konteks di seluruh panggilan fungsi. Ini berguna untuk agen otomatis dan tugas ekstraksi data.

Mode JSON

Atur response_format ke {"type": "json_object"} untuk output JSON yang ketat. Model akan memformat responsnya sebagai JSON yang valid. Ini berguna untuk memparse data terstruktur dalam aplikasi.

Mode JSON memastikan pemformatan yang konsisten. Gunakan saat kode turunan Anda mengharapkan struktur skema tertentu. Model mematuhi format yang diminta. Ini mengurangi kebutuhan akan logika parsing tambahan.

Parameter, Batas, dan Error

Kendalikan generasi dengan temperature, top_p, dan urutan stop. Batas laju adalah 300 permintaan per menit per kunci. Anda dapat memiliki hingga 8 permintaan paralel. Badan permintaan tidak boleh melebihi 8 MB. Kesalahan HTTP 402 menunjukkan saldo tidak mencukupi. Kesalahan HTTP 429 berarti Anda telah mencapai batas laju. Saldo prabayar tidak pernah kedaluwarsa. Kesalahan gratis.

cURL

Copycurl https://api.grokuncensored.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.grokuncensored.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.grokuncensored.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)