Create a message

curl --request POST \
  --url https://api.naga.ac/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "claude-sonnet-4.5",
  "max_tokens": 512,
  "messages": [
    {
      "role": "user",
      "content": "Explain the CAP theorem in one paragraph."
    }
  ]
}
'

{
  "content": [
    {
      "text": "The CAP theorem states that a distributed system can guarantee at most two of consistency, availability, and partition tolerance at the same time once network partitions are possible.",
      "type": "text"
    }
  ],
  "created": 1743393600,
  "id": "msg_123",
  "model": "claude-sonnet-4.5",
  "role": "assistant",
  "stop_reason": "end_turn",
  "type": "message",
  "usage": {
    "input_tokens": 17,
    "output_tokens": 32
  }
}

{
  "error": {
    "message": "The request body is invalid.",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "message": "The request body is invalid.",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "message": "The request body is invalid.",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "message": "The request body is invalid.",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "message": "The request body is invalid.",
    "type": "invalid_request_error"
  }
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

{
  "error": {
    "message": "The request body is invalid.",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "message": "The request body is invalid.",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "message": "The request body is invalid.",
    "type": "invalid_request_error"
  }
}

POST

messages

curl --request POST \
  --url https://api.naga.ac/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "claude-sonnet-4.5",
  "max_tokens": 512,
  "messages": [
    {
      "role": "user",
      "content": "Explain the CAP theorem in one paragraph."
    }
  ]
}
'

{
  "content": [
    {
      "text": "The CAP theorem states that a distributed system can guarantee at most two of consistency, availability, and partition tolerance at the same time once network partitions are possible.",
      "type": "text"
    }
  ],
  "created": 1743393600,
  "id": "msg_123",
  "model": "claude-sonnet-4.5",
  "role": "assistant",
  "stop_reason": "end_turn",
  "type": "message",
  "usage": {
    "input_tokens": 17,
    "output_tokens": 32
  }
}

{
  "error": {
    "message": "The request body is invalid.",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "message": "The request body is invalid.",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "message": "The request body is invalid.",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "message": "The request body is invalid.",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "message": "The request body is invalid.",
    "type": "invalid_request_error"
  }
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

{
  "error": {
    "message": "The request body is invalid.",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "message": "The request body is invalid.",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "message": "The request body is invalid.",
    "type": "invalid_request_error"
  }
}

Authorizations

Authorization

string

header

required

Primary authentication for inference endpoints. Send your Naga API key as Authorization: Bearer <api-key>.

Body

application/json

Stateless Messages API endpoint (Anthropic Messages API compatibility).

Request surface is intentionally limited to what maps into our internal /v1/chat/completions pipeline.

model

string

required

Model identifier to route the request to.

Example:

"claude-sonnet-4.5"

max_tokens

integer

required

Maximum number of output tokens to generate.

Required range: x >= 1

messages

MessageParam · object[]

required

Conversation history in Anthropic Messages format.

Required array length: 1 - 100000 elements

Show child attributes

system

stream

boolean

default:false

Return Anthropic-style SSE events instead of a single JSON response.

temperature

number | null

Required range: 0 <= x <= 2

top_p

number | null

Required range: 0 <= x <= 1

stop_sequences

string[] | null

tools

(ToolParam · object | WebSearchToolParam · object)[] | null

ToolParam
WebSearchToolParam

Show child attributes

tool_choice

ToolChoiceAutoParam · object

ToolChoiceAutoParam
ToolChoiceAnyParam
ToolChoiceToolParam
ToolChoiceNoneParam

Show child attributes

thinking

ThinkingConfigEnabledParam · object

ThinkingConfigEnabledParam
ThinkingConfigDisabledParam
ThinkingConfigAdaptiveParam

Show child attributes

output_config

OutputConfigParam · object | null

Show child attributes

Response

JSON response when stream=false, or Anthropic-style Server-Sent Events when stream=true.

string

required

model

string

required

content

(AnthropicTextBlockResponse · object | AnthropicThinkingBlockResponse · object | AnthropicImageBlockResponse · object | AnthropicSearchResultBlockResponse · object | AnthropicToolUseBlockResponse · object)[]

required

AnthropicTextBlockResponse
AnthropicThinkingBlockResponse
AnthropicImageBlockResponse
AnthropicSearchResultBlockResponse
AnthropicToolUseBlockResponse

Show child attributes

created

integer

required

type

string

default:message

Allowed value: "message"

role

string

default:assistant

Allowed value: "assistant"

stop_reason

string | null

stop_sequence

string | null

usage

AnthropicUsageResponse · object | null

Show child attributes

Overview

Endpoints

Authorizations

Body

Response