URL Dasar dan Autentikasi
API kami mengikuti standar OpenAI Chat Completions. Untuk berinteraksi dengan layanan, Anda harus mengarahkan klien Anda ke https://api.grokapikey.com/v1 dan menyertakan kunci API unik Anda di header Authorization. Anda dapat membuat kunci ini segera setelah masuk dengan hanya email dan kata sandi. Kunci ditampilkan sekali saat dibuat, jadi simpan dengan aman. Jika Anda kehilangannya, Anda dapat membuat kunci baru dari dasbor Anda, yang secara instan mencabut kunci sebelumnya. Tidak perlu menghubungkan kartu kredit untuk akun uji coba.
Permintaan Pertama Anda
Mulailah dengan mengirim prompt teks sederhana untuk memverifikasi konektivitas. Gunakan endpoint standar chat/completions dengan pengenal model uncensored. Contoh berikut menunjukkan perintah curl dasar untuk menguji koneksi. Ini mengonfirmasi bahwa autentikasi Anda benar dan layanan merespons. Anda kemudian dapat mengadaptasi struktur ini untuk logika aplikasi spesifik Anda.
Ganti YOUR_API_KEY dengan kunci aktual Anda sebelum menjalankan perintah ini.
curl https://api.grokapikey.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
Jika Anda membangun aplikasi Python, gunakan perpustakaan resmi openai. Konfigurasikan klien untuk menggunakan URL dasar kami dan kunci API Anda. Ini memungkinkan Anda memanfaatkan idiom Python yang akrab sambil mengakses model tanpa sensor. Klien menangani serialisasi dan streaming secara otomatis. Pastikan lingkungan Anda memiliki versi terbaru perpustakaan yang terinstal untuk kompatibilitas terbaik dengan endpoint kami.
from openai import OpenAI
client = OpenAI(base_url="https://api.grokapikey.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 proyek JavaScript atau TypeScript, SDK OpenAI Node.js bekerja langsung. Atur properti apiKey dan baseURL dalam objek konfigurasi Anda. Ini memastikan bahwa semua permintaan berikutnya dialihkan melalui infrastruktur kami. Anda dapat menggunakan pola async/await standar untuk menangani respons. Pendekatan ini ideal untuk aplikasi sisi server atau fungsi tepi yang memerlukan akses API langsung tanpa perutean melalui OpenAI.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.grokapikey.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
Untuk aplikasi yang mendapat manfaat dari generasi token secara real-time, aktifkan streaming dengan mengatur stream: true dalam badan permintaan Anda. API mengembalikan aliran Server-Sent Events (SSE) dari respons parsial. Hal ini mengurangi latensi yang dirasakan pengguna dan memungkinkan tampilan segera teks yang dihasilkan. Setiap bagian berisi delta dari respons. Tangani peristiwa ini dalam kode klien Anda untuk memperbarui UI secara bertahap. Streaming menggunakan token secara normal dan tidak memengaruhi harga.
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, dan Konteks
Setiap kunci API dibatasi hingga 300 permintaan per menit dan ukuran body permintaan maksimum 8 MB. Jika Anda melebihi batas laju, API mengembalikan kode status 429; tunggu beberapa detik dan coba lagi. Error 401 menunjukkan kunci tidak valid atau dicabut, sedangkan error 402 berarti saldo prabayar Anda telah habis. Model mendukung jendela konteks 100.000 token untuk input dan output secara gabungan. Pastikan prompt Anda sesuai dengan batas ini untuk menghindari pemotongan. Filter konten tetap minimal, kecuali pemblokiran keras untuk konten seksual yang melibatkan anak di bawah umur.