AI Gateway: Chuyển đổi client của bạn chỉ với ba dòng mã
Kết nối client SDK OpenAI hiện có của bạn với endpoint không kiểm duyệt của chúng tôi bằng cách cập nhật hai biến. Hướng dẫn nhanh này sẽ hướng dẫn bạn qua xác thực, yêu cầu tiêu chuẩn, truyền phát và sử dụng công cụ.
Yêu cầu tiên quyết: Cài đặt SDK bạn thích
Trước khi gửi yêu cầu, hãy đảm bảo môi trường phát triển của bạn đã cài đặt SDK phù hợp. Vì endpoint của chúng tôi tuân theo tiêu chuẩn API tương thích OpenAI, bạn có thể sử dụng thư viện chính thức hoặc bất kỳ client tương thích nào. Đối với Python, chạy pip install openai. Đối với Node.js, sử dụng npm install openai. Không cần tệp cấu hình bổ sung ngoài các biến môi trường bạn sẽ đặt ở bước tiếp theo.
Bước 1: Cấu hình URL cơ sở và khóa API
Endpoint AI gateway của chúng tôi hoạt động trên một URL cơ sở riêng biệt. Bạn cần lấy khóa API từ bảng điều khiển và cấu hình client SDK của bạn trỏ đến https://api.openaigatewayapi.com/v1. Điều này đảm bảo tất cả yêu cầu bỏ qua cơ sở hạ tầng OpenAI tiêu chuẩn và định tuyến trực tiếp đến máy chủ mô hình không kiểm duyệt của chúng tôi. Bạn không cần thay đổi tên mô hình; chỉ cần đặt URL cơ sở và cung cấp khóa của bạn.
Bước 2: Gửi yêu cầu hoàn thành chat tiêu chuẩn
Với client đã được cấu hình, bạn có thể gửi một yêu cầu hoàn thành trò chuyện tiêu chuẩn. ID của mô hình là uncensored. Yêu cầu này minh họa khả năng cơ bản nhập văn bản và xuất văn bản. Hệ thống sẽ xử lý prompt của bạn và trả về kết quả hoàn thành mà không có các bộ lọc nội dung thông thường do các nhà cung cấp lớn áp dụng, miễn là nội dung không phải là tình dục rõ ràng liên quan đến trẻ vị thành niên. Sử dụng lệnh sau để xác minh kết nối.
Bước 3: Bật truyền phát với Sự kiện gửi bởi máy chủ
Để giảm độ trễ và cải thiện trải nghiệm người dùng, hãy bật truyền phát bằng cách đặt stream=true. Endpoint hỗ trợ Sự kiện gửi bởi máy chủ (SSE), cho phép bạn nhận token khi chúng được tạo. Điều này đặc biệt hữu ích cho việc tạo nội dung dài hoặc các ứng dụng tương tác. Luồng phản hồi sẽ phát ra các phần nhỏ cho đến khi hoàn thành, cung cấp phản hồi thời gian thực mà không cần chờ xử lý toàn bộ cửa sổ ngữ cảnh.
Bước 4: Sử dụng gọi hàm để tích hợp công cụ
Endpoint hỗ trợ gọi công cụ, cho phép bạn xác định các hàm và để mô hình quyết định khi nào gọi chúng. Điều này cho phép các quy trình làm việc phức tạp bằng cách tích hợp các API hoặc nguồn dữ liệu bên ngoài trực tiếp vào logic LLM của bạn. Xác định các công cụ của bạn trong tham số tools, và mô hình sẽ trả về đầu ra JSON có cấu trúc khi thích hợp. Tính năng này hoạt động giống hệt với định dạng OpenAI tiêu chuẩn, giúp dễ dàng chuyển đổi nhà cung cấp mà không cần viết lại logic tích hợp công cụ của bạn.
Bước 5: Xử lý lỗi và giới hạn tốc độ
Theo dõi việc sử dụng khóa API của bạn và xử lý các lỗi tiềm ẩn một cách khéo léo. Nếu khóa không hợp lệ, bạn sẽ nhận được lỗi 401. Nếu tín dụng trả trước của bạn đã hết, lỗi 402 cho biết bạn cần nạp tiền. Hệ thống áp dụng giới hạn 300 yêu cầu mỗi phút trên mỗi khóa; vượt quá giới hạn này sẽ kích hoạt lỗi giới hạn tốc độ 429. Ngoài ra, hãy giữ thân yêu cầu của bạn dưới 8 MB để tránh bị từ chối. Cửa sổ ngữ cảnh hỗ trợ tối đa 100.000 token cho cả prompt và kết quả hoàn thành kết hợp.
cURL
curl https://api.openaigatewayapi.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."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.openaigatewayapi.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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openaigatewayapi.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);Truyền phát
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)Thông số kỹ thuật
Toàn bộ giới hạn và tính năng thực tế của API ở một nơi — hãy kiểm tra trước khi nạp tiền.
| Mục | Giá trị |
|---|---|
| Định dạng | tương thích OpenAI: mọi SDK OpenAI đều chạy được, chỉ cần đổi base URL và khóa |
| ID mô hình | uncensored |
| Xác thực | Authorization: Bearer YOUR_KEY |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.openaigatewayapi.com/v1 |
| Chế độ JSON | response_format: {"type": "json_object"} |
| Đầu ra tối đa | tối đa phần còn lại của cửa sổ 100.000 token; max_tokens tùy chọn (không giới hạn riêng) |
| Streaming | có — server-sent events; phần cuối chứa lượng token đã dùng |
| Tham số | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Cửa sổ ngữ cảnh | 100.000 token (đầu vào + đầu ra) |
| Gọi hàm | có — tools, tool_choice; phản hồi có tool_calls, kể cả khi streaming; kết quả gửi lại bằng role: tool |
| Kích thước yêu cầu | tối đa 8 MB |
| Yêu cầu đồng thời | tối đa 8 cùng lúc cho mỗi khóa |
| Header phản hồi | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Giới hạn tốc độ | 300 yêu cầu mỗi phút cho mỗi khóa |
| Giá | $0,15 cho 1 triệu token đầu vào · $0,50 cho 1 triệu token đầu ra |
| Thời hạn | tín dụng đã trả không hết hạn, không đăng ký định kỳ |
| Tính phí | tín dụng trả trước theo mức dùng thực tế; lỗi và từ chối miễn phí |
| Nạp tiền | USDT (TRC20) hoặc USDC (Base), số tiền nguyên bất kỳ từ $20 đến $500 |
| Dùng thử miễn phí | $0,50 trong 7 ngày, không cần thẻ · Khóa dùng thử: 2 yêu cầu song song, 60 yêu cầu/phút; hạn mức đầy đủ (8 và 300) sau lần nạp đầu |
| Thưởng | +5% từ $50, +10% từ $100, +15% từ $200 |
| Khóa | mỗi tài khoản một khóa đang hoạt động; khóa mới thay thế khóa cũ |
| Đăng nhập | Google hoặc email và mật khẩu |
| Nội dung | cho phép nội dung người lớn; từ chối nội dung tình dục liên quan đến trẻ vị thành niên |
Mã lỗi
Lỗi trả về dạng JSON với type cố định; yêu cầu lỗi hoặc bị từ chối không bị tính phí.
| Mã | Loại | Ý nghĩa |
|---|---|---|
400 | bad_request | JSON sai, tin nhắn trống, tham số sai hoặc vượt cửa sổ ngữ cảnh |
401 | missing_key · invalid_key · key_revoked | thiếu khóa, sai khóa hoặc khóa đã bị thay |
402 | no_credit | hết tín dụng — nạp tiền là dùng tiếp ngay |
403 | content_blocked | nội dung tình dục liên quan trẻ vị thành niên — từ chối, không tính phí |
404 | not_found | endpoint không tồn tại |
413 | request_too_large | nội dung lớn hơn 8 MB |
429 | rate_limited · concurrency | vượt 300/phút hoặc 8 đồng thời — chờ rồi thử lại |
503 | upstream_busy | mô hình đang bận — thử lại sau vài giây |
Hỏi đáp
Kích thước cửa sổ ngữ cảnh là bao nhiêu?
Mô hình hỗ trợ cửa sổ ngữ cảnh 100.000 token, bao gồm cả prompt đầu vào và kết quả đầu ra. Điều này cho phép xử lý tài liệu lớn hoặc lưu trữ lịch sử hội thoại trong một yêu cầu duy nhất.
Tôi nạp tiền tín dụng như thế nào?
Bạn có thể nạp tiền tín dụng trả trước của mình từ $20 bằng crypto (USDT trên TRC20, USDC trên Base). Tín dụng không bao giờ hết hạn. Bạn cũng nhận được thêm 5% cho các khoản nạp từ $50 trở lên, thêm 10% cho các khoản nạp từ $100 trở lên, và thêm 15% cho các khoản nạp từ $200 trở lên.
Dịch vụ này có sử dụng dữ liệu của tôi để huấn luyện không?
Không. Các prompt của bạn không được sử dụng để huấn luyện. Dịch vụ chỉ yêu cầu email và mật khẩu để đăng ký, đảm bảo quyền riêng tư trong khi cung cấp quyền truy cập trực tiếp vào mô hình không kiểm duyệt mà không có điều khoản ẩn hoặc chính sách lưu trữ dữ liệu.
Khóa của bạn chỉ cách một biểu mẫu
Tạo tài khoản, sao chép khóa, thay đổi URL cơ sở. Đó là toàn bộ quá trình thiết lập.