Getting Started

Introduction

Learn the fundamentals of NovaAI and how the platform is designed to simplify AI development. This introduction provides an overview of NovaAI's architecture, core principles, and key capabilities, helping you understand how its unified API enables developers to build intelligent applications efficiently.

Welcome to NovaAI

NovaAI is a unified AI platform that enables developers to build intelligent applications using a single, consistent API. From conversational assistants and image generation to semantic search and multimodal workflows, NovaAI provides production-ready AI capabilities without requiring infrastructure management.

Whether you're building a customer support chatbot, an AI-powered writing assistant, a document search engine, or an autonomous workflow, NovaAI offers scalable APIs, official SDKs, and enterprise-grade security to accelerate development.

Note: Nova AI is designed around a model-first architecture. Every capability including chat, vision, embeddings, audio, and agents - uses a consistent authentication and request structure, making it easy to adopt new features as your application evolves.

Note: Nova AI is designed around a model-first architecture. Every capability including chat, vision, embeddings, audio, and agents - uses a consistent authentication and request structure, making it easy to adopt new features as your application evolves.

Platform Overview

NovaAI combines multiple AI services into a unified developer platform.

Capability

Description

Primary Endpoint

Chat

Conversational AI for assistants and applications

/v1/chat

Vision

Analyze and understand images

/v1/vision

Image Generation

Generate images from text prompts

/v1/images

Embeddings

Create vector representations for semantic search

/v1/embeddings

Audio

Speech-to-text and text-to-speech

/v1/audio

Files

Upload and manage documents

/v1/files

Vector Store

Store and retrieve embeddings

/v1/vector-store

Agents

AI agents capable of tool execution

/v1/agents

Why NovaAI?

Modern AI applications often require multiple services to accomplish a single workflow. A chatbot may need language models for conversation, embeddings for semantic search, vision models for image understanding, and audio models for speech processing. Managing separate APIs, authentication methods, and SDKs for each capability increases development complexity and maintenance overhead.

NovaAI addresses this challenge by providing a unified developer platform that standardizes AI integration through a consistent API, shared authentication model, and common request structure.

Instead of learning multiple providers and workflows, developers can access every AI capability through a single platform.

Core Principles

  • Unified API - Access every AI capability through one consistent API design.

  • Developer First - Clean SDKs, predictable endpoints, and comprehensive documentation.

  • Scalable Infrastructure - Built to support prototypes, startups, and enterprise workloads.

  • Secure by Design - Authentication, encryption, and permission controls are integrated into every request.

  • Extensible Platform - Easily adopt new models and capabilities without changing your application architecture.

Design Philosophy

NovaAI follows an API-first architecture where every capability is treated as a modular service. This approach ensures that developers can start with a single feature, such as chat completion, and progressively expand to more advanced capabilities - including agents, vector search, or multimodal workflows - without redesigning their application.

The platform emphasizes consistency over complexity. Whether you're generating text, analyzing images, or creating embeddings, every endpoint follows the same authentication flow, request conventions, and response patterns, reducing the learning curve and improving long-term maintainability.

Tip: Learning the common request structure early will make every other section of the documentation easier to understand, as most NovaAI endpoints follow the same design principles.

Tip: Learning the common request structure early will make every other section of the documentation easier to understand, as most NovaAI endpoints follow the same design principles.

How NovaAI Works

Rendering diagram…

NovaAI acts as the intelligence layer between your application and advanced AI models. Every request follows the same lifecycle:

  1. Your application sends a request.

  2. NovaAI authenticates the client.

  3. The selected AI model processes the request.

  4. The generated response is returned in a standardized format.

Basic Request Example

curl https://api.novaai.dev/v1/chat \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nova-chat-4",
"messages": [
{
"role": "user",
"content": "Explain vector embeddings in simple terms."
}
]
}'

The API uses RESTful endpoints with JSON request and response bodies. Every authenticated request requires an API key passed using the Authorization header.

API Endpoint

Property

Value

Base URL

https://api.novaai.dev/v1

Protocol

HTTPS

Authentication

Bearer Token

Format

JSON

Versioning

URL Versioning (v1)

Request Properties

model

string

required

AI model used to process the request.

messages

array

required

Conversation history supplied to the model.

temperature

number

optional

Controls output randomness.

max_tokens

integer

optional

Maximum number of generated tokens.

stream

boolean

optional

Enables real-time streaming responses.

Supported SDKs

NovaAI provides officially maintained SDKs for the most common programming languages.

SDK

Status

JavaScript

Stable

Python

Stable

Go

Stable

PHP

Stable

Java

Beta

Developer Workflow

Rendering diagram…

This workflow represents the typical development lifecycle when integrating NovaAI into an application.

AI Prompt Example

Summarize a document

Copy Prompt

Summarize a document

Copy Prompt

Use this prompt as a starting point when experimenting with chat models or document processing workflows.

Frequently Asked Questions

What makes NovaAI different from individual AI providers?

NovaAI provides a unified API that standardizes authentication, request formats, SDKs, and developer workflows across multiple AI capabilities, reducing integration complexity.

Is NovaAI suitable for production workloads?

Yes. NovaAI is designed for scalable, production-ready deployments with support for streaming, batching, monitoring, rate limiting, and enterprise security practices.

Do I need separate APIs for chat, vision, and embeddings?

No. All AI capabilities are available through the same platform and authenticated using a single API key.

Which programming languages are officially supported?

Official SDKs are available for JavaScript, Python, Go, PHP, and Java (Beta), with additional community SDKs available through the developer ecosystem.

What makes NovaAI different from individual AI providers?

NovaAI provides a unified API that standardizes authentication, request formats, SDKs, and developer workflows across multiple AI capabilities, reducing integration complexity.

Is NovaAI suitable for production workloads?

Yes. NovaAI is designed for scalable, production-ready deployments with support for streaming, batching, monitoring, rate limiting, and enterprise security practices.

Do I need separate APIs for chat, vision, and embeddings?

No. All AI capabilities are available through the same platform and authenticated using a single API key.

Which programming languages are officially supported?

Official SDKs are available for JavaScript, Python, Go, PHP, and Java (Beta), with additional community SDKs available through the developer ecosystem.

Was this helpful?

Was this helpful?

Create a free website with Framer, the website builder loved by startups, designers and agencies.