DEVELOPER PREVIEW

API docs and playable demos for AI Reels and Stories.

Try fixed generated examples, inspect the response shape, embed a hosted player, and see how instant previews become final MP4 exports.

Try fixed demos Read API contract

POST /v1/renders 200 OK

{
  "status": "preview_ready",
  "preview_url": ".../embed/demo?preset=article",
  "mp4_status": "rendering",
  "webhook": "export_ready"
}

PLAYGROUND

Fixed demos that return real MP4s.

Public docs can stay open without burning render budget. These presets use generated sample outputs while showing the same shape production API calls will use.

What is real in this version?

The fixed demo player is real: these pages use actual MP4 files and can be embedded with an iframe after deployment.

The /v1/renders API, API keys, webhooks, and embed.js SDK are interface drafts for now. They are shown so customers can evaluate the integration shape before the backend is connected.

Choose preset

Ratio: 9:16
Duration: 38s
Scenes: 6
Audience: product teams

MP4 demo

rnd_demo_article_01

{
  "id": "rnd_demo_article_01",
  "object": "render",
  "status": "completed",
  "mode": "both",
  "preset": "article",
  "ratio": "9:16",
  "duration_seconds": 38,
  "preview_status": "ready",
  "mp4_status": "completed",
  "expires_at": null,
  "urls": {
    "preview_url": "https://vidcrafter.app/embed/demo?preset=article&view=preview",
    "embed_url": "https://vidcrafter.app/embed/demo?preset=article",
    "mp4_url": "https://vidcrafter.app/demos/reel-article.mp4",
    "poster_url": "https://vidcrafter.app/demos/reel-article.jpg"
  }
}

API CONTRACT

One composition, three delivery modes.

The API can return an instant hosted preview for product UX, an embed player for customer websites, and final MP4 exports for social platforms.

preview

Fast browser preview. Best for testing, approvals, and "show me now" workflows.

embed

Hosted iframe or JS player. Uses preview first, then swaps to MP4 when available.

mp4

Async export for Reels, Stories, TikTok, Shorts, and ad platforms.

POST /v1/renders

Create a render job. Returns preview_url immediately when mode is both or preview.

GET /v1/renders/{id}

Poll status, final MP4 URL, poster URL, duration, and failure details.

POST /v1/renders/{id}/exports

Request another ratio, draft MP4, or final quality export from the same composition.

POST /v1/webhooks/test

Verify completed, failed, and export_ready callbacks before going live.

EMBED PLAYER

For customer websites, ship the player instead of a raw file.

Customers can paste an iframe or load the JS SDK. The player can show the instant preview while the final MP4 export finishes in the background.

Open current embed demo

1Create renderAPI returns job id and preview URL.

2Show embediframe loads the hosted preview player.

3Swap to MP4Player uses final video when export completes.

ACCESS MODEL

Start with accounts and API keys. Add stricter controls where they help.

Device binding is not a good default for server integrations. Domain and IP controls work better as optional enterprise settings.

Account gate

Playground access starts invite-only so render cost stays controlled.

API keys

Keys can be created, rotated, revoked, and scoped per workspace.

Rate limits

Default 60 preview jobs/hour and 20 MP4 exports/hour during beta.

Domain allowlist

Embed player can be restricted to approved customer domains.

IP allowlist

Optional for server-to-server API calls, not required for the first integration.

Webhooks

Signed callbacks notify customers when final MP4 exports are ready.