URL cơ sở và Xác thực
API của chúng tôi tuân theo tiêu chuẩn Chat Completions của OpenAI. Để tương tác với dịch vụ, bạn phải chỉ định client của mình đến https://api.grokapikey.com/v1 và bao gồm khóa API duy nhất của bạn trong tiêu đề Authorization. Bạn có thể tạo khóa này ngay lập tức sau khi đăng ký chỉ với email và mật khẩu. Khóa được hiển thị một lần khi tạo, vì vậy hãy lưu trữ nó một cách an toàn. Nếu bạn làm mất nó, bạn có thể tạo lại một khóa mới từ bảng điều khiển của mình, khóa cũ sẽ bị thu hồi ngay lập tức. Không cần liên kết thẻ tín dụng cho tài khoản dùng thử.
Yêu cầu đầu tiên của bạn
Bắt đầu bằng cách gửi một prompt văn bản đơn giản để xác minh kết nối. Sử dụng endpoint chuẩn chat/completions với định danh mô hình uncensored. Ví dụ sau đây minh họa lệnh curl cơ bản để kiểm tra kết nối. Điều này xác nhận xác thực của bạn là chính xác và dịch vụ đang phản hồi. Sau đó, bạn có thể điều chỉnh cấu trúc này cho logic ứng dụng cụ thể của mình.
Thay thế YOUR_API_KEY bằng khóa thực tế của bạn trước khi chạy lệnh này.
curl https://api.grokapikey.com/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."}]
}'Tích hợp SDK Python
Nếu bạn đang xây dựng ứng dụng Python, hãy sử dụng thư viện chính thức openai. Định cấu hình máy khách để sử dụng URL cơ sở của chúng tôi và khóa API của bạn. Điều này cho phép bạn tận dụng các mẫu Python quen thuộc trong khi truy cập mô hình không kiểm duyệt. Máy khách xử lý tuần tự hóa và truyền phát tự động. Đảm bảo môi trường của bạn có phiên bản mới nhất của thư viện được cài đặt để tương thích tốt nhất với các endpoint của chúng tôi.
from openai import OpenAI
client = OpenAI(base_url="https://api.grokapikey.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)Tích hợp SDK Node.js
Đối với các dự án JavaScript hoặc TypeScript, SDK OpenAI cho Node.js hoạt động ngay lập tức. Đặt các thuộc tính apiKey và baseURL trong đối tượng cấu hình của bạn. Điều này đảm bảo rằng tất cả các yêu cầu tiếp theo sẽ được định tuyến qua cơ sở hạ tầng của chúng tôi. Bạn có thể sử dụng các mẫu async/await tiêu chuẩn để xử lý phản hồi. Cách tiếp cận này rất lý tưởng cho các ứng dụng phía máy chủ hoặc các hàm biên (edge functions) yêu cầu truy cập API trực tiếp mà không cần chuyển tiếp thông qua OpenAI.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.grokapikey.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 truyền phát (Streaming)
Đối với các ứng dụng hưởng lợi từ việc tạo token theo thời gian thực, hãy bật truyền phát bằng cách đặt stream: true trong thân yêu cầu của bạn. API trả về luồng Sự kiện gửi bởi máy chủ (SSE) của các phản hồi từng phần. Điều này giảm độ trễ cảm nhận đối với người dùng và cho phép hiển thị ngay lập tức văn bản được tạo. Mỗi chunk chứa một phần delta của phản hồi. Xử lý các sự kiện này trong mã phía client của bạn để cập nhật giao diện người dùng theo từng bước. Truyền phát sử dụng token bình thường và không ảnh hưởng đến giá.
stream = 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
Mỗi khóa API bị giới hạn ở 300 yêu cầu mỗi phút và kích thước thân yêu cầu tối đa là 8 MB. Nếu bạn vượt quá giới hạn tốc độ, API sẽ trả về mã trạng thái 429; hãy đợi vài giây và thử lại. Lỗi 401 cho biết khóa không hợp lệ hoặc đã bị thu hồi, trong khi lỗi 402 có nghĩa là tín dụng trả trước của bạn đã hết. Mô hình hỗ trợ cửa sổ ngữ cảnh 100.000 token cho cả đầu vào và đầu ra kết hợp. Đảm bảo prompt của bạn nằm trong giới hạn này để tránh bị cắt ngắn. Bộ lọc nội dung vẫn rất tối thiểu, ngoại trừ việc chặn cứng đối với nội dung tình dục liên quan đến trẻ vị thành niên.
