Dokumentasi API

Autentikasi dan URL dasar

URL dasar untuk semua permintaan adalah https://api.grokapiplatform.com/v1. Autentikasi dengan meneruskan kunci API unik Anda di Authorization header. Setiap permintaan harus menyertakan header ini untuk memverifikasi saldo akun Anda dan menerapkan batas laju.

Endpoint Chat completions

Kirim pertanyaan teks ke POST /v1/chat/completions. ID model yang digunakan adalah "uncensored". Titik akhir ini menangani interaksi teks masuk dan teks keluar standar tanpa memerlukan konfigurasi tambahan untuk penggunaan dasar.

Copycurl https://api.grokapiplatform.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check my current token usage balance."}]
  }'

Model ini beroperasi dengan jendela konteks 100,000 token. Token input dan output berbagi batas ini. Permintaan yang melebihi jendela konteks akan gagal segera.

Respons streaming dengan SSE

Aktifkan streaming dengan mengatur stream: true dalam badan permintaan Anda. Server mengembalikan Server-Sent Events (SSE) dengan pembarian token inkremental. Gunakan ini untuk tampilan real-time atau untuk mengurangi latensi yang dirasakan.

Copyfrom openai import OpenAI

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

Detail penggunaan token muncul di potongan terakhir aliran. Anda dapat melacak total konsumsi per permintaan tanpa menguraikan setiap delta perantara.

Pemanggilan fungsi dan alat

Tentukan alat dalam tools array dan set tool_choice untuk memicu perilaku tertentu. Model mendukung pola penggunaan alat standar yang kompatibel dengan SDK OpenAI.

Copyimport OpenAI from "openai";

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

Gunakan tool_choice: "auto" untuk pemilihan otomatis atau sebutkan nama alat untuk eksekusi paksa. Ini bekerja mulus dengan model tanpa sensor untuk tugas penalaran kompleks.

Mode JSON untuk output terstruktur

Atur response_format ke {"type": "json_object"} untuk memaksakan output JSON yang ketat. Ini mengurangi kesalahan parsing saat mengintegrasikan dengan aplikasi frontend atau pipeline data.

Parameter dan batas

Sesuaikan temperature, top_p, dan seed untuk mengontrol acak. Output maksimum per permintaan adalah 16.000 token. Kesalahan seperti 401 menunjukkan kunci tidak valid, 402 berarti kredit prabayar tidak cukup, dan 429 menandakan batas laju. Batasnya adalah 300 permintaan per menit per kunci. Kredit tidak pernah kedaluwarsa, sehingga Anda dapat mengisi ulang dengan USDT atau USDC kapan saja diperlukan.

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)