Create Chat Completion

Creates a model response from conversation history. Supports streaming and non-streaming responses. Compatible with the OpenAI Chat Completions API.

POST /v1/chat/completions

Create Chat Completion

cURL

curl --request POST \
  --url https://api.nusabasedigital.com/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-4",
  "messages": [
    {
      "content": "<string>",
      "name": "<string>",
      "tool_calls": [
        {
          "id": "<string>",
          "type": "function",
          "function": {
            "name": "<string>",
            "arguments": "<string>"
          }
        }
      ],
      "tool_call_id": "<string>",
      "reasoning_content": "<string>",
      "reasoning": "<string>"
    }
  ],
  "temperature": 1,
  "top_p": 1,
  "n": 1,
  "stream": false,
  "stream_options": {
    "include_usage": true
  },
  "stop": "<string>",
  "max_tokens": 123,
  "max_completion_tokens": 123,
  "presence_penalty": 0,
  "frequency_penalty": 0,
  "logit_bias": {},
  "user": "<string>",
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "<string>",
        "description": "<string>",
        "parameters": {}
      }
    }
  ],
  "response_format": {
    "json_schema": {}
  },
  "seed": 123,
  "modalities": [],
  "audio": {
    "voice": "<string>",
    "format": "<string>"
  }
}
'

200

{
  "id": "<string>",
  "object": "chat.completion",
  "created": 123,
  "model": "<string>",
  "choices": [
    {
      "index": 123,
      "message": {
        "role": "system",
        "content": "<string>",
        "name": "<string>",
        "tool_calls": [
          {
            "id": "<string>",
            "type": "function",
            "function": {
              "name": "<string>",
              "arguments": "<string>"
            }
          }
        ],
        "tool_call_id": "<string>",
        "reasoning_content": "<string>",
        "reasoning": "<string>"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 123,
    "total_tokens": 123,
    "prompt_tokens_details": {
      "cached_tokens": 123,
      "text_tokens": 123,
      "audio_tokens": 123,
      "image_tokens": 123
    },
    "completion_tokens_details": {
      "text_tokens": 123,
      "audio_tokens": 123,
      "reasoning_tokens": 123
    }
  },
  "system_fingerprint": "<string>",
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

model · string · required

Model ID

Example:

"gpt-4"

messages · object[] · required

List of conversation messages

Show child attributes

temperature · number · default: 1

Sampling temperature

Required range: 0 <= x <= 2

top_p · number · default: 1

Nucleus sampling parameter

Required range: 0 <= x <= 1

n · integer · default: 1

Number of generations

Required range: x >= 1

stream · boolean · default: false

Whether to stream the response

stream_options · object

Show child attributes

stop · string string[]

Stop sequence

max_tokens · integer

Maximum number of generated tokens

max_completion_tokens · integer

Maximum number of completion tokens

presence_penalty · number · default: 0

Required range: -2 <= x <= 2

frequency_penalty · number · default: 0

Required range: -2 <= x <= 2

logit_bias · object

Show child attributes

user · string

tools · object[]

Show child attributes

tool_choice · enum<string> object

Available options: none, auto, required

response_format · object

Show child attributes

seed · integer

reasoning_effort · enum<string>

Reasoning effort (for models that support reasoning)

Available options: low, medium, high

modalities · enum<string>[]

Available options: text, audio

audio · object

Show child attributes

Response

200

application/json

Response created successfully

id · string

object · string

Example:

"chat.completion"

created · integer

model · string

choices · object[]

Show child attributes

usage · object

Show child attributes

system_fingerprint · string

error · object

Error profile (non-streaming only)

Show child attributes