Tài liệu Grok ai api

Xác thực & Base URL

Bắt đầu bằng cách tạo khóa API của bạn qua bảng điều khiển hoặc tiếp tục với Google.

Điểm máy khách của bạn tại https://api.grokaiapi.com/v1 và chuyển khóa trong Authorization header. URL cơ sở này hoạt động với bất kỳ SDK tương thích OpenAI nào, cho phép bạn thay thế mô hình không kiểm duyệt của chúng tôi mà không cần viết lại logic tích hợp của mình.

Điểm cuối /v1/chat/completions

Gửi các yêu cầu POST đến /v1/chat/completions để nhận phản hồi văn bản ngay lập tức.

API của chúng tôi tuân thủ các thông số kỹ thuật tiêu chuẩn của OpenAI, vì vậy bạn có thể tích hợp nó nhanh chóng vào hệ thống hiện có của mình. ID mô hình đơn giản là uncensored, đảm bảo bạn có quyền truy cập trực tiếp vào mô hình không giới hạn của chúng tôi mà không có bộ định tuyến proxy.

Copycurl https://api.grokaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current version of the model?"}]
  }'

Tích hợp SDK Python

Sử dụng SDK Python chính thức để xử lý các yêu cầu với ít mã nhất.

Cấu hình URL cơ sở và khóa API, sau đó gọi điểm cuối hoàn thành trò chuyện. Cách tiếp cận này giữ mã của bạn sạch sẽ và cho phép bạn tập trung vào việc xây dựng các tính năng ứng dụng của mình thay vì quản lý các kết nối HTTP theo cách thủ công.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.grokaiapi.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Thiết lập SDK Node

Triển khai tích hợp trong Node.js bằng cách đặt các biến môi trường đúng cách.

SDK tự động xử lý vòng đời yêu cầu, giúp dễ dàng thêm LLM không kiểm duyệt của chúng tôi vào các dịch vụ backend của bạn. Bạn có thể quản lý lịch sử hội thoại và cửa sổ ngữ cảnh trực tiếp thông qua các cấu trúc mảng tiêu chuẩn.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.grokaiapi.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Phản hồi luồng & Đếm token

Bật phát trực tiếp bằng cách đặt stream: true trong thân yêu cầu của bạn.

Nhận kết xuất token thời gian thực qua Server-Sent Events. Chunk cuối chứa tổng mức sử dụng token, cho phép bạn theo dõi chi phí chính xác mà không cần thêm lệnh gọi API. Tính năng này rất quan trọng để xây dựng các giao diện trò chuyện phản hồi nhanh, mang lại cảm giác tức thì.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Giới hạn, Lỗi và Ngữ cảnh

API của chúng tôi hỗ trợ cửa sổ ngữ cảnh 100.000 token cho các cuộc trò chuyện kéo dài.

Xử lý các lỗi như 401 cho khóa không hợp lệ, 402 cho tín dụng không đủ và 429 cho giới hạn tốc độ. Bạn được giới hạn ở 300 yêu cầu mỗi phút và 8 yêu cầu đồng thời mỗi khóa. Giữ kích thước thân yêu cầu của bạn dưới 8 MB để đảm bảo hiệu suất trơn tru.