Changelog

​

Changes to check in an existing integration

• Deprecated: POST /v1/project/create/ugc-ads keeps working, but UGC Studio now has one endpoint per format: Product in Hand, App Demo, Fashion, Before / After and Voiceover. The format comes from the path and its assets sit at the top of the body. Same price.
• Breaking: an integration, scheduled post or analysed account id that belongs to another team now answers 404 (it was 403), the same as a missing id. See Channels, Publish and Account Analysis.
• Breaking: create requests that used to produce a failed or degraded video are now refused with 400 and nothing is charged: an unknown caption preset, text style, game, art style or motion style, mediaType: "media" without media, or a model that does not match the media type. A malformed id answers 400 or 404, never 500. See Validation errors.
• Breaking: rate limits per team: 30 POST and 120 other requests per minute, and 3 URL downloads at a time. Over a limit you get 429 with Retry-After and X-RateLimit-* headers; nothing runs or is charged. See Rate limits.
• Every webhook call is now signed and carries Hooked-Signature, Hooked-Event and Hooked-Delivery. The body is unchanged, so existing handlers keep working; verify the signature to reject forged calls and use Hooked-Delivery to drop duplicates. Team endpoints can subscribe to events in Settings → Webhooks. See Verify the signature.
• GET /v1/health answers only the API and database status. Host details (Node version, platform, memory, uptime, environment) and the degraded status are gone.
• POST /v1/project/create/product-ads was removed. The trends, niche and social search endpoints are not available for now and answer 404.

​

New: idempotent creates

• Send an Idempotency-Key header on any POST that creates or charges. A retry with the same key and body within 24 hours gets the first answer back (Idempotent-Replayed: true) without creating or charging again. See Idempotency.

​

New: slow creates answer at once

• Article to Video, PDF to Video, PDF to Brainrot and Cinematic answer in seconds with a projectId and status processing. Invalid input, missing keys and too few credits are still refused up front; a later failure turns the project failed, refunds it and calls your webhook.
• PDF to Video and PDF to Brainrot download and read pdfUrl themselves: teams on their own keys no longer need a Firecrawl key for them.

​

New endpoints

• List projects, Get project and Delete project: follow a project from creation to its video.
• Get captions and Edit project: read a finished project’s captions, change it, then Render again.
• Delete video.

• List, Get, Import from a URL, Upload + Complete upload and Delete.
• Generate image and Generate video into the library.
• A failed media says why in error (Get Media). Generation and import take an optional webhook and metadata, called once with media.completed or media.failed. See Media webhooks.

• UGC Studio per format (above), Podcast / Dualcast, Reddit Story, Quiz Video and Scrolling Video.
• From a source: Article to Video, PDF to Video, PDF to Brainrot, Music to Video and Clone Video.
• Cinematic Studio.

• Avatars: Get, Create from a photo, Generate, Hook + Demo reaction and Delete.
• Voices: Clone, Text to speech, Speech to speech and Delete.
• Cinematic characters: List, Get, Create, Update and Delete.

• Remove background, Expand and Get image.

• Account: plan, billing mode, credit balance, storage and provider keys.
• Catalogs: the valid values for presets, styles, games, models and other fields, so you can check a value before you create.