Create Chat Completion

Create a chat completion using various AI models

POST /v1/chat/completions

Create chat completion

cURL

curl --request POST \
  --url https://router.requesty.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "messages": [
    {
      "content": "<string>",
      "name": "<string>"
    }
  ],
  "model": "openai/gpt-4o-mini",
  "max_tokens": 123,
  "temperature": 123,
  "top_p": 123,
  "stream": true,
  "tools": [
    {
      "function": {
        "name": "<string>",
        "description": "<string>",
        "parameters": {}
      }
    }
  ],
  "tool_choice": "<string>",
  "response_format": {}
}
'

200

{
  "id": "<string>",
  "object": "<string>",
  "created": 123,
  "model": "<string>",
  "choices": [
    {
      "index": 123,
      "message": {
        "content": "<string>",
        "name": "<string>"
      },
      "finish_reason": "<string>"
    }
  ],
  "usage": {
    "completion_tokens": 123,
    "completion_tokens_details": {
      "reasoning_tokens": 123
    },
    "prompt_tokens": 123,
    "prompt_tokens_details": {
      "cached_tokens": 123,
      "caching_tokens": 123
    },
    "total_tokens": 123,
    "cost": 123
  }
}

PDF Support

Send PDFs using the input_file content type. You can provide the PDF as either base64-encoded data or a URL.

Using Base64-Encoded PDF

curl https://router.requesty.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_REQUESTY_API_KEY" \
  -d '{
    "model": "anthropic/claude-sonnet-4-20250514",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "Summarize this PDF"
          },
          {
            "type": "input_file",
            "filename": "document.pdf",
            "file_data": "data:application/pdf;base64,<base64-encoded-pdf-data>"
          }
        ]
      }
    ]
  }'

Using PDF URL

curl https://router.requesty.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_REQUESTY_API_KEY" \
  -d '{
    "model": "anthropic/claude-sonnet-4-20250514",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "Summarize this PDF"
          },
          {
            "type": "input_file",
            "filename": "document.pdf",
            "file_data": "https://example.com/document.pdf"
          }
        ]
      }
    ]
  }'

Parameters

• type: Must be "input_file"
• filename: The name of the PDF file (e.g., "document.pdf")
• file_data: Either base64-encoded PDF content or a URL to the PDF file

Authorizations

Authorization · string · header · required

API key for authentication

Body

application/json

messages · object[] · required

An array of message objects with role and content

Show child attributes

model · string · default: openai/gpt-4o-mini

The model name. If omitted, defaults to openai/gpt-4o-mini.

Example:

"openai/gpt-4o-mini"

max_tokens · integer

Maximum number of tokens to generate

temperature · number

Controls randomness of the output

top_p · number

Controls diversity of the output

stream · boolean

Enable Server-Sent Events (SSE) streaming responses

tools · object[]

Available tools for function calling

Show child attributes

tool_choice · string

Specifies how tool calling should be handled

response_format · object

For structured responses (some models only)

Response

200

application/json

Chat completion response

id · string · required

Unique identifier for the completion

object · string · required

Object type

created · integer · required

Timestamp of creation

model · string · required

Model used for completion

choices · object[] · required

Show child attributes

usage · object

Show child attributes