DeepSeek R1

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

• deepseek/deepseek-r1

Model Overview

DeepSeek R1 is 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 | nullableoptional

logit_biasobject | nullableoptional

logprobsboolean | nullableoptional

top_logprobsnumber | nullableoptional

max_tokensnumber · min: 1 · default: 512optional

max_completion_tokensinteger · min: 1optional

ninteger | nullableoptional

predictionobjectoptional

presence_penaltynumber | nullableoptional

seedinteger · min: 1optional

messagesone of[]required

streamboolean · default: falseoptional

stream_optionsobjectoptional

top_pnumber · min: 0.1 · max: 1optional

temperaturenumber · max: 2optional

stopany ofoptional

toolsobject[]optional

tool_choiceany ofoptional

parallel_tool_callsbooleanoptional

reasoning_effortstring · enumoptional

Options: low, medium, high

response_formatone ofoptional

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": 1,
    "max_completion_tokens": 1,
    "n": 1,
    "prediction": {
      "type": "content",
      "content": "text"
    },
    "presence_penalty": 1,
    "seed": 1,
    "messages": [
      {
        "role": "system",
        "content": "text",
        "name": "text"
      }
    ],
    "stream": true,
    "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