Costo dei token di Claude: documentazione compatibile con OpenAI

Impostazione dell'URL di base e autenticazione

Inizia puntando il tuo SDK al nostro URL di base e passando la tua chiave API nell'intestazione di autorizzazione. Richiediamo un'autenticazione semplice basata su intestazioni, quindi non hai bisogno di flussi OAuth complessi o logica di inizializzazione specifica per l'SDK. Crea un account tramite Google o email, quindi recupera istantaneamente la tua chiave dal dashboard. Questa chiave concede l'accesso al singolo modello uncensored identificato come 'uncensored'. Puoi ruotare le chiavi se necessario, ma esiste solo una chiave attiva per account in qualsiasi momento. Assicurati che la tua libreria client sia configurata per inviare correttamente il token Bearer prima di effettuare la tua prima richiesta.

Struttura endpoint Chat completions

Invia richieste POST a /v1/chat/completions con un array messages contenente il tuo prompt e le istruzioni di sistema. L'endpoint accetta payload JSON standard compatibili con OpenAI, consentendoti di integrare il nostro servizio in Cursor, Windsurf o script personalizzati senza riscrivere il codice. Specifica il modello come 'uncensored' per assicurarti di ricevere l'output del nostro LLM uncensored specifico. Puoi controllare la creatività tramite temperature e top_p, oppure forzare risultati deterministici impostando temperature a 0. Le richieste vengono elaborate immediatamente e ti viene addebitato solo per l'utilizzo effettivo dei token. Errori e rifiuti non consumano il tuo credito prepagato.

Risposte in streaming e utilizzo dei token

Abilita lo streaming impostando stream su true nel corpo della richiesta. Questo restituisce Server-Sent Events (SSE) che aggiornano la tua UI in tempo reale man mano che i token vengono generati. L'ultimo chunk dello stream contiene l'utilizzo totale dei token per la richiesta, consentendoti di tracciare i costi con precisione senza interrogare un endpoint di utilizzo separato. Lo streaming è ideale per finestre di contesto lunghe fino a 100,000 token. Puoi analizzare gli chunk di contenuto delta per visualizzare il testo mentre appare. Questo approccio riduce la latenza percepita per gli utenti in attesa di ragionamenti complessi o output di lunga forma.

Function calling e modalità JSON

Utilizza il parametro tools per definire gli schemi delle funzioni per il function calling, oppure imposta response_format su json_object per output JSON rigorosi. Il modello supporta sia l'estrazione di dati strutturati che l'esecuzione dinamica di strumenti nella stessa finestra di contesto. Puoi definire più strumenti in una singola richiesta e il modello restituirà chiamate agli strumenti o risposte di testo diretto come necessario. Questa flessibilità rende l'API adatta per costruire agenti o automatizzare flussi di lavoro. Assicurati che le definizioni delle funzioni seguano il formato OpenAI per garantire la compatibilità con i client standard.

Regole sui limiti di frequenza e sulla concorrenza

Ogni chiave API consente 300 richieste al minuto e fino a 8 richieste concorrenti simultanee. La dimensione massima del corpo della richiesta è di 8 MB, il che limita la quantità di dati che puoi inviare in un singolo prompt. Se superi questi limiti, riceverai un codice di stato 429 che indica che hai raggiunto il limite di velocità. Puoi monitorare il tuo utilizzo tramite la risposta in streaming o l'endpoint /v1/models. Questi limiti garantiscono prestazioni stabili per tutti gli utenti. Pianifica l'elaborazione batch di conseguenza per evitare limitazioni durante i periodi di picco.

Gestione degli errori e rimborsi

Gestisci gli errori HTTP 401 verificando che la tua chiave API sia corretta e attiva. Un errore 402 indica un credito prepagato insufficiente, che richiede una ricarica prima di ulteriori richieste. Non vengono emessi rimborsi per il credito consumato, ma gli errori come le doppie addebitazioni vengono risolti tramite la pagina Supporto. Gli errori durante l'elaborazione non deducono token dal tuo saldo. Il modello rifiuta i contenuti che coinvolgono minori ma consente altri temi adulti legali. Controlla regolarmente il saldo del tuo account per evitare interruzioni impreviste nel tuo flusso di lavoro.

cURL

Copycurl https://api.claudetokenpricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "calculate the cost for 100k tokens"}]
  }'

Python

Copyfrom openai import OpenAI

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

Streaming

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)