Avvio rapido: API testuale per la tua pipeline Vision API
Integra il nostro motore di testo senza censura nella tua pipeline visiva utilizzando l'interfaccia compatibile con OpenAI. Questa guida copre l'autenticazione, le chat completions, lo streaming e i vincoli per l'elaborazione di dati visivi ad alto contesto.
- URL di base
https://api.visionllmapi.com/v1- Modello
uncensored
URL di base e Autenticazione
Inizia impostando il tuo Base URL su https://api.visionllmapi.com/v1. Questo endpoint è compatibile con gli SDK standard di OpenAI e con qualsiasi client compatibile con OpenAI. Hai bisogno di una chiave API per autenticare le richieste. Generane una nella pagina Chiave API iscrivendoti solo con email e password. Non è necessaria una carta di credito per iniziare e ricevi $0,50 di credito di prova valido per 7 giorni. Richiedi questo credito con un clic nella pagina della tua chiave API. Mantieni la tua chiave al sicuro; puoi rigenerarla in qualsiasi momento, il che invalida immediatamente la chiave precedente.
Prima Richiesta
Invia una richiesta POST a /v1/chat/completions. Usa l'ID del modello uncensored. L'API accetta input testuale e restituisce output testuale, rendendola ideale per il post-processing dei dati della pipeline vision. Puoi includere prompt di sistema per definire il comportamento, ad esempio istruendo il modello a estrarre dati strutturati dai risultati OCR o a descrivere il contenuto delle immagini senza che i filtri sui contenuti interferiscano con casi d'uso creativi o per adulti.
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."}]
}'
La risposta conterrà il testo generato nel campo choices[0].message.content. Se il modello rifiuta di rispondere a causa del limite rigido sui contenuti sessuali che coinvolgono minori, riceverai un errore o un contenuto vuoto a seconda della gestione specifica del rifiuto.
SDK Python
Usa l'SDK Python ufficiale di OpenAI per integrare facilmente. Imposta le variabili base_url e api_key per puntare al nostro servizio. Questo approccio funziona con qualsiasi libreria client compatibile con OpenAI. L'SDK gestisce la serializzazione e deserializzazione JSON, ma sei responsabile della gestione della struttura della risposta nella logica della tua applicazione.
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)
Questo metodo è adatto per l'elaborazione in batch o quando hai bisogno di un'esecuzione sincrona. Per le applicazioni in tempo reale, considera l'uso di risposte in streaming per ridurre la latenza percepita.
SDK Node.js
Per gli ambienti JavaScript, usa l'SDK Node.js di OpenAI. Configura baseURL e apiKey per corrispondere all'endpoint della nostra API. Questo ti permette di integrare il motore di testo senza censura direttamente nelle tue applicazioni web o server-side Node.js. L'SDK fornisce un'interfaccia familiare per gli sviluppatori che utilizzano già i servizi 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);
Assicurati di gestire i dati di risposta in modo appropriato, poiché il modello potrebbe restituire grandi quantità di testo a seconda della finestra di contesto utilizzata. Non ci sono garanzie specifiche sul comportamento dei tentativi di ripetizione o sul decoding JSON oltre a quanto fornito dalla documentazione standard degli SDK.
Risposte in Streaming
Abilita lo streaming impostando stream: true nella tua richiesta. L'API restituisce Server-Sent Events (SSE) per la consegna dei token in tempo reale. Questo è utile per le pipeline visive dove vuoi visualizzare i risultati in modo incrementale. Ogni evento contiene un frammento parziale della risposta, permettendoti di aggiornare l'interfaccia utente mentre il testo viene generato.
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)
Analizza lo stream SSE per estrarre i token di contenuto. Questo riduce il tempo al primo token, che è critico per le applicazioni interattive. Ricorda che il conteggio totale dei token viene comunque conteggiato nei tuoi limiti di utilizzo.
Limiti di Richiesta e Vincoli
Ogni chiave API è limitata a 300 richieste al minuto. La dimensione massima del corpo della richiesta è di 8 MB. Se superi il limite di richieste, riceverai un errore 429. Se il tuo account non ha credito, riceverai un errore 402. Se la chiave non è valida, riceverai un errore 401. La finestra di contesto supporta fino a 100.000 token per prompt e completamento combinati. Questa ampia finestra di contesto garantisce che la tua logica vision-to-text non sia limitata dai vincoli sui token. Non ci sono garanzie contrattuali SLA e non sono fornite certificazioni SOC2 o HIPAA. Il modello è ottimizzato per l'uso adulto legale ma blocca i contenuti sessuali che coinvolgono minori.
Domande e risposte
È un'API multimodale?
No. Questa è un'API solo testo. Non accetta immagini, audio o video direttamente. Devi prima elaborare i dati visivi in testo, quindi inviare il testo a questa API per il post-processing, l'estrazione o la generazione.
Come viene calcolato il prezzo?
La tariffazione è a consumo con credito prepagato. I token di input costano $0,15 per 1M di token, e i token di output costano $0,50 per 1M di token. I crediti non scadono mai e non ci sono canoni mensili.
Qual è la dimensione della finestra di contesto?
La finestra di contesto è di 100.000 token, che coprono sia il prompt di input che il completamento generato. Questo permette di elaborare documenti di grandi dimensioni o dati estesi della pipeline visiva in una singola richiesta.
La tua chiave è a un modulo di distanza
Crea un account, copia la chiave, cambia l'URL di base. È tutta la configurazione.
URL di basehttps://api.visionllmapi.com/v1
Scheda tecnica dell'API
Tutti i limiti e le funzioni reali dell'API in un unico posto: controllali prima di ricaricare.
| Voce | Valore |
|---|---|
| Formato | compatibile OpenAI: qualsiasi SDK OpenAI funziona cambiando base URL e chiave |
| Base URL | https://api.visionllmapi.com/v1 |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| ID modello | uncensored |
| Autenticazione | Authorization: Bearer YOUR_KEY |
| Function calling | sì — tools, tool_choice; risposte con tool_calls anche in streaming; risultati come role: tool |
| Output massimo | fino al resto della finestra di 100.000 token; max_tokens opzionale (nessun limite separato) |
| Streaming | sì — server-sent events; l'ultimo blocco riporta l'uso dei token |
| Finestra di contesto | 100.000 token (input + output) |
| Parametri | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Modalità JSON | response_format: {"type": "json_object"} |
| Limite di frequenza | 300 richieste al minuto per chiave |
| Dimensione | fino a 8 MB per richiesta |
| Concorrenza | 8 richieste contemporanee per chiave |
| Header | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Ricarica | USDT (TRC20) o USDC (Base), qualsiasi importo intero da $20 a $500 |
| Prova gratuita | $0,50 per 7 giorni, senza carta · Chiave di prova: 2 richieste parallele, 60 al minuto; limiti completi (8 e 300) dopo la prima ricarica |
| Bonus | +5% da $50, +10% da $100, +15% da $200 |
| Prezzo | $0,15 per 1M token in input · $0,50 per 1M in output |
| Fatturazione | credito prepagato in base all'uso reale; errori e rifiuti gratuiti |
| Scadenza | il credito pagato non scade, nessun abbonamento |
| Contenuti | contenuti per adulti consentiti; rifiutati i contenuti sessuali con minori |
| Accesso | Google oppure e-mail e password |
| Chiavi | una chiave attiva per account; una nuova sostituisce la precedente |
Codici di errore
Gli errori arrivano in JSON con un type fisso; le richieste fallite o rifiutate non si pagano.
| HTTP | Tipo | Significato |
|---|---|---|
400 | bad_request | JSON non valido, messaggi vuoti, parametro errato o contesto troppo lungo |
401 | missing_key · invalid_key · key_revoked | chiave mancante, errata o sostituita |
402 | no_credit | credito esaurito — ricarica e riparti subito |
403 | content_blocked | contenuti sessuali con minori — rifiutato, non addebitato |
404 | not_found | endpoint sconosciuto |
413 | request_too_large | corpo oltre 8 MB |
429 | rate_limited · concurrency | oltre 300/min o 8 in parallelo — attendi e riprova |
503 | upstream_busy | modello occupato — riprova tra pochi secondi |