Tutorial de la API de DeepSeek: V4 Flash / Pro con Python y JavaScript

Llama a DeepSeek V4 Flash y Pro a través de APIMaster con curl, Python y JavaScript. Configura tu clave de API, transmite respuestas y soluciona errores comunes.

¿Puedes llamar a DeepSeek con el SDK de OpenAI? Sí. A través de APIMaster, establece la URL base de la API en https://apimaster.ai/v1, usa tu clave de API de APIMaster y selecciona deepseek-v4-flash o deepseek-v4-pro. Esta guía cubre esa configuración de puerta de enlace; una clave emitida por otro proveedor no es intercambiable.

Última prueba: 2026-09-07. Ambos modelos devolvieron HTTP 200 y el texto esperado en nuestra prueba de Chat Completions. Codex CLI 0.153.4 y Claude Code 2.1.239 también completaron pruebas de herramientas de texto y lectura de archivos a través de la misma puerta de enlace. Estas son comprobaciones funcionales breves, no un punto de referencia de contexto largo o fiabilidad. Los ejemplos de Python, JavaScript y transmisión a continuación demuestran el uso correspondiente de la API; no son resultados de referencia separados.

1. Obtén tu clave y elige un modelo

Crea una cuenta y obtén una clave de API. Asegúrate de que la clave tenga acceso al modelo seleccionado y cuota suficiente. Consulta los precios actuales en el mercado de modelos; las tarifas pueden variar según la ruta y el momento.

Configuración	Valor
URL base del SDK	`https://apimaster.ai/v1`
Endpoint HTTP	`POST https://apimaster.ai/v1/chat/completions`
Autorización	`Authorization: Bearer YOUR_APIMASTER_API_KEY`
Modelo Flash	`deepseek-v4-flash`
Modelo Pro	`deepseek-v4-pro`

Ambos modelos usan la misma forma de solicitud. Comienza con cualquiera de los modelos y luego compara los resultados en tu propia carga de trabajo. Reemplaza YOUR_APIMASTER_API_KEY a continuación con tu clave localmente; no la confirmes en el control de versiones ni la pongas en código de navegador.

macOS / Linux:

export APIMASTER_API_KEY='YOUR_APIMASTER_API_KEY'

Windows PowerShell:

$env:APIMASTER_API_KEY = 'YOUR_APIMASTER_API_KEY'

Estas variables se aplican a la terminal actual. Ejecuta los siguientes ejemplos desde esa terminal.

2. Haz tu primera solicitud con curl

El siguiente comando usa sintaxis de shell de macOS / Linux. Los usuarios de Windows pueden usar el ejemplo de Python multiplataforma a continuación.

curl --fail-with-body 'https://apimaster.ai/v1/chat/completions' \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "Reply with exactly: DEEPSEEK_TEST_OK"}],
    "max_tokens": 256,
    "stream": false
  }'

Esperado: HTTP 200 y choices[0].message.content igual a DEEPSEEK_TEST_OK. Cambia solo model a deepseek-v4-pro para repetir la prueba. La respuesta puede incluir un nombre de modelo con versión; continúa usando los ID de modelo públicos anteriores en las solicitudes.

3. Llama a DeepSeek desde Python

Instala el SDK:

python -m pip install openai

Guarda como deepseek_example.py, luego ejecuta python deepseek_example.py:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["APIMASTER_API_KEY"],
    base_url="https://apimaster.ai/v1",
)
response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "Reply with exactly: DEEPSEEK_TEST_OK"}],
    max_tokens=256,
)
print(response.choices[0].message.content)

Para una tarea de codificación, reemplaza el mensaje con tus requisitos. Aumenta el presupuesto de salida para respuestas más largas; el presupuesto de prueba corto no es adecuado para generar una aplicación completa.

4. Llama a DeepSeek desde JavaScript

Usa un entorno Node.js del lado del servidor:

npm install openai

Guarda como deepseek_example.mjs, luego ejecuta node deepseek_example.mjs:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.APIMASTER_API_KEY,
  baseURL: "https://apimaster.ai/v1",
});
const response = await client.chat.completions.create({
  model: "deepseek-v4-pro",
  messages: [{ role: "user", content: "Reply with exactly: DEEPSEEK_TEST_OK" }],
  max_tokens: 256,
});
console.log(response.choices[0].message.content);

5. Transmite la respuesta final

Usando el client de Python anterior:

stream = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "Explain a Python dictionary in three sentences."}],
    max_tokens=1024,
    stream=True,
)
for chunk in stream:
    if not chunk.choices:
        continue
    text = chunk.choices[0].delta.content
    if text:
        print(text, end="", flush=True)
print()

Esto imprime el texto de la respuesta final de content. Algunas respuestas también exponen reasoning_content; está separado de la respuesta final. No asumas que cada fragmento de transmisión contiene texto o una entrada choices.

Solución de problemas

Síntoma	Qué verificar
401	Usa una clave de APIMaster, verifica los espacios en blanco y el encabezado Bearer, y confirma que la variable de entorno esté configurada en esta terminal.
403 o error de acceso al modelo	Verifica los permisos de modelo de la clave y las restricciones de la cuenta.
404	Usa `/v1/chat/completions`; no dupliques `/v1` ni agregues el endpoint a una URL base del SDK.
429 o cuota insuficiente	Lee el cuerpo del error para distinguir un límite de velocidad de un agotamiento de cuota. Reintenta con retroceso para límites de velocidad; verifica el saldo para errores de cuota.
Respuesta vacía o truncada	Inspecciona `finish_reason`, aumenta el presupuesto de tokens y distingue `content` de los campos de razonamiento.
Tiempo de espera o 5xx	Registra la marca de tiempo y el ID de solicitud, reintenta con retroceso y contacta al soporte si persiste. Nunca envíes tu clave completa en un informe de error.

Preguntas frecuentes

¿Es la clave de API la misma que una clave oficial de DeepSeek?

No. Este tutorial usa una clave emitida por APIMaster con el endpoint de APIMaster. Mantén la clave y el endpoint de su proveedor emisor emparejados.

¿Puedo cambiar entre Flash y Pro sin reescribir mi integración?

Sí, cambia el campo model entre deepseek-v4-flash y deepseek-v4-pro, siempre que tu clave pueda acceder a ambos. Verifica la salida de cada modelo y los precios actuales para tu carga de trabajo.

¿Una solicitud exitosa prueba la identidad del modelo subyacente?

No. El éxito HTTP y un nombre de modelo devuelto establecen que una solicitud se completó; no verifican de forma independiente la identidad del modelo.

¿Puedo usar estos modelos en Codex y Claude Code?

Nuestras configuraciones probadas completaron solicitudes de herramientas de texto y lectura de archivos en ambos CLI. Los protocolos difieren: Codex usa /v1/responses, mientras que Claude Code usa /v1/messages. Sigue las guías dedicadas en lugar de sustituir el endpoint de Chat Completions en una configuración de CLI.