Hướng dẫn tích hợp API Grok

Tại sao nên dùng giải pháp thay thế API Grok không kiểm duyệt?

Truy cập API trực tiếp thường áp dụng các bộ lọc nội dung nghiêm ngặt chặn các chủ đề người lớn hợp pháp hoặc gây tranh cãi. Nhiều nhà cung cấp ẩn những từ chối này sâu trong cấu trúc phản hồi của họ. Một mô hình không kiểm duyệt cung cấp dữ liệu suy luận thô cho bất kỳ trường hợp sử hợp pháp nào. Bạn nhận được đầu ra đầy đủ mà không có lớp an toàn doanh nghiệp can thiệp.

Các API cấp doanh nghiệp thường thay đổi logic lọc của chúng mà không báo trước. Điều này làm gián đoạn các ứng dụng phụ thuộc vào các loại nội dung cụ thể. Một dịch vụ không kiểm duyệt chuyên dụng loại bỏ sự không chắc chắn này. Các lời nhắc của bạn trả về chính xác những gì mô hình tạo ra.

Hãy xem xét sự khác biệt giữa giao diện trò chuyện và API thô. Giao diện người dùng trò chuyện có thể ẩn các đầu ra tinh tế. API hiển thị toàn bộ luồng token. Sự minh bạch này rất quan trọng đối với các nhà phát triển đang xây dựng các công cụ chuyên biệt.

Dịch vụ của chúng tôi hoạt động độc lập. Chúng tôi không cung cấp Grok hay bất kỳ mô hình nào của nhà cung cấp khác. Chúng tôi cung cấp một mô hình ngôn ngữ lớn không kiểm duyệt riêng biệt. Nó chạy trên máy chủ của riêng chúng tôi. Giao diện vẫn quen thuộc với người dùng OpenAI.

Lợi ích chính

• Không có phí đăng ký hàng tháng.
• Thanh toán trả trước minh bạch.
• Đầu ra gốc cho nội dung người lớn hợp pháp.
• Không có từ chối ẩn cho các chủ đề gây tranh cãi.

Hiểu cấu trúc Điểm cuối API

Two endpoints handle all interactions: POST /v1/chat/completions and GET /v1/models. These follow the standard OpenAI API specification. You send a JSON payload with your system and user messages. The server returns a JSON response with the generated text.

Điểm cuối GET liệt kê các mô hình có sẵn. Nó xác nhận kết nối của bạn là hợp lệ. Sử dụng điều này để xác minh khóa API của bạn hoạt động trước khi gửi tải nặng. Nó cũng hiển thị ID mô hình bạn phải bao gồm trong các yêu cầu của mình.

URL cơ sở của chúng tôi là HTTPS://api.isgrokunfiltered.com/v1. Điều này thay thế URL OpenAI mặc định trong cấu hình máy khách của bạn. ID mô hình cần gửi là "uncensored". Điều này đảm bảo bạn kết nối đúng máy chủ.

Xác thực sử dụng token Bearer trong header Authorization. Bao gồm khóa API của bạn trực tiếp. Không cần các luồng OAuth phức tạp. Sự đơn giản này giảm đáng kể thời gian tích hợp.

Tóm tắt điểm cuối

Phương pháp	Đường dẫn	Hàm
POST	/v1/chat/completions	Tạo phản hồi văn bản
GET	/v1/models	Liệt kê các mô hình khả dụng

Cấu hình Máy khách của bạn cho Streaming

Bật chế độ phát trực tiếp bằng cách đặt tham số stream thành true trong thân yêu cầu của bạn. Điều này trả về các sự kiện gửi qua máy chủ (SSE) thay vì một đối tượng JSON đơn lẻ. Mỗi sự kiện chứa một chunk văn bản một phần của phản hồi. Bạn có thể hiển thị văn bản cho người dùng theo thời gian thực.

Streaming làm giảm độ trễ cảm nhận cho các phản hồi dài. Người dùng thấy đầu ra khi nó được tạo. Điều này cải thiện trải nghiệm cho các giao diện giống như chat. Nó cũng cho phép bạn hủy yêu cầu sớm nếu cần.

Mỗi chunk bao gồm dữ liệu sử dụng token trong sự kiện cuối cùng. Bạn có thể theo dõi chính xác số token đầu vào và đầu ra. Điều này giúp bạn giám sát số dư tín dụng trả trước của mình. Lỗi trong quá trình streaming vẫn sẽ tiêu tốn token cho dữ liệu đã xử lý.

Xử lý định dạng SSE đúng cách. Phân tích cú pháp mỗi dòng bắt đầu bằng "data: ". Bỏ qua sự kiện "[DONE]" cuối cùng. Điều này đảm bảo ứng dụng của bạn xử lý mọi token một cách chính xác.

Copyfrom openai import OpenAI

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

Xử lý Gọi Hàm trong Chế độ Không kiểm duyệt

Gọi hàm cho phép ứng dụng của bạn thực thi mã dựa trên đầu ra của mô hình. Gửi một danh sách các công cụ trong yêu cầu. Mô hình trả về một mảng tool_calls thay vì văn bản thuần túy. Mã của bạn thực thi hàm và gửi kết quả trở lại.

Điều này hoạt động liền mạch với mô hình không kiểm duyệt của chúng tôi. Mô hình không từ chối gọi hàm dựa trên loại nội dung. Nó tập trung vào cấu trúc logic của yêu cầu. Điều này rất lý tưởng cho các nhiệm vụ trích xuất dữ liệu phức tạp.

Sử dụng chế độ JSON để thực thi các định dạng đầu ra nghiêm ngặt. Đặt response_format thành json_object. Mô hình chỉ trả về JSON hợp lệ. Điều này làm giảm lỗi phân tích cú pháp trong backend của bạn. Nó đảm bảo các cấu trúc dữ liệu nhất quán.

Kết hợp gọi hàm với streaming cho các tương tác động. Bạn có thể bắt đầu thực thi các hàm trong khi mô hình vẫn đang tạo dữ liệu. Điều này tạo ra một ứng dụng phản hồi nhanh. Mô hình không kiểm duyệt xử lý các định nghĩa công cụ đa dạng mà không có sự thiên vị.

Copyimport OpenAI from "openai";

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

Tối ưu hóa Chi phí Token cho Ngữ cảnh Dài

Cửa sổ ngữ cảnh hỗ trợ tối đa 100.000 token. Điều này bao gồm cả prompt và completion. Ngữ cảnh dài hơn tiêu tốn nhiều số dư trả trước hơn. Hãy theo dõi việc sử dụng token để tránh các khoản phí không mong muốn.

Token đầu vào có giá $0.15 cho mỗi triệu token. Token đầu ra có giá $0.50 cho mỗi triệu token. Token đầu ra đắt hơn đáng kể. Hãy tối ưu hóa lời nhắc của bạn để giảm kích thước đầu vào. Sử dụng hướng dẫn hệ thống ngắn gọn. Tránh gửi lịch sử không cần thiết.

Đặt tham số max_tokens để kiểm soát độ dài đầu ra. Giá trị mặc định là 2,048 token. Bạn có thể tăng giá trị này lên đến 16,000 token mỗi yêu cầu. Điều này ngăn chặn việc tạo dữ liệu chạy không kiểm soát làm cạn kiệt tín dụng nhanh chóng.

Lỗi và từ chối đều miễn phí. Bạn chỉ trả tiền cho việc tạo token thành công. Điều này bảo vệ bạn khỏi lãng phí chi tiêu cho các yêu cầu thất bại. Theo dõi số dư của bạn thường xuyên để luôn cập nhật.

Chi tiết bảng giá

• Đầu vào: $0.15 / 1M token
• Xuất: $0.50 / 1M token
• Đầu ra tối đa: 16.000 token
• Cửa sổ ngữ cảnh: 100.000 token

Giới hạn tốc độ và Cài đặt độ đồng thời

Mỗi khóa API cho phép 300 yêu cầu mỗi phút. Giới hạn này áp dụng trên toàn bộ khóa của bạn. Các ứng dụng tần suất cao cần quản lý tốc độ yêu cầu của mình một cách cẩn thận. Vượt quá giới hạn sẽ trả về lỗi 429 Quá nhiều yêu cầu.

Bạn có thể có tối đa 8 yêu cầu đồng thời mỗi khóa. Điều này cho phép xử lý song song các nhiệm vụ độc lập. Quản lý độ đồng thời để tránh vượt quá giới hạn tốc độ. Phân phối các yêu cầu qua các khoảng thời gian.

Kích thước thân yêu cầu tối đa là 8 MB. Các tải trọng lớn với lịch sử rộng rãi có thể vượt quá điều này. Nén đầu vào của bạn hoặc cắt ngắn các tin nhắn cũ. Điều này đảm bảo các yêu cầu của bạn được xử lý thành công.

Bạn chỉ có thể có một khóa hoạt động cho mỗi tài khoản. Nếu bạn mất khóa, hãy tạo khóa mới. Khóa cũ sẽ không còn hiệu lực ngay lập tức. Điều này giúp đơn giản hóa quản lý bảo mật. Xoay khóa định kỳ để tăng cường an toàn.

Copycurl https://api.isgrokunfiltered.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of five unique Python script ideas."}]
  }'

Di chuyển Khóa API Grok Hiện có của bạn

Việc di chuyển sang API của chúng tôi yêu cầu thay đổi base URL và model ID. Cấu trúc mã client hiện có của bạn hầu như giữ nguyên. Cập nhật base URL thành HTTPS://api.isgrokunfiltered.com/v1. Thay đổi model ID thành "uncensored".

Khắc phục Các Lỗi Tích Hợp Phổ Biến

Lỗi 401 Unauthorized cho thấy khóa API không hợp lệ hoặc đã hết hạn. Xác minh khóa của bạn trong bảng điều khiển. Đảm bảo bạn đang gửi nó trong tiêu đề Authorization. Kiểm tra khoảng trắng đầu dòng hoặc lỗi chính tả.

429 Quá nhiều yêu cầu có nghĩa là bạn đã vượt quá giới hạn tốc độ. Giảm tần suất yêu cầu hoặc tăng khoảng thời gian giữa các lần gọi. Sử dụng cơ chế backoff theo cấp số nhân để thử lại. Điều này ngăn chặn làm quá tải máy chủ.

400 Bad Request thường bắt nguồn từ JSON không hợp lệ. Đảm bảo payload của bạn khớp với schema mong đợi. Kiểm tra các trường bắt buộc bị thiếu như messages hoặc model. Sử dụng endpoint GET để xác minh khả dụng của model.

Lỗi máy chủ nội bộ 500 hiếm khi xảy ra nhưng vẫn có thể. Hãy thử lại yêu cầu sau một khoảng thời gian ngắn. Nếu sự cố vẫn tiếp diễn, hãy liên hệ hỗ trợ. Nhật ký của chúng tôi có thể giúp xác định nguyên nhân gốc rễ nhanh chóng.

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)

Các bước tiếp theo: Kiểm tra Mô hình Uncensored của Bạn

Bắt đầu với một yêu cầu tạo văn bản đơn giản. Gửi một prompt ngắn và xác minh định dạng phản hồi. Kiểm tra xem phát trực tiếp có hoạt động chính xác không. Đảm bảo gọi hàm tích hợp mượt mà với mã của bạn.

Theo dõi việc sử dụng token của bạn cẩn thận. Mô hình trả trước chỉ tính phí cho các token thực tế. Lỗi là miễn phí. Điều này cho phép thử nghiệm an toàn. Nạp thêm tín dụng của bạn bằng tiền điện tử khi cần.

Kiểm tra các trường hợp biên như ngữ cảnh dài và các định nghĩa công cụ phức tạp. Xác minh rằng mô hình không kiểm duyệt xử lý các chủ đề đa dạng. Đảm bảo ứng dụng của bạn xử lý các phản hồi một cách chính xác. Điều này chuẩn bị cho bạn cho việc sử dụng sản xuất.

Đăng ký bằng Google hoặc email. Nhận khóa API của bạn ngay lập tức. Không cần số điện thoại. Bắt đầu kiểm tra ngay lập tức với $0.50 tín dụng dùng thử. Điều này cung cấp cho bạn một cách đánh giá dịch vụ không rủi ro.