Grok API: gọi Grok trực tiếp từ code của bạn

Hai cách gọi Grok từ mã nguồn

Lập trình viên có thể gọi các mô hình Grok theo hai cách chính. Đầu tiên là xAI API, do chính công ty vận hành (hiện mang thương hiệu SpaceXSI), lấy API key từ console.x.ai. Thứ hai là dùng một dịch vụ định tuyến mô hình (model router) như OpenRouter, nơi tổng hợp mô hình của nhiều nhà cung cấp chỉ với một key và một hóa đơn duy nhất. Cả hai đều hỗ trợ định dạng OpenAI Chat Completions, vì vậy các SDK chính thức của OpenAI đều hoạt động mượt mà ngay khi bạn đổi địa chỉ base URL và tên mô hình.

Nên chọn hướng đi nào?

• xAI API nếu bạn muốn trải nghiệm sớm nhất mọi tính năng của Grok: danh sách mô hình đầy đủ, Responses API, công cụ tìm kiếm web và tìm kiếm trên X phía máy chủ, tạo hình ảnh và video với Grok Imagine, giọng nói, xử lý tác vụ theo lô (batch jobs) và ưu đãi giảm giá khi dùng prompt cache. Base URL là https://api.x.ai/v1.
• OpenRouter nếu bạn muốn linh hoạt chuyển đổi giữa Grok và các mô hình từ những công ty khác mà không cần ký thêm hợp đồng mới, hoặc nếu bạn đã có sẵn tài khoản OpenRouter. Base URL là https://openrouter.ai/api/v1, tên mô hình có tiền tố x-ai/. Hướng dẫn thiết lập có tại hướng dẫn nhanh OpenRouter.

Dù chọn cách nào, hãy luôn lưu trữ API key trên máy chủ hoặc trong biến môi trường. Tuyệt đối không nhúng key vào mã nguồn trang web hay ứng dụng di động, nơi bất kỳ ai cũng có thể đọc được.

Gửi yêu cầu đầu tiên đến xAI API

Tạo một API key trong trang console, lưu vào biến môi trường XAI_API_KEY, và gửi tin nhắn đến 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 (dùng thư viện 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": "Is 391 a prime number? Show your check."}],
)
print(answer.choices[0].message.content)

Tham số reasoning_effort điều chỉnh thời gian mô hình suy nghĩ trước khi trả lời. Grok 4.3 hỗ trợ các mức none, low, medium, high và xhigh (mặc định là low); Grok 4.7 hỗ trợ low, medium, high và xhigh (mặc định là high). Đối với Grok 4.20, xAI phát hành các ID riêng biệt: grok-4.20-0309-reasoning và grok-4.20-0309-non-reasoning.

Thực hiện tương tự qua OpenRouter

Trên OpenRouter, hãy lưu key vào OPENROUTER_API_KEY và sử dụng các ID có tiền tố x-ai/. OpenRouter điều khiển quá trình suy nghĩ thông qua đối tượng reasoning. Đoạn mã JavaScript sau chạy trên Node.js 18 trở lên:

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);

Để kích hoạt tính năng suy nghĩ, hãy gửi reasoning: { effort: "low" } (hoặc medium, high). Thêm exclude: true nếu bạn muốn mô hình dùng tư duy suy luận nhưng không trả về các bước suy nghĩ đó. Đặt stream: true để nhận câu trả lời theo thời gian thực khi đang tạo chữ, giúp giao diện chat phản hồi nhanh hơn rõ rệt.

Gửi hình ảnh

Grok 4.20, 4.3 và 4.7 đều có khả năng đọc hình ảnh. Sử dụng định dạng tin nhắn chuẩn OpenAI với danh sách các phần nội dung. Tài liệu của xAI hỗ trợ ảnh định dạng JPEG và PNG dung lượng tối đa 20 MiB; bạn có thể dùng URL công khai hoặc data URL dạng base64.

{
  "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."}
    ]
  }]
}

Bảng giá và ID các mô hình Grok

Dưới đây là các mô hình văn bản hiện tại của SpaceXAI được liệt kê trên OpenRouter, đi kèm dung lượng ngữ cảnh và giá trên mỗi triệu token (giá niêm yết trên OpenRouter, tháng 10/2026). xAI API áp dụng mức giá cơ bản tương đương cho các prompt dưới 200.000 token.

Một số chi tiết từ trang mô hình và bảng giá của xAI (giá niêm yết của xAI, tháng 10/2026):

• Prompt dài có chi phí cao hơn. Khi prompt đạt từ 200.000 token trở lên, toàn bộ yêu cầu sẽ được tính theo biểu giá cao hơn: $4 / $12 cho Grok 4.7, $2.50 / $5 cho Grok 4.3 và 4.20.
• Đầu vào được lưu vào bộ nhớ cache rẻ hơn: $0.50 trên mỗi triệu token cho Grok 4.7 và $0.20 cho Grok 4.3 và 4.20, áp dụng cho các phần tiền tố prompt lặp lại.
• Xử lý theo lô (batch jobs) không cần gấp sẽ được giảm giá, và OpenRouter cũng niêm yết x-ai/grok-4.3:batch ở mức $1 / $2.
• Dung lượng ngữ cảnh khác nhau tùy nguồn: OpenRouter công bố 2.000.000 token cho Grok 4.20, trong khi trang mô hình chính thức của xAI ghi là 1.000.000.

Token suy nghĩ được tính là token đầu ra, vì vậy chi phí cho mỗi câu trả lời của mô hình lý luận (reasoning) có thể cao hơn so với mức giá tính trên token thông thường.

Lời khuyên hữu ích

• Nên bắt đầu với Grok 4.20 non-reasoning cho các tác vụ hội thoại, viết lại văn bản và trích xuất dữ liệu. Mô hình này xử lý nhanh và tiết kiệm chi phí. Hãy chuyển sang Grok 4.3 hoặc 4.7 khi chất lượng xử lý các bài toán phức tạp quan trọng hơn tốc độ.
• Lưu ý mốc thời gian cập nhật kiến thức. Grok 4.7 nắm được dữ liệu sự kiện đến tháng 5/2026 theo thông tin từ xAI. Với những thông tin mới hơn, hãy đưa dữ kiện trực tiếp vào prompt hoặc sử dụng công cụ tìm kiếm web và tìm kiếm trên X phía máy chủ của xAI (tính phí theo lượt gọi).
• Thiết lập system message rõ ràng về vai trò, văn phong và định dạng đầu ra mong muốn; đồng thời yêu cầu định dạng JSON kèm schema nếu mã nguồn của bạn cần phân tích cú pháp câu trả lời.
• Xử lý giới hạn tần suất (rate limits). Hãy thiết lập thử lại tự động (retry) sau một khoảng dừng ngắn khi nhận mã lỗi 429.
• Tuân thủ quy định sử dụng. Chính sách sử dụng của xAI áp dụng cho cả người dùng API, và trường safety_identifier cho phép bạn gắn thẻ yêu cầu theo từng người dùng cuối.

Xử lý sự cố thường gặp

• Lỗi 401 hoặc 403: API key bị thiếu, bị thu hồi hoặc nạp sai môi trường. In vài ký tự đầu của key trên máy chủ để kiểm tra xem biến đã nhận đúng chưa.
• Không tìm thấy mô hình (Model not found): kiểm tra lại tiền tố. OpenRouter yêu cầu x-ai/grok-4.7, trong khi xAI dùng định dạng gốc grok-4.7.
• Câu trả lời bị trống hoặc phản hồi rất chậm từ mô hình reasoning thường do mô hình đã dùng hết giới hạn token đầu ra cho việc suy nghĩ. Hãy giảm mức effort hoặc tăng max_tokens.
• Hình ảnh bị từ chối: chuyển đổi định dạng sang JPEG hoặc PNG và đảm bảo tệp không vượt quá giới hạn kích thước cho phép.

Câu hỏi thường gặp

Grok API có tương thích với OpenAI SDK không?

Có. Bạn chỉ cần trỏ SDK tới https://api.x.ai/v1 cùng key của xAI, hoặc trỏ tới OpenRouter cùng key của OpenRouter, sau đó điền đúng ID mô hình Grok.

Có bản Grok API miễn phí không?

Hiện không có gói miễn phí cố định nào được công bố. Cả xAI và OpenRouter đều tính phí theo token, nhưng các thử nghiệm ngắn thường tốn rất ít chi phí.

Tôi có thể tạo ảnh bằng Grok API không?

Có, thông qua các mô hình Grok Imagine của xAI trên một endpoint xử lý hình ảnh riêng biệt. Xem thêm tại trang Grok Imagine của chúng tôi. Giao diện chat của chúng tôi hiện không tạo hình ảnh.

Grok.Online sử dụng mô hình Grok nào?

Giao diện chat của chúng tôi cung cấp Grok 4.20 (tắt chế độ suy nghĩ), Grok 4.3 (mức suy nghĩ thấp), và Grok 4.7 với tối đa 10 tin nhắn mỗi ngày, tất cả đều thông qua OpenRouter.