Tài liệu API

Xác thực và Base URL

Bắt đầu bằng cách tạo khóa của bạn qua bảng điều khiển. Sử dụng URL cơ sở https://api.grokapipricing.com/v1 cho tất cả các yêu cầu. Đặt Authorization header để Bearer YOUR_API_KEY. Khóa đơn lẻ này hoạt động trên tất cả các điểm cuối. Xoay khóa tự do nếu cần.

POST /v1/chat/completions

Gửi lời nhắc của bạn đến điểm cuối trò chuyện. ID mô hình luôn là uncensored. Cấu hình các tham số như temperature hoặc top_p để kiểm soát độ sáng tạo. Các phản hồi trả về các phần hoàn thành trò chuyện tiêu chuẩn với siêu dữ liệu sử dụng token. Lỗi như 402 hoặc 429 cho biết vấn đề về thanh toán hoặc giới hạn tốc độ.

GET /v1/models

Kiểm tra các mô hình có sẵn bằng cách gửi yêu cầu GET đến điểm cuối models. Bạn sẽ thấy uncensored model được liệt kê. Điều này xác nhận kết nối và khả dụng của mô hình. Sử dụng điều này để gỡ lỗi cấu hình khách hàng trước khi gửi các tải trọng nặng.

Sử dụng SSE và Streaming

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. API trả về Sự kiện được gửi bởi máy chủ (SSE) để phân phối token theo thời gian thực. Thống kê sử dụng token xuất hiện trong chunk cuối cùng của luồng. Điều này giảm độ trễ cảm nhận đối với các phản hồi dài.

Function Calling và chế độ JSON

Sử dụng response_format với {"type": "json_object"} cho các đầu ra JSON nghiêm ngặt. Bật gọi hàm bằng cách định nghĩa tools trong yêu cầu của bạn. Mô hình hỗ trợ tool_choice cho việc thực thi bắt buộc hoặc tự động. Điều này đảm bảo tích hợp đáng tin cậy với logic backend của bạn.

Giới hạn tốc độ và Ràng buộc

Bạn bị giới hạn 300 yêu cầu mỗi phút cho mỗi khóa. Độ đồng thời được giới hạn ở 8 yêu cầu đồng thời. Kích thước thân yêu cầu tối đa là 8 MB. Cửa sổ ngữ cảnh cho phép tổng cộng 100.000 token. Các yêu cầu vượt quá các giới hạn này sẽ nhận lỗi 429 hoặc 400 ngay lập tức.

cURL

Copycurl https://api.grokapipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run query and return rows"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.grokapipricing.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át trực tiếp

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)