Skip to main content

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.
EndpointDescription
AuthenticationAPI key authentication
Error CodesUnified error response format
Get User BalanceQuery account balance
Query Monthly BillQuery monthly billing
Query Usage-Based BillingQuery usage-based billing
Query Fixed-Term BillingQuery fixed-term billing

Model APIs

LLM APIs

Large Language Model APIs with OpenAI compatibility.
EndpointDescription
Create Chat CompletionCreate a chat completion
Create CompletionCreate a completion
Create EmbeddingsCreate embeddings
Create RerankRerank search results
List ModelsList available models
Retrieve ModelGet model details
Batch Operations:
EndpointDescription
Create BatchCreate a batch job
Retrieve BatchGet batch job status
Cancel BatchCancel a batch job
List BatchesList all batch jobs
Upload Batch Input FileUpload file for batch
List FilesList uploaded files
Query FileGet file metadata
Delete FileDelete a file
Retrieve File ContentGet file content

Image, Audio and Video APIs

Multimodal AI APIs for content generation and editing. Core Endpoints:
EndpointDescription
WebhookWebhook configuration
Get ModelQuery available models
Task ResultGet async task results
Image Generation:
EndpointDescription
Text to ImageGenerate images from text
Image to ImageTransform existing images
ReimagineReimagine compositions
FLUX.1 SchnellFast image generation
Seedream 3.0High-quality generation
Seedream 4.0Advanced generation
Qwen ImageQwen image generation
Image Editing:
EndpointDescription
UpscaleImage upscaling
Remove BackgroundBackground removal
Replace BackgroundBackground replacement
InpaintingImage inpainting
Image to PromptReverse engineering
Video Generation:
EndpointDescription
Text to VideoGenerate videos from text
Image to VideoAnimate images
Hunyuan Video FastFast video generation
Wan 2.5 T2V PreviewWan 2.5 preview
Kling V2.1 MasterKling V2.1 master
Minimax Hailuo 02Minimax Hailuo
Vidu Q1Vidu Q1 generation
Audio:
EndpointDescription
Minimax Speech 02Minimax TTS HD
Minimax Speech 2.8Minimax 2.8 HD
GLM TTSGLM text-to-speech
GLM ASRGLM speech recognition

GPU APIs

GPU instance management and serverless GPU endpoints.

GPU Instance

EndpointDescription
Create InstanceCreate GPU instance
List InstancesList all instances
Get InstanceGet instance details
Start InstanceStart instance
Stop InstanceStop instance
Delete InstanceDelete instance
Template Management:
EndpointDescription
Create TemplateCreate template
List TemplatesList templates
Get TemplateGet template details
Product & Pricing:
EndpointDescription
List ProductsList GPU products

Serverless GPUs

EndpointDescription
Create EndpointCreate endpoint
List EndpointList endpoints
Get EndpointGet endpoint details
Update EndpointUpdate endpoint
Delete EndpointDelete 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 QueryGo 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

Need Help?