Un'unica API: Guida rapida
Integra la nostra API LLM senza censura con una sola modifica alla configurazione. La compatibilità pronto all'uso significa che scambi l'URL base e la chiave API, mantenendo il tuo codice esistente.
URL base e autenticazione
Inizia puntando il tuo client sul nostro endpoint dedicato. Questa API compatibile con OpenAI utilizza intestazioni di autenticazione standard, quindi devi solo modificare due valori nella tua configurazione.
L'URL base è https://api.onekeyllmapi.com/v1. Genera la tua chiave API univoca nella pagina di registrazione. Non è necessaria una carta per iniziare e la chiave viene mostrata immediatamente dopo la registrazione. Mantieni questa chiave sicura; autentica tutte le richieste al servizio.
Completamento di base
Invia un prompt di testo semplice per ricevere una risposta diretta. Questo è il nucleo della nostra offerta API AI per sviluppatori. Il modello restituisce testo senza filtri sui contenuti per l'uso adulto legale, rendendolo ideale per attività creative o senza restrizioni.
- ID modello:
uncensored - Endpoint:
POST /v1/chat/completions - Contesto: 100.000 token
Esegui la tua prima richiesta con questo esempio:
curl https://api.onekeyllmapi.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."}]
}'
Integrazione SDK Python
Usa la libreria ufficiale OpenAI Python per interagire con il nostro servizio. Le uniche modifiche necessarie sono base_url e api_key. Questo garantisce che la tua logica esistente funzioni senza modifiche.
- Installa tramite
pip install openai - Imposta le variabili di ambiente o passa direttamente nell'inizializzazione del client
- Chiama
chat.completions.create()come al solito
Configura il client in questo modo:
from openai import OpenAI
client = OpenAI(base_url="https://api.onekeyllmapi.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)
Utilizzo SDK Node.js
Integra i tuoi progetti JavaScript o TypeScript utilizzando il pacchetto Node.js standard di OpenAI. Punta il client al nostro URL e fornisci la tua chiave. Questo approccio mantiene la compatibilità con qualsiasi struttura client compatibile con OpenAI.
- Installa tramite
npm install openai - Inizializza con URL base personalizzato
- Usa i pattern standard async/await
Esempio di inizializzazione:
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.onekeyllmapi.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);
Risposte in streaming
Ricevi le risposte token per token per una latenza percepita inferiore. La nostra API streaming supporta gli eventi inviati dal server (SSE), permettendoti di visualizzare l'output man mano che viene generato. Questo è utile per interfacce chat o applicazioni in tempo reale.
- Imposta
stream: truenella tua richiesta - Analizza lo stream SSE sul client
- Gestisci i token parziali in modo efficiente
Abilita lo streaming nel tuo codice:
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)
Limiti, errori e contesto
Comprendi i vincoli per creare integrazioni robuste. L'API supporta una finestra di contesto da 100k token, consentendo l'elaborazione di documenti lunghi o conversazioni. Le richieste sono limitate a una dimensione del corpo di 8 MB.
Gli errori comuni includono 401 per chiavi non valide, 402 quando il credito prepagato è esaurito e 429 per il superamento di 300 richieste al minuto. Il credito pay-as-you-go non scade mai e puoi ricaricare a partire da $10. La chiamata di funzioni è supportata per l'esecuzione delle funzioni.
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.onekeyllmapi.com/v1 |
| Autenticazione | Authorization: Bearer YOUR_KEY |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| Finestra di contesto | 100.000 token (input + output) |
| Function calling | sì — tools, tool_choice; risposte con tool_calls anche in streaming; risultati come role: tool |
| Modalità JSON | response_format: {"type": "json_object"} |
| Parametri | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Streaming | sì — server-sent events; l'ultimo blocco riporta l'uso dei token |
| Output massimo | fino al resto della finestra di 100.000 token; max_tokens opzionale (nessun limite separato) |
| Dimensione | fino a 8 MB per richiesta |
| Header | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Limite di frequenza | 300 richieste al minuto per chiave |
| Concorrenza | 8 richieste contemporanee per chiave |
| Ricarica | USDT (TRC20) o USDC (Base), qualsiasi importo intero da $10 a $500 |
| Fatturazione | credito prepagato in base all'uso reale; errori e rifiuti gratuiti |
| Scadenza | il credito pagato non scade, nessun abbonamento |
| Bonus | +5% da $50, +10% da $100 |
| Prezzo | $0,25 per 1M token in input · $1,00 per 1M in output |
| 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 |
| Chiavi | una chiave attiva per account; una nuova sostituisce la precedente |
| Accesso | Google oppure e-mail e password |
| Contenuti | contenuti per adulti consentiti; rifiutati i contenuti sessuali con minori |
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
È un modello OpenAI?
No. Serviamo un unico modello linguistico grande dedicato e senza censura, eseguito sui nostri server GPU. Non è GPT, Claude o il modello di nessun altro fornitore, ma è compatibile con la loro struttura API.
Come funziona la tariffazione?
Utilizziamo un modello di pagamento a consumo senza canoni mensili. I token di input costano $0,25 per 1M, e i token di output costano $1,00 per 1M. Il credito prepagato non scade mai e puoi iniziare con un credito di prova da $0,50.
Qual è la dimensione della finestra di contesto?
L'API supporta una finestra di contesto di 100.000 token sia per il prompt che per il completamento. Questo consente conversazioni estese o l'elaborazione di documenti lunghi all'interno di una singola richiesta.
La tua chiave è a un modulo di distanza
Crea un account, copia la chiave, cambia l'URL base. È tutta la configurazione.