Grok API Documentation

Buy credits, generate a key, and call Grok through a simple endpoint. If you've used the OpenAI API before, you already know this one.

Introduction

The Grok API exposes a REST interface modeled on the OpenAI specification. You authenticate with a bearer token and receive standard JSON responses, so the official OpenAI SDKs and most HTTP clients work with minimal changes.

Base URL

Authentication

The API uses bearer token authentication. Create a key from your dashboard after topping up credits, then pass it on every request:

# HTTP headers
Authorization: Bearer sk-grok-your-key
Content-Type: application/json

Quickstart

Python

from openai import OpenAI

client = OpenAI(api_key="sk-grok-your-key", base_url="https://api.grokapi.io/v1")

resp = client.chat.completions.create(
    model="grok-4",
    messages=[{"role": "user", "content": "Explain RAG in one sentence."}],
)
print(resp.choices[0].message.content)

cURL

curl https://api.grokapi.io/v1/chat/completions \
  -H "Authorization: Bearer sk-grok-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-4", "messages": [{"role":"user","content":"Hello!"}]}'

Chat completions

Creates a model response for a conversation. Core parameters:

• model — grok-4 or grok-3. Required.
• messages — array of { role, content } objects. Required.
• temperature, max_tokens, stream — optional.

Streaming

Set stream: true to receive tokens as server-sent events, terminated by data: [DONE] — identical to the OpenAI streaming format.

Models

Errors

Conventional HTTP status codes are used, with an OpenAI-style error body: { "error": { "message", "type", "code" } }.

Rate limits

Rate limits scale with your plan and balance. When you exceed a limit you'll receive a 429 with a Retry-After header — back off and retry. Need a custom limit? Contact us.