Grok API: volání Grok z vlastního kódu

Dva způsoby, jak přistupovat ke Grok z kódu

Vývojáři mohou volat modely Grok dvěma hlavními způsoby. Prvním je xAI API přímo od samotné společnosti (nyní pod značkou SpaceXSI) s klíči z console.x.ai. Druhým je model router, například OpenRouter, který nabízí modely mnoha poskytovatelů pod jedním klíčem a jednou fakturací. Obě varianty přijímají požadavky ve formátu OpenAI Chat Completions, takže oficiální SDK od OpenAI fungují ihned po změně výchozí adresy URL a názvu modelu.

Kterou cestu zvolit

• xAI API, pokud chcete mít všechny funkce Grok jako první: kompletní nabídku modelů, Responses API, vyhledávání na webu i na síti X přímo na straně serveru, generování obrázků a videa přes Grok Imagine, hlas, dávkové zpracování (batch jobs) a slevy na cachované prompty. Výchozí URL je https://api.x.ai/v1.
• OpenRouter, pokud chcete přepínat mezi Grok a modely od jiných společností bez dalších smluv, nebo už účet na OpenRouter máte. Výchozí URL je https://openrouter.ai/api/v1 s ID modelů začínajícími předponou x-ai/. Návod k nastavení najdete v příručce rychlého startu OpenRouter.

V obou případech mějte klíč bezpečně uložený na serveru nebo v proměnné prostředí. Nikdy jej nevkládejte přímo do webových stránek ani mobilních aplikací, kde by si ho mohl kdokoliv přečíst.

Váš první požadavek na xAI API

Vytvořte si klíč v konzoli, uložte jej jako XAI_API_KEY a pošlete zprávu modelu Grok 4.7:

curl

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "reasoning_effort": "low",
    "messages": [
      {"role": "system", "content": "Jste stručný asistent."},
      {"role": "user", "content": "Dejte mi tři tipy na první maraton."}
    ]
  }'

Python s knihovnou OpenAI

import os
from openai import OpenAI

grok = OpenAI(
    api_key=os.environ["XAI_API_KEY"],
    base_url="https://api.x.ai/v1",
)

answer = grok.chat.completions.create(
    model="grok-4.3",
    reasoning_effort="medium",
    messages=[{"role": "user", "content": "Je 391 prvočíslo? Ukažte svůj postup ověření."}],
)
print(answer.choices[0].message.content)

Parametr reasoning_effort určuje, jak dlouho model před odpovědí přemýšlí. Grok 4.3 podporuje hodnoty none, low, medium, high a xhigh (výchozí je low); Grok 4.7 podporuje low, medium, high a xhigh (výchozí je high). Pro Grok 4.20 nabízí xAI samostatná ID: grok-4.20-0309-reasoning a grok-4.20-0309-non-reasoning.

Totéž přes OpenRouter

Na OpenRouter uložte klíč do OPENROUTER_API_KEY a použijte ID s předponou x-ai/. OpenRouter řídí přemýšlení pomocí objektu reasoning. Tento JavaScript můžete spustit v Node.js 18 nebo novějším:

const endpoint = "https://openrouter.ai/api/v1/chat/completions";

const reply = await fetch(endpoint, {
  headers: {
    Authorization: `Bearer ${process.env.OPENROUTER_API_KEY}`,
    "Content-Type": "application/json",
  },
  method: "POST",
  body: JSON.stringify({
    model: "x-ai/grok-4.20",
    reasoning: { enabled: false },
    stream: false,
    messages: [{ role: "user", content: "Přepište tento titulek klidnějším tónem: CENY ZNOVU EXPLODUJÍ" }],
  }),
});
const json = await reply.json();
console.log(json.choices[0].message.content);

Pokud chcete, aby se model nad odpovědí zamyslel, pošlete místo toho reasoning: { effort: "low" } (případně medium či high). Přidejte exclude: true, pokud chcete, aby model uvažování využil, ale nevracel jeho průběh. Nastavením stream: true získáte odpověď postupně tak, jak se generuje, což v chatovacím rozhraní působí mnohem plynuleji.

Odeslání obrázku

Grok 4.20, 4.3 i 4.7 dokážou analyzovat obrázky. Použijte strukturu zpráv známou z OpenAI se seznamem jednotlivých částí obsahu. Dokumentace xAI podporuje formáty JPEG a PNG do velikosti 20 MiB; využít lze jak veřejnou URL adresu, tak base64 data URL.

{
  "model": "grok-4.20-0309-non-reasoning",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/receipt.png"}},
      {"type": "text", "text": "Vypište položky a celkovou částku z této účtenky."}
    ]
  }]
}

ID modelů Grok a ceník

Zde jsou aktuální textové modely od SpaceXAI, které nabízí OpenRouter, včetně kontextového okna a cen za milion tokenů (ceník OpenRouter z října 2026). xAI API účtuje u promptů do 200 000 tokenů stejné základní sazby.

Několik podrobností ze stránky o modelech a cenách od xAI (ceník xAI z října 2026):

• Dlouhé prompty stojí více. Jakmile prompt dosáhne 200 000 tokenů, celý požadavek se účtuje za vyšší sazbu: 4 $ / 12 $ pro Grok 4.7, 2,50 $ / 5 $ pro Grok 4.3 a 4.20.
• Cachovaný vstup je levnější: 0,50 $ za milion tokenů u Grok 4.7 a 0,20 $ u Grok 4.3 a 4.20 pro opakované prefixy v promptech.
• Dávkové úlohy (batch jobs), které nespěchají, získávají slevu; OpenRouter navíc uvádí x-ai/grok-4.3:batch za 1 $ / 2 $.
• Velikost kontextu se liší podle zdroje: OpenRouter uvádí 2 000 000 tokenů pro Grok 4.20, zatímco na stránkách xAI se uvádí 1 000 000.

Tokeny vygenerované během uvažování (thinking) se počítají jako výstup, takže model s reasoningem může za jednu odpověď stát více, než by odpovídalo pouhé sazbě za token.

Praktické tipy

• Začněte s Grok 4.20 non-reasoning pro chat, přepisování textů a extrakci dat. Je rychlý a levný. Na Grok 4.3 nebo 4.7 přejděte ve chvíli, kdy je kvalita u náročných úkolů důležitější než rychlost.
• Myslete na datum uzávěrky znalostí. Podle xAI má Grok 4.7 znalosti o událostech do května 2026. Pro cokoliv novějšího předejte fakta přímo v promptu, nebo využijte serverové nástroje xAI pro vyhledávání na webu a síti X, které se účtují za každé volání.
• Napište systémovou zprávu, kde specifikujete požadovanou roli, tón i formát výstupu. Pokud odpověď zpracováváte v kódu, vyžádejte si JSON se schématem.
• Ošetřete limity volání (rate limits). Když obdržíte odpověď s kódem 429, zkuste požadavek po krátké pauze zopakovat.
• Dodržujte pravidla. Pro využití API platí zásady přijatelného užívání xAI. Pole safety_identifier vám navíc umožní označovat požadavky podle jednotlivých koncových uživatelů.

Když se něco pokazí

• 401 nebo 403: klíč chybí, byl zneplatněn nebo je načten v nesprávném prostředí. Vypište si jeho prvních několik znaků na serveru a ověřte, zda je dostupný.
• Model nenalezen (Model not found): zkontrolujte prefix. OpenRouter vyžaduje x-ai/grok-4.7, zatímco xAI očekává samotné grok-4.7.
• Prázdné nebo velmi pomalé odpovědi u modelu s reasoningem obvykle znamenají, že vyčerpal svůj výstupní limit na samotné přemýšlení. Snižte úroveň effort nebo zvyšte max_tokens.
• Obrázek byl odmítnut: převeďte jej do formátu JPEG nebo PNG a zkontrolujte, zda nepřekračuje povolenou velikost.

Často kladené otázky

Je Grok API kompatibilní s OpenAI SDK?

Ano. Stačí v SDK nastavit adresu https://api.x.ai/v1 s klíčem od xAI, nebo adresu OpenRouter s příslušným OpenRouter klíčem, a zadat ID modelu Grok.

Existuje bezplatné Grok API?

Žádný trvalý bezplatný tarif není k dispozici. Jak xAI, tak OpenRouter účtují poplatky podle počtu tokenů, i když krátké testy stojí jen zlomky centů.

Lze pomocí Grok API generovat obrázky?

Ano, prostřednictvím modelů Grok Imagine od xAI na samostatném koncovém bodu pro obrázky. Podívejte se na naši stránku věnovanou Grok Imagine. Náš chat obrázky negeneruje.

Který model Grok využívá Grok.Online?

Náš chat nabízí Grok 4.20 s vypnutým reasoningem, Grok 4.3 s nízkou úrovní přemýšlení a Grok 4.7 s limitem až 10 zpráv denně – vše přes OpenRouter.