Chave de API compatível com OpenAI: Obtenha uma e envie uma chamada
Uma chave de API compatível com OpenAI é um token bearer normal que funciona com qualquer SDK OpenAI assim que você aponta o cliente para uma URL base diferente. Esta página mostra como obter uma para a API de texto hospedada neste site e fazer uma chamada funcional em poucos minutos.
AtualizadoSpeech To Text API

O que a chave realmente é
"Compatível com OpenAI" descreve a forma da API HTTP, não a empresa por trás dela. O serviço aceita o mesmo corpo JSON em POST /v1/chat/completions que os SDKs OpenAI enviam, e lê o mesmo cabeçalho Authorization: Bearer. Por causa disso, uma chave deste serviço se encaixa em qualquer ferramenta que permita definir uma URL base e chave de API personalizadas: as bibliotecas oficiais Python e Node, LangChain, curl puro e a maioria dos clientes de chat de desktop.
A chave não é uma chave OpenAI, e não funcionará em api.openai.com. O inverso também é verdadeiro: uma chave OpenAI não funcionará aqui. Cada chave pertence a um serviço, e este executa um único modelo de pesos abertos, ajustado para responder sem recusas de conteúdo para uso adulto legal, hospedado por um provedor independente. Não é a API oficial de nenhum fornecedor de modelo e não encaminha para outros fornecedores.
Aqui está o que você precisa lembrar. A URL base para este site é https://api.speechtotextapis.com/v1. O ID do modelo é uncensored. A chave é qualquer string que você obtiver após o cadastro. Tudo abaixo é uma variação desses três valores.
O serviço é apenas de texto. Lida com conclusões de chat, streaming, chamada de funções e modo JSON. Não gera imagens ou áudio, não oferece embeddings e não ajusta modelos. Se você veio de um pipeline de voz, o trabalho típico é a etapa de texto após a transcrição: limpar uma transcrição, dividi-la em cenas, reescrever diálogos ou extrair dados estruturados. O guia de processamento de roteiro de voz cobre esse lado com mais detalhes.
Obtenha sua chave em quatro etapas
- Cadastre-se. Use Google, ou registre-se com um endereço de e-mail e uma senha.
- Abra a página da chave de API. Ela está localizada na página da chave neste site. Sua chave é criada e exibida lá.
- Resgate o crédito de teste. Um botão na mesma página oferece $0,50 de crédito de teste com um clique. É um por pessoa, válido por 7 dias, e não precisa de cartão.
- Copie a chave para um armazenamento de segredos. Uma variável de ambiente é suficiente para um teste local. Para qualquer coisa implantada, use o gerenciador de segredos do seu host.
O teste serve para provar que a integração funciona antes de você pagar qualquer coisa. Ao preço atual, é suficiente para muitas requisições curtas, e a seção de custos mais abaixo mostra os cálculos. Quando estiver pronto para continuar, a página de preços lista os valores de recarga. O crédito é pré-pago, não há assinatura, e o crédito nunca expira, então não há pressão para gastar uma recarga antes de algum prazo.
Chaves de teste são limitadas mais rigorosamente do que chaves completas: 2 requisições simultâneas e 60 requisições por minuto. Isso é suficiente para um primeiro script. Se você planeja distribuir dezenas de partes de transcrição em paralelo, espere atingir o limite até migrar para uma conta paga.
As três configurações que todo cliente pede
Qualquer software que você use, a tela de configuração pede as mesmas três coisas sob nomes ligeiramente diferentes.
| Configuração | Nome de campo típico | Valor |
|---|---|---|
| Endpoint | URL base, base da API, host | https://api.speechtotextapis.com/v1 |
| Credencial | Chave de API, token, segredo | Sua chave da página de chaves |
| Modelo | Modelo, nome do modelo, mecanismo | uncensored |
Um detalhe que costuma confundir: a URL base já termina em /v1. Os SDKs adicionam /chat/completions automaticamente, portanto você não deve incluí-lo. Se o seu cliente solicitar a URL completa do endpoint de chat em vez da URL base, o valor é https://api.speechtotextapis.com/v1/chat/completions.
Se uma ferramenta oferecer apenas a opção predefinida "OpenAI" com um host codificado e sem possibilidade de edição, ela não conseguirá se comunicar com este serviço. Procure uma opção "personalizada", "compatível com OpenAI" ou "avançada" que exponha o campo da URL base.
Sua primeira requisição
Comece com curl, porque remove todas as camadas entre você e a API. Substitua YOUR_KEY pela chave que você copiou.
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"}
]
}'
Uma resposta bem-sucedida é um objeto JSON com uma matriz choices. O texto está em choices[0].message.content, e um bloco usage informa os tokens pelos quais você foi cobrado.
A mesma chamada com a biblioteca Python oficial fica assim. Apenas base_url e api_key diferem de uma configuração padrão do OpenAI.
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 no Node, usando o mesmo pacote:
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);
Você não precisa definir max_tokens. Quando omitido, a conclusão pode usar o que restar da janela de 100.000 tokens após o seu prompt. Defina-o manualmente se quiser um limite máximo rígido de custo por chamada.
Verifique se a chave funciona sem gastar tokens
Antes de integrar uma chave a um sistema maior, faça uma chamada de baixo custo ao endpoint de modelos. Isso confirma se a chave é aceita e se a URL base está correta.
curl -i https://api.speechtotextapis.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
A flag -i imprime os cabeçalhos de resposta, onde esta API relata o estado útil:
X-Request-Ididentifica a requisição. Inclua-o se entrar em contato com suporte sobre uma chamada específica.X-Balance-USDmostra o crédito restante na conta.X-RateLimit-Limit-RequestseX-RateLimit-Limit-Concurrencymostram os limites que se aplicam à sua chave, para que você possa ver de relance se a chave tem limites de teste ou completos.
Ler X-Balance-USD no seu próprio código é uma maneira barata de alertar-se antes que o crédito acabe. Registre-o uma vez por trabalho, em vez de uma vez por requisição, se não quiser saída barulhenta.
Quanto custa usar uma chave
Ter uma chave não custa nada. Você paga por tokens: $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída, descontados do crédito pré-pago. Requisições falhas ou recusadas não são cobradas.
Um exemplo prático com a chamada de limpeza de transcrição acima. Digamos que um prompt tenha 1.000 tokens e a resposta limpa tenha 500 tokens.
- Entrada: 1.000 / 1.000.000 x $0,15 = $0,00015
- Saída: 500 / 1.000.000 x $0,50 = $0,00025
- Total: $0,0004 por chamada
O crédito de teste de $0,50 cobre portanto cerca de 1.250 chamadas desse tamanho ($0,50 / $0,0004). Seus próprios números serão diferentes, porque as transcrições variam em comprimento, mas o método é o mesmo: conte os tokens de entrada, conte os tokens de saída, multiplique.
Quando você recarrega, qualquer valor inteiro de $20 a $500 é aceito. Recargas maiores têm um bônus: +5% a partir de $50, +10% a partir de $100 e +15% a partir de $200. Uma recarga de $100, por exemplo, lhe dá $110 de crédito. Você pode pagar com cripto (USDT na TRC20, USDC na Base).
Mantendo a chave segura
Uma chave de API é a senha do seu saldo. Quem a tem pode gastar seu crédito, então trate-a assim.
- Mantenha-a fora do controle de código-fonte. Leia-a de uma variável de ambiente ou de um gerenciador de segredos.
- Não a inclua no JavaScript do navegador ou no pacote de um aplicativo móvel. Qualquer coisa que rode no dispositivo do usuário pode ser inspecionada. Coloque um pequeno servidor entre o front-end e a API e deixe o servidor adicionar o cabeçalho.
- Não cole-a em capturas de tela, tickets ou mensagens de chat.
- Se você acha que uma chave vazou, pare de usá-la e entre em contato com o suporte imediatamente, em vez de esperar para ver o que acontece.
Sobre privacidade: os prompts enviados para a API não são usados para treinamento. Isso é uma declaração sobre o serviço, não um motivo para enviar segredos que você não precisa enviar. Remova dados pessoais das transcrições quando a tarefa não exigir.
Quando uma chamada falha
A maioria dos problemas do primeiro dia vem de uma de quatro causas.
A URL base está errada
Os dois erros comuns são a falta de /v1 e a duplicação de /chat/completions. Compare seu valor caractere por caractere com o da tabela acima.
A chave tem um caractere estranho
Copiar de uma página muitas vezes traz junto um espaço ou nova linha final. Remova o valor no seu código e verifique se o cabeçalho lê Bearer, um espaço, então a chave.
O nome do modelo não é uncensored
Os clientes muitas vezes usam outro nome de modelo como padrão. Defina o modelo explicitamente em todas as chamadas.
HTTP 429
Existem dois tipos, e o código de erro os distingue. rate_limited significa que você enviou muitas requisições por minuto. concurrency significa que muitas estavam em execução ao mesmo tempo. Uma requisição de streaming ocupa seu slot de concorrência até o fim do streaming, então um leitor lento pode causar esse erro mesmo com uma taxa de requisições baixa. Um 429 com o cabeçalho Retry-After: 5 significa que o serviço está brevemente sobrecarregado; aguarde os cinco segundos e tente novamente. Um backoff exponencial curto no seu cliente lida com todos os três casos.
Para a lista completa de parâmetros, formato de streaming e detalhes de chamada de funções, consulte a documentação da API.
Mais guias
Perguntas e respostas
Isso é o mesmo que uma chave OpenAI?
Não. Segue o mesmo formato de solicitação, então SDKs OpenAI funcionam com ela, mas é emitida por este serviço e só funciona contra a URL base deste serviço.
Preciso de cartão de crédito para obter uma chave?
Não. Crie sua conta com Google ou e-mail e, em seguida, resgate o crédito de teste grátis de $0,50 com um clique na página da chave. O teste não precisa de cartão e é válido por 7 dias.
Qual nome de modelo devo usar?
Use uncensored no campo do modelo. Uma chamada para GET /v1/models listará o que a chave pode acessar.
Posso usar a mesma chave de vários servidores?
Sim, mas os limites se aplicam à chave como um todo: 8 requisições simultâneas e 300 requisições por minuto para uma chave completa, 2 e 60 para uma chave de teste.
A chave funciona para imagens ou fala?
Não. A API é apenas de texto. Ela não gera nem transcreve áudio ou imagens, e não tem embeddings nem fine-tuning.
Sua chave está a um formulário de distância
Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.