# Novita > CLI for all Novita AI APIs — LLM chat, image generation/editing (Stable Diffusion, FLUX), video generation, text-to-speech, speech-to-text, voice cloning, GPU cloud instance management, and serverless endpoints. Use this skill whenever the user wants to call Novita AI services, generate or edit images, create videos, do TTS/ASR, manage GPU instances, deploy serverless workloads, or interact with any novita.ai API. Also trigger when the user mentions the `novita` CLI tool, Novita AI pricing/models/balance, or asks for workplace image assets such as PPT graphics, marketing posters, product photos, social media visuals, avatars, flowcharts, UI mockups, exploded diagrams, report illustrations, or prompt-polished image generation. - Skill: `novitalabs/novita` (Agent Skill, multi-file: 20 files) - Install (CLI): `npx skillmds@latest add novitalabs/novita` - Raw SKILL.md: https://api.skillmd.com/api/skills/novitalabs/novita/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Marketing & Growth - Author: novitalabs (https://skillmd.com/u/novitalabs) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/novitalabs/novita --- # Novita AI CLI Access all Novita AI APIs from the command line. 95 tests pass (34 unit + 61 E2E, zero mocks). For the full command reference, read `references/commands.md`. For verified endpoint coverage, read `references/endpoints.md`. For workplace image prompt templates, read `references/easy-image/`. ## Quick Reference ```bash # LLM novita chat "Hello" -m deepseek/deepseek-v3-0324 novita embed "text" -m baai/bge-m3 novita rerank "query" -d "doc1" -d "doc2" novita models list --filter deepseek # Image generation novita image flux "a sunset" -W 512 -H 512 # sync, fast novita image generate "a cat" -W 512 -H 512 --steps 20 # async, SD # Image editing (sync) novita image remove-bg photo.jpg -o clean.png novita image reimagine photo.jpg -o new.png novita image to-prompt photo.jpg novita image remove-text photo.jpg -o clean.png novita image cleanup photo.jpg mask.png -o out.png novita image outpainting photo.jpg "forest" -W 1536 novita image merge-face face.jpg target.jpg -o merged.png # Image editing (async) novita image img2img photo.jpg "watercolor" --strength 0.5 novita image inpainting photo.jpg mask.png "red flower" novita image upscale photo.jpg --scale 2 novita image replace-bg photo.jpg "beach sunset" # Video (async) novita video generate "snow scene" --frames 32 novita video from-image photo.jpg --model SVD-XT novita video hunyuan "a cat playing piano" # Audio novita audio tts "Hello" --voice Calm_Woman -o hello.mp3 novita audio glm-tts "Hello" --voice jam -o hello.wav novita audio asr recording.wav novita audio voice-clone https://example.com/voice.mp3 # Account novita account balance novita account billing novita account usage-billing novita account fixed-billing # Async task management novita task status novita task wait -o ./results --timeout 300 # Batch & files novita files upload batch.jsonl novita files list / get / content / delete novita batch create novita batch list / get / cancel # GPU instances novita gpu products / cpu-products / clusters novita gpu create --product-id xxx --image pytorch:latest --gpu-num 1 novita gpu list / get / start / stop / restart / delete novita gpu metrics / edit # Templates novita template list / get / create / edit / delete # Storage novita storage list / create / delete # Serverless novita serverless list / get / create / update / delete ``` ## Decision Guide ### Workplace image assistant When the user asks for a business/workplace visual (PPT cover, poster, product photo, report graphic, social content, avatar, badge, sticker, intro graphic, flowchart, UI prototype, exploded diagram): 1. Parse the request into scene, channel, subject, style, ratio, text content, and any brand/product constraints. 2. If the core subject is missing, ask one concise question. Otherwise proceed. 3. Load the matching template from `references/easy-image/templates/{scene}.md`; use `references/easy-image/glossary.md` for professional terminology if useful. 4. Build one polished English prompt. If visible text is requested, specify the exact text and language. 5. Choose dimensions from the channel map below, then call Novita CLI. Prefer `novita image flux` for quick drafts and `novita image generate` for higher-control Stable Diffusion jobs. 6. Show a short enhancement summary before generation, then save images to the requested output directory or the current directory. Channel size map: | Channel | Size | |---------|------| | PPT / presentation | `-W 1280 -H 720` | | WeChat Moments / square product image | `-W 1024 -H 1024` | | Xiaohongshu / portrait social post | `-W 768 -H 1024` | | Douyin / short video cover | `-W 576 -H 1024` | | WeChat article header | `-W 1408 -H 600` | Available easy-image templates: `avatar`, `badge-id`, `emoji-sticker`, `exploded-diagram`, `flowchart`, `intro-graphic`, `marketing-poster`, `ppt-slides`, `product-photo`, `report-illustration`, `scene-photo`, `social-media-grid`, `ui-prototype`. ### Which image command? - **Text -> Image**: `image flux` (fast, sync) or `image generate` (SD, async, more control) - **Image + Text -> New Image**: `image img2img` (async) - **Edit part of image**: `image inpainting` (mask + prompt, async) or `image cleanup` (erase masked area, sync) - **Extend image**: `image outpainting` (sync) - **Remove elements**: `image remove-bg` (background), `image remove-text` (text overlay) - **Describe image**: `image to-prompt` (sync) - **Enlarge image**: `image upscale` (async) - **Swap face**: `image merge-face` (sync) - **Restyle**: `image reimagine` (sync) - **New background**: `image replace-bg` (async) ### Which TTS? - **English, high quality**: `audio tts` (MiniMax, returns download URL, mp3/wav/flac) - **Chinese, low latency**: `audio glm-tts` (GLM, returns binary PCM/WAV) ### Sync vs Async? - **Sync** (result immediately): `flux`, `remove-bg`, `reimagine`, `cleanup`, `outpainting`, `remove-text`, `to-prompt`, `merge-face` - **Async** (returns task_id, poll with `task wait`): `generate`, `img2img`, `inpainting`, `upscale`, `replace-bg`, all `video` commands ## Common Workflows ### Generate, upscale, and remove background ```bash novita image flux "product photo" -W 512 -H 512 -o ./tmp novita image upscale ./tmp/novita_flux_0.png --scale 4 --no-wait novita task wait -o ./results novita image remove-bg ./results/task_xxx_0.png -o final.png ``` ### Batch LLM processing ```bash novita files upload batch.jsonl novita batch create novita batch get # poll until completed novita files content -o results.jsonl ``` ### TTS -> ASR round-trip ```bash novita audio tts "Hello world" -o hello.mp3 novita audio asr hello.mp3 ``` ## Agent Guidance - **API Key**: `NOVITA_API_KEY` env var is required. If not set, guide the user to create one at https://novita.ai/settings/key-management. Alternatively pass `--api-key` per-command. - Use `--json-output` for all machine-readable output - Use `--no-stream` with chat for complete JSON responses - For async commands, use `--no-wait` to get task_id, then `novita task wait ` for control - All commands exit with code 1 on error, printing to stderr - For image requests that mention current, latest, real brands/products, or exact public figures, use web search before prompt assembly when up-to-date visual accuracy matters. - GPU instance creation costs real money — check `novita gpu products` for pricing first - Template CRUD is free — safe for testing ## Common Errors - **"API key required"** → Set `NOVITA_API_KEY` env var or pass `--api-key`. Get a key at https://novita.ai/settings/key-management - **"INSUFFICIENT_RESOURCE"** on GPU create → Try a different `--product-id` or `--billing spot` - **Task timeout** → Increase `--timeout` value, or use `--no-wait` and poll manually - **404 on storage/billing APIs** → These endpoints may not be available for all account types - **GLM TTS returns binary** → Output is raw PCM/WAV audio, saved directly to file (not JSON)