deepseek-r1

This documentation is valid for the following list of our models:

• deepseek/deepseek-r1

Model Overview

A cutting-edge reasoning model developed by DeepSeek AI, designed to excel in complex problem-solving, mathematical reasoning, and programming assistance. Leveraging a Mixture-of-Experts (MoE) architecture, the model activates only a subset of its parameters for each token processed, allowing for efficient computation while maintaining high performance across various tasks.

Setup your API Key

If you don’t have an API key for the AI/ML API yet, feel free to use our Quickstart guide.

Submit a request

API Schema

Generate a conversational response using a language model.

Creates a chat completion using a language model, allowing interactive conversation by predicting the next response based on the given chat history. This is useful for AI-driven dialogue systems and virtual assistants.

post

/v1/chat/completions

Authorizations

Body

frequency_penaltynumber | nullable

logprobsboolean | nullable

top_logprobsnumber | nullable

max_tokensnumber · min: 1 · default: 512

max_completion_tokensinteger · min: 1

ninteger | nullable

presence_penaltynumber | nullable

seedinteger · min: 1

streamboolean · default: false

top_pnumber · min: 0.1 · max: 1

temperaturenumber · max: 2

parallel_tool_callsboolean

modelundefined · enumrequired

Options: deepseek/deepseek-r1

reasoning_effortstring · enum

Options: low, medium, high

logit_biasobject | nullable

stream_optionsobject

stopany of

tool_choiceany of

toolsobject[]

response_formatone of

predictionobject

messagesone of[]required

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.aimlapi.com/v1/chat/completions' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "frequency_penalty": 1,
    "logprobs": true,
    "top_logprobs": 1,
    "max_tokens": 512,
    "max_completion_tokens": 1,
    "n": 1,
    "presence_penalty": 1,
    "seed": 1,
    "stream": false,
    "top_p": 1,
    "temperature": 1,
    "parallel_tool_calls": true,
    "model": "deepseek/deepseek-r1",
    "reasoning_effort": "low",
    "logit_bias": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "stream_options": {
      "include_usage": true
    },
    "stop": "text",
    "tool_choice": "none",
    "tools": [
      {
        "type": "function",
        "function": {
          "description": "text",
          "name": "text",
          "parameters": null,
          "required": [
            "text"
          ]
        }
      }
    ],
    "response_format": {
      "type": "text"
    },
    "prediction": {
      "type": "content",
      "content": "text"
    },
    "messages": [
      {
        "name": "text",
        "role": "system",
        "content": "text"
      }
    ]
  }'

201

201

No body