Szybki start: API tekstowe do Twojego potoku Vision API
Zintegruj nasz silnik tekstu bez cenzury ze swoim potokiem wizyjnym za pomocą standardowego interfejsu kompatybilnego z OpenAI. Ten przewodnik obejmuje uwierzytelnianie, ukończenia czatu, strumieniowanie oraz ograniczenia dla przetwarzania danych wizyjnych o dużym oknie kontekstu.
- Bazowy URL
https://api.visionllmapi.com/v1- Model
uncensored
Base URL i uwierzytelnianie
Zacznij od ustawienia Base URL na https://api.visionllmapi.com/v1. Ten endpoint jest kompatybilny ze standardowymi SDK OpenAI i dowolnym klientem kompatybilnym z OpenAI. Potrzebujesz klucza API do uwierzytelniania zapytań. Wygeneruj go na stronie Pobierz klucz API, logując się tylko adresem e-mail i hasłem. Nie jest wymagana karta kredytowa do rozpoczęcia, a otrzymujesz $0,50 w trial credit ważnym przez 7 dni. Odbierz ten kredyt jednym kliknięciem na stronie klucza API. Chroń swój klucz; możesz go wygenerować ponownie w dowolnym momencie, co natychmiast unieważnia poprzedni klucz.
Pierwsze zapytanie
Wyślij zapytanie POST do /v1/chat/completions. Użyj identyfikatora modelu uncensored. API przyjmuje dane wejściowe tekstowe i zwraca dane wyjściowe tekstowe, co czyni je idealnym do postprzetwarzania danych z potoku wizyjnego. Możesz dołączyć prompty systemowe, aby zdefiniować zachowanie, np. instrukcje dla modelu do ekstrakcji danych strukturalnych z wyników OCR lub opisu zawartości obrazu bez ingerencji filtrów treści w przypadkach kreatywnych lub dla dorosłych.
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."}]
}'
Odpowiedź będzie zawierać wygenerowany tekst w polu choices[0].message.content. Jeśli model odmówi udzielenia odpowiedzi z powodu sztywnego limitu treści seksualnych involving minors, otrzymasz błąd lub pustą zawartość w zależności od konkretnej obsługi odmowy.
SDK Python
Użyj oficjalnego SDK Python OpenAI, aby łatwo zintegrować usługę. Ustaw zmienne base_url i api_key, aby wskazywały na naszą usługę. To podejście działa z dowolną biblioteką klienta kompatybilną z OpenAI. SDK obsługuje serializację i deserializację JSON, ale Ty ponosisz odpowiedzialność za obsługę struktury odpowiedzi w logice swojej aplikacji.
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)
Ta metoda jest odpowiednia do przetwarzania wsadowego lub gdy potrzebujesz wykonania synchronicznego. W przypadku aplikacji w czasie rzeczywistym rozważ użycie odpowiedzi strumieniowych, aby zmniejszyć postrzeganą opóźnienie.
SDK Node.js
W środowiskach JavaScript użyj SDK Node.js OpenAI. Skonfiguruj baseURL i apiKey, aby pasowały do endpointu naszego API. Pozwala to na bezpośrednią integrację silnika tekstu bez cenzury w Twoich aplikacjach webowych lub serwerowych Node.js. SDK zapewnia znany interfejs dla programistów już korzystających z usług 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);
Upewnij się, że odpowiednio obsługujesz dane odpowiedzi, ponieważ model może zwracać duże ilości tekstu w zależności od użytego okna kontekstu. Nie ma żadnych specyficznych gwarancji dotyczących ponownych prób lub dekodowania JSON poza tym, co zapewnia standardowa dokumentacja SDK.
Odpowiedzi strumieniowe
Włącz strumieniowanie, ustawiając stream: true w swoim zapytaniu. API zwraca zdarzenia wysyłane przez serwer (SSE) dla dostarczania tokenów w czasie rzeczywistym. Jest to przydatne w potokach wizyjnych, gdzie chcesz wyświetlać wyniki przyrostowo. Każde zdarzenie zawiera częściowy fragment odpowiedzi, pozwalając na aktualizację interfejsu użytkownika w miarę generowania tekstu.
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)
Przeanalizuj strumień SSE, aby wyodrębnić tokeny zawartości. Zmniejsza to czas do pierwszego tokena, co jest krytyczne dla aplikacji interaktywnych. Pamiętaj, że całkowita liczba tokenów nadal wlicza się do limitów użycia.
Limity zapytań i ograniczenia
Każdy klucz API jest ograniczony do 300 zapytań na minutę. Maksymalny rozmiar ciała zapytania wynosi 8 MB. Jeśli przekroczysz limit zapytań, otrzymasz błąd 429. Jeśli Twoje konto nie ma kredytu, otrzymasz błąd 402. Jeśli klucz jest nieprawidłowy, otrzymasz błąd 401. Okno kontekstu obsługuje do 100 000 tokenów dla promptu i uzupełnienia łącznie. To duże okno kontekstu zapewnia, że Twoja logika wizja-na-tekst nie jest wąskim gardłem przez limity tokenów. Nie ma gwarancji SLA, a certyfikaty SOC2 ani HIPAA nie są dostarczane. Model jest dostosowany do prawnego użytku dla dorosłych, ale blokuje treści seksualne involving minors.
Pytania i odpowiedzi
Czy to jest API multimodalne?
Nie. To jest API tylko tekstowe. Nie przyjmuje ono bezpośrednio obrazów, audio ani wideo. Najpierw musisz przetworzyć dane wizyjne na tekst, a następnie wysłać ten tekst do tego API do postprzetwarzania, ekstrakcji lub generowania.
Jak obliczana jest cena?
Cena to model pay-as-you-go z przedpłaconym kredytem. Tokeny wejściowe kosztują $0,15 za 1M tokenów, a tokeny wyjściowe kosztują $0,50 za 1M tokenów. Kredyty nie wygasają, a nie ma miesięcznych opłat subskrypcyjnych.
Jaki jest rozmiar okna kontekstu?
Okno kontekstu wynosi 100 000 tokenów, obejmując zarówno prompt wejściowy, jak i wygenerowane uzupełnienie. Pozwala to na przetwarzanie dużych dokumentów lub rozległych danych z potoku wizyjnego w jednym zapytaniu.
Twój klucz jest o jeden formularz stąd
Utwórz konto, skopiuj klucz, zmień Base URL. To cała konfiguracja.
Podstawowy URLhttps://api.visionllmapi.com/v1
Parametry API
Wszystkie rzeczywiste limity i funkcje API w jednym miejscu — sprawdź je przed doładowaniem.
| Element | Wartość |
|---|---|
| Format API | zgodne z OpenAI: działa każdy SDK OpenAI — zmień base URL i klucz |
| Base URL | https://api.visionllmapi.com/v1 |
| Endpointy | POST /v1/chat/completions · GET /v1/models |
| ID modelu | uncensored |
| Uwierzytelnianie | Authorization: Bearer YOUR_KEY |
| Wywoływanie funkcji | tak — tools, tool_choice; odpowiedź zawiera tool_calls, także w strumieniu; wyniki jako role: tool |
| Maks. odpowiedź | do reszty okna 100 000 tokenów; max_tokens opcjonalne (bez osobnego limitu) |
| Strumieniowanie | tak — server-sent events; ostatni fragment zawiera zużycie tokenów |
| Okno kontekstu | 100 000 tokenów (wejście + odpowiedź) |
| Parametry | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Tryb JSON | response_format: {"type": "json_object"} |
| Limit zapytań | 300 zapytań na minutę na klucz |
| Rozmiar zapytania | do 8 MB |
| Równoległe zapytania | do 8 jednocześnie na klucz |
| Nagłówki odpowiedzi | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Doładowanie | USDT (TRC20) lub USDC (Base), dowolna pełna kwota od $20 do $500 |
| Darmowy kredyt | $0,50 na 7 dni, bez karty · Klucz próbny: 2 równoległe żądania, 60 na minutę; pełne limity (8 i 300) po pierwszym doładowaniu |
| Bonus | +5% od $50, +10% od $100, +15% od $200 |
| Cena | $0,15 za 1 mln tokenów wejścia · $0,50 za 1 mln tokenów wyjścia |
| Rozliczenie | przedpłacony kredyt według rzeczywistego zużycia; błędy i odmowy są darmowe |
| Ważność | opłacony kredyt nie wygasa, bez subskrypcji |
| Treści | treści dla dorosłych dozwolone; treści seksualne z udziałem nieletnich są odrzucane |
| Logowanie | Google albo e-mail i hasło |
| Klucze | jeden aktywny klucz na konto; nowy zastępuje stary |
Kody błędów
Błędy wracają jako JSON ze stałym type; nieudane i odrzucone zapytania są bezpłatne.
| HTTP | Typ | Znaczenie |
|---|---|---|
400 | bad_request | błędny JSON, puste wiadomości, zły parametr lub za długi kontekst |
401 | missing_key · invalid_key · key_revoked | brak klucza, zły klucz lub klucz zastąpiony nowym |
402 | no_credit | brak kredytu — doładuj, działa od razu |
403 | content_blocked | treści seksualne z nieletnimi — odmowa, bez opłaty |
404 | not_found | nieznany endpoint |
413 | request_too_large | treść większa niż 8 MB |
429 | rate_limited · concurrency | ponad 300/min lub 8 równolegle — odczekaj i ponów |
503 | upstream_busy | model zajęty — ponów za kilka sekund |