Clave de API compatible con OpenAI: obtén una y envía una petición
Una clave de API compatible con OpenAI es un token bearer normal que funciona con cualquier SDK de OpenAI una vez que apuntas el cliente a una base URL diferente. Esta página muestra cómo obtener una para la API de texto alojada en este sitio y hacer una llamada funcional en unos minutos.
ActualizadoSpeech To Text API

Qué es realmente la clave
"Compatible con OpenAI" describe la forma de la API HTTP, no la compañía detrás de ella. El servicio acepta el mismo cuerpo JSON en POST /v1/chat/completions que envían los SDK de OpenAI, y lee el mismo encabezado Authorization: Bearer. Debido a eso, una clave de este servicio se integra en cualquier herramienta que te permita configurar una base URL y una clave de API personalizadas: las bibliotecas oficiales de Python y Node, LangChain, curl simple y la mayoría de los clientes de chat de escritorio.
La clave no es una clave de OpenAI, y no funcionará en api.openai.com. Lo inverso también es cierto: una clave de OpenAI no funcionará aquí. Cada clave pertenece a un servicio, y este ejecuta un único modelo de pesos abiertos, ajustado para responder sin rechazos de contenido para uso adulto legal, alojado por un proveedor independiente. No es la API oficial de ningún proveedor de modelos y no enruta a otros proveedores.
Esto es lo que necesitas recordar. La base URL para este sitio es https://api.speechtotextapis.com/v1. El ID del modelo es uncensored. La clave es cualquier cadena que obtengas después de registrarte. Todo lo siguiente es una variación de esos tres valores.
El servicio es solo de texto. Maneja completados de chat, streaming, llamadas a funciones y modo JSON. No genera imágenes ni audio, no ofrece incrustaciones y no ajusta modelos. Si viniste aquí desde una tubería de voz, el trabajo típico es el paso de texto después de la transcripción: limpiar una transcripción, dividirla en escenas, reescribir diálogos o extraer datos estructurados. La guía de procesamiento de guiones de voz cubre ese lado con más detalle.
Obtén tu clave en cuatro pasos
- Regístrate. Usa Google, o regístrate con una dirección de correo electrónico y una contraseña.
- Abre la página de claves de API. Se encuentra en la página de claves en este sitio. Tu clave se crea y muestra allí.
- Reclama el crédito de prueba. Un botón en la misma página te da $0,50 de crédito de prueba con un solo clic. Es uno por persona, válido por 7 días y no requiere tarjeta.
- Copia la clave en un almacén de secretos. Una variable de entorno es suficiente para una prueba local. Para cualquier implementación, usa el gestor de secretos de tu host.
La prueba está destinada a demostrar que la integración funciona antes de que pagues algo. Al precio actual es suficiente para muchas peticiones cortas, y la sección de costos más abajo muestra la aritmética. Cuando estés listo para continuar, la página de precios lista los montos de recarga. El crédito es prepago, no hay suscripción y el crédito no caduca, así que no hay presión por gastar una recarga antes de alguna fecha límite.
Las claves de prueba tienen límites más estrictos que las claves completas: 2 peticiones simultáneas y 60 peticiones por minuto. Eso es suficiente para un primer script. Si planeas distribuir docenas de fragmentos de transcripción en paralelo, espera alcanzar el límite hasta que pases a una cuenta con fondos.
Las tres configuraciones que todo cliente solicita
Sea cual sea el software que uses, la pantalla de configuración solicita las mismas tres cosas con nombres ligeramente diferentes.
| Configuración | Nombre de campo típico | Valor |
|---|---|---|
| Endpoint | Base URL, base de API, host | https://api.speechtotextapis.com/v1 |
| Credencial | Clave de API, token, secreto | Tu clave de la página de claves |
| Modelo | Modelo, nombre del modelo, motor | uncensored |
Un detalle confunde a la gente: la base URL ya termina en /v1. Los SDKs añaden /chat/completions ellos mismos, así que no debes añadirlo. Si tu cliente solicita la URL completa del endpoint de chat en lugar de una base, el valor es https://api.speechtotextapis.com/v1/chat/completions.
Si una herramienta solo ofrece una opción "OpenAI" preestablecida con un host codificado y sin forma de editarlo, no puede comunicarse con este servicio. Busca una opción "personalizada", "compatible con OpenAI" o "avanzada" que exponga el campo de base URL.
Tu primera petición
Comienza con curl, porque elimina todas las capas entre tú y la API. Reemplaza YOUR_KEY con la clave que copiaste.
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 respuesta exitosa es un objeto JSON con una matriz choices. El texto está en choices[0].message.content, y un bloque usage informa los tokens por los que fuiste cobrado.
La misma llamada con la biblioteca oficial de Python se ve así. Solo base_url y api_key difieren de una configuración de OpenAI estándar.
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)
Y en Node, usando el mismo paquete:
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);
No necesitas configurar max_tokens. Cuando se omite, la completación puede usar lo que quede de la ventana de 100.000 tokens después de tu prompt. Configúralo tú mismo si quieres un límite estricto en el costo por llamada.
Verifica que la clave funciona sin gastar tokens
Antes de conectar una clave en un sistema más grande, haz una llamada barata al endpoint de modelos. Confirma que la clave es aceptada y que la base URL es correcta.
curl -i https://api.speechtotextapis.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
La bandera -i imprime los encabezados de respuesta, donde esta API informa el estado útil:
X-Request-Ididentifica la petición. Inclúyelo si contactas a soporte sobre una llamada específica.X-Balance-USDmuestra el crédito restante en la cuenta.X-RateLimit-Limit-RequestsyX-RateLimit-Limit-Concurrencymuestran los límites que se aplican a tu clave, para que puedas ver a simple vista si la clave tiene límites de prueba o completos.
Leer X-Balance-USD en tu propio código es una forma barata de alertarte antes de que se agote el crédito. Regístralo una vez por trabajo en lugar de una vez por petición si no quieres una salida ruidosa.
Cuánto cuesta usar una clave
Tener una clave no tiene costo. Pagas por tokens: $0.15 por cada 1M de tokens de entrada y $0.50 por cada 1M de tokens de salida, descontados del crédito prepago. Las peticiones fallidas o rechazadas no se cobran.
Un ejemplo práctico con la llamada de limpieza de transcripción anterior. Digamos que un prompt tiene 1.000 tokens y la respuesta limpia tiene 500 tokens.
- Entrada: 1,000 / 1,000,000 x $0.15 = $0.00015
- Salida: 500 / 1.000.000 x $0,50 = $0,00025
- Total: $0.0004 por llamada
Por tanto, el crédito de prueba de $0.50 cubre aproximadamente 1,250 llamadas de ese tamaño ($0.50 / $0.0004). Tus propios números variarán, porque las transcripciones varían en longitud, pero el método es el mismo: cuenta los tokens de entrada, cuenta los tokens de salida y multiplica.
Cuando recargas, se acepta cualquier monto entero desde $20 hasta $500. Las recargas más grandes tienen un bono: +5% desde $50, +10% desde $100 y +15% desde $200. Una recarga de $100, por ejemplo, te da $110 de crédito. Puedes pagar con cripto (USDT en TRC20, USDC en Base).
Mantener la clave segura
Una clave de API es la contraseña de tu saldo. Cualquier persona que la tenga puede gastar tu crédito, así que trátala como tal.
- No la guardes en el control de código fuente. Léela desde una variable de entorno o un gestor de secretos.
- No la incluyas en JavaScript del navegador ni en paquetes de aplicaciones móviles. Cualquier cosa que se ejecute en el dispositivo del usuario puede ser inspeccionada. Coloca un pequeño servidor entre tu interfaz y la API y deja que el servidor añada la cabecera.
- No la pegues en capturas de pantalla, tickets o mensajes de chat.
- Si crees que una clave se ha filtrado, deja de usarla y contacta con soporte inmediatamente en lugar de esperar a ver qué ocurre.
Sobre la privacidad: los prompts enviados a la API no se utilizan para entrenamiento. Esta es una afirmación sobre el servicio, no una razón para enviar secretos que no necesites enviar. Elimina los datos personales de las transcripciones cuando la tarea no lo requiera.
Cuando falla una petición
La mayoría de los problemas del primer día provienen de una de cuatro causas.
La URL base es incorrecta
Los dos errores habituales son la falta de /v1 y un /chat/completions duplicado. Compara tu valor carácter por carácter con el de la tabla anterior.
La clave tiene un carácter extraño
Copiar desde una página a menudo incluye un espacio o salto de línea al final. Recorta el valor en tu código y verifica que la cabecera lea Bearer, un espacio, y luego la clave.
El nombre del modelo no es uncensored
Los clientes suelen usar por defecto otro nombre de modelo. Establece el modelo explícitamente en cada llamada.
HTTP 429
Existen dos variantes, y el código de error las distingue. rate_limited significa que enviaste demasiadas peticiones por minuto. concurrency significa que había demasiadas en vuelo a la vez. Una petición en streaming mantiene su espacio de concurrencia hasta que finaliza el streaming, por lo que un lector lento puede causar este error incluso con una tasa de peticiones baja. Un 429 con un encabezado Retry-After: 5 significa que el servicio está brevemente sobrecargado; espera los cinco segundos y reintenta. Un backoff exponencial corto en tu cliente maneja los tres casos.
Para la lista completa de parámetros, el formato de streaming y los detalles de llamadas a funciones, consulta la documentación de la API.
Más guías
Preguntas y respuestas
¿Es lo mismo que una clave de OpenAI?
No. Sigue el mismo formato de petición, por lo que los SDKs de OpenAI funcionan con ella, pero es emitida por este servicio y solo funciona contra la URL base de este servicio.
¿Necesito una tarjeta de crédito para obtener una clave?
No. Regístrate con Google o correo electrónico, y luego reclama el crédito de prueba de $0.50 con un solo clic en la página de claves. La prueba no requiere tarjeta y es válida durante 7 días.
¿Qué nombre de modelo debo usar?
Usa uncensored en el campo del modelo. Una llamada a GET /v1/models listará a qué puede acceder la clave.
¿Puedo usar la misma clave desde varios servidores?
Sí, pero los límites se aplican a la clave en su conjunto: 8 peticiones simultáneas y 300 peticiones por minuto para una clave completa, 2 y 60 para una clave de prueba.
¿Funciona la clave para imágenes o voz?
No. La API es solo de texto. No genera ni transcribe audio o imágenes, y no tiene embeddings ni ajuste fino.
Tu clave está a un formulario de distancia
Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.