Grok API: pagtawag sa Grok mula sa sarili mong code

Dalawang paraan para gamitin ang Grok mula sa code

Maaaring tawagin ng mga developer ang Grok models sa dalawang pangunahing paraan. Ang una ay ang xAI API, na pinapatakbo mismo ng kumpanya (ngayon ay may tatak na SpaceXSI), gamit ang mga key mula sa console.x.ai. Ang ikalawa ay isang model router gaya ng OpenRouter, na nag-aalok ng mga modelo mula sa iba't ibang provider gamit ang iisang key at isang bill lang. Pareho silang tumatanggap ng mga request sa format na OpenAI Chat Completions, kaya gagana ang mga opisyal na OpenAI SDK kapag pinalitan mo ang base address at ang pangalan ng modelo.

Aling opsyon ang dapat piliin

• xAI API kung gusto mo ng maagang access sa bawat feature ng Grok: ang kumpletong listahan ng mga modelo, ang Responses API, server-side web search at X search tools, image at video generation gamit ang Grok Imagine, boses, batch jobs, at mga diskwento sa cached-prompt. Base URL https://api.x.ai/v1.
• OpenRouter kung nais mong magpalit-palit sa pagitan ng Grok at mga modelo ng ibang kumpanya nang walang bagong kontrata, o kung mayroon ka nang OpenRouter account. Base URL https://openrouter.ai/api/v1, na may model id na may prefix na x-ai/. Ang setup ay nasa OpenRouter quickstart.

Kahit alin ang piliin mo, panatilihin ang key sa isang server o sa isang environment variable. Huwag na huwag itong ilalagay sa loob ng isang web page o mobile app, kung saan kahit sino ay madali itong makikita.

Ang una mong request sa xAI API

Gumawa ng key sa console, i-save ito bilang XAI_API_KEY, at magpadala ng mensahe sa 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": "You are a concise assistant."},
      {"role": "user", "content": "Give me three tips for a first marathon."}
    ]
  }'

Python, gamit ang OpenAI library

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": "Is 391 a prime number? Show your check."}],
)
print(answer.choices[0].message.content)

Kinokontrol ng reasoning_effort kung gaano katagal mag-iisip ang modelo bago sumagot. Tumatanggap ang Grok 4.3 ng none, low, medium, high, at xhigh, at naka-default sa low; tumatanggap naman ang Grok 4.7 ng low, medium, high, at xhigh, at naka-default sa high. Para sa Grok 4.20, naglabas ang xAI ng magkahiwalay na id: grok-4.20-0309-reasoning at grok-4.20-0309-non-reasoning.

Gawin din ito sa OpenRouter

Sa OpenRouter, ilagay ang key sa OPENROUTER_API_KEY at gamitin ang mga id na may x-ai/. Kinokontrol ng OpenRouter ang pag-iisip gamit ang isang reasoning object. Gumagana ang JavaScript na ito sa Node.js 18 o mas bago:

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: "Rewrite this headline in a calmer tone: PRICES EXPLODE AGAIN" }],
  }),
});
const json = await reply.json();
console.log(json.choices[0].message.content);

Para pag-isipin ang modelo, ipadala ang reasoning: { effort: "low" } (o medium, high). Idagdag ang exclude: true kung gusto mong gamitin ang proseso ng pag-iisip ngunit ayaw mo itong isama sa sagot. I-set ang stream: true para matanggap ang sagot habang sinusulat ito, na mas mabilis tingnan sa isang chat interface.

Pagpapadala ng larawan

Kayang magbasa ng mga larawan ng Grok 4.20, 4.3, at 4.7. Gamitin ang OpenAI-style na mensahe na may listahan ng mga bahagi. Tumatanggap ang docs ng xAI ng mga JPEG at PNG na larawan hanggang 20 MiB; puwede ang isang pampublikong URL o isang 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": "List the items and the total on this receipt."}
    ]
  }]
}

Mga Grok model id at presyo

Ito ang mga kasalukuyang text model na nakalista sa OpenRouter para sa SpaceXAI, kasama ang laki ng context at mga presyo bawat milyong token (list price ng OpenRouter, Okt 2026). Naniningil ang xAI API ng parehong base rate para sa mga prompt na mas mababa sa 200,000 token.

Ilang detalye mula sa page ng mga modelo at presyo ng xAI (list price ng xAI, Okt 2026):

• Mas mahal ang mahahabang prompt. Kapag umabot sa 200,000 token ang isang prompt, sisingilin ang buong request sa mas mataas na rate: $4 / $12 para sa Grok 4.7, $2.50 / $5 para sa Grok 4.3 at 4.20.
• Mas mura ang cached input: $0.50 bawat milyon para sa Grok 4.7 at $0.20 para sa Grok 4.3 at 4.20, para sa mga inuulit na prompt prefix.
• May diskwento ang mga batch job na puwedeng maghintay, at inililista rin ng OpenRouter ang x-ai/grok-4.3:batch sa halagang $1 / $2.
• Iba-iba ang context depende sa source: Naglilista ang OpenRouter ng 2,000,000 token para sa Grok 4.20, habang 1,000,000 naman ang nakasaad sa mismong model page ng xAI.

Binibilang bilang output ang mga thinking token, kaya maaaring mas maging mahal ang sagot ng isang reasoning model kaysa sa ipinapahiwatig ng presyo nito bawat token.

Mga praktikal na tip

• Magsimula sa Grok 4.20 non-reasoning para sa chat, rewriting, at extraction. Mabilis ito at mura. Lumipat sa Grok 4.3 o 4.7 kapag mas mahalaga ang kalidad sa mahihirap na gawain kaysa sa bilis.
• Tandaan ang knowledge cut-off. Ayon sa xAI, alam ng Grok 4.7 ang mga kaganapan hanggang Mayo 2026. Para sa mas bago, isama ang mga impormasyon sa iyong prompt, o gamitin ang server-side web at X search tools ng xAI, na sinisingil bawat tawag.
• Sumulat ng system message na nagtatakda ng role, tono, at format ng output na gusto mo, at humingi ng JSON na may schema kapag ipa-parse ng code mo ang sagot.
• Ihanda ang app para sa mga rate limit. Mag-retry pagkatapos ng maikling sandali kapag nakatanggap ka ng 429 response.
• Sundin ang mga panuntunan. Nalalapat ang acceptable use policy ng xAI sa paggamit ng API, at may safety_identifier field upang matukoy mo ang mga request bawat end user.

Kapag may nagkaproblema

• 401 o 403: nawawala, binuwag, o na-load sa maling environment ang key. I-print ang mga unang character nito sa server para masigurong nandiyan ito.
• Model not found: suriin ang prefix. Kailangan sa OpenRouter ang x-ai/grok-4.7, habang grok-4.7 lang ang kailangan sa xAI.
• Walang laman o napakabagal na sagot mula sa isang reasoning model: kadalasang nangangahulugang naubos nito ang output budget sa pag-iisip. Babaan ang effort o itaas ang max_tokens.
• Tinanggihan ang larawan: i-convert ito sa JPEG o PNG at panatilihin itong mas mababa sa limitasyon sa laki ng file.

FAQ

Compatible ba ang Grok API sa OpenAI SDK?

Oo. Ituro lang ang SDK sa https://api.x.ai/v1 gamit ang xAI key, o sa OpenRouter gamit ang OpenRouter key, at gamitin ang isang Grok model id.

Mayroon bang libreng Grok API?

Walang nakalistang permanenteng libreng tier. Parehong naniningil ang xAI at OpenRouter bawat token, bagama't napakaliit lang ng gastos para sa maiikling test.

Maaari ba akong gumawa ng mga larawan gamit ang Grok API?

Oo, sa pamamagitan ng mga Grok Imagine model ng xAI sa isang nakahiwalay na images endpoint. Tingnan ang aming page para sa Grok Imagine. Hindi gumagawa ng mga larawan ang aming chat.

Aling Grok model ang ginagamit ng Grok.Online?

Nag-aalok ang aming chat ng Grok 4.20 nang walang reasoning, Grok 4.3 sa low reasoning effort, at Grok 4.7 nang hanggang 10 mensahe bawat araw, lahat sa pamamagitan ng OpenRouter.