deepseek4api.comGuía
Guía de la API de DeepSeek y alternativa lista para usar
La mayoría de las personas que abren la documentación de la API de DeepSeek buscan las mismas cinco respuestas: la URL base, cómo autenticarse, qué nombre de modelo usar, qué parámetros funcionan y cómo se ve una llamada funcional. Esta página cubre eso, luego muestra las mismas llamadas contra un endpoint alternativo compatible con OpenAI que puedes integrar.


Puntos clave
- DeepSeek documenta una API estilo OpenAI, por lo que el SDK de OpenAI funciona cambiando la URL base, la clave y el nombre del modelo.
- Este sitio no es la API oficial de DeepSeek; sirve un único modelo independiente de pesos abiertos bajo el ID uncensored.
- El mismo código funciona en ambos: solo cambian tres valores.
- La ventana de contexto es de 100.000 tokens, con streaming, herramientas y modo JSON compatibles.
Las cinco cosas que responde la documentación de la API de DeepSeek
Cuando los desarrolladores buscan la documentación de la API de DeepSeek, normalmente intentan completar una primera petición. El patrón es el mismo que para cualquier servicio estilo OpenAI, por lo que una tabla facilita la comparación.
| Pregunta | Documentación de DeepSeek | Esta API |
|---|---|---|
| URL base | Documentado en su inicio rápido (api.deepseek.com) | https://api.deepseek4api.com/v1 |
| Autenticación | Token Bearer en el encabezado Authorization | Token Bearer en el encabezado Authorization |
| Nombre del modelo | Listado en la documentación de sus modelos; verifica los nombres actuales | uncensored |
| Endpoint principal | Completados de chat | Chat completions, Responses, lista de modelos |
| Precios | Revisa sus precios actuales | $0,15 / 1M tokens de entrada, $0,50 / 1M tokens de salida |
Lee las páginas propias de DeepSeek para cualquier cosa sobre sus modelos, precios y límites; cambian, y este artículo no intenta repetirlas. El punto es que la forma de la petición es compartida, por lo que moverse entre los dos es un cambio de configuración.
Una cosa que debes tener clara: este sitio no es la API oficial de DeepSeek, y no es un enrutador hacia DeepSeek. Es un endpoint alojado, compatible con OpenAI, que sirve un único modelo de pesos abiertos gestionado por un proveedor independiente y ajustado para responder sin rechazos de contenido para uso adulto lícito.
Paso 1: autenticación y URL base
Crea una cuenta (Google, o correo electrónico y contraseña) y abre la página de claves de API. Copia la clave. Los nuevos usuarios también pueden reclamar $0,50 de crédito de prueba con un solo clic, válido por 7 días y sin necesidad de tarjeta.
Cada petición lleva el encabezado Authorization: Bearer YOUR_KEY. Con curl:
curl https://api.deepseek4api.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
Eso lista el modelo disponible, uncensored. Si copias un ejemplo de DeepSeek, reemplaza tres cosas: la URL base, la clave y el nombre del modelo. Nada más necesita cambiar.
Paso 2: un chat completion en Python
El SDK de OpenAI es lo que usan los ejemplos de la documentación de DeepSeek, y funciona sin cambios aquí:
from openai import OpenAI
client = OpenAI(
base_url="https://api.deepseek4api.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise technical assistant."},
{"role": "user", "content": "Explain idempotency in two sentences."},
],
temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)
Los parámetros de muestreo compatibles, incluyendo temperature, top_p, stop, seed y las penalizaciones de presencia y frecuencia, se pasan directamente. max_tokens es opcional porque el completion puede usar lo que quede de la ventana de 100.000 tokens.
Paso 3: streaming, modo JSON y herramientas
Transmisión
Establece stream: true para recibir eventos enviados por el servidor. El uso se informa al final del stream.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.deepseek4api.com/v1",
apiKey: process.env.API_KEY,
});
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a haiku about caching." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}
Modo JSON
Pasa response_format: {"type": "json_object"} y menciona JSON en tu prompt. La salida es un objeto JSON que puedes analizar directamente.
Llamadas a funciones
Los parámetros tools y tool_choice funcionan en el formato de OpenAI, las llamadas a funciones se transmiten en deltas, y devuelves resultados como mensajes con role: "tool". Si tu código ya hace llamadas a funciones contra DeepSeek, debería portarse con el cambio de tres valores anterior, pero prueba tus propios esquemas.
Dónde difieren
El mismo protocolo no significa el mismo servicio. Cosas a verificar cuando muevas una carga de trabajo:
- Comportamiento del modelo. Un modelo diferente da respuestas, estilo de razonamiento y comportamiento de rechazo diferentes. Vuelve a ejecutar tu conjunto de prompts antes de cambiar algo en producción.
- Campos específicos de razonamiento. Si dependes de campos de respuesta específicos del proveedor de un modelo DeepSeek determinado, no asumas que existen aquí. Los campos estándar de chat completion sí.
- Funcionalidades no ofrecidas. Esta API es solo de texto: sin imágenes, audio, video, embeddings ni ajuste fino.
- Límites. Una clave completa permite 8 peticiones simultáneas y 300 por minuto; una clave de prueba permite 2 y 60. Al superar un límite obtienes HTTP 429 con
rate_limitedoconcurrency. - Saldo. Comprueba el crédito con
GET /v1/balance, la ruta de créditos estilo OpenAI, o el encabezadoX-Balance-USDen cada respuesta.
Para ver cómo un usuario enfocado en DeepSeek piensa en el costo, consulta las notas de precios de DeepSeek; para configuraciones de editor, la guía de VS Code.
Lo que cuesta una llamada aquí
La facturación es prepago y por token: $0,15 por cada 1M de tokens de entrada y $0,50 por cada 1M de tokens de salida. Una petición con 1.500 tokens de entrada y 600 tokens de salida cuesta 1.500 x $0,15 / 1M = $0,000225 por entrada más 600 x $0,50 / 1M = $0,0003 por salida, un total de $0,000525. Una recarga de $20 cubre unas 38.000 llamadas de este tipo.
Las recargas aceptan cualquier cantidad entera desde $20 hasta $500, con +5% desde $50, +10% desde $100 y +15% desde $200. Puedes pagar con cripto (USDT en TRC20, USDC en Base). El crédito no caduca y las peticiones fallidas o rechazadas no se cobran. Detalles en la página de precios.
Una lista de verificación de migración
Si estás portando una aplicación que ya habla con DeepSeek, sigue estos pasos en orden. Cada paso toma minutos.
- Pon los tres valores en la configuración. La URL base, la clave y el nombre del modelo deben provenir de variables de entorno, no de constantes dispersas en el código.
- Ejecuta una prueba de humo. Un chat completion, un completion en streaming, una llamada en modo JSON y una llamada a herramientas. Los cuatro fragmentos anteriores las cubren.
- Reproduce prompts reales. Toma 30 prompts de tus registros y compara las respuestas lado a lado. Júzgalos según tus propios criterios en lugar de una puntuación genérica.
- Maneja 429. Añade reintento con backoff y honra
Retry-After. Una petición en streaming mantiene su slot de concurrencia hasta que termina el stream, así que cierra los streams abandonados. - Vigila el costo. Registra
usagede cada respuesta y compáralo con el encabezadoX-Balance-USDdurante un día de tráfico. - Lanza gradualmente. Envía primero el 5 al 10 por ciento del tráfico al nuevo endpoint, luego aumentalo.
Compara el coste por tarea, no el precio por token, porque diferentes modelos usan diferentes cantidades de tokens para el mismo trabajo. Para una comprobación abierta de cómo se comportan los modelos de escritura permisivos, la redacción de roleplay es un complemento útil.
Elegir entre ellas
Usa la API propia de DeepSeek cuando necesites específicamente un modelo DeepSeek, sus funciones de proveedor o su soporte oficial. Usa este endpoint cuando quieras un modelo alojado compatible con OpenAI que responda sin rechazos de contenido para uso adulto lícito, con facturación prepago simple y prompts que no se usan para entrenamiento. Muchos equipos querrán ambos detrás de un interruptor de configuración, lo que el protocolo compartido hace fácil. El material de referencia para esta API vive en la documentación.
Más guías
Preguntas y respuestas
¿Es esta la API oficial de DeepSeek?
No. Es un endpoint independiente compatible con OpenAI que sirve un único modelo de pesos abiertos con el ID uncensored. No es el servicio de DeepSeek y no enruta hacia él.
¿Puedo reutilizar mi código de DeepSeek?
Si usa el SDK de OpenAI o el formato de chat completions, normalmente sí. Cambia la URL base, la clave y el nombre del modelo, luego prueba tus prompts.
¿Dónde encuentro el nombre del modelo?
Llama a GET /v1/models. Esta API sirve un único modelo con el ID uncensored.
¿Qué tan larga es la ventana de contexto?
100.000 tokens para prompt más completion.
Token Bearer en el encabezado Authorization
Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.