Developer API

The Nuvid API

Generate ad-ready videos programmatically. POST a URL, receive a 20-pack of vertical videos with captions, voiceovers and your brand kit applied — straight into your stack.

Fast

20-video packs delivered in under 90 seconds.

Secure

Bearer-token auth, scoped keys, full audit log.

Webhooks

Subscribe to job.completed and credits.low events.

Base URL

https://api.nuvid.ai/v1

Authentication

Generate an API key in your dashboard under Settings → API keys. Include it as a Bearer token in every request.

Authorization: Bearer nv_live_xxxxxxxxxxxxxxxxxxxx

Generate a 20-pack

POST /v1/jobs
Content-Type: application/json

{
  "url": "https://yourstore.com/products/coffee",
  "pack_size": 20,
  "aspect_ratio": "9:16",
  "brand_kit_id": "bk_abc123"
}

Returns a job_id. Poll GET /v1/jobs/{job_id} or subscribe to a webhook.

Remix a video

POST /v1/videos/{video_id}/remix

{
  "music_category": "uplifting",
  "ending_cta": "Shop the drop →"
}

Costs 2 credits per remix.

Rate limits

Starter — 60 requests / minute, 200 jobs / day
Growth — 300 requests / minute, 2,000 jobs / day
Scale — custom, contact sales

Webhooks

Configure an endpoint URL in your dashboard. Each delivery is signed with HMAC-SHA256 in the X-Nuvid-Signature header.

Events:
  job.completed       — pack ready, includes signed download URLs
  job.failed          — generation failed
  credits.low         — balance dropped below threshold

Need an API key?

API access is included in Growth and Scale plans.

See pricing Talk to sales