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:
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 |
Need Help?
Last modified on June 10, 2026