NovitaAI is a hosted AI infrastructure provider with an OpenAI-compatible API. Apus provides NovitaAI through the official external @openclaw/novita-provider plugin. Model refs use the novita/deepseek/deepseek-v4-pro form.

Setup

Install the plugin:

apus plugins install @openclaw/novita-provider

Installation applies to a running Gateway automatically; otherwise it takes effect on the next startup. See Apply changes and inspect.

Create an API key at novita.ai/settings/key-management, then run:

apus onboard --auth-choice novita-api-key

Or set:

export NOVITA_API_KEY="<your-novita-api-key>" # pragma: allowlist secret

Defaults

Setting Value
Plugin @openclaw/novita-provider
Provider id novita
Aliases novita-ai, novitaai
Base URL https://api.novita.ai/openai/v1
Env var NOVITA_API_KEY
Default model novita/deepseek/deepseek-v4-pro

Model catalog

novita/minimax/minimax-m2.7 remains selectable as a deprecated compatibility entry but is hidden from model pickers.

This is a starting point, not a live catalog. Your account, region, or Novita's current offering may add, remove, or restrict routes. Check before setting a long-lived default:

apus models list --provider novita

Video generation

The same plugin and NOVITA_API_KEY support the video generation tool through Novita's native asynchronous API at https://api.novita.ai.

Model Modes Duration Resolution
wan2.6-t2v (default) Text or one image to video 5/10/15s 720P, 1080P
wan2.6-i2v One image to video 5/10/15s 720P, 1080P
minimax-hailuo-2.3-t2v Text or one image to video 6/10s 768P, 1080P
minimax-hailuo-2.3-i2v One image to video 6/10s 768P, 1080P
minimax-hailuo-2.3-fast-i2v One image to video 6/10s 768P, 1080P

Supplying one image with a -t2v model selects the same family's -i2v route. Both families accept remote image URLs and local image files, sent as data URIs. Hailuo supports 1080P only for 6-second videos; use 768P for 10 seconds. Video reference inputs are unsupported.

Wan defaults to silent output; set audio: true to generate audio. It also accepts one remote HTTP(S) audio reference. Text-to-video supports 16:9, 9:16, 1:1, 4:3, and 3:4; image-to-video inherits the source aspect ratio. Wan options are negative_prompt, prompt_extend, shot_type (single or multi), and seed. Hailuo options are enable_prompt_expansion and fast_pretreatment (the latter is unavailable on the Fast model).

{
  agents: {
    defaults: {
      mediaModels: {
        video: {
          primary: "novita/wan2.6-t2v",
        },
      },
    },
  },
}

When to choose Novita

Choose a direct vendor provider when you need vendor-native request parameters or support contracts. Choose a local provider when the model must run on your own hardware or network boundary.

Troubleshooting

Related