Skip to main content
POST
https://api.naga.ac
/
v1
/
chat
/
completions
Chat Completions
curl --request POST \
  --url https://api.naga.ac/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "messages": [
    {}
  ],
  "tools": [
    {}
  ],
  "tool_choice": {},
  "response_format": {},
  "temperature": 123,
  "top_p": 123,
  "stream": true,
  "stream_options": {},
  "stop": [
    "<string>"
  ],
  "max_completion_tokens": 123,
  "reasoning_effort": "<string>",
  "presence_penalty": 123,
  "frequency_penalty": 123,
  "logit_bias": {},
  "parallel_tool_calls": true,
  "prediction.static_content": {},
  "web_search_options": {},
  "image_config": {}
}
'
{
  "id": "<string>",
  "object": "<string>",
  "created": 123,
  "model": "<string>",
  "choices": [
    {
      "index": 123,
      "message": {
        "role": "<string>",
        "content": "<string>",
        "tool_calls": [
          {}
        ]
      },
      "finish_reason": "<string>"
    }
  ],
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 123,
    "total_tokens": 123
  }
}
OpenAI-compatible The request/response format mirrors OpenAI’s Chat Completions. Bring your existing OpenAI SDK code and only change baseURL and the apiKey.

​
Request Parameters

​
model
string
required
Target model ID.
​
messages
array
required
Chat messages. Each item:
  • role (string): “system” | “user” | “assistant” | “tool”
  • content (string or array): Text, or an array of blocks including:
    • Text: { "type": "text", "text": "..." }
    • Image: { "type": "image_url", "image_url": { "url": "https://...", "detail": "low|high|auto" } }
    • File (PDF): { "type": "file", "file": { "filename": "...", "file_data": "https://..." } }
    • Audio (Gemini only): { "type": "input_audio", "input_audio": { "data": "BASE64", "format": "wav|mp3" } }
​
tools
array
Tool definitions (JSON), OpenAI-compatible.
​
tool_choice
string | object
Tool forcing strategy.
​
response_format
object
  • Text: { "type": "text" }
  • JSON object: { "type": "json_object" }
  • JSON schema: { "type": "json_schema", "json_schema": { "name": "...", "schema": { ... }, "strict": true } }
​
temperature
number
Sampling temperature (0..2).
​
top_p
number
Nucleus sampling probability (0..1).
​
stream
boolean
default:"false"
Whether to stream the response.
​
stream_options
object
{ "include_usage": boolean }
​
stop
string | string[]
Stop sequences.
​
max_completion_tokens
integer
Maximum number of tokens to generate.
​
reasoning_effort
string
“minimal” | “low” | “medium” | “high”
​
presence_penalty
number
Penalty for new tokens based on their presence in the text so far (-2..2).
​
frequency_penalty
number
Penalty for new tokens based on their frequency in the text so far (-2..2).
​
logit_bias
object
Modify the likelihood of specified tokens appearing in the completion.
​
parallel_tool_calls
boolean
Whether to enable parallel tool calls.
​
prediction.static_content
object
Pre-seeded content for structured tasks.
​
web_search_options
object
Optional web search config.
​
image_config
object
Image generation configuration (for models with native image generation like gemini-2.5-flash-image) - aspect_ratio (string): Aspect ratio for generated images. Supported values: “1:1”, “2:3”, “3:2”, “3:4”, “4:3”, “4:5”, “5:4”, “9:16”, “16:9”, “21:9”
See Features → Multimodal for details about text, image, file, and audio blocks in messages.

​
Example Request

from openai import OpenAI

client = OpenAI(
    base_url="https://api.naga.ac/v1",
    api_key="YOUR_API_KEY",
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {"role": "user", "content": "What's 2+2?"}
    ],
    temperature=0.2,
)
print(resp.choices[0].message.content)

​
Multimodal Example

Image and file inputs follow the same content-array format: 
{
  "model": "gemini-2.5-flash",
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "text", "text": "What is in this audio and document?" },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://upload.wikimedia.org/wikipedia/commons/thumb/d/dd/Gfp-wisconsin-madison-the-nature-boardwalk.jpg/2560px-Gfp-wisconsin-madison-the-nature-boardwalk.jpg"
          }
        },
        {
          "type": "input_audio",
          "input_audio": { "data": "BASE64_AUDIO", "format": "wav" }
        },
        {
          "type": "file",
          "file": {
            "filename": "document.pdf",
            "file_data": "https://bitcoin.org/bitcoin.pdf"
          }
        }
      ]
    }
  ]
}
See Features → Multimodal for provider-specific modality support.

​
Response

A standard OpenAI-compatible response including:
  • id, object, created, model
  • choices (array) with message, finish_reason, etc.
  • Optional usage if enabled (stream_options.include_usage or at final response)
When stream=true, server-sent events follow the OpenAI streaming format.

​
Response Fields

​
id
string
Unique request identifier
​
object
string
Always “chat.completion” or “chat.completion.chunk” for streaming
​
created
integer
Unix timestamp of request creation
​
model
string
The model used for completion
​
choices
array
Array of completion choices
​
usage
object
Token usage statistics