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.

post

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.

Authorizations

Body

modelundefined · enumrequired

Options: deepseek/deepseek-r1

frequency_penaltynumber | nullable

logit_biasobject | nullable

logprobsboolean | nullable

top_logprobsnumber | nullable

max_tokensnumber · min: 1 · default: 512

max_completion_tokensinteger · min: 1

ninteger | nullable

predictionobject

presence_penaltynumber | nullable

seedinteger · min: 1

messagesone of[]required

streamboolean · default: false

stream_optionsobject

top_pnumber · min: 0.1 · max: 1

temperaturenumber · max: 2

stopany of

toolsobject[]

tool_choiceany of

parallel_tool_callsboolean

reasoning_effortstring · enum

Options: low, medium, high

response_formatone of

Responses

cURL

JavaScript

Python

HTTP

cURL

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

201

201

No body