DeepSeek V4 Pro API: контекст 1M, ответ 384K

deepseek/v4-pro/chat

DeepSeek V4 Pro в чате через OpenAI-совместимый эндпоинт. Принимает до 1 048 576 токенов текста, отвечает до 384 000; reasoning effort low или high (по умолчанию high), до 128 описаний инструментов и формат ответа JSON.

Ввод $1.32Вывод $3.96за 1 млн токеновКешированный ввод $0.044

Запустить модель Открыть API

Отправить запрос

Примеры используют публичные параметры выбранного эндпоинта. Замените API-ключ и примеры медиафайлов, затем отправьте запрос со своего сервера.

SDK и интеграции

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

Аутентификация API

Храните API-ключ в серверной переменной окружения SPICY_API_KEY. Используйте Bearer-аутентификацию и Content-Type: application/json для 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'

Пример построен по входной схеме этой модели — той же, по которой API проверяет каждый запрос.

Для одного логического запроса сохраняйте один Idempotency-Key. После обрыва сети не отправляйте запрос автоматически с новым ключом. Сохраните request_id для проверки уже принятого запроса. Предыдущий поток чата повторно не воспроизводится.

Входные параметры

Параметры модели находятся на одном уровне с model в теле JSON. Этот эндпоинт не использует объект-обёртку input.

messagesarray<object>Обязательно

Не более 256 упорядоченных реплик, только текст. Возвращайте reasoning_content в реплике assistant, чтобы разговор с инструментами оставался связным.

По умолчанию: Не задано
Ограничения: minItems:1
maxItems:256

messages[].rolestringОбязательно внутри объекта

Role of the message author.

По умолчанию: Не задано
Допустимые значения: "system""developer""user""assistant""tool"

messages[].namestringНеобязательно

Optional name identifying the speaker within its role.

По умолчанию: Не задано

messages[].contentstring | array | nullНеобязательно

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

По умолчанию: Не задано

{
  "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>Необязательно

Tool calls the assistant requested in this message.

По умолчанию: Не задано

messages[].tool_call_idstringНеобязательно

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

По умолчанию: Не задано

messages[].reasoning_contentstringНеобязательно

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

По умолчанию: Не задано

{
  "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_formatobjectНеобязательно

Запрашивайте объект JSON, когда ответ потребляет код.

По умолчанию: Не задано

tool_choicestring | objectНеобязательно

auto, none, required или объект с именем вызываемой функции.

По умолчанию: Не задано

parallel_tool_callsbooleanНеобязательно

true или false, по умолчанию true: модель может запросить несколько вызовов инструментов за один ход. При false за ход будет не больше одного вызова — это удобно в циклах, где каждый вызов зависит от результата предыдущего. На цену не влияет.

По умолчанию: true

toolsarray<object>Необязательно

До 128 описаний функций на запрос.

По умолчанию: Не задано
Ограничения: maxItems:128

max_tokensintegerНеобязательно

Ограничивает ответ значением 384 000. Значение по умолчанию 32 768 обрежет план миграции без всякой ошибки. Токены рассуждения тарифицируются как вывод, поэтому оставляйте запас сверх ожидаемого видимого ответа.

По умолчанию: 32768
Ограничения: minimum:1
maximum:384000

stopstring | arrayНеобязательно

До 4 последовательностей — строкой или массивом. Ответ обрывается, как только модель пишет одну из них, а совпавший текст не возвращается. Значения по умолчанию нет. Тариф не меняется: оборванный раньше ответ оплачивается только за фактически сгенерированные токены.

По умолчанию: Не задано
Ограничения: minLength:1
minItems:1
maxItems:4

reasoning_effortstringНеобязательно

none, low или high, по умолчанию high. none полностью пропускает этап рассуждения — это единственная настройка, при которой токены рассуждения не попадают в счёт, поскольку тарифицируются как вывод. low — для объёмных проходов, high — для ответов, где ошибка недопустима.

По умолчанию: "high"
Допустимые значения: "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
}

Прочитать результат

При stream: false запрос сразу возвращает полный ответ чата. Читайте choices[].message; опрашивать задачу не нужно. Если клиент поддерживает Server-Sent Events, можно указать stream: true.

Пример ответа после завершения

{
  "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
  }
}

Ответ приведён для примера структуры. usage содержит число токенов; фактический расход и стоимость зависят от запроса.

SDK и интеграции

Используйте SpicyAPI в приложении, терминале, ИИ-ассистенте или визуальном процессе. Выберите руководство по настройке.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Команды терминала и скрипты автоматизации.

MCP

Claude Code · Cursor · Codex

Agent Skill

Многоразовые инструкции для ИИ-ассистента.

n8n

Узлы сообщества для самостоятельного хостинга и импортируемые шаблоны HTTP Request для n8n Cloud.

ComfyUI

Процессы работы с изображениями, видео и аудио на узловом холсте.

Другие интеграции

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

Посмотреть готовые рабочие процессы

Это чат-модель, поэтому она работает везде, где работает chat API от OpenAI: клиент оставьте свой, поменяйте базовый URL и укажите идентификатор этой модели.

Направьте сюда любой OpenAI-совместимый клиент

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

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

Все инструменты, поддерживающие OpenAI chat API, подключаются одинаково: SDK, Vercel AI SDK, LangChain, aider и Cline. Сервер MCP и CLI spicyapi работают с асинхронными задачами обработки медиа. Настройка каждого инструмента описана в разделе для разработчиков.

Использование в SillyTavern и приложениях для ролевых игр

В SillyTavern, RisuAI, Agnai или любом приложении с OpenAI-совместимой настройкой вставьте базовый URL ниже и свой API-ключ, а в качестве модели выберите deepseek/v4-pro/chat. Вызовы прямо из браузера разрешены, а ползунки, которые эта модель не поддерживает, игнорируются, а не вызывают ошибку.

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

Руководство по SillyTavern RisuAI, Agnai и другие Расширение для SillyTavern

Использование в ComfyUI

Установите узлы SpicyAPI через ComfyUI Manager или командой ниже и выберите deepseek/v4-pro/chat в узле SpicyAPI Chat, чтобы использовать эту модель внутри графа ComfyUI.

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

Готовые воркфлоу Руководство по установке Исходный код на GitHub

Встроенная панель читает ту же схему, что и эта страница, поэтому не может разойтись с API. Если содержимое должно индексироваться поиском по документации, возьмите JSON из /api/embed/models/ и отрисуйте его самостоятельно.

<iframe src="https://spicyapi.ai/embed/ru/models/deepseek-v4-pro/api?model=deepseek%2Fv4-pro%2Fchat" width="100%" height="560" loading="lazy" title="Пример запроса" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Открыть панель

Рабочая область

Отправить запрос

Аутентификация API

Входные параметры

Прочитать результат

SDK и интеграции

Использование в SillyTavern и приложениях для ролевых игр

Использование в ComfyUI