Make a narrated story video from a template, with your own scenes
Your model writes the scenes; SoftSolz lays them out in the template, applies the brand kit, animates them and records the voice-over and music. Only the voice-over uses AI credits. The video goes straight into the library. Errors: 400 invalid_input names the field to fix (for example text over its length); 400 field_not_available for hero_images or image_attachment_ids; 404 not_found for an unknown photo; 402 when the workspace is out of AI credits for the voice-over; 429 rate_limited when more than 20 videos are made in 10 minutes.
https://app.softsolz.uk/api/v1/services/creative-studio/storiesRecent Requests
Kept only in this browserHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Idempotency-KeystringOptional idempotency key for safe retries.
Body Params
titlestringTitle in the library. Defaults to the first headline.
templatestringTemplate id from GET /story-templates. Leave out to pick one from category and the scenes.
formatstringstory 9:16 (default), landscape 16:9 or square 1:1.
paletteobjectOnly to override the brand kit: { primary, secondary, accent, dark, light } as #rrggbb.
product_asset_idstringProduct photo from POST /assets.
product_photostringOr the name of a saved photo.
voicestringVoice of the voice-over.
musicstringMusic mood; none for voice only.
notestringNote for the version history.
categorystringBusiness category; helps pick a template when template is left out.
target_secondsintegerLength you want. The spoken words decide the real length; GET /guide gives words per scene.
scenesarray of objectsrequired3 to 8 scenes: a hook first, a cta last, one idea each.
Response
Response Body
idstringDesign id.titlestringTitle shown in the library.formatstringstory (9:16), landscape (16:9), square (1:1) or a picture format.widthintegerWidth in pixels.heightintegerHeight in pixels.versionintegerCurrent version. Every change makes a new one.saved_atstring | nullWhen it joined the library.created_atstringWhen it was made.updated_atstringSend it back as expected_updated_at to make sure nobody changed the video since you read it.is_storybooleanTrue for a story video made from a template.storyobject | nullThe scenes of a story video. null for a picture or a custom design.soundtrackobject | nullVoice-over and music. null when the design has none.videoobjectThe MP4 file of the current version.linksobjectPages in SoftSolz for this design.notesarray of stringsOnly on create and change: anything that was adjusted, such as text that was shortened.Request
curl --request POST \ --url https://app.softsolz.uk/api/v1/services/creative-studio/stories \ --header 'Authorization: Bearer sk_live_your_key' \ --header 'Content-Type: application/json' \ --data '{ "template": "product-launch", "format": "story", "product_asset_id": "a0000000-0000-0000-0000-000000000001", "voice": "coral", "music": "upbeat", "target_seconds": 20, "scenes": [ { "kind": "hook", "fields": { "headline": "Mornings, upgraded", "kicker": "New" }, "narration": "Meet the coffee that makes every morning feel like a weekend.", "image": "product" }, { "kind": "feature", "fields": { "headline": "Roasted this week", "sub": "Fresh beans in every bag", "icon": "leaf" }, "narration": "Every bag is roasted this week, so it always tastes fresh.", "image": "product" }, { "kind": "offer", "fields": { "headline": "Launch price", "price": "£9", "was": "£12" }, "narration": "Grab a bag for nine pounds while the launch price lasts.", "image": "product" }, { "kind": "cta", "fields": { "headline": "Order today", "button": "Shop now", "url": "example.com" }, "narration": "Order today and taste the difference tomorrow.", "image": "product" } ]}'Credentials
Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.
Response · 201
{ "data": { "id": "your-id", "title": "your-title", "format": "your-format", "width": 1, "height": 1, "version": 1, "saved_at": "2026-01-01T09:00:00.000Z", "created_at": "2026-01-01T09:00:00.000Z", "updated_at": "2026-01-01T09:00:00.000Z", "is_story": true, "story": { "template": "your-template", "format": "story", "category": "your-category", "voice": "your-voice", "music": "your-music", "target_seconds": 1, "product_asset_id": "your-product-asset-id", "scenes": [ { "kind": "hook", "fields": {}, "narration": "your-narration", "image": "product" } ] }, "soundtrack": { "status": "queued", "voice": "your-voice", "music": "your-music", "total_ms": 1, "error_code": "your-error-code", "lines": 1, "updated_at": "2026-01-01T09:00:00.000Z" }, "video": { "duration_ms": 1, "mp4_ready": true, "download_url": "https://example.com", "download_expires_at": "2026-01-01T09:00:00.000Z" }, "links": { "open": "your-open" }, "notes": [ "your-notes" ] }}