Documentazione API per gli strumenti Uncensored Video
Inizia con l'API video senza censura in pochi minuti. Questa guida copre autenticazione, formati di richiesta, streaming e prezzi per creare pipeline video basate su testo.
URL base e autenticazione
L'API utilizza l'URL base standard compatibile con OpenAI. Invia richieste a https://api.uncensoredvideo.top/v1. L'autenticazione si basa su una singola chiave API generata durante la registrazione. Includila nell'intestazione Authorization come token Bearer. I nuovi account ricevono immediatamente una chiave tramite accesso Google o registrazione email. Non è richiesto il numero di telefono. La chiave rimane attiva fino alla sostituzione manuale; il credito prepagato non scade.
Prima richiesta
Invia una richiesta POST a /v1/chat/completions con l'ID del modello uncensored. Il modello accetta input testuale e restituisce output testuale. Non genera immagini o video direttamente. Usa questo endpoint per bozze di prompt, estrazione di metadati o scrittura di script per la tua pipeline video.
curl https://api.uncensoredvideo.top/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."}]
}'Questa richiesta invia un prompt semplice al modello. La risposta contiene il testo generato, che puoi poi passare al tuo strumento di generazione video. Il modello è ottimizzato per evitare rifiuti per contenuti adulti leciti, garantendo che il tuo flusso creativo non venga interrotto.
Integrazione SDK Python
Usa l'SDK Python ufficiale di OpenAI. Imposta base_url e api_key per corrispondere agli endpoint dell'API video senza censura. Questo ti permette di usare metodi familiari come client.chat.completions.create. L'SDK gestisce automaticamente la serializzazione JSON. Configura parametri come temperature e top_p per controllare la creatività. L'ID del modello è sempre uncensored. Puoi attivare lo streaming delle risposte o richiedere la modalità JSON per l'estrazione di dati strutturati.
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredvideo.top/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 frammento di codice mostra una chiamata di completamento standard. Funziona con qualsiasi client compatibile con OpenAI. Regola il parametro max_tokens per controllare la lunghezza dell'output. L'output massimo predefinito è di 2.048 token, se non specificato diversamente.
Utilizzo SDK Node.js
Installa il pacchetto Node.js di OpenAI. Inizializza il client con l'URL di base https://api.uncensoredvideo.top/v1 e la tua chiave API. Usa lo stesso endpoint chat.completions usato in Python. L'SDK Node supporta i pattern async/await per un'integrazione pulita. Puoi inviare più messaggi nella cronologia delle conversazioni per mantenere il contesto. Il modello supporta la chiamata di funzioni, consentendoti di definire strumenti per l'estrazione di metadati.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredvideo.top/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);Questo esempio mostra come effettuare una richiesta. L'oggetto risposta contiene il contenuto generato. Puoi analizzare l'output per l'uso nel tuo flusso di produzione video. Assicurati di gestire gli errori in modo appropriato, poiché potrebbero verificarsi problemi di rete o chiavi non valide.
Risposte in streaming
Abilita lo streaming impostando stream: true nella tua richiesta. L'API restituisce un flusso di Server-Sent Events (SSE). Ogni frammento contiene testo parziale. L'ultimo frammento include le statistiche di utilizzo, come i conteggi dei token. Lo streaming riduce la latenza percepita per script lunghi o metadati dettagliati. Consente alla tua applicazione di visualizzare i progressi in tempo reale. È ideale per strumenti interattivi o per la visualizzazione live del testo.
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)Questo flusso elabora i frammenti al loro arrivo. I dati di utilizzo nell'ultimo frammento ti aiutano a monitorare i costi con precisione. Gli errori durante lo streaming possono interrompere il flusso, quindi implementa una logica di retry se necessario. Il modello supporta fino a 100.000 token nella finestra di contesto.
Limiti, errori e contesto
La finestra di contesto è di 100.000 token in totale. L'output massimo per richiesta è di 32.000 token. Puoi effettuare 300 richieste al minuto e 8 richieste parallele per chiave. I corpi delle richieste devono essere inferiori a 8 MB. Gli errori includono 401 per chiavi non valide e 429 per i limiti di richiesta. 402 indica credito insufficiente. Il credito prepagato viene addebitato solo per l'effettivo utilizzo dei token. Errori e rifiuti sono gratuiti. Il credito non scade mai. Non serve carta per la prova da $0,50. Richiedi questo credito con un clic nella pagina della tua chiave API. Ricarica con USDT o USDC.
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 |
| ID modello | uncensored |
| Base URL | https://api.uncensoredvideo.top/v1 |
| Autenticazione | Authorization: Bearer YOUR_KEY |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| Output massimo | fino al resto della finestra di 100.000 token; max_tokens opzionale (nessun limite separato) |
| Parametri | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Modalità JSON | response_format: {"type": "json_object"} |
| Finestra di contesto | 100.000 token (input + output) |
| Streaming | sì — server-sent events; l'ultimo blocco riporta l'uso dei token |
| Function calling | sì — tools, tool_choice; risposte con tool_calls anche in streaming; risultati come role: tool |
| Concorrenza | 8 richieste contemporanee per chiave |
| Dimensione | fino a 8 MB per richiesta |
| Limite di frequenza | 300 richieste al minuto 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 |
| Scadenza | il credito pagato non scade, nessun abbonamento |
| 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 |
| Accesso | Google oppure e-mail e password |
| Contenuti | contenuti per adulti consentiti; rifiutati i contenuti sessuali con minori |
| 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.
| Codice | 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 |
Domande e risposte
Qual è la dimensione della finestra di contesto?
La finestra di contesto è di 100.000 token, inclusi prompt e completamento. L'output massimo per richiesta è di 32.000 token. Se max_tokens non è impostato, il limite è di 2.048 token.
Come gestire i limiti di richiesta?
Sei limitato a 300 richieste al minuto e a 8 richieste concorrenti per chiave. Se superi questi limiti, l'API restituisce un codice di stato 429. Implementa un'attesa esponenziale nel tuo client per gestire i retry in modo elegante.
Cosa succede se il credito si esaurisce?
Le richieste falliscono se il credito è insufficiente. L'API restituisce il codice 402. Il credito prepagato viene addebitato solo per l'effettivo utilizzo dei token. Errori e rifiuti non consumano credito. Il credito non scade mai, puoi ricaricarlo quando vuoi.
La tua chiave è a un modulo di distanza
Crea un account, copia la chiave, cambia l'URL base. È tutta qui la configurazione.