Actualizado
Clave de API de DeepSeek no funciona: causas y soluciones
Cuando aparece un error de clave de API de DeepSeek que no funciona, la clave es la culpable con menos frecuencia de lo que imaginas. La mayoría de los fallos provienen de la URL base, un saldo vacío, un nombre de modelo incorrecto o un cliente que envía la clave en el lugar equivocado.
Comienza con una prueba de una línea
Antes de cambiar algo en tu aplicación, elimina el cliente de la ecuación. Una única llamada curl te dice si la clave, la URL y el nombre del modelo funcionan juntos. Reemplaza los marcadores con los valores del panel y la documentación de tu proveedor.
curl -i https://YOUR-PROVIDER/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR-MODEL","messages":[{"role":"user","content":"ping"}]}'La bandera -i imprime la línea de estado y los encabezados, y esos datos importan más que el cuerpo. Si curl funciona y tu aplicación no, el fallo está en la configuración de la aplicación. Si curl también falla, el problema es la clave, la cuenta o el endpoint.
Lee primero el código de estado
| Código | Significado habitual | Qué verificar |
|---|---|---|
| 401 | La clave fue rechazada | Errores copiados, espacios extra, clave revocada o eliminada, clave de otro proveedor |
| 402 o un mensaje de saldo | No queda crédito | Saldo de la cuenta y página de facturación |
| 404 | Ruta o modelo incorrectos | Base URL, /v1 al final, ortografía del nombre del modelo |
| 429 | Demasiadas peticiones | Peticiones por minuto, llamadas paralelas, encabezados de reintento |
| 5xx o tiempo de espera | Lado del proveedor o red | Página de estado del proveedor, reintento más tarde, enrutamiento regional |
Estos son los significados comunes en proveedores de estilo OpenAI. Cada proveedor documenta sus propios códigos exactos, así que consulta su documentación actual para los detalles.
La clave en sí
Las claves son cadenas largas y se rompen de formas aburridas. Pega la clave en un editor de texto plano y busca un espacio o salto de línea al final, una comilla al inicio o un salto de línea añadido por una aplicación de chat. Asegúrate de que el encabezado lea Authorization: Bearer KEY con un solo espacio después de Bearer. Si configuras la clave en una variable de entorno, imprime su longitud en tu aplicación (no su valor) para confirmar que se cargó.
Otros dos casos son comunes. Primero, creaste una clave, cerraste la página y copiaste una versión enmascarada. La mayoría de los paneles muestran una clave una sola vez, así que crea una nueva. Segundo, estás usando una clave de un servicio contra la URL de otro servicio. Una clave solo es válida para el proveedor que la emitió.
Saldo, facturación y crédito gratis
Muchas claves de API solo funcionan mientras la cuenta tenga crédito. Un saldo vacío puede parecer una clave rota. Abre la página de facturación de tu proveedor y confirma que tienes fondos, que una recarga se ha procesado realmente y que cualquier crédito promocional no haya caducado. Las recargas con cripto pueden tardar unos minutos en aparecer.
Si quieres comparar cómo otro servicio prepago maneja esto, nuestro modelo es simple: compras crédito, las llamadas lo consumen a $0.15 por 1M de tokens de entrada y $0.50 por 1M de tokens de salida, las peticiones fallidas o rechazadas no se cobran y el crédito nunca caduca. Puedes leer el saldo con GET /v1/balance o desde el encabezado X-Balance-USD en cada respuesta.
Base URL y nombre del modelo
La causa más frecuente en herramientas como SillyTavern, Janitor AI y complementos de editor es una URL base escrita ligeramente mal. Errores comunes: falta /v1, un /v1/v1 duplicado, usar http en lugar de https, o pegar la ruta completa /chat/completions en un campo que ya la añade. El campo del modelo es la otra trampa. Debe coincidir con un ID de modelo que el proveedor liste. Lista los modelos con GET /v1/models si el proveedor lo admite, o lee la documentación actual.
Las guías de configuración para herramientas específicas están en este sitio: usar una clave en SillyTavern, en Janitor AI y en VS Code.
Límites de peticiones y concurrencia
Una ráfaga de peticiones simultáneas puede provocar un 429 incluso con una clave válida. Busca un encabezado Retry-After y reduce la frecuencia. Un reintento mínimo en Python se ve así:
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.deepseekapikey.com/v1", api_key="YOUR_KEY")
def ask(prompt):
for attempt in range(4):
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": prompt}],
)
return r.choices[0].message.content
except RateLimitError:
time.sleep(5 * (attempt + 1))
raise RuntimeError("still rate limited")En nuestro endpoint una clave completa permite 8 peticiones concurrentes y 300 peticiones por minuto. Una petición en streaming mantiene su espacio hasta que finalice la transmisión. El código de error es rate_limited o concurrency, y una sobrecarga temporal devuelve 429 con Retry-After: 5.
Problemas de red y regionales
Si curl se cuelga o se reinicia, el problema puede estar entre tú y el proveedor: un proxy corporativo, una VPN, DNS o un bloqueo regional. Prueba una red diferente, verifica que tu proxy pase los encabezados Authorization y aumenta el tiempo de espera de tu cliente para generaciones largas. Las respuestas en streaming también pueden ser cortadas por proxies que almacenan en búfer; prueba con stream: false para separar los dos problemas.
Una lista de verificación que puedes ejecutar en cinco minutos
- Ejecuta la prueba curl y anota el código de estado.
- Crea una clave nueva y pruébala. Si la nueva clave funciona, la antigua se copió mal o fue revocada.
- Verifica el saldo y cualquier fecha de caducidad del crédito.
- Compara la base URL y el ID del modelo con la documentación del proveedor, carácter por carácter.
- Envía una petición sin streaming, sin herramientas y con un prompt corto. Añade las funciones una por una.
- Busca llamadas paralelas. Si tu aplicación dispara varias peticiones a la vez, reduce la concurrencia.
- Prueba otra red o desactiva la VPN.
- Mira los encabezados de respuesta, incluido cualquier ID de petición. Un equipo de soporte puede encontrar tu llamada con ese ID.
El paso cinco encuentra una cantidad sorprendente de errores. Definiciones de herramientas ligeramente inválidas, un valor de max_tokens muy grande o un cuerpo por encima del límite de tamaño pueden devolver errores que parecen problemas de clave. En nuestro endpoint el límite del cuerpo es 8 MB y cada respuesta lleva un encabezado X-Request-Id que puedes citar para soporte.
Configura un endpoint de respaldo
Las interrupciones y los límites ocurren con cualquier proveedor, así que mantén un segundo endpoint compatible con OpenAI en tu configuración. El nuestro es un modelo de pesos abiertos alojado y ajustado para responder sin rechazos por contenido para uso adulto lícito. No es la API oficial de DeepSeek ni es un router, así que espera respuestas y comportamientos distintos. Cambiar requiere dos ajustes: URL base https://api.deepseekapikey.com/v1 y modelo uncensored.
curl https://api.deepseekapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'Los usuarios nuevos pueden reclamar $0,50 de crédito de prueba con un solo clic en la página de clave de API, válido por 7 días. Las recargas van de $20 a $500 con cripto; consulta la página de precios y la documentación para más detalles.
Más guías
Preguntas y respuestas
¿Por qué mi clave funciona en curl pero no en mi app?
La app probablemente tiene una URL base incorrecta, un nombre de modelo equivocado o una copia caducada de la clave. Compara su configuración con tu llamada curl que funciona carácter por carácter.
¿Una clave válida garantiza que las peticiones tendrán éxito?
No. Un saldo vacío, un límite de peticiones o un nombre de modelo desconocido pueden fallar con una clave perfectamente válida.
¿Puedo usar el mismo código con otro proveedor?
Si ambos son compatibles con OpenAI, sí. Cambia la URL base, la clave y el ID del modelo.
¿Tu endpoint es el mismo modelo que DeepSeek?
No. Es un modelo de pesos abiertos ejecutado por un proveedor independiente y no es la API oficial de ningún proveedor.
Tu clave está a un formulario de distancia
Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.
