API Reference¶

Complete documentation for the Nova AI API.

Endpoint¶

POST https://aiservices.novasuite.one/api/v1/{model_id}

Replace {model_id} with: - modela-9-pico - modela-9-nano - modela-9 - modela-9-pro

Authentication¶

All API requests require authentication using API keys.

Authorization: Bearer nvai_sk_YOUR_API_KEY

Security

Never expose your API keys in client-side code.

Request Body¶

Parameter	Type	Required	Description
`message`	string/array	Yes	User message. String for text, Array for multimodal (9/9-Pro).
`history`	array	No	Previous conversation history.
`context`	string	No	System prompt/instructions.
`stream`	boolean	No	Enable streaming. Default `true` for 9/Nano/Pro. `false` for Pico.
`logprobs`	boolean	No	Return token log probabilities. Default `false`.

JSON Request Examples¶

Text OnlyWith Images (9 & 9-Pro)

{
  "message": "Explain quantum computing",
  "context": "Simple terms only."
}

{
  "message": [
    { "type": "image", "media_type": "image/jpeg", "data": "base64..." },
    { "type": "text", "text": "What is this?" }
  ]
}

Response Format¶

Streaming (SSE)¶

Default for 9-Nano, 9, 9-Pro.

data: {"type":"content_block_delta","text":"Hello"}
...
data: {"type":"message_stop","nb_input_tokens":10,"nb_generated_tokens":5,"generated_text":"Hello..."}

Non-Streaming (JSON)¶

Default for 9-Pico.

{
  "statusCode": 200,
  "body": "{\"type\":\"message_stop\",\"generated_text\":\"response...\"}"
}

Logprobs¶

Available when logprobs: true.

"logprobs": {
  "tokens": ["Hello", "!"],
  "token_logprobs": [-0.001, -0.05]
}