IT ▾
Ottieni la chiave API

API stile OpenAI con cURL e token Bearer

Per chiamare un'API stile OpenAI da riga di comando invii una POST HTTP con un header Authorization che trasporta il tuo token. Questa pagina fornisce comandi cURL funzionanti per ogni funzionalità dell'API e i controlli da eseguire in caso di errore.

Aggiornato

Finestra del terminale che invia una chiave dorata e pacchetti dati lungo un nastro luminoso a un server

Punti chiave

  • Il token va nell'header Authorization: Bearer YOUR_KEY, e l'ID del modello è uncensored.
  • Esistono due endpoint: GET /v1/models e POST /v1/chat/completions.
  • Aggiungi -N e stream true per vedere i token arrivare tramite eventi inviati dal server.
  • Leggi X-Balance-USD e gli header del limite di richieste con curl -i; un 429 indica di aspettare e riprovare.

La richiesta minima

Ecco il modo più breve per eseguire open ai api curl con token contro questo servizio. Inserisci la chiave in una variabile d'ambiente così non finisce nella cronologia della shell, poi invia un messaggio di chat:

export UF_KEY="paste-your-key-here"

curl https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Explain what a bearer token is in two sentences."}
    ]
  }'

La risposta è in formato JSON con la struttura di completamento chat OpenAI. La risposta si trova in choices[0].message.content, e un oggetto usage riporta i token prompt e di completamento. Ogni parte del comando ha un compito:

  • Authorization: Bearer ... trasporta il token. "Bearer" è il nome dello schema; chi possiede il token è trattato come il suo proprietario, motivo per cui lo tieni fuori dai repository pubblici.
  • Content-Type: application/json dice al server come leggere il corpo. Senza di esso, la richiesta spesso fallisce con un errore di analisi del corpo.
  • model deve essere uncensored, l'unico modello servito da questa API.
  • messages è un elenco di oggetti con un role (system, user, assistant o tool) e content.

Per ottenere una chiave, registrati con Google o email e password, poi usa la pagina delle chiavi API. I nuovi utenti possono richiedere $0,50 di credito di prova con un clic: nessuna carta, valido per 7 giorni, uno a persona.

Verifica la chiave con GET /v1/models

Prima di eseguire il debug di una richiesta di lunga durata, verifica che il token funzioni con la chiamata più economica disponibile. L'elenco dei modelli non costa nulla e mostra se l'URL, l'intestazione e la chiave sono tutti corretti.

curl -s https://api.unfilteredaimodels.com/v1/models \
  -H "Authorization: Bearer $UF_KEY"

Una buona risposta è un elenco JSON che include uncensored. Se hai jq installato, passa l'output in pipe per estrarre solo gli ID:

curl -s https://api.unfilteredaimodels.com/v1/models \
  -H "Authorization: Bearer $UF_KEY" | jq -r '.data[].id'

Se non torna nulla di utile, procedi attraverso l'elenco qui sotto in ordine, perché le cause sono elencate in base alla frequenza:

  1. La variabile è vuota. Esegui echo "${UF_KEY:0:6}" per vedere i primi caratteri senza stampare l'intera chiave.
  2. L'header è scritto male o manca "Bearer" prima della chiave.
  3. Le virgolette curve da un documento o client chat hanno sostituito le virgolette dritte nel comando.
  4. L'URL base è errato. È https://api.unfilteredaimodels.com/v1, con api. davanti e /v1 alla fine.
  5. La chiave è stata copiata con uno spazio o a capo finale.

Leggi gli header di risposta

Aggiungi -i per includere gli header nell'output, o -D - per stamparli mantenendo pulito il corpo:

curl -s -D - -o /dev/null \
  https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"ping"}]}'

Quattro header di risposta vale la pena conoscere:

IntestazioneSignificato
X-Request-IdIdentificatore di questa richiesta. Citale se contatti il supporto.
X-Balance-USDIl tuo credito prepagato residuo.
X-RateLimit-Limit-RequestsRichieste al minuto consentite per la tua chiave.
X-RateLimit-Limit-ConcurrencyRichieste simultanee consentite per la tua chiave.

I limiti sono 300 richieste al minuto e 8 richieste concorrenti per una chiave completa, e 60 al minuto e 2 concorrenti per una chiave di prova. La richiesta sopra imposta max_tokens a 5 solo per mantenere il test piccolo. Nell'uso normale max_tokens è facoltativo e il completamento può usare tutto ciò che rimane della finestra da 100.000 token dopo il tuo prompt.

Streaming dalla riga di comando

Imposta "stream": true e aggiungi -N così curl non bufferizza l'output. Vedrai righe che iniziano con data:, ciascuna con un piccolo delta JSON, e un finale data: [DONE]. Il chunk prima include l'uso del token.

curl -N https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "stream": true,
    "messages": [{"role": "user", "content": "Write a four-line poem about a cron job."}]
  }'

Per stampare solo il testo, filtra lo streaming con una breve pipe:

curl -sN https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","stream":true,"messages":[{"role":"user","content":"Count to five."}]}' \
  | sed -u 's/^data: //' | grep -v '^\[DONE\]' | grep -v '^$' \
  | jq -rj '.choices[0].delta.content // empty'
echo

Una richiesta in streaming mantiene la sua slot di concorrenza fino alla fine dello streaming. Se avvii molti stream in parallelo da uno script e dimentichi di farli terminare, raggiungerai il limite di concorrenza anche se il tasso di richieste è basso.

Modalità JSON e chiamate di funzioni

La modalità JSON fa sì che il modello restituisca un singolo oggetto JSON valido. Indica anche la forma desiderata nel prompt, altrimenti le chiavi saranno quelle scelte dal modello.

curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "response_format": {"type": "json_object"},
    "messages": [
      {"role": "user", "content": "Return JSON with keys city and country for the capital of Portugal."}
    ]
  }' | jq -r '.choices[0].message.content'

La chiamata di funzioni usa i campi standard tools e tool_choice. Il modello risponde con un array tool_calls invece che testo; esegui la funzione tu stesso e invia il risultato come messaggio con role: "tool" e il corrispondente tool_call_id.

curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "tool_choice": "auto",
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get current weather for a city",
        "parameters": {
          "type": "object",
          "properties": {"city": {"type": "string"}},
          "required": ["city"]
        }
      }
    }],
    "messages": [{"role": "user", "content": "What is the weather in Lisbon?"}]
  }'

Nella risposta, cerca choices[0].message.tool_calls[0].function.arguments. È una stringa JSON che analizzi, chiami la tua funzione meteo personale e restituisci nella richiesta successiva. Parametri come temperature, top_p, stop, seed e le penalità vengono passati. La documentazione elenca tutti i campi supportati.

Tieni al sicuro il token e mantieni i comandi ordinati

Un token bearer è una password con un nome diverso. Chiunque lo abbia può spendere il tuo credito, quindi trattalo con la stessa cura. Non incollare mai una chiave reale in una issue pubblica, uno screenshot o un log del terminale condiviso. Se sospetti che una chiave sia trapelata, sostituila dalla pagina delle chiavi e aggiorna i tuoi script.

La cronologia della shell è la perdita più comune su una macchina personale. Digitare la chiave direttamente in un comando la memorizza nel file di cronologia. Impostarla una volta con export memorizza comunque quella riga. Due abitudini più pulite aiutano. Leggi la chiave da un file che solo tu puoi aprire, oppure precedi il comando con uno spazio se la tua shell è impostata per ignorare le righe che iniziano con uno spazio. Un piccolo file funziona bene:

mkdir -p ~/.config/uf
printf '%s' 'paste-your-key-here' > ~/.config/uf/key
chmod 600 ~/.config/uf/key

export UF_KEY="$(cat ~/.config/uf/key)"

Corpi JSON lunghi sono difficili da leggere tra virgolette singole, e le virgolette si rompono non appena il prompt contiene un apostrofo. Metti il corpo in un file e lascia che curl lo legga con -d @file:

cat > request.json <<'JSON'
{
  "model": "uncensored",
  "temperature": 0.3,
  "messages": [
    {"role": "system", "content": "You answer in plain language."},
    {"role": "user", "content": "What's the difference between a 401 and a 403 status code?"}
  ]
}
JSON

curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json | jq -r '.choices[0].message.content'

Lo stesso approccio mantiene gestibili i prompt di grandi dimensioni entro il limite del corpo di 8 MB, e un file può essere versionato in git mentre la chiave rimane fuori dal repository. Su Windows PowerShell, le virgolette singole attorno al JSON si comportano in modo diverso e la continuazione della riga con backslash non esiste; la forma -d @request.json evita entrambi i problemi e puoi usare un backtick alla fine di una riga per continuare un comando.

Quando hai finito di testare, passa a un SDK. Le librerie Python e Node di OpenAI accettano lo stesso URL base e chiave, gestiscono per te i retry e lo streaming, e leggono lo stesso formato di risposta che hai analizzato manualmente qui. I comandi cURL rimangono il modo più veloce per verificare se un errore deriva dal tuo codice o dalla richiesta stessa, quindi tieni un comando funzionante noto nelle tue note. Quando segnali un problema al supporto, includi l'X-Request-Id della chiamata fallita e il codice di stato esatto; quella coppia permette a qualcuno di trovare la richiesta senza chiederti di ripetere il test e risparmia un giro di andata e ritorno.

Errori, retry e costo per chiamata

Quando superi un limite, l'API risponde HTTP 429. Il codice di errore ti dice quale limite: rate_limited indica troppe richieste al minuto, concurrency indica troppe richieste simultanee. Un sovraccarico temporaneo restituisce anche 429 e aggiunge Retry-After: 5. Curl può fare retry da solo per errori transitori:

curl --retry 3 --retry-delay 5 --retry-all-errors \
  https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Hello"}]}'

Tieni anche il corpo sotto gli 8 MB, il che conta se pubblichi file codificati nel prompt.

Le richieste fallite o rifiutate non vengono addebitate. Quelle riuscite seguono una formula semplice: $0,15 per 1M di token di input e $0,50 per 1M di token di output. Una chiamata di test con 40 token di input e 120 token di output costa 40 / 1.000.000 x $0,15 = $0,000006 più 120 / 1.000.000 x $0,50 = $0,00006, quindi $0,000066 in totale. Un migliaio di esse ammontano a $0,066.

Il credito è prepagato e non scade mai. Le ricariche vanno da $20 a $500 in importi interi, con un bonus del 5% da $50, 10% da $100 e 15% da $200, con cripto (USDT su TRC20, USDC su Base). La pagina dei prezzi mostra i dettagli. Se una risposta sembra errata, la pagina miti e fatti spiega cosa fa e cosa non fa il modello.

Domande e risposte

La tua chiave è a un modulo di distanza

Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.

Dove va il token in un comando cURL?
    In un header: -H "Authorization: Bearer YOUR_KEY". Il corpo della richiesta richiede anche l'header Content-Type: application/json.
Quale nome di modello devo usare?
    Usa uncensored. Puoi confermarlo con GET /v1/models.
Perché ottengo 429?
    Hai superato un limite. Il codice rate_limited indica troppe richieste al minuto, concurrency indica troppe richieste simultanee. Attendi qualche secondo o riduci il numero di richieste parallele.
Come vedo il credito residuo?
    Ogni risposta include un header X-Balance-USD. Stampa gli header con curl -i o curl -D -.
Questa è l'API ufficiale di OpenAI?
    No. È un servizio indipendente compatibile con OpenAI che esegue un modello a pesi aperti, quindi gli SDK e i comandi cURL creati per il formato OpenAI funzionano dopo aver modificato l'URL di base e la chiave.