IT ▾

speechtotextapis.comLLM senza censura per pipeline di post-elaborazione del testo

Speech To Text API
Ottieni la chiave API

Chiave API compatibile con OpenAI: Ottienila e invia una richiesta

Una chiave API compatibile con OpenAI è un normale token bearer che funziona con qualsiasi SDK OpenAI una volta puntato il client a un base URL diverso. Questa pagina mostra come ottenerla per l'API di testo ospitata su questo sito e fare una chiamata funzionante in pochi minuti.

AggiornatoSpeech To Text API

Una chiave luminosa che collega una finestra del terminale a un server, illustrante una chiave API per un'API di testo compatibile

Cosa è effettivamente la chiave

"Compatibile con OpenAI" descrive la forma dell'API HTTP, non l'azienda dietro di essa. Il servizio accetta lo stesso corpo JSON su POST /v1/chat/completions che inviano gli SDK OpenAI, e legge la stessa intestazione Authorization: Bearer. Grazie a ciò, una chiave di questo servizio si inserisce in qualsiasi strumento che ti permetta di impostare un base URL e una chiave API personalizzati: le librerie ufficiali Python e Node, LangChain, curl puro e la maggior parte dei client desktop.

La chiave non è una chiave OpenAI e non funzionerà su api.openai.com. Il contrario è anche vero: una chiave OpenAI non funzionerà qui. Ogni chiave appartiene a un servizio, e questo esegue un singolo modello a pesi aperti, ottimizzato per rispondere senza filtri sui contenuti per uso adulto legale, ospitato da un provider indipendente. Non è l'API ufficiale di alcun fornitore di modelli e non instrada verso altri fornitori.

Ecco cosa devi ricordare. L'URL di base per questo sito è https://api.speechtotextapis.com/v1. L'ID del modello è uncensored. La chiave è qualsiasi stringa che ottieni dopo la registrazione. Tutto quanto segue è una variazione di questi tre valori.

Il servizio è solo per il testo. Gestisce chat completamenti, streaming, chiamata di funzioni e modalità JSON. Non genera immagini o audio, non offre embedding e non effettua il fine-tuning dei modelli. Se sei arrivato qui da una pipeline vocale, il compito tipico è il passaggio di testo dopo la trascrizione: pulizia di una trascrizione, suddivisione in scene, riscrittura del dialogo o estrazione di dati strutturati. La guida elaborazione script vocali tratta questo aspetto in maggiore dettaglio.

Ottieni la tua chiave in quattro passaggi

  1. Registrati. Usa Google, o registrati con un indirizzo email e una password.
  2. Apri la pagina della chiave API. Si trova alla pagina della chiave su questo sito. La tua chiave viene creata e mostrata lì.
  3. Richiedi il credito di prova. Un pulsante nella stessa pagina ti offre $0,50 di credito di prova con un clic. È uno per persona, valido per 7 giorni e non richiede carta.
  4. Copia la chiave in un archivio segreto. Una variabile d'ambiente è sufficiente per un test locale. Per qualsiasi deployment, usa il gestore di segreti del tuo host.

La prova serve a dimostrare che l'integrazione funziona prima di pagare qualsiasi cosa. Al prezzo corrente è sufficiente per molte richieste brevi, e la sezione sui costi più in basso mostra i calcoli. Quando sei pronto a continuare, la pagina dei prezzi elenca gli importi di ricarica. Il credito è prepagato, non c'è abbonamento e il credito non scade mai, quindi non c'è pressione di spendere una ricarica prima di una scadenza.

Le chiavi di prova sono limitate più rigorosamente rispetto alle chiavi complete: 2 richieste concorrenti e 60 richieste al minuto. È più che sufficiente per un primo script. Se prevedi di distribuire in parallelo decine di chunk di trascrizione, aspettati di raggiungere il limite fino al passaggio a un account finanziato.

Le tre impostazioni richieste da ogni client

Qualunque software tu usi, la schermata di configurazione chiede le stesse tre cose con nomi leggermente diversi.

ImpostazioneNome di campo tipicoValore
EndpointBase URL, API base, hosthttps://api.speechtotextapis.com/v1
CredenzialeChiave API, token, segretoLa tua chiave dalla pagina della chiave
ModelloModello, nome del modello, motoreuncensored

Un dettaglio confonde le persone: il base URL termina già con /v1. Gli SDK aggiungono /chat/completions da soli, quindi non dovresti aggiungerlo. Se il tuo client chiede l'URL completo dell'endpoint chat invece di un base, il valore è https://api.speechtotextapis.com/v1/chat/completions.

Se uno strumento offre solo un preset "OpenAI" con un host hardcoded e nessun modo per modificarlo, non può comunicare con questo servizio. Cerca un'opzione "custom", "compatibile con OpenAI" o "avanzata" che esponga il campo del base URL.

La tua prima richiesta

Inizia con curl, perché rimuove ogni strato tra te e l'API. Sostituisci YOUR_KEY con la chiave che hai copiato.

curl https://api.speechtotextapis.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
      {"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"}
    ]
  }'

Una risposta riuscita è un oggetto JSON con un array choices. Il testo è in choices[0].message.content, e un blocco usage segnala i token per cui sei stato addebitato.

La stessa chiamata con la libreria ufficiale Python appare così. Solo base_url e api_key differiscono da una configurazione OpenAI standard.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.speechtotextapis.com/v1",
    api_key=os.environ["API_KEY"],
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
        {"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"},
    ],
)
print(resp.choices[0].message.content)

E in Node, usando lo stesso pacchetto:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.speechtotextapis.com/v1",
  apiKey: process.env.API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [
    { role: "user", content: "Rewrite this in plain English: the beta shipped on Tuesday." },
  ],
});
console.log(resp.choices[0].message.content);

Non hai bisogno di impostare max_tokens. Quando è omesso, il completion può usare tutto ciò che rimane della finestra da 100.000 token dopo il tuo prompt. Impostalo tu stesso se vuoi un limite rigido al costo per chiamata.

Verifica che la chiave funzioni senza spendere token

Prima di collegare una chiave a un sistema più grande, fai una chiamata economica all'endpoint dei modelli. Conferma che la chiave sia accettata e che il base URL sia corretto.

curl -i https://api.speechtotextapis.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

Il flag -i stampa le intestazioni di risposta, dove questa API segnala lo stato utile:

  • X-Request-Id identifica la richiesta. Includilo se contatti support per una chiamata specifica.
  • X-Balance-USD mostra il credito rimanente sull'account.
  • X-RateLimit-Limit-Requests e X-RateLimit-Limit-Concurrency mostrano i limiti applicabili alla tua chiave, così puoi vedere a colpo d'occhio se la chiave ha limiti di prova o completi.

Leggere X-Balance-USD nel tuo codice è un modo economico per avvisarti prima che il credito si esaurisca. Registrane il log una volta per lavoro invece che una volta per richiesta se non vuoi output rumoroso.

Quanto costa usare una chiave

Avere una chiave non costa nulla. Paghi per i token: $0.15 per 1M di token di input e $0.50 per 1M di token di output, prelevati dal credito prepagato. Le richieste fallite o rifiutate non vengono addebitate.

Un esempio pratico con la chiamata di pulizia della trascrizione sopra. Supponi che un prompt sia di 1.000 token e la risposta pulita sia di 500 token.

  • Input: 1.000 / 1.000.000 x $0,15 = $0,00015
  • Output: 500 / 1.000.000 × $0,50 = $0,00025
  • Totale: $0.0004 per chiamata

Il credito di prova di $0.50 copre quindi circa 1.250 chiamate di questa dimensione ($0.50 / $0.0004). I tuoi numeri effettivi varieranno, perché le trascrizioni variano in lunghezza, ma il metodo è lo stesso: conta i token in ingresso, conta i token in uscita, moltiplica.

Quando ricarichi, è accettato qualsiasi importo intero da $20 a $500. Ricarichi più elevati comportano un bonus: +5% da $50, +10% da $100 e +15% da $200. Una ricarica di $100, ad esempio, ti dà $110 di credito. Puoi pagare con cripto (USDT su TRC20, USDC su Base).

Mantenere la chiave sicura

Una chiave API è una password per il tuo saldo. Chiunque la abbia può spendere il tuo credito, quindi trattala come tale.

  • Tienila fuori dal controllo del codice sorgente. Leggila da una variabile d'ambiente o da un gestore di segreti.
  • Non includerlo nel JavaScript del browser o nel bundle di un'app mobile. Tutto ciò che viene eseguito sul dispositivo dell'utente può essere ispezionato. Inserisci un piccolo server tra il tuo front-end e l'API e lascia che il server aggiunga l'intestazione.
  • Non incollarlo in screenshot, ticket o messaggi di chat.
  • Se pensi che una chiave sia stata compromessa, smetti di usarla e contatta subito il supporto invece di aspettare di vedere cosa succede.

Sulla privacy: i prompt inviati all'API non vengono utilizzati per l'addestramento. Questa è un'affermazione sul servizio, non un motivo per inviare segreti che non devi inviare. Rimuovi i dati personali dalle trascrizioni quando il compito non lo richiede.

Quando una chiamata fallisce

La maggior parte dei problemi del primo giorno deriva da una di queste quattro cause.

L'URL di base è errato

I due soliti errori sono un /v1 mancante e un /chat/completions doppio. Confronta il tuo valore carattere per carattere con quello nella tabella sopra.

La chiave contiene un carattere estraneo

La copia da una pagina spesso porta con sé uno spazio o un a capo finale. Pulisci il valore nel tuo codice e controlla che l'intestazione legga Bearer, uno spazio, poi la chiave.

Il nome del modello non è uncensored

I client spesso impostano come predefinito un altro nome di modello. Imposta esplicitamente il modello in ogni chiamata.

HTTP 429

Esistono due varianti e il codice di errore le distingue. rate_limited significa che hai inviato troppe richieste al minuto. concurrency significa che erano troppe in corso contemporaneamente. Una richiesta in streaming mantiene la sua slot di concorrenza fino alla fine dello streaming, quindi un client lento può causare questo errore anche con un basso tasso di richieste. Un 429 con l'intestazione Retry-After: 5 significa che il servizio è brevemente sovraccarico; attendi cinque secondi e riprova. Un breve backoff esponenziale nel tuo client gestisce tutti e tre i casi.

Per l'elenco completo dei parametri, il formato di streaming e i dettagli sulla chiamata di funzioni, consulta la documentazione API.

Domande e risposte

È la stessa chiave di OpenAI?

No. Segue lo stesso formato di richiesta, quindi gli SDK OpenAI funzionano con essa, ma è emessa da questo servizio e funziona solo con l'URL di base di questo servizio.

Serve una carta di credito per ottenere una chiave?

No. Iscriviti con Google o email, poi richiedi il credito di prova da $0,50 con un clic nella pagina della chiave. La prova non richiede una carta ed è valida per 7 giorni.

Quale nome del modello devo usare?

Usa uncensored nel campo del modello. Una chiamata a GET /v1/models elencherà a cosa può accedere la chiave.

Posso usare la stessa chiave da più server?

Sì, ma i limiti si applicano alla chiave nel suo complesso: 8 richieste parallele e 300 richieste al minuto su una chiave completa, 2 e 60 su una chiave di prova.

La chiave funziona per immagini o audio?

No. L'API è solo testo. Non genera né trascrive audio o immagini, e non ha embedding né fine-tuning.

La tua chiave è a un modulo di distanza

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

Ottieni chiave APILeggi la documentazione