Avvio rapido: Connetti il tuo client

Prerequisiti e installazione dell'SDK

Installa l'SDK ufficiale per il tuo linguaggio per gestire autenticazione e serializzazione delle richieste in modo automatico. Hai bisogno di una chiave API valida e dell'URL base configurato nell'ambiente del tuo client. Il nostro servizio accetta parametri standard come temperature e top_p senza richiedere intestazioni personalizzate.

Assicurati che la tua variabile di ambiente contenga il token in modo sicuro prima di eseguire qualsiasi script. Le versioni SDK devono essere aggiornate per supportare correttamente le funzionalità di streaming e JSON mode. Non sono richiesti driver aggiuntivi per la generazione solo di testo.

Configurazione dell'URL Base e della Chiave

Indirizza il tuo client al nostro URL base specifico per instradare le richieste attraverso la nostra infrastruttura uncensored. Utilizza l'intestazione Authorization: Bearer YOUR_KEY per autenticare ogni chiamata. Questa configurazione funziona identicamente per i test locali o per gli script di distribuzione in produzione.

Sostituisci l'endpoint OpenAI predefinito con il nostro host per evitare confusione con altri fornitori. Mantieni la tua chiave segreta e non esporla nei repository pubblici. La configurazione rimane statica fino alla rotazione della chiave.

Invio della tua prima richiesta

Esegui una chiamata standard di completamento chat per verificare la connettività e il formato della risposta. Invia un prompt semplice per confermare che il modello restituisca testo senza rifiuti. Questo test garantisce che la tua chiave abbia credito prepagato sufficiente per l'utilizzo.

Copycurl https://api.keyapiminimax.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a JSON object with keys id and name"}]
  }'

Controlla la risposta per i dettagli sui contenuti e sull'utilizzo dei token. Se ricevi un errore 401, verifica il formato della tua chiave. Un 402 indica che è necessario ricaricare il saldo del credito.

Gestione delle risposte in streaming

Abilita lo streaming per ricevere i token in tempo reale man mano che vengono generati. Questo riduce la latenza percepita per gli utenti in attesa di output lunghi. L'ultimo chunk contiene i conteggi finali dei token per una fatturazione accurata.

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)

Gestisci le risposte parziali con grazia nel codice del client. Memorizza il contenuto in buffer fino alla chiusura dello stream o al verificarsi di un errore. Lo streaming funziona con tutti i parametri standard, incluse le regolazioni della temperatura.

Integrazione SDK Python

Utilizza la libreria Python per gestire le richieste con codice boilerplate minimo. Inizializza il client con il tuo URL base e la chiave per un utilizzo immediato. Questo approccio semplifica la gestione degli errori e l'analisi delle risposte.

Copyfrom openai import OpenAI

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

Accedi al contenuto generato direttamente dall'oggetto di risposta. Controlla la presenza di errori e gestisci i limiti di frequenza in modo appropriato. L'SDK supporta sia flussi di lavoro sincroni che asincroni.

SDK Node e Limiti

Integra con applicazioni Node.js utilizzando l'SDK JavaScript ufficiale. Imposta l'URL di base per garantire che le richieste raggiungano il nostro endpoint senza censure. Monitora il tuo utilizzo per rimanere entro i limiti di velocità.

Copyimport OpenAI from "openai";

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

Puoi effettuare 300 richieste al minuto con una concorrenza di 8. Ogni corpo della richiesta deve rimanere inferiore a 8 MB. La finestra di contesto supporta un totale di 100,000 token. Errori e rifiuti non consumano credito, ma gli output riusciti sì. Mantieni la tua chiave sicura e ruotala se necessario.

Comprendere l'utilizzo dei token

La fatturazione si basa sui token effettivi utilizzati nel prompt e nel completamento. I token di input costano $0.15 per milione, mentre i token di output costano $0.50 per milione. Il credito prepagato copre tutto l'utilizzo senza commissioni mensili.

Errori e rifiuti sono gratuiti, quindi paghi solo per le risposte riuscite. L'ultimo chunk in uno stream contiene il conteggio dei token. Monitora il tuo dashboard per tracciare le spese ed evitare di rimanere senza credito. Ricarica con USDT o USDC per un accesso istantaneo.