Avvio Rapido Integrazione API Character

Installa l'SDK

Inizia installando la libreria client ufficiale per il tuo linguaggio. Questo garantisce la compatibilità con l'endpoint compatibile con OpenAI che forniamo. La libreria si occupa della serializzazione e della logica di retry per te.

Per Python, usa pip. Per Node.js, usa npm. Questo passaggio richiede pochi secondi e configura l'ambiente per i campioni di codice che seguono.

Configura il tuo URL di base

Indirizza il client SDK al nostro endpoint per accedere al modello senza filtri. L'URL di base è HTTPS://api.apicharacter.com/v1. Questo sostituisce l'URL predefinito di OpenAI nella tua configurazione.

Senza questa modifica, le richieste falliranno o colpiranno il servizio sbagliato. Devi impostarlo solo una volta quando inizializzi l'istanza del tuo client.

Imposta la tua Chiave API

Inietta la tua chiave nella variabile d'ambiente o nella configurazione del client. L'autenticazione è richiesta per ogni richiesta per tracciare l'utilizzo del tuo credito prepagato. La tua chiave concede accesso all'endpoint LLM uncensored.

Mantieni questo valore sicuro. Agisce come tua unica credenziale per l'account. Non è necessario alcun numero di telefono o verifica aggiuntiva per l'accesso di base.

Effettua la tua prima richiesta

Invia un semplice completamento chat per verificare la connettività. L'ID del modello è "uncensored". Questo conferma che la tua autenticazione e l'URL di base sono corretti prima di costruire la tua applicazione.

Vedi l'esempio qui sotto per una richiesta cURL standard.

Copycurl https://api.apicharacter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "set my name to Alex"}]
  }'

Gestisci le risposte in streaming

Abilita lo streaming per una latenza inferiore nelle tue interfacce chat. Imposta il parametro stream su true nella tua richiesta. L'SDK restituirà i token man mano che vengono generati.

Questo è fondamentale per le esperienze utente reattive. Gestisci i chunk parziali man mano che arrivano tramite Server-Sent Events.

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 Contesto

Comprendere i tuoi vincoli per evitare interruzioni del servizio. Hai a disposizione una finestra di contesto di 100.000 token. L'output massimo è di 16.000 token a meno che non specifichi diversamente.

Il limite di frequenza è di 300 richieste al minuto. Un errore 401 indica una chiave non valida. Un errore 402 indica credito zero. Un errore 429 indica che hai superato il limite di frequenza. Tieni presente questi aspetti per la scalatura in produzione.

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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