Hướng dẫn sử dụng API Grok từ A-z

Để sử dụng API của Grok do xAI cung cấp, bạn cần thực hiện các bước sau đây. Lưu ý rằng thông tin này dựa trên các tài liệu và hướng dẫn mới nhất, nhưng bạn nên kiểm tra trang chính thức của xAI để cập nhật thông tin chi tiết:

1. Đăng ký tài khoản và truy cập xAI Developer Portal#

• Truy cập trang web xAI: Vào trang xAI API hoặc cổng dành cho nhà phát triển của xAI (thường được gọi là xAI Developer Portal).

• Tạo tài khoản: Nếu chưa có tài khoản, đăng ký bằng email hoặc liên kết với tài khoản Google/X (Twitter). Nếu đã có, đăng nhập vào hệ thống.

• Chọn gói dịch vụ: xAI cung cấp các gói API với các mức truy cập khác nhau. Bạn có thể bắt đầu với gói miễn phí (nếu có) hoặc chọn gói trả phí tùy theo nhu cầu. Hiện tại, API Grok 3 đã được triển khai, nhưng API Grok 2 cũng có thể được sử dụng trong một số trường hợp.

2. Lấy khóa API#

• Sau khi đăng nhập vào Developer Portal, điều hướng đến phần API Keys hoặc Quản lý API.

• Tạo một khóa API mới (Access Key và Secret Key). Sao chép và lưu trữ khóa này an toàn, vì nó sẽ được sử dụng để xác thực các yêu cầu API.

• Lưu ý bảo mật: Không chia sẻ khóa API công khai hoặc nhúng trực tiếp vào mã nguồn. Lưu trữ khóa trong biến môi trường (ví dụ: XAI_API_KEY) để tăng cường bảo mật.

3. Cài đặt môi trường phát triển#

• Sử dụng SDK Python (khuyến nghị): xAI cung cấp Grok Python SDK để đơn giản hóa việc tích hợp API. Cài đặt SDK bằng lệnh: pip install xai-sdk

• Thiết lập biến môi trường: export XAI_API_KEY="your_api_key_here" Thay your_api_key_here bằng khóa API bạn vừa tạo.

• Công cụ thay thế: Bạn cũng có thể sử dụng các công cụ như Apidog hoặc Postman để gửi yêu cầu API trực tiếp nếu không muốn dùng SDK.

4. Gửi yêu cầu API#

• Cấu trúc yêu cầu cơ bản: API của xAI sử dụng REST và giao tiếp qua JSON. URL cơ bản thường là: https://api.grok.xai.com/v1

• Ví dụ yêu cầu bằng cURL: curl https://api.grok.xai.com/v1/completions \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "grok-3", "prompt": "Xin chào, Grok!", "max_tokens": 50 }' Thay YOUR_API_KEY bằng khóa API của bạn.

• Ví dụ bằng Python SDK: import xai_sdk client = xai_sdk.Client() response = client.sampler.sample( prompt="Xin chào, Grok! Hãy giới thiệu về bạn.", temperature=0.7, max_tokens=100 ) print(response) Đoạn code này gửi một yêu cầu để Grok trả lời với văn bản.

5. Tùy chỉnh và kiểm tra#

• Các tham số tùy chỉnh: model: Chọn mô hình, ví dụ grok-3 hoặc grok-3-mini. prompt: Câu lệnh hoặc câu hỏi bạn muốn Grok xử lý.

  • max_tokens: Số lượng token tối đa trong phản hồi.

  • temperature: Điều chỉnh mức độ sáng tạo của phản hồi (0.0: chính xác, 1.0: sáng tạo hơn).

• Kiểm tra với Apidog: Nếu dùng Apidog, bạn có thể tạo yêu cầu mới, nhập URL API, thêm khóa API vào header, và kiểm tra phản hồi. Apidog cũng hỗ trợ lưu tài liệu API để dễ dàng quản lý.

• Theo dõi sử dụng: API Grok có thể tính phí dựa trên số token sử dụng. Kiểm tra trường usage trong phản hồi để quản lý chi phí.

6. Sử dụng miễn phí qua OpenRouter (tùy chọn)#

• Nếu bạn muốn thử nghiệm API Grok 3 mà không cần đăng ký trực tiếp với xAI, bạn có thể sử dụng OpenRouter, một nền tảng API thống nhất hỗ trợ truy cập Grok 3 và Grok 3 Mini.

• Các bước: Đăng ký tài khoản trên OpenRouter. Yêu cầu tín dụng miễn phí (OpenRouter cung cấp tín dụng miễn phí cho người dùng mới).

  • Tạo khóa API trên OpenRouter và sử dụng nó để gửi yêu cầu tới mô hình Grok 3.

  • Tích hợp với các công cụ như Cursor, Cline, hoặc Apidog để thử nghiệm.

• Lưu ý: Tín dụng miễn phí có giới hạn, và bạn cần kiểm tra chi phí nếu sử dụng lâu dài.

7. Một số lưu ý quan trọng#

• Grok 3.5 không tồn tại: Hiện tại, chỉ có Grok 3 và Grok 3 Mini. Bỏ qua các nguồn thông tin đề cập đến Grok 3.5 vì chúng không chính xác.guidelines

• Hạn chế của gói miễn phí: Gói miễn phí trên grok.com hoặc OpenRouter có giới hạn (ví dụ: 10 câu hỏi mỗi 2 giờ). Để sử dụng không giới hạn, bạn cần gói SuperGrok hoặc X Premium+.

• Tính năng hiện tại: API Grok 3 chủ yếu hỗ trợ xử lý văn bản. Các tính năng như xử lý hình ảnh hoặc giọng nói đang được phát triển và sẽ ra mắt trong tương lai.

• Kiểm tra tài liệu chính thức: Luôn tham khảo tài liệu API tại xAI API Docs để có thông tin cập nhật về các endpoint, mô hình, và giá cả.

8. Xử lý lỗi thường gặp#

• Lỗi 401 (Authentication Error): Kiểm tra xem khóa API có đúng và được cấu hình chính xác trong biến môi trường hoặc header.

• Lỗi vượt giới hạn: Nếu bạn vượt quá giới hạn token hoặc số yêu cầu, nâng cấp gói dịch vụ hoặc tối ưu hóa yêu cầu bằng cách giảm max_tokens.

9. Thông tin giá cả#

• xAI không công khai chi tiết giá API trên trang chủ, nhưng giá thường được tính dựa trên số token (ví dụ: $2/1M token đầu vào cho một số mô hình). Để biết giá chính xác, kiểm tra tại xAI API hoặc liên hệ hỗ trợ xAI.

• Nếu sử dụng qua OpenRouter, bạn có thể tận dụng tín dụng miễn phí ban đầu, nhưng sau đó chi phí sẽ phụ thuộc vào mô hình và số token sử dụng.

10. Tài liệu tham khảo#

• Trang chính thức xAI API: x.ai/api

• Hướng dẫn sử dụng Grok 3 API với Apidog: apidog.com

• OpenRouter để truy cập miễn phí: openrouter.ai

Nếu bạn cần hướng dẫn chi tiết hơn về một bước cụ thể hoặc ví dụ mã nguồn, hãy cho tôi biết!

---

---

API của Grok do xAI cung cấp không hoàn toàn miễn phí, nhưng có một số chương trình và tùy chọn cho phép bạn sử dụng miễn phí trong giới hạn nhất định, đặc biệt trong giai đoạn beta hoặc với các chương trình khuyến mãi. Dưới đây là thông tin chi tiết dựa trên dữ liệu mới nhất tính đến tháng 6/2025:

1. Giai đoạn Public Beta (Đã kết thúc vào cuối 2024)#

• Trong giai đoạn public beta (từ tháng 11 đến cuối tháng 12/2024), xAI cung cấp $25 tín dụng miễn phí mỗi tháng cho tất cả người dùng đăng ký trên console.x.ai.

• Những người đã mua tín dụng trả trước cũng nhận được thêm tín dụng miễn phí tương ứng trong thời gian này. Ví dụ: nếu bạn mua $50 tín dụng, bạn nhận thêm $25 tín dụng miễn phí mỗi tháng trong tháng 11 và 12/2024.

• Tình trạng hiện tại: Chương trình beta này đã kết thúc vào cuối năm 2024, nên tín dụng miễn phí $25/tháng không còn áp dụng từ tháng 1/2025.

2. Chương trình Data-Sharing (Kết thúc vào tháng 5/2025)#

• xAI từng có một chương trình cho phép người dùng nhận $150 tín dụng miễn phí mỗi tháng nếu đồng ý chia sẻ dữ liệu yêu cầu và phản hồi API với xAI để cải thiện mô hình. Tuy nhiên, chương trình này đã bị hủy bỏ vào tháng 5/2025.

• Để tham gia chương trình này trước khi nó kết thúc, bạn cần nạp tối thiểu $5 vào tài khoản.

3. Live Search API Beta (Miễn phí đến 5/6/2025)#

• xAI đang cung cấp Live Search API (cho phép truy cập dữ liệu thời gian thực từ X, tin tức, và RSS feeds) hoàn toàn miễn phí trong giai đoạn beta, kéo dài đến ngày 5/6/2025.

• Điều kiện: Bạn cần đăng ký tài khoản trên console.x.ai và tạo một khóa API riêng cho Live Search. Khi sử dụng, bạn phải đồng ý chia sẻ dữ liệu yêu cầu với xAI để giúp họ tinh chỉnh dịch vụ.

• Đây là cơ hội tốt để thử nghiệm API miễn phí, đặc biệt nếu bạn đang phát triển ứng dụng cần dữ liệu thời gian thực.

4. Tùy chọn miễn phí qua bên thứ ba#

• OpenRouter: Bạn có thể truy cập API Grok 3 miễn phí thông qua OpenRouter, một nền tảng cung cấp tín dụng miễn phí cho người dùng mới (thường là $5, đủ để xử lý khoảng 625,000 token). Cách thực hiện: Đăng ký tài khoản trên openrouter.ai, yêu cầu tín dụng miễn phí, và sử dụng khóa API của OpenRouter để truy cập Grok 3. Lưu ý: Tín dụng miễn phí có giới hạn, và sau khi hết, bạn cần trả phí theo giá của OpenRouter.

• laozhang.ai: Đây là một dịch vụ proxy cung cấp truy cập API Grok 3 với $5 tín dụng miễn phí khi đăng ký, không yêu cầu X Premium. Dịch vụ này được đánh giá là hợp pháp và cho phép sử dụng thương mại. Cách thực hiện: Truy cập laozhang.ai, tạo tài khoản, và sử dụng tín dụng miễn phí để thử nghiệm.

5. Gói miễn phí trên grok.com hoặc X#

• Truy cập Grok (không qua API) trên grok.com hoặc X là miễn phí với giới hạn sử dụng (khoảng 10 câu hỏi mỗi 2 giờ). Tuy nhiên, đây không phải là API mà chỉ là giao diện trò chuyện. Để sử dụng API, bạn cần khóa API và thường phải trả phí sau khi hết tín dụng miễn phí.

• Nếu bạn có X Premium+ ($16/tháng) hoặc SuperGrok ($50/tháng), bạn sẽ có giới hạn sử dụng API cao hơn, nhưng vẫn không hoàn toàn miễn phí.

6. Chi phí API nếu không miễn phí#

• Nếu không có tín dụng miễn phí, chi phí API Grok được tính dựa trên số token: Grok 3: $3-$5 cho 1 triệu token đầu vào, $15-$25 cho 1 triệu token đầu ra. Grok 3 Mini: $0.30-$0.60 cho 1 triệu token đầu vào, $0.50-$4 cho 1 triệu token đầu ra.

• So sánh với các đối thủ: OpenAI: $2.50 (đầu vào), $10 (đầu ra) cho GPT-4o. Anthropic: $3 (đầu vào), $15 (đầu ra) cho Claude 3.7 Sonnet.

• Để biết giá chính xác, kiểm tra tại xAI API Docs.

7. Lưu ý#

• Grok 3.5 không tồn tại: Bất kỳ thông tin nào về Grok 3.5 đều không chính xác. Hiện tại, chỉ có Grok 3 và Grok 3 Mini.

• Hạn chế khu vực: Một số dịch vụ có thể bị giới hạn ở một số quốc gia, nhưng laozhang.ai hoặc OpenRouter thường không có giới hạn khu vực nghiêm ngặt.

• Bảo mật khóa API: Luôn lưu trữ khóa API trong biến môi trường (ví dụ: XAI_API_KEY) để tránh rò rỉ.

Kết luận#

• Hiện tại (tháng 6/2025), bạn có thể sử dụng Live Search API miễn phí đến 5/6/2025 bằng cách đăng ký trên console.x.ai và đồng ý chia sẻ dữ liệu.

• Ngoài ra, bạn có thể thử nghiệm miễn phí với OpenRouter hoặc laozhang.ai thông qua tín dụng miễn phí khi đăng ký.

• Sau khi hết tín dụng miễn phí hoặc giai đoạn beta, bạn sẽ phải trả phí theo số token sử dụng. Để biết thêm chi tiết về giá, truy cập x.ai/api.