URL de API y URL base de DeepSeek: Cómo cambiar
La URL de API de deepseek que copias de la documentación propia de DeepSeek es una URL base, y solo funciona con la clave de DeepSeek y los modelos de DeepSeek. Si quieres un endpoint estilo OpenAI diferente, cambias esa URL, la clave y el ID del modelo.
Actualizado
Puntos clave
- Una URL base es el prefijo; el SDK añade /chat/completions a ella.
- Este servicio usa https://api.getdeepseekapi.com/v1 con el ID de modelo uncensored.
- No es la API de DeepSeek, por lo que una clave de DeepSeek no funcionará aquí y viceversa.
- La mayoría de los clientes también aceptan la URL y la clave a través de OPENAI_BASE_URL y OPENAI_API_KEY.

URL base, endpoint y ruta: las tres partes
La gente suele pegar una dirección completa en un campo que espera un prefijo, y luego obtiene un 404. Tres términos mantienen esto diferenciado.
- URL base: el prefijo compartido de cada llamada, por ejemplo
https://api.getdeepseekapi.com/v1. Esto es lo que pones en la configuración "API base" o "URL base" de un cliente. - Ruta del endpoint: la parte añadida por el SDK, como
/chat/completions,/responseso/models. - URL completa: base más ruta, como
https://api.getdeepseekapi.com/v1/chat/completions. Los clientes HTTP crudos como curl necesitan este valor.
La regla que atrapa a la mayoría: los SDK y las aplicaciones piden la URL base, mientras que curl y los nodos HTTP piden la URL completa. Si una herramienta devuelve un 404, comprueba primero si has puesto una URL completa donde se esperaba una base, o viceversa. Una ruta duplicada como /v1/chat/completions/chat/completions en el error es la pista.
Qué es la URL base de DeepSeek y qué no es
DeepSeek publica su propia dirección de API en su documentación, junto con los nombres de modelo que tu clave de API puede usar. Consulta esa fuente para obtener el valor actual en lugar de confiar en un artículo de blog, incluido este. Una clave de DeepSeek funciona contra el endpoint de DeepSeek y en ningún otro lugar.
El servicio en este sitio es un producto separado. No es la API oficial de DeepSeek, no reenvía a DeepSeek ni sirve modelos de DeepSeek. Es una API alojada compatible con OpenAI para un modelo de pesos abiertos, gestionada por un proveedor independiente y ajustada para responder sin filtros de contenido para uso adulto lícito. Su dirección es:
https://api.getdeepseekapi.com/v1 # model: uncensored
El ID del modelo es uncensored, y la autenticación es Authorization: Bearer <key>. Las claves se emiten en la página de claves de API. Si estás comparando lo que significa una clave para cada servicio, la página sobre la clave de API de DeepSeek tiene más detalles.
Cambio de endpoints en los SDKs de OpenAI
Cualquier SDK de OpenAI funciona una vez que cambias la URL base y la clave. En Python:
from openai import OpenAI
client = OpenAI(
base_url="https://api.getdeepseekapi.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Name three uses for a base URL."}],
)
print(resp.choices[0].message.content)
En Node.js el campo se escribe baseURL:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.getdeepseekapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Name three uses for a base URL." }],
});
console.log(resp.choices[0].message.content);
Fíjate en la diferencia: Python usa base_url, Node usa baseURL. Si los confundes, el SDK usa en silencio la dirección predeterminada de OpenAI, que luego rechaza tu clave.
Cambio sin tocar código
Los SDKs oficiales de OpenAI leen dos variables de entorno, por lo que una aplicación existente puede redirigirse sin cambio de código:
export OPENAI_BASE_URL="https://api.getdeepseekapi.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
python app.py # the app still has to request model "uncensored"
El nombre del modelo es la parte que no puedes saltarte. Si la aplicación define otro ID de modelo, pedirá ese y fallará, así que cámbialo a uncensored en la configuración o el archivo de configuración de la app. Muchas herramientas muestran los tres valores en una misma pantalla de configuración, generalmente etiquetados como URL base, clave de API y modelo.
El mismo cambio de tres valores funciona en frameworks. Con LangChain en Python, por ejemplo, ChatOpenAI(base_url="https://api.getdeepseekapi.com/v1", api_key="YOUR_KEY", model="uncensored") es suficiente. Las herramientas de programación que aceptan un endpoint compatible con OpenAI funcionan de la misma manera; consulta la guía sobre cómo usar una API para programación.
HTTP sin procesar: las rutas exactas
Para curl, scripts y nodos HTTP, construyes la URL completa tú mismo. Estas son las rutas en este servicio:
| Propósito | Método y URL |
|---|---|
| Chat | POST https://api.getdeepseekapi.com/v1/chat/completions |
| API de respuestas | POST https://api.getdeepseekapi.com/v1/responses |
| Lista de modelos | GET https://api.getdeepseekapi.com/v1/models |
| Saldo | GET https://api.getdeepseekapi.com/v1/balance |
| Saldo, estilo OpenAI | GET https://api.getdeepseekapi.com/v1/dashboard/billing/credit_grants |
curl https://api.getdeepseekapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'
Usa solo HTTPS. El streaming funciona con "stream": true sobre eventos enviados por el servidor, y la misma URL sirve ambos modos.
Introducción de la URL en aplicaciones con pantalla de configuración
Muchas interfaces de chat, editores y herramientas de automatización tienen una opción de "endpoint compatible con OpenAI personalizado". Las etiquetas difieren, pero los campos se mapean uno a uno:
| Campo en la app | Valor |
|---|---|
| API base, URL base, Endpoint, URL del servidor | https://api.getdeepseekapi.com/v1 |
| Clave de API, Token, Secreto | Tu clave de API de este servicio |
| Modelo, Nombre del modelo, ID del modelo | uncensored |
Algunas aplicaciones quieren una URL de chat completa en lugar de una base. En ese caso usa https://api.getdeepseekapi.com/v1/chat/completions. Si la aplicación tiene un botón "probar conexión", suele llamar a la lista de modelos, que es GET /v1/models. Si el botón falla pero un chat manual funciona, la comprobación de la aplicación es más estricta que la API, y puedes ignorarla.
Una prueba rápida de validación solo de la URL
Antes de depurar una aplicación, verifica la URL con la lista de modelos. No requiere cuerpo y es gratis:
curl -s https://api.getdeepseekapi.com/v1/models -H "Authorization: Bearer $API_KEY" # the chat model ID is uncensored
Deberías recibir JSON con un array de datos. Una página de error HTML indica un host o ruta incorrectos, como un subdominio faltante: el host comienza con api., no www..
Corrección de los errores habituales
- 404 Not Found. A la URL base le falta
/v1, la tiene dos veces o incluye la ruta del endpoint. - 401 o un error de autenticación. Usaste una clave de otro servicio, o el encabezado carece de
Bearer. Las claves no son intercambiables entre proveedores. - Modelo no encontrado. La solicitud aún nombra un modelo del proveedor anterior. Establece
uncensored. - La aplicación aún se comunica con el servicio antiguo. Algunas herramientas almacenan en caché la configuración o leen una variable diferente. Reinicia el proceso y verifica la pantalla de configuración.
- Problema con la barra final. La mayoría de los clientes lo manejan, pero si uno no lo hace, elimina la barra final de la URL base.
Si no estás seguro de qué lado falla, envía el comando curl anterior. Una respuesta 200 prueba la URL, la clave y el modelo; cualquier otro error está en tu aplicación. La documentación lista los límites y encabezados como X-Request-Id, lo que ayuda al contactar soporte.
Lo que permanece igual después del cambio
La forma de las peticiones y respuestas sigue el formato de OpenAI, por lo que los arrays de mensajes, temperature, top_p, stop, seed, penalizaciones, llamadas a funciones y modo JSON funcionan como es habitual. La ventana de contexto es de 100 000 tokens para el prompt más la respuesta, y el cuerpo máximo de la petición es de 8 MB. El servicio es solo de texto: sin imágenes, audio, embeddings ni ajuste fino, por lo que las funciones basadas en estos datos requieren otro proveedor.
La facturación también es independiente del proveedor anterior: $0,15 por cada 1M de tokens de entrada y $0,50 por cada 1M de tokens de salida del crédito prepago, como se muestra en la página de precios. Los nuevos usuarios pueden reclamar $0,50 de crédito de prueba para verificar que el cambio funciona antes de pagar cualquier cosa.
Más guías
Preguntas y respuestas
¿Cuál es la URL base de la API de DeepSeek?
DeepSeek la publica en su propia documentación, así que verifica allí el valor actual. El endpoint en este sitio es un servicio diferente en https://api.getdeepseekapi.com/v1.
¿Puedo usar una clave de DeepSeek en este endpoint?
No. Las claves se emiten por servicio. Obtén una clave para esta API en la página de claves y establece el modelo en uncensored.
¿Debe terminar la URL base en /v1?
Sí para este servicio: https://api.getdeepseekapi.com/v1. Los SDKs añaden la ruta del endpoint después de esta URL, así que no añadas /chat/completions tú mismo.
¿Por qué obtengo 404 después de cambiar la URL?
Usualmente la ruta se duplica o falta /v1. Compara tu URL base con el valor exacto anterior.
Tu clave está a un formulario de distancia
Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.