Hướng dẫn nhanh: API văn bản cho quy trình Vision API của bạn
Tích hợp động cơ văn bản không kiểm duyệt của chúng tôi vào pipeline thị giác của bạn bằng giao diện tương thích chuẩn với OpenAI. Hướng dẫn này bao gồm xác thực, chat completions, streaming và các ràng buộc để xử lý dữ liệu thị giác có ngữ cảnh lớn.
- URL gốc
https://api.visionllmapi.com/v1- Mô hình
uncensored
URL cơ bản & Xác thực
Bắt đầu bằng cách đặt URL cơ bản của bạn thành https://api.visionllmapi.com/v1. Endpoint này tương thích với các SDK OpenAI tiêu chuẩn và bất kỳ khách hàng nào tương thích với OpenAI. Bạn cần một khóa API để xác thực các yêu cầu. Tạo khóa này trên trang Lấy khóa API bằng cách đăng ký chỉ với email và mật khẩu. Không cần thẻ tín dụng để bắt đầu, và bạn nhận được $0,50 tín dụng dùng thử có hiệu lực trong 7 ngày. Nhận tín dụng này chỉ với một cú nhấp chuột trên trang khóa API của bạn. Giữ khóa của bạn an toàn; bạn có thể tạo lại khóa bất cứ lúc nào, điều này sẽ vô hiệu hóa ngay lập tức khóa trước đó.
Yêu cầu đầu tiên
Gửi yêu cầu POST đến /v1/chat/completions. Sử dụng ID mô hình uncensored. API chấp nhận đầu vào văn bản và trả về đầu ra văn bản, khiến nó lý tưởng để xử lý hậu kỳ dữ liệu pipeline thị giác. Bạn có thể bao gồm các prompt hệ thống để xác định hành vi, chẳng hạn như hướng dẫn mô hình trích xuất dữ liệu có cấu trúc từ kết quả OCR hoặc mô tả nội dung hình ảnh mà không có bộ lọc nội dung can thiệp vào các trường hợp sử dụng sáng tạo hoặc người lớn.
curl https://api.visionllmapi.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."}]
}'
Phản hồi sẽ chứa văn bản được tạo ra trong trường choices[0].message.content. Nếu mô hình từ chối trả lời do giới hạn cứng về nội dung tình dục liên quan đến trẻ em, bạn sẽ nhận được lỗi hoặc nội dung trống tùy thuộc vào cách xử lý từ chối cụ thể.
SDK Python
Sử dụng SDK Python chính thức của OpenAI để tích hợp dễ dàng. Đặt các biến base_url và api_key để trỏ đến dịch vụ của chúng tôi. Cách tiếp cận này hoạt động với bất kỳ thư viện khách hàng tương thích OpenAI nào. SDK xử lý việc tuần tự hóa và giải tuần tự hóa JSON, nhưng bạn chịu trách nhiệm xử lý cấu trúc phản hồi trong logic ứng dụng của mình.
from openai import OpenAI
client = OpenAI(base_url="https://api.visionllmapi.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)
Phương pháp này phù hợp để xử lý hàng loạt hoặc khi bạn cần thực thi đồng bộ. Đối với các ứng dụng thời gian thực, hãy cân nhắc sử dụng phản hồi streaming để giảm độ trễ cảm nhận được.
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 baseURL và apiKey để khớp với endpoint API của chúng tôi. Điều này cho phép bạn tích hợp động cơ văn bản không kiểm duyệt trực tiếp vào các ứng dụng Node.js trên web hoặc phía máy chủ của bạn. SDK cung cấp giao diện quen thuộc cho các nhà phát triển đã sử dụng các dịch vụ của OpenAI.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.visionllmapi.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);
Đảm bảo bạn xử lý dữ liệu phản hồi một cách phù hợp, vì mô hình có thể trả về lượng văn bản lớn tùy thuộc vào cửa sổ ngữ cảnh được sử dụng. Không có đảm bảo cụ thể về hành vi thử lại hoặc giải mã JSON ngoài những gì tài liệu SDK tiêu chuẩn cung cấp.
Phản hồi Streaming
Bật streaming bằng cách đặt stream: true trong yêu cầu của bạn. API trả về các Sự kiện được gửi bởi máy chủ (SSE) để phân phối token theo thời gian thực. Điều này hữu ích cho các pipeline thị giác nơi bạn muốn hiển thị kết quả từng phần. Mỗi sự kiện chứa một phần nhỏ của phản hồi, cho phép bạn cập nhật giao diện người dùng khi văn bản được tạo ra.
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)
Phân tích luồng SSE để trích xuất các token nội dung. Điều này giảm thời gian để có token đầu tiên, điều rất quan trọng đối với các ứng dụng tương tác. Hãy nhớ rằng tổng số token vẫn được tính vào giới hạn sử dụng của bạn.
Giới hạn tốc độ & Ràng buộc
Mỗi khóa API được giới hạn ở 300 yêu cầu mỗi phút. Kích thước tối đa của thân yêu cầu là 8 MB. Nếu bạn vượt quá giới hạn tốc độ, bạn sẽ nhận được lỗi 429. Nếu tài khoản của bạn không có tín dụng, bạn sẽ nhận được lỗi 402. Nếu khóa không hợp lệ, bạn sẽ nhận được lỗi 401. Cửa sổ ngữ cảnh hỗ trợ tối đa 100.000 token cho prompt và kết hợp hoàn thành. Cửa sổ ngữ cảnh lớn này đảm bảo logic chuyển đổi từ hình ảnh sang văn bản của bạn không bị nghẽn bởi giới hạn token. Không có đảm bảo SLA và không có chứng nhận SOC2 hoặc HIPAA. Mô hình được tinh chỉnh cho việc sử dụng hợp pháp của người lớn nhưng chặn nội dung tình dục liên quan đến trẻ em dưới 18 tuổi.
Hỏi đáp
Đây có phải là API đa phương thức không?
Không. Đây là API chỉ xử lý văn bản. API không chấp nhận trực tiếp hình ảnh, âm thanh hoặc video. Bạn phải chuyển đổi dữ liệu thị giác thành văn bản trước, sau đó gửi văn bản đó đến API này để xử lý hậu kỳ, trích xuất hoặc tạo nội dung.
Giá được tính như thế nào?
Giá theo hình thức trả trước theo mức sử dụng. Token đầu vào giá $0,15 cho mỗi 1 triệu token, và token đầu ra giá $0,50 cho mỗi 1 triệu token. Tín dụng không hết hạn và không có phí đăng ký hàng tháng.
Kích thước cửa sổ ngữ cảnh là bao nhiêu?
Cửa sổ ngữ cảnh là 100.000 token, bao gồm cả prompt đầu vào và phần hoàn thành được tạo ra. Điều này cho phép xử lý các tài liệu lớn hoặc dữ liệu pipeline thị giác mở rộng trong một yêu cầu duy nhất.
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.
URL cơ bảnhttps://api.visionllmapi.com/v1
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 |
| Base URL | https://api.visionllmapi.com/v1 |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| ID mô hình | uncensored |
| Xác thực | Authorization: Bearer YOUR_KEY |
| 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 |
| Đầ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 |
| Cửa sổ ngữ cảnh | 100.000 token (đầu vào + đầu ra) |
| Tham số | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Chế độ JSON | response_format: {"type": "json_object"} |
| Giới hạn tốc độ | 300 yêu cầu mỗi phút cho mỗi khóa |
| 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 |
| 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 |
| Giá | $0,15 cho 1 triệu token đầu vào · $0,50 cho 1 triệu token đầu ra |
| 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í |
| Thời hạn | tín dụng đã trả không hết hạn, không đăng ký định kỳ |
| 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 |
| Đăng nhập | Google hoặc email và mật khẩ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ũ |
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í.
| HTTP | 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 |