Skip to content
Motionbar
Sign inStart free
APIFloor plan

Every studio
is an endpoint.

The same routes the studio uses, with your key. Clone a twin, quote a render, start a take, poll the job, pull the file. A sandbox host returns realistic dummy jobs so you can build before you spend a credit.

live-api.motionbar.aisandbox.motionbar.aiAuthorization: Bearer mb_live_…
mb_live_ key · credits are real
POSThttps://live-api.motionbar.ai/api/talk
{
  "avatarId": "avt_01J9…",
  "script": "Hi — I’m Mara, and this is the new collection.",
  "aspect": "9:16",
  "engine": "default",
  "resolution": "1080p",
  "audio": "voice"
}
Response · 202 Accepted212 ms
{
  "status": "queued",
  "jobId": "job_01J9…",
  "job": { "id": "tlk_01J9…", "videoUrl": "" },
  "live": true,
  "balance": 1104
}

Quote. Start. Poll. Pull.

Every studio follows the same four calls. The quote is the price you will pay; the job carries the file when it lands.

01Quote itGET /api/credits/quote?feature=…

Returns the credits a render will cost for these settings. Studio-specific quotes exist too: /api/cinema/quote, /api/sound/quote, /api/marketing/quote.

02Start itPOST /api/talk · /api/cinema · /api/scene …

Returns 202 with a jobId and the balance after reservation. Uploads go through POST /api/assets/presign first.

03Poll itGET /api/jobs/:id

status: queued → running → succeeded | failed, with a customer-safe step string. Failed jobs refund automatically.

04Pull itvideoUrl · imageUrl · audioUrl

Signed URLs on the job; GET /api/library lists everything you have made. Files are yours to keep.

Endpoint map

61 routes · same names as the studio
Twinwho's on camera
POST/api/clone
GET/api/people/:id
DELETE/api/people/:id
GET/api/cast
POST/api/characters
POST/api/locations
Talk · Cinema · Seriesthe director studios
POST/api/talk
GET/api/talk/:id
GET/api/cinema/quote
POST/api/cinema
POST/api/shows
POST/api/shows/breakdown
GET/api/episodes/:id/estimate
POST/api/episodes/:id/shoot
POST/api/episodes/:id/stitch
Listing · Fashion · Glamstills and staging
POST/api/scene
GET/api/scene/:id
POST/api/outfits
POST/api/fashion
GET/api/fashion/:id
GET/api/glam-presets
POST/api/glam-take
POST/api/product-take
Viral · Brand · Marketingthe feed and the kit
GET/api/viral/templates
POST/api/briefs/viral/write
POST/api/viral
POST/api/ugc
POST/api/briefs/brand/write
POST/api/briefs/brand
GET/api/marketing/templates
GET/api/marketing/quote
POST/api/marketing
GET/api/marketing-ads/presets
POST/api/marketing-ads
Recast · Motions · Effects · Freehandfootage in, footage out
POST/api/recast/presign
POST/api/recast
GET/api/recast/:id
POST/api/motions
GET/api/motions/:id
GET/api/effects/presets
POST/api/effects
POST/api/freehand/write
POST/api/freehand
POST/api/freehand/:id/retry
Sound · Cameo · Influencerthe rest of the floor
GET/api/sound/quote
POST/api/sound
POST/api/sound/compose
GET/api/sound/:id
GET/api/cameo/scenes
POST/api/cameo
POST/api/influencer
GET/api/influencer/:id
Jobs · Library · Fileswhat every studio shares
GET/api/jobs/:id
GET/api/library
DELETE/api/library/:kind/:id
GET/api/assets
POST/api/assets/presign
POST/api/assets
GET/api/media?src=
GET/api/credits/quote
GET/api/me
Sandbox

Build first.
Spend later.

Point the same code at sandbox.motionbar.ai with a mb_test_ key. Every route answers with the real shape and realistic dummy data: quotes return numbers, jobs queue then succeed after a few seconds, files resolve to sample media. No credits move.

Same routes, same shapesEvery path in the map exists on the sandbox host. Types match production so your client compiles once.
Jobs behave like jobsA sandbox job sits in queued for ~3 s, running for ~5 s, then succeeds with sample media — so polling and webhooks are exercised for real.
Consent still gates cloningPOST /api/clone on the sandbox requires a consentClipId too. The gate is part of the contract, not a production add-on.
Balance never movesQuotes return real numbers; reservations and refunds are logged but the sandbox balance stays at 999,999.

How the API behaves

Auth

Authorization: Bearer mb_live_… or mb_test_…. Keys are created and rotated at developer.motionbar.ai; one key per environment.

Credits

The quote is the price. A 202 reserves the credits; a failed job refunds them; nothing else is charged.

Rate limits

Per-key limits are shown in the portal with live usage. 429 carries Retry-After.

Consent

Cloning needs a recorded consent clip, by API exactly as in the studio. There is no bypass for keys.

Your key is
one page away.

API access ships with the Floor plan. Keys, docs, the sandbox and usage live at developer.motionbar.ai.