Flux API: Prompt và kịch bản qua một endpoint
Tích hợp mô hình LLM không kiểm duyệt của chúng tôi vào quy trình truyền thông của bạn với một endpoint tương thích OpenAI. Viết kịch bản, trích xuất siêu dữ liệu hoặc xử lý hậu kỳ văn bản mà không bị từ chối nội dung.
uncensoredhttps://api.fluxapikey.com/v1
URL cơ bản và xác thực
API của chúng tôi tuân theo cấu trúc chat-completions tiêu chuẩn của OpenAI. Để bắt đầu, bạn cần một URL cơ bản và khóa API. URL cơ bản cho tất cả các yêu cầu là https://api.fluxapikey.com/v1. Bạn có thể nhận khóa API bằng cách đăng ký trên trang Lấy khóa API chỉ với email và mật khẩu. Không cần thẻ tín dụng cho bản dùng thử.
Chuyển khóa của bạn vào tiêu đề Authorization dưới dạng token Bearer. Mỗi tài khoản chỉ được giới hạn một khóa tại một thời điểm; việc tạo lại khóa sẽ làm vô hiệu hóa khóa trước đó. Các prompt không được sử dụng để huấn luyện, và giới hạn nội dung cứng duy nhất là không có nội dung liên quan đến trẻ vị thành niên.
Gửi yêu cầu đầu tiên của bạn
Thực hiện yêu cầu POST đến /v1/chat/completions với prompt của bạn. ID mô hình luôn là uncensored. Endpoint này chấp nhận các tải trọng JSON tiêu chuẩn và trả về phản hồi văn bản. Nó hỗ trợ truyền qua Server-Sent Events (SSE) và gọi hàm.
Dưới đây là một ví dụ cơ bản sử dụng curl:
curl https://api.fluxapikey.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."}]
}'Yêu cầu này gửi văn bản của bạn đến các máy chủ GPU của chúng tôi. Mô hình được tinh chỉnh để trả lời mà không từ chối các chủ đề trưởng thành hợp pháp, hư cấu hoặc gây tranh cãi. Bạn có thể điều chỉnh các tham số max_tokens và temperature khi cần.
Tích hợp SDK Python
Sử dụng SDK Python chính thức của OpenAI để tương tác với API của chúng tôi. Đặt URL cơ bản thành endpoint của chúng tôi và cung cấp khóa API của bạn. Điều này cho phép bạn sử dụng các phương thức quen thuộc như client.chat.completions.create.
from openai import OpenAI
client = OpenAI(base_url="https://api.fluxapikey.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)Cấu hình này đảm bảo tương thích với các cơ sở mã hiện có. Đối tượng phản hồi chứa văn bản được tạo trong response.choices[0].message.content. Bạn có thể phân tích cú pháp văn bản này cho kịch bản, phụ đề hoặc trích xuất siêu dữ liệu trong quy trình video hoặc âm thanh của bạn.
Sử dụng SDK Node.js
Đối với môi trường JavaScript, hãy sử dụng SDK Node.js của OpenAI. Cấu hình các thuộc tính baseURL và apiKey để trỏ đến dịch vụ của chúng tôi. Điều này cho phép tích hợp liền mạch vào các ứng dụng Node.js để tạo văn bản theo thời gian thực.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.fluxapikey.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);Cấu trúc phản hồi khớp với định dạng OpenAI. Bạn có thể truy cập nội dung được tạo và xử lý lỗi bằng các khối try-catch tiêu chuẩn. Cách tiếp cận này rất lý tưởng cho xử lý phía máy chủ trong các ứng dụng web hoặc công cụ CLI.
Phản hồi truyền qua SSE
Bật truyền bằng cách đặt stream: true trong yêu cầu của bạn. API trả về Server-Sent Events (SSE) với các đoạn văn bản tăng dần. Điều này hữu ích cho các ứng dụng thời gian thực nơi bạn muốn hiển thị văn bản khi nó được tạo.
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)Mỗi đoạn chứa một phản hồi một phần. Bạn có thể tích lũy các đoạn này để tái tạo toàn bộ văn bản hoặc hiển thị chúng theo thời gian thực. Truyền giảm độ trễ cảm nhận đối với người dùng đang chờ đợi các kịch bản hoặc mô tả dài.
Giới hạn, Lỗi và Cửa sổ ngữ cảnh
API của chúng tôi có các giới hạn cụ thể để đảm bảo độ tin cậy. Bạn có thể gửi tối đa 300 yêu cầu mỗi phút trên mỗi khóa. Kích thước tải trọng yêu cầu tối đa là 8 MB. Cửa sổ ngữ cảnh hỗ trợ 100.000 token cho cả prompt và kết quả hoàn thành.
Các lỗi phổ biến bao gồm 401 cho khóa không hợp lệ, 402 cho tín dụng không đủ và 429 cho giới hạn tốc độ. Nếu bạn vượt quá giới hạn tốc độ, hãy đợi và thử lại. Giá cả của chúng tôi minh bạch: $0,25 cho mỗi 1 triệu token đầu vào và $1,00 cho mỗi 1 triệu token đầu ra. Tín dụng trả trước không bao giờ hết hạn, và bạn có thể nạp tiền từ $10.
Thông số API
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 |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| ID mô hình | uncensored |
| Xác thực | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.fluxapikey.com/v1 |
| Tham số | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Streaming | có — server-sent events; phần cuối chứa lượng token đã dùng |
| 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 |
| 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) |
| Cửa sổ ngữ cảnh | 100.000 token (đầu vào + đầu ra) |
| Kích thước yêu cầu | tối đa 8 MB |
| Header phản hồi | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Yêu cầu đồng thời | tối đa 8 cùng lúc cho mỗi khóa |
| Giới hạn tốc độ | 300 yêu cầu mỗi phút cho mỗi khóa |
| Thời hạn | tín dụng đã trả không hết hạn, không đăng ký định kỳ |
| Thưởng | +5% từ $50, +10% từ $100 |
| 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í |
| Giá | $0,25 cho 1 triệu token đầu vào · $1,00 cho 1 triệu token đầu ra |
| Nạp tiền | USDT (TRC20) hoặc USDC (Base), số tiền nguyên bất kỳ từ $10 đế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 |
| 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?
Cửa sổ ngữ cảnh hỗ trợ 100.000 token cho cả prompt và kết quả hoàn thành. Điều này cho phép bạn xử lý các cuộc hội thoại dài hoặc tài liệu lớn trong một yêu cầu duy nhất.
Tôi xử lý lỗi như thế nào?
Các lỗi thường gặp bao gồm 401 cho khóa không hợp lệ, 402 cho tín dụng không đủ và 429 cho giới hạn tốc độ. Bạn có thể kiểm tra mã trạng thái và thông báo phản hồi để xác định vấn đề và thực hiện hành động phù hợp.
Tôi có thể sử dụng API này để tạo hình ảnh hoặc video không?
Không, API này chỉ dành cho các cuộc trò chuyện văn bản. Chúng tôi cung cấp mô hình không kiểm duyệt để kỹ thuật prompt, viết kịch bản và xử lý hậu kỳ. Để tạo hình ảnh hoặc video, bạn cần sử dụng mô hình hoặc dịch vụ chuyên dụng.
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ơ bản. Đó là toàn bộ quá trình thiết lập.