Build with the Nova Content API

Introduction

The Nova Content API is a simple HTTPS/JSON API. Send a request with your API key and a prompt, and get back generated media. All endpoints are served from your Nova Content domain under /api.

Copyloading…

Authentication

Authenticate every request with your secret API key in the Authorization header as a Bearer token. Keys start with nc_live_. Keep them secret — anyone with your key can spend your credits.

CopyAuthorization: Bearer nc_live_your_secret_key

Don't have a key yet? Create one below (free — you just need a Nova Content account).

Your API keys

Create, copy, and revoke your API keys here. You can have up to 5 active keys.

Never run out of credits

Turn on auto-recharge and we'll automatically top up your balance with a credit pack whenever it drops below your chosen threshold — so your API calls never hard-stop mid-integration. We charge the card you save here, and the credits land in your non-expiring pack balance.

JavaScript / TypeScript SDK

A zero-dependency SDK that works in Node 18+, Deno, Bun, and the browser. Import it directly from your Nova Content domain — no install step:

Copy

Or download nova-content.js and bundle it with your app.

Example

Copy

The SDK exposes generateImage, generateVoice, generateMusic, listVoices, and getUsage. Errors throw a NovaContentError with status and body.

Rate limits

Each API key is limited to … requests per minute. Every response includes these headers so you can track your budget:

If you exceed the limit you'll get a 429 Too Many Requests response. Back off for the number of seconds in Retry-After and try again.

Generate image

POST/api/generate/image   5 credits / image

Create an image from a text prompt.

Body parameters

Example request

Copy

Example response

{
  "imageUrl": "data:image/png;base64,iVBORw0KGgo…",
  "creditsUsed": 5,
  "creditsRemaining": 695,
  "provider": "stability"
}

Generate voice

POST/api/generate/voice   10 credits min

Convert text to a natural-sounding voiceover. Cost is max(10, ceil(text.length × 0.01)) credits.

Body parameters

Example request

Copy

Example response

{
  "audioUrl": "data:audio/mpeg;base64,SUQzBA…",
  "creditsUsed": 10,
  "creditsRemaining": 685
}

List available voices: GET/api/generate/voices

Generate music

POST/api/generate/music   15 (clip) / 30 (full)

Generate a music track from a text prompt. There are two tiers: Quick Clip (≤30s, 15 credits) and Full Song (up to 3 min, 30 credits). The tier is auto-derived from durationSec (over 30s ⇒ full) unless you set tier explicitly.

Body parameters

Example request

Copy

Example response

{
  "audioUrl": "data:audio/mpeg;base64,SUQzBA…",
  "tier": "clip",
  "creditsUsed": 15,
  "creditsRemaining": 670
}

Errors

The API uses standard HTTP status codes. Error responses are JSON with an error message.

Usage

Track how many calls each of your keys has made.