Apertus ia API Documentation
Collega i tuoi strumenti esistenti a IA senza censura con una singola chiave API e l'endpoint standard compatibile con OpenAI.
1. Quickstart: Connect Your First Request
L'URL di base è https://api.apertusia.com/v1. Inserisci la tua chiave API nell'intestazione Authorization. L'identificativo del modello è uncensored. Questa configurazione funziona con qualsiasi client compatibile con OpenAI.
Usa questo comando cURL per testare immediatamente la connettività. Sostituisci YOUR_API_KEY con la tua chiave effettiva.
curl https://api.apertusia.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top 5 python libraries for web scraping"}]
}'Gli errori di autenticazione restituiscono 401. I fondi insufficienti restituiscono 402. I limiti di frequenza restituiscono 429.
2. Parametri supportati: Temperatura, Top P e Seed
Controlla la casualità con temperature, la diversità con top_p e la riproducibilità con seed. Questi parametri seguono le convenzioni standard di OpenAI. Imposta temperature a 0.7 per un output bilanciato o 1.0 per una maggiore creatività. Usa top_p per limitare il campionamento alla massa di probabilità più alta. Il parametro seed garantisce output identici per il debug.
Esempio di frammento Python per test locali:
from openai import OpenAI
client = OpenAI(base_url="https://api.apertusia.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)
3. Risposte in streaming con eventi inviati dal server
Abilita lo streaming impostando stream: true. L'API restituisce chunk tramite Server-Sent Events. Ogni chunk contiene testo parziale e dati sull'utilizzo dei token. Questo riduce la latenza percepita per le risposte lunghe. Gestisci gli eventi SSE per aggiornare la tua UI in tempo reale.
Esempio Node.js che utilizza l'SDK ufficiale:
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.apertusia.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);
4. Configurazione del Function Calling e della modalità JSON
Usa response_format con {"type": "json_object"} per un output JSON rigoroso. Questo garantisce dati strutturati per pipeline programmatiche. Abilita la chiamata di funzioni fornendo un array tools nel corpo della richiesta. Il modello restituirà le chiamate agli strumenti nel formato previsto. Usa tool_choice per forzare un comportamento specifico.
5. Limiti di velocità e vincoli sulle dimensioni delle richieste
Ogni chiave API supporta 300 richieste al minuto. Le richieste concorrenti sono limitate a 8 per chiave. La dimensione massima del corpo della richiesta è 8 MB. La finestra di contesto contiene 100,000 token in totale. L'output massimo per richiesta è fino all'intera finestra da 100,000 token. Lascia max_tokens non impostato, oppure impostalo su un valore elevato, per evitare la troncatura. Gli errori non consumano credito. Non vengono emessi rimborsi, ma gli errori di fatturazione vengono corretti tramite Supporto.
6. Autenticazione e gestione degli errori
Genera la tua chiave tramite la dashboard. Accedi con Google o email. La chiave viene visualizzata immediatamente. Includila nell'intestazione Authorization: Bearer. Le chiavi non valide restituiscono 401. Gli errori 429 indicano l'esaurimento del limite di frequenza. Gli errori 402 significano che il tuo credito prepagato è esaurito. Aggiungi fondi con USDT o USDC. I crediti non scadono mai.
Streaming
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)Common queries
What is the uncensored ia model context window?
Il modello supporta una finestra di contesto di 100,000 token. Questo include sia il prompt che il completamento. Non c'è un limite separato per l'output: una risposta può utilizzare tutto lo spazio rimasto nella finestra.
How do I handle streaming responses in Python?
Imposta il parametro <code>stream</code> su <code>true</code> nella tua richiesta. Itera sull'oggetto di risposta per elaborare ogni chunk. Usa l'SDK ufficiale per l'analisi automatica di SSE.
What happens if I hit the rate limit?
L'API restituisce un codice di stato 429. È possibile riprovare dopo una breve attesa. Ogni chiave consente 300 richieste al minuto. Aumenta la concorrenza generando ulteriori chiavi se necessario.
Ottieni la tua chiave ora
Registrati, ottieni la chiave, punta al nostro endpoint. Fatto.