Guida rapida API Embeddings

Autenticazione

Accedi all'API utilizzando una chiave API unica generata dal tuo cruscotto account. Inserisci questa chiave nell'intestazione Authorization di ogni richiesta utilizzando lo schema Bearer. L'URL di base per tutti gli endpoint è https://api.embeddingapis.com/v1. Questo URL funziona con gli SDK ufficiali OpenAI e qualsiasi client configurato per servizi compatibili con OpenAI. Assicurati di mantenere la chiave al sicuro, poiché garantisce l'accesso ai tuoi crediti prepagati.

Ogni account è limitato a una chiave attiva, che può essere rigenerata in qualsiasi momento. La rigenerazione della chiave revoca immediatamente quella precedente, quindi aggiorna la tua configurazione tempestivamente.

L'endpoint Chat Completions

Invia prompt di testo all'endpoint POST /v1/chat/completions. L'API serve un singolo modello senza censura identificato dall'ID uncensored. Questo modello è un LLM a pesi aperti ottimizzato per rispondere senza rifiuti sui contenuti per argomenti adulti leciti, di fantasia o di ricerca sulla sicurezza. Elabora testo in input ed emette testo, rendendolo ideale per fasi di post-elaborazione, riassunto o estrazione nella tua pipeline.

Struttura la tua richiesta con un array messages contenente i tuoi prompt di sistema e utente. L'API restituisce una risposta JSON contenente il testo generato.

Copycurl https://api.embeddingapis.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 l'API. Imposta base_url sul nostro endpoint e fornisci la tua chiave API. Questo approccio ti permette di sfruttare il codice client esistente con modifiche minime. Il client gestisce la serializzazione e le richieste di rete, restituendo risposte strutturate che puoi analizzare per la logica della tua applicazione.

Assicurati di utilizzare una versione recente dell'SDK per supportare tutte le funzionalità, incluso lo streaming e la chiamata di funzioni. L'ID del modello rimane uncensored quando si invocano le completions.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.embeddingapis.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)

Integrazione SDK Node.js

Per ambienti JavaScript o TypeScript, usa l'SDK Node.js OpenAI. Configura il client con l'URL di base corretto e la chiave API. Questa configurazione garantisce la compatibilità con le tue pipeline Node esistenti. L'SDK gestisce la connessione all'endpoint POST /v1/chat/completions, permettendoti di inviare prompt e ricevere completamenti di testo in modo efficiente.

Questa integrazione è adatta per l'elaborazione del testo lato server, come la generazione di didascalie, script o l'estrazione di dati da grandi blocchi di testo.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.embeddingapis.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

Per applicazioni a bassa latenza, abilita lo streaming impostando stream: true nella tua richiesta. L'API restituisce uno stream Server-Sent Events (SSE), consegnando i token man mano che vengono generati. Questo è particolarmente utile per interfacce utente in tempo reale o quando si elaborano testi lunghi dove il feedback immediato è prezioso.

Analizza lo stream SSE per gestire le risposte parziali. Il modello senza censura supporta questa modalità, permettendoti di reagire ai contenuti man mano che vengono prodotti senza attendere il completamento intero.

Copystream = 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 finestra di contesto

La finestra di contesto supporta 100.000 token per prompt e completazione combinati. Le richieste che superano il limite del corpo di 8 MB o il limite di richieste di 300 richieste al minuto falliranno. Gli errori di autenticazione restituiscono uno stato 401 se la chiave non è valida. Quando il credito prepagato è esaurito, le richieste falliscono perché non rimangono crediti per coprire l'utilizzo dei token. Uno stato 429 indica l'esaurimento del limite di richieste.

Si applica sempre un limite rigido sui contenuti: le richieste contenenti contenuti sessuali che coinvolgono minori sono bloccate, indipendentemente dalle altre impostazioni. Tutti gli altri contenuti adulti leciti vengono elaborati senza rifiuti.