API Reference Overview - Documentation

Welcome to Novita AI API Reference

This documentation provides comprehensive reference for all Novita AI APIs. Our APIs are organized into several categories:

Base URLs

All API requests should be made to:

https://api.novita.ai

OpenAI-Compatible Endpoints:

https://api.novita.ai/openai

API Groups

Basic APIs

Fundamental APIs for authentication, billing, and account management.

Endpoint	Description
Authentication	API key authentication
Error Codes	Unified error response format
Get User Balance	Query account balance
Query Monthly Bill	Query monthly billing
Query Usage-Based Billing	Query usage-based billing
Query Fixed-Term Billing	Query fixed-term billing

Model APIs

LLM APIs

Large Language Model APIs with OpenAI compatibility.

Endpoint	Description
Create Chat Completion	Create a chat completion
Create Completion	Create a completion
Create Embeddings	Create embeddings
Create Rerank	Rerank search results
List Models	List available models
Retrieve Model	Get model details

Batch Operations:

Endpoint	Description
Create Batch	Create a batch job
Retrieve Batch	Get batch job status
Cancel Batch	Cancel a batch job
List Batches	List all batch jobs
Upload Batch Input File	Upload file for batch
List Files	List uploaded files
Query File	Get file metadata
Delete File	Delete a file
Retrieve File Content	Get file content

Image, Audio and Video APIs

Multimodal AI APIs for content generation and editing. Core Endpoints:

Endpoint	Description
Webhook	Webhook configuration
Get Model	Query available models
Task Result	Get async task results

Image Generation:

Endpoint	Description
Text to Image	Generate images from text
Image to Image	Transform existing images
Reimagine	Reimagine compositions
FLUX.1 Schnell	Fast image generation
Seedream 3.0	High-quality generation
Seedream 4.0	Advanced generation
Qwen Image	Qwen image generation

Image Editing:

Endpoint	Description
Upscale	Image upscaling
Remove Background	Background removal
Replace Background	Background replacement
Inpainting	Image inpainting
Image to Prompt	Reverse engineering

Video Generation:

Endpoint	Description
Text to Video	Generate videos from text
Image to Video	Animate images
Hunyuan Video Fast	Fast video generation
Wan 2.5 T2V Preview	Wan 2.5 preview
Kling V2.1 Master	Kling V2.1 master
Minimax Hailuo 02	Minimax Hailuo
Vidu Q1	Vidu Q1 generation

Audio:

Endpoint	Description
Minimax Speech 02	Minimax TTS HD
Minimax Speech 2.8	Minimax 2.8 HD
GLM TTS	GLM text-to-speech
GLM ASR	GLM speech recognition

GPU APIs

GPU instance management and serverless GPU endpoints.

GPU Instance

Endpoint	Description
Create Instance	Create GPU instance
List Instances	List all instances
Get Instance	Get instance details
Start Instance	Start instance
Stop Instance	Stop instance
Delete Instance	Delete instance

Template Management:

Endpoint	Description
Create Template	Create template
List Templates	List templates
Get Template	Get template details

Product & Pricing:

Endpoint	Description
List Products	List GPU products

Serverless GPUs

Endpoint	Description
Create Endpoint	Create endpoint
List Endpoint	List endpoints
Get Endpoint	Get endpoint details
Update Endpoint	Update endpoint
Delete Endpoint	Delete endpoint

Quick Start

1. Get Your API Key

Visit the settings page to create and manage your API keys.

2. Make Your First Request

curl --location 'https://api.novita.ai/v1/models' \
  --header 'Authorization: Bearer {{API Key}}'

3. Explore SDKs

We provide official SDKs for popular languages:

Authentication

All API requests require authentication using Bearer tokens. Include your API key in the Authorization header:

Authorization: Bearer {{API Key}}

See Authentication for details.

Error Handling

Novita AI uses standard HTTP status codes and returns errors in a unified format. See Error Codes for complete error reference.

Common Use Cases

User Query	Go To
”How to get started?”	Quick Start + Authentication
”API not working, error 401”	Error Codes
”Generate images from text”	Text to Image
”Create chatbot with LLM”	Chat Completion
”Generate videos”	Text to Video
”Deploy GPU instance”	Create Instance
”Check my balance”	Get User Balance
”OpenAI compatible API”	LLM API Guide

​Welcome to Novita AI API Reference

​Base URLs

​API Groups

​Basic APIs

​Model APIs

​LLM APIs

​Image, Audio and Video APIs

​GPU APIs

​GPU Instance

​Serverless GPUs

​Quick Start

​1. Get Your API Key

​2. Make Your First Request

​3. Explore SDKs

​Authentication

​Error Handling

​Common Use Cases

​Need Help?