API DeepSeek V4 Pro : contexte 1M, 384K sortie

deepseek/v4-pro/chat

Chat DeepSeek V4 Pro via un endpoint compatible OpenAI. Il accepte jusqu’à 1 048 576 tokens de texte et en renvoie jusqu’à 384 000, avec effort de raisonnement low ou high (high par défaut), jusqu’à 128 définitions d’outils et format de réponse JSON.

Entrée $1.32Sortie $3.96par 1 million de tokensEntrée en cache $0.044

Exécuter le modèle Voir l’API

Envoyer une requête

Les exemples suivent les paramètres publics du point de terminaison choisi. Remplacez la clé API et les médias d’exemple, puis envoyez la requête depuis votre serveur.

SDK et intégrations

POSThttps://api.spicyapi.ai/v1/chat/completions

Authentification API

Conservez la clé API dans la variable serveur SPICY_API_KEY. Utilisez l’authentification Bearer et Content-Type: application/json pour les requêtes JSON.

Authorization: Bearer $SPICY_API_KEY

curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "deepseek/v4-pro/chat",
  "messages": [
    {
      "role": "user",
      "content": "Summarise the following release notes into three bullet points."
    }
  ],
  "stream": true
}' \
  | jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'

Généré à partir du schéma d’entrée de ce modèle, le même que l’API utilise pour valider chaque requête.

Conservez le même Idempotency-Key pour chaque requête logique. Après une coupure réseau, ne renvoyez pas automatiquement la requête avec une nouvelle clé. Gardez request_id pour retrouver la requête acceptée. Le flux de chat précédent n’est pas rejoué.

Paramètres d’entrée

Placez les paramètres du modèle au même niveau que model dans le corps JSON. Ce point de terminaison ne les encapsule pas dans un objet input.

messagesarray<object>Obligatoire

256 tours ordonnés au maximum, contenu texte uniquement. Renvoyez reasoning_content sur un tour assistant pour garder une conversation à outils cohérente.

Valeur par défaut: Non définie
Contraintes: minItems:1
maxItems:256

messages[].rolestringObligatoire dans l’objet

Role of the message author.

Valeur par défaut: Non définie
Valeurs autorisées: "system""developer""user""assistant""tool"

messages[].namestringFacultatif

Optional name identifying the speaker within its role.

Valeur par défaut: Non définie

messages[].contentstring | array | nullFacultatif

Message content, either plain text or a list of content parts.

Valeur par défaut: Non définie

{
  "type": [
    "string",
    "array",
    "null"
  ],
  "items": {
    "oneOf": [
      {
        "type": "object",
        "required": [
          "type",
          "text"
        ],
        "properties": {
          "text": {
            "type": "string"
          },
          "type": {
            "const": "text"
          }
        }
      }
    ]
  },
  "description": "Message content, either plain text or a list of content parts."
}

messages[].tool_callsarray<object>Facultatif

Tool calls the assistant requested in this message.

Valeur par défaut: Non définie

messages[].tool_call_idstringFacultatif

Identifier of the tool call this message answers. Required on tool messages.

Valeur par défaut: Non définie

messages[].reasoning_contentstringFacultatif

Reasoning text from a previous assistant reply, preserved when continuing a tool conversation.

Valeur par défaut: Non définie

{
  "type": "array",
  "x-ui": {
    "order": 100,
    "widget": "chat-messages",
    "primary": true
  },
  "items": {
    "type": "object",
    "allOf": [
      {
        "if": {
          "required": [
            "reasoning_content"
          ]
        },
        "then": {
          "properties": {
            "role": {
              "const": "assistant"
            }
          }
        }
      }
    ],
    "required": [
      "role"
    ],
    "properties": {
      "name": {
        "type": "string",
        "description": "Optional name identifying the speaker within its role."
      },
      "role": {
        "enum": [
          "system",
          "developer",
          "user",
          "assistant",
          "tool"
        ],
        "type": "string",
        "description": "Role of the message author."
      },
      "content": {
        "type": [
          "string",
          "array",
          "null"
        ],
        "items": {
          "oneOf": [
            {
              "type": "object",
              "required": [
                "type",
                "text"
              ],
              "properties": {
                "text": {
                  "type": "string"
                },
                "type": {
                  "const": "text"
                }
              }
            }
          ]
        },
        "description": "Message content, either plain text or a list of content parts."
      },
      "tool_calls": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Tool calls the assistant requested in this message."
      },
      "tool_call_id": {
        "type": "string",
        "description": "Identifier of the tool call this message answers. Required on tool messages."
      },
      "reasoning_content": {
        "type": "string",
        "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
      }
    },
    "additionalProperties": false
  },
  "maxItems": 256,
  "minItems": 1,
  "description": "Conversation history in order, oldest message first."
}

response_formatobjectFacultatif

Réclamez un objet JSON quand la réponse est consommée par du code.

Valeur par défaut: Non définie

tool_choicestring | objectFacultatif

auto, none, required, ou un objet qui nomme la fonction à appeler.

Valeur par défaut: Non définie

parallel_tool_callsbooleanFacultatif

true ou false, true par défaut : le modèle peut demander plusieurs appels d’outils dans un même tour. Avec false, vous obtenez au plus un appel par tour, pour les boucles où chaque appel dépend du résultat précédent. Aucun effet sur le prix.

Valeur par défaut: true

toolsarray<object>Facultatif

Jusqu’à 128 définitions de fonctions par requête.

Valeur par défaut: Non définie
Contraintes: maxItems:128

max_tokensintegerFacultatif

Plafonne la réponse à 384 000. Le défaut de 32 768 tronquera un plan de migration sans lever d’erreur. Les tokens de raisonnement sont aussi facturés en sortie : prévoyez donc de la marge au-dessus de la réponse visible attendue.

Valeur par défaut: 32768
Contraintes: minimum:1
maximum:384000

stopstring | arrayFacultatif

Jusqu’à 4 séquences, sous forme de chaîne ou de tableau. La réponse s’arrête dès que le modèle en écrit une, et le texte correspondant n’est pas renvoyé. Pas de valeur par défaut. Le tarif ne change pas : une réponse coupée plus tôt n’est facturée que pour les tokens produits.

Valeur par défaut: Non définie
Contraintes: minLength:1
minItems:1
maxItems:4

reasoning_effortstringFacultatif

none, low ou high, high par défaut. none saute entièrement la passe de raisonnement : c’est le seul réglage qui garde les tokens de raisonnement hors de la facture, car ils sont facturés comme sortie. low pour les passes de volume, high pour les réponses qui ne doivent pas être fausses.

Valeur par défaut: "high"
Valeurs autorisées: "none""low""high"

{
  "type": "object",
  "required": [
    "messages"
  ],
  "x-pricing": {
    "billingMode": "formula",
    "variantFields": []
  },
  "properties": {
    "stop": {
      "type": [
        "string",
        "array"
      ],
      "x-ui": {
        "order": 65,
        "widget": "text",
        "affects_price": false
      },
      "items": {
        "type": "string",
        "minLength": 1
      },
      "maxItems": 4,
      "minItems": 1,
      "minLength": 1,
      "description": "Sequences that end the reply as soon as the model writes one; the matched text is not returned."
    },
    "tools": {
      "type": "array",
      "x-ui": {
        "order": 35,
        "widget": "json"
      },
      "items": {
        "type": "object"
      },
      "maxItems": 128,
      "description": "Tool definitions the model may call."
    },
    "messages": {
      "type": "array",
      "x-ui": {
        "order": 100,
        "widget": "chat-messages",
        "primary": true
      },
      "items": {
        "type": "object",
        "allOf": [
          {
            "if": {
              "required": [
                "reasoning_content"
              ]
            },
            "then": {
              "properties": {
                "role": {
                  "const": "assistant"
                }
              }
            }
          }
        ],
        "required": [
          "role"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Optional name identifying the speaker within its role."
          },
          "role": {
            "enum": [
              "system",
              "developer",
              "user",
              "assistant",
              "tool"
            ],
            "type": "string",
            "description": "Role of the message author."
          },
          "content": {
            "type": [
              "string",
              "array",
              "null"
            ],
            "items": {
              "oneOf": [
                {
                  "type": "object",
                  "required": [
                    "type",
                    "text"
                  ],
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "type": {
                      "const": "text"
                    }
                  }
                }
              ]
            },
            "description": "Message content, either plain text or a list of content parts."
          },
          "tool_calls": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Tool calls the assistant requested in this message."
          },
          "tool_call_id": {
            "type": "string",
            "description": "Identifier of the tool call this message answers. Required on tool messages."
          },
          "reasoning_content": {
            "type": "string",
            "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 256,
      "minItems": 1,
      "description": "Conversation history in order, oldest message first."
    },
    "max_tokens": {
      "type": "integer",
      "x-ui": {
        "unit": "tokens",
        "order": 60,
        "widget": "number",
        "advanced": false,
        "affects_price": false
      },
      "default": 32768,
      "maximum": 384000,
      "minimum": 1,
      "description": "Maximum number of tokens to generate in the reply."
    },
    "tool_choice": {
      "type": [
        "string",
        "object"
      ],
      "x-ui": {
        "order": 30,
        "widget": "json"
      },
      "description": "Controls whether and which tool the model may call."
    },
    "response_format": {
      "type": "object",
      "x-ui": {
        "order": 25,
        "widget": "json"
      },
      "description": "Requested reply format, such as plain text or a JSON object."
    },
    "reasoning_effort": {
      "enum": [
        "none",
        "low",
        "high"
      ],
      "type": "string",
      "x-ui": {
        "order": 70,
        "widget": "radio"
      },
      "default": "high",
      "description": "How much reasoning the model spends before answering."
    },
    "parallel_tool_calls": {
      "type": "boolean",
      "x-ui": {
        "order": 33,
        "widget": "switch",
        "affects_price": false
      },
      "default": true,
      "description": "Whether the model may request more than one tool call in a single turn."
    }
  },
  "x-input-token-limit": 1048576,
  "additionalProperties": false
}

Lire le résultat

Avec stream à false, la requête renvoie directement la réponse complète : lisez choices[].message, sans interroger de tâche. Passez stream à true si votre client gère les Server-Sent Events.

Exemple de réponse terminée

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "deepseek/v4-pro/chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is a concise summary of the release notes."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 14,
    "total_tokens": 46
  }
}

Cette réponse n’illustre que la structure. usage donne le nombre de tokens ; la consommation et le coût réels dépendent de votre requête.

SDK et intégrations

Utilisez SpicyAPI dans votre application, terminal, assistant IA ou workflow visuel. Choisissez un guide de configuration.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Commandes de terminal et scripts d’automatisation.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instructions réutilisables pour votre assistant IA.

n8n

Nœuds communautaires pour n8n auto-hébergé et workflows HTTP Request à importer dans n8n Cloud.

ComfyUI

Workflows image, vidéo et audio sur un canevas de nœuds.

Autres intégrations

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

Parcourir les workflows prêts à utiliser

C’est un modèle de conversation : il fonctionne partout où fonctionne l’API chat d’OpenAI. Gardez votre client, changez l’URL de base, désignez ce modèle par son identifiant.

Pointez ici n’importe quel client compatible OpenAI

export OPENAI_BASE_URL="https://api.spicyapi.ai/v1"
export OPENAI_API_KEY="$SPICY_API_KEY"

aider --model openai/deepseek/v4-pro/chat

Tout outil compatible avec l’API chat d’OpenAI s’utilise de la même façon — les SDK, le Vercel AI SDK, LangChain, aider, Cline. Le serveur MCP et la CLI spicyapi prennent en charge les tâches média asynchrones. Retrouvez la configuration de chaque outil dans l’espace développeurs.

L’utiliser dans SillyTavern et les applis de jeu de rôle

Dans SillyTavern, RisuAI, Agnai ou toute appli dotée d’un réglage compatible OpenAI, collez l’URL de base ci-dessous et votre clé d’API, puis choisissez deepseek/v4-pro/chat comme modèle. Les appels depuis le navigateur sont acceptés, et les curseurs que ce modèle ne prend pas en charge sont ignorés au lieu d’être refusés.

Base URL: https://api.spicyapi.ai/v1
Model: deepseek/v4-pro/chat

Guide SillyTavern RisuAI, Agnai et d’autres Extension SillyTavern

À utiliser dans ComfyUI

Installez les nœuds SpicyAPI depuis ComfyUI Manager ou avec la commande ci-dessous, puis choisissez deepseek/v4-pro/chat dans le nœud SpicyAPI Chat pour utiliser ce modèle dans un graphe ComfyUI.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Exemples de workflows Guide d’installation Code source sur GitHub

Le panneau intégré lit le même schéma que cette page : il ne peut donc pas diverger de l’API. Si votre documentation a besoin d’un contenu indexable, récupérez plutôt le JSON sous /api/embed/models/ et affichez-le vous-même.

<iframe src="https://spicyapi.ai/embed/fr/models/deepseek-v4-pro/api?model=deepseek%2Fv4-pro%2Fchat" width="100%" height="560" loading="lazy" title="Exemple de requête" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Ouvrir le panneau

Atelier

Envoyer une requête

Authentification API

Paramètres d’entrée

Lire le résultat

SDK et intégrations

L’utiliser dans SillyTavern et les applis de jeu de rôle

À utiliser dans ComfyUI