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

Xác thực & URL cơ sở

API của chúng tôi triển khai giao thức tương thích openai. Bạn xác thực bằng cách truyền khóa API duy nhất trong tiêu đề Authorization. URL gốc cho mọi yêu cầu là https://api.groknsfw.cc/v1. Khác với các nhà cung cấp tiêu chuẩn, chúng tôi không yêu cầu ID tổ chức cụ thể. Chỉ cần tạo khóa qua bảng điều khiển hoặc trang đăng ký nhanh. Giữ khóa của bạn an toàn; nó cung cấp quyền truy cập đầy đủ vào tín dụng trả trước của bạn. Không có phí hàng tháng hoặc đăng ký, chỉ có giá theo token không hết hạn.

Mọi yêu cầu đều phải bao gồm định danh mô hình uncensored. Mô hình này là mô hình ngôn ngữ lớn trọng số mở được lưu trữ trên cơ sở hạ tầng của chúng tôi, khác biệt với các nhà cung cấp khác. Nó được tinh chỉnh để cung cấp phản hồi không kiểm duyệt cho nội dung người lớn hợp pháp trong khi vẫn duy trì độ chính xác cao về mặt thực tế. Bạn không cần thay đổi phiên bản thư viện khách hàng; các SDK OpenAI tiêu chuẩn hoạt động ngay lập tức.

Hoàn thành trò chuyện cơ bản

Gửi một yêu cầu hoàn thành trò chuyện tiêu chuẩn để tạo văn bản. Endpoint chấp nhận một danh sách các tin nhắn, bao gồm các vai trò hệ thống, người dùng và trợ lý. Cấu trúc này cho phép bạn xác định ngữ cảnh, hướng dẫn và lịch sử hội thoại. Mô hình trả về phản hồi văn bản dựa trên prompt được cung cấp. Bạn có thể kiểm soát độ sáng tạo của đầu ra bằng các tham số như temperature và top_p. Nếu không chỉ định max_tokens, giới hạn đầu ra mặc định là 2,048 token. Bạn có thể tăng giới hạn này lên tới 32,000 token mỗi yêu cầu, trong cửa sổ ngữ cảnh tổng cộng 100,000 token.

Lỗi được trả về ở định dạng JSON tiêu chuẩn. Các vấn đề phổ biến bao gồm khóa không hợp lệ hoặc không đủ tín dụng. API không xử lý phân đoạn token cho bạn; bạn gửi văn bản và mô hình xử lý nó ở nội bộ. Bạn nhận được văn bản được tạo cuối cùng hoặc các luồng một phần nếu được bật.

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

Gọi hàm & Công cụ

API hỗ trợ gọi hàm, cho phép mô hình xuất dữ liệu có cấu trúc thay vì văn bản thuần túy. Xác định các công cụ của bạn trong tham số tools, chỉ định tên hàm, mô tả và lược đồ tham số. Khi mô hình xác định cần gọi công cụ, nó trả về tên hàm và đối số ở định dạng JSON. Ứng dụng của bạn sau đó thực thi hàm và đưa kết quả trở lại hội thoại. Điều này cho phép các quy trình làm việc phức tạp, trích xuất dữ liệu và các hành động tự động. Đặt tool_choice để kiểm soát xem mô hình có bắt buộc sử dụng công cụ hay có thể tự do chọn.

Chế độ JSON

Đối với các ứng dụng yêu cầu định dạng đầu ra nghiêm ngặt, hãy sử dụng chế độ JSON. Đặt tham số response_format thành {"type": "json_object"}. Mô hình sẽ hạn chế đầu ra của nó thành JSON hợp lệ. Điều này lý tưởng để phân tích dữ liệu vào các hệ thống backend của bạn hoặc tạo cấu hình có cấu trúc. Lưu ý rằng chế độ JSON có thể giảm nhẹ độ linh hoạt trong suy luận của mô hình so với văn bản tự do. Đảm bảo prompt của bạn hướng dẫn rõ ràng mô hình chỉ xuất JSON. Tính năng này hoạt động cùng với gọi hàm nhưng cung cấp giao diện đơn giản hơn khi bạn chỉ cần dữ liệu có cấu trúc mà không cần định nghĩa công cụ.

Sử dụng token & Giới hạn

Tài khoản của bạn bị 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. Kích thước thân yêu cầu tối đa là 8 MB. Nếu bạn vượt quá các giới hạn này, API trả về mã trạng thái 429. Lỗi xác thực trả về 401 và không đủ tín dụng trả về 402. Giá là $0,25 cho mỗi triệu token đầu vào và $1,00 cho mỗi triệu token đầu ra. Lỗi và từ chối không tiêu thụ tín dụng. Cửa sổ ngữ cảnh là 100,000 token tổng cộng, bao gồm cả prompt và kết quả. Quản lý việc sử dụng token của bạn cẩn thận để tránh chi phí không mong muốn. Tín dụng không bao giờ hết hạn và bạn có thể nạp tiền bất cứ lúc nào bằng tiền điện tử.

cURL

Copycurl https://api.groknsfw.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.groknsfw.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.groknsfw.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)