Hướng dẫn nhanh cho người dùng Grok

URL cơ sở và Xác thực

API của chúng tôi tương thích hoàn toàn với các SDK của OpenAI. Bạn chỉ cần cập nhật base_url và cung cấp khóa của bạn trong tiêu đề Authorization. Đăng ký qua Google hoặc email để nhận khóa của bạn ngay lập tức. Không cần số điện thoại hoặc thẻ tín dụng để bắt đầu. Sử dụng ID mô hình uncensored cho tất cả các yêu cầu.

Xác thực được xử lý thông qua token Bearer. Đảm bảo khóa của bạn được gửi trong tiêu đề của mọi yêu cầu. Nếu bạn nhận được lỗi 401, khóa của bạn không hợp lệ hoặc đã hết hạn. Dịch vụ của chúng tôi là độc lập và không bán lại các mô hình của các nhà cung cấp khác.

Hoàn thành Hội thoại Cơ bản

Gửi yêu cầu POST tiêu chuẩn đến /v1/chat/completions. API chấp nhận đầu vào văn bản và trả về đầu ra văn bản. Bạn có thể xác định các prompt hệ thống để hướng dẫn hành vi của mô hình. Mô hình phản hồi mà không từ chối đối với nội dung người lớn hợp pháp, tiểu thuyết hoặc các chủ đề gây tranh cãi.

Chỉ định mô hình là uncensored trong tải trọng của bạn. Cửa sổ ngữ cảnh hỗ trợ tối đa 100.000 token tổng cộng. Đầu ra tối đa là 32.000 token mỗi yêu cầu. Lỗi và từ chối không tiêu thụ tín dụng.

Phản hồi Truyền phát

Bật truyền phát bằng cách đặt stream: true. API trả về các Sự kiện được Gửi bởi Máy chủ (SSE). Mỗi chunk chứa các bản cập nhật văn bản tăng dần. Chunk cuối cùng bao gồm thống kê sử dụng token để minh bạch hóa việc tính phí.

Truyền phát rất lý tưởng để cập nhật giao diện người dùng theo thời gian thực. Phân tích luồng SSE để hiển thị văn bản khi nó được tạo. Điều này giảm độ trễ cảm nhận đối với người dùng. API xử lý giao thức truyền phát một cách tự động.

Gọi Hàm

Xác định các công cụ trong tham số tools. Mô hình có thể trả về các lệnh gọi công cụ có cấu trúc. Sử dụng tool_choice để buộc các hành vi cụ thể. Điều này cho phép tích hợp với các hệ thống và quy trình làm việc bên ngoài.

Gọi hàm hoạt động với định dạng OpenAI tiêu chuẩn. Phân tích phản hồi để thực hiện các công cụ được yêu cầu. Mô hình duy trì ngữ cảnh qua các lệnh gọi hàm. Điều này hữu ích cho các tác nhân tự động và các nhiệm vụ trích xuất dữ liệu.

Chế độ JSON

Đặt response_format thành {"type": "json_object"} để có đầu ra JSON nghiêm ngặt. Mô hình sẽ định dạng phản hồi của nó dưới dạng JSON hợp lệ. Điều này hữu ích để phân tích dữ liệu có cấu trúc trong các ứng dụng.

Chế độ JSON đảm bảo định dạng nhất quán. Hãy dùng khi mã của bạn cần cấu trúc schema cụ thể. Mô hình tuân thủ đúng định dạng yêu cầu. Điều này giảm nhu cầu thêm logic phân tích cú pháp.

Tham số, Giới hạn và Lỗi

Kiểm soát quá trình tạo với temperature, top_p và các chuỗi stop. Giới hạn tốc độ là 300 yêu cầu mỗi phút mỗi khóa. Bạn có thể có tối đa 8 yêu cầu đồng thời. Thân yêu cầu không được vượt quá 8 MB. Lỗi 402 cho biết tín dụng không đủ. Lỗi 429 có nghĩa là bạn đã đạt đến giới hạn tốc độ. Tín dụng là tín dụng trả trước và không bao giờ hết hạn. Lỗi là miễn phí.

cURL

Copycurl https://api.grokuncensored.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.grokuncensored.cc/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)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.grokuncensored.cc/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);

Truyền phát

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)