Guía de API de DeepSeek V4

Modelos de DeepSeek V4 publicados

Cuando está habilitado, el registro de modelos muestra los nombres, identificadores exactos de enrutamiento, versiones y estado de inferencia. Si el identificador está vacío, significa que el catálogo no ha publicado un valor de enrutamiento; no lo deduzca a partir del nombre del modelo.

Desarrollador

DeepSeek

Acceso para nuevos clientes

Disponible

Envíe su primera solicitud

Envía solicitudes HTTPS a la URL base indicada. Usa POST /chat/completions para chat de texto compatible con OpenAI o POST /messages para Claude Messages. Selecciona el protocolo en el banco de trabajo del modelo y utiliza su URL y formato JSON exactos.

URL base de la API: https://fusionpointai.com/api/v1

Cree o gestione una clave de API de cliente en la configuración de claves de su cuenta. Envíela como token bearer y guárdela en un servidor de confianza; no la incluya en código del navegador, control de versiones ni registros públicos.

La clave necesita el ámbito ai:inference y acceso a la suscripción de cliente pertinente. La clave de API pública no es la contraseña de la cuenta y no debe compartirse.

Estos ejemplos usan el punto de acceso JSON registrado de Chat Completions y los clientes Python y Node.js compatibles con OpenAI. Guarde la clave en la variable de entorno FUSIONPOINTAI_API_KEY. Sustituya el valor de model únicamente por un identificador exacto de los que aparecen arriba.

# Install the client for your application language.
# Python:
python -m pip install openai
# Node.js:
npm install openai

# Bash: enter the key without storing it in shell history.
read -rs -p 'FusionPointAI API key: ' FUSIONPOINTAI_API_KEY
export FUSIONPOINTAI_API_KEY
printf '\n'
# After finishing:
# unset FUSIONPOINTAI_API_KEY

curl 'https://fusionpointai.com/api/v1/chat/completions' \
  -H "Authorization: Bearer $FUSIONPOINTAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
    "model": "deepseek-flash",
    "messages": [
        {
            "role": "user",
            "content": "Summarize this in one sentence."
        }
    ],
    "temperature": 0.7,
    "max_tokens": 300
}'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FUSIONPOINTAI_API_KEY"],
    base_url="https://fusionpointai.com/api/v1",
)

response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "Summarize this in one sentence."}],
    temperature=0.7,
    max_tokens=300,
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.FUSIONPOINTAI_API_KEY,
  baseURL: "https://fusionpointai.com/api/v1",
});

const response = await client.chat.completions.create({
  model: "deepseek-flash",
  messages: [{ role: "user", content: "Summarize this in one sentence." }],
  temperature: 0.7,
  max_tokens: 300,
});
console.log(response.choices[0].message.content);

OpenAI · Contrato de solicitud y respuesta

El punto de acceso acepta JSON. Los mensajes se envían en orden y cada uno contiene un rol admitido y contenido de tipo string. Los parámetros opcionales de generación deben respetar los límites de validación indicados. La respuesta es un objeto JSON chat.completion con choices y, si el proveedor lo devuelve, el uso de tokens.

Estructura de la respuesta

Una respuesta correcta contiene id, object (chat.completion), created, model y choices. Cada choice incluye su índice, un mensaje del asistente y finish_reason. usage puede incluir el número de tokens. Aunque una solicitud supere la validación del gateway, pueden aplicarse límites específicos del proveedor.

{
    "id": "chatcmpl_example",
    "object": "chat.completion",
    "created": 1700000000,
    "model": "deepseek-flash",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "A concise summary of the supplied text."
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 12,
        "completion_tokens": 10,
        "total_tokens": 22
    }
}

Acceso, límites y uso seguro

Las suscripciones activas de clientes no descuentan las solicitudes ni los tokens de una cuota; las claves de sandbox sí están sujetas a la asignación mensual publicada. Esta condición de la suscripción es independiente de los límites técnicos del modelo y del proveedor ascendente.

• Las ventanas de contexto, el tamaño máximo de salida, las funciones admitidas en las solicitudes y los controles temporales de tráfico del proveedor ascendente pueden variar. Consulte la información del proveedor y del modelo antes de enviar tráfico de producción.
• El punto de acceso aplica un límite de 60 solicitudes por minuto para cada identidad de limitación pertinente. HTTP 429 también puede indicar controles temporales de tráfico del proveedor ascendente; reduzca el ritmo y reintente con pausas, no en un bucle continuo.
• Use HTTPS, mantenga las claves en el servidor, conceda solo el ámbito de inferencia necesario y revoque cuanto antes una clave que pueda haberse expuesto.
• Chat Completions admite texto síncrono. Claude Messages admite por separado bloques de contenido nativos, herramientas y SSE cuando el modelo seleccionado lo permite. Estos contratos no incluyen otros puntos de acceso de proveedores.

Acceso al proveedor y requisitos de la cuenta

Autentíquese con una clave de API de cliente que tenga el ámbito ai:inference y pertenezca a una cuenta con acceso a este servicio. El catálogo indica si actualmente se admiten nuevos clientes. No concede acceso, crea una suscripción ni sustituye los permisos de la cuenta o de la clave.

Errores y resolución de problemas

Los errores de validación y los resultados no utilizables del proveedor que devuelve el punto de acceso se presentan en un objeto JSON con message, type y code; los errores de validación también pueden incluir detalles de campos. No incluya claves de API ni contenido privado de las instrucciones en las solicitudes de asistencia.

Los errores de validación y del proveedor devueltos por la operación de chat usan un objeto error. El middleware de autenticación, ámbitos y límites puede devolver, en su lugar, un campo message de nivel superior. Compruebe conjuntamente el estado y el cuerpo de la respuesta.

Preguntas frecuentes