SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

AI Creative Studio

Make narrated story videos from a template with scenes your own model writes.

AI Creative Studio turns a few short scenes into a narrated video: the scenes are laid out in one of 15 story templates with the workspace brand kit, animated, and given a voice-over and music. Through the API your code, or an AI assistant connected to the workspace, writes the scenes with its own model. SoftSolz does the layout, the product cut-out, the voice and the music. Only the voice-over uses AI credits, and a music-only change is free.

Scopes

  • service.creative-studio.view - read the guide, the templates, the library and product photos.
  • service.creative-studio.create - make story videos.
  • service.creative-studio.edit - change videos, upload and remove product photos.
  • service.creative-studio.delete - delete videos.

Read the guide first

GET /services/creative-studio/guide lists every scene kind with its fields and maximum characters, the words per scene for a given length, the voices and music moods. Hand it to your model before it writes. GET /services/creative-studio/story-templates lists the templates; leave template out and SoftSolz picks one from category and the scenes.

Add a product photo

Send the photo with POST /files (base64, under about 700 KB) or POST /files/upload-links, then POST /assets with the file_id. The background is removed, with no credits used. Pass the returned id as product_asset_id and set image to product on the scenes that should show it.

Make a video

bash
curl https://app.softsolz.uk/api/v1/services/creative-studio/stories \
-H "Authorization: Bearer sk_live_your_key" \
-H "Content-Type: application/json" \
-d '{"template":"product-launch","target_seconds":20,"music":"upbeat","scenes":[{"kind":"hook","fields":{"headline":"Mornings, upgraded"},"narration":"Meet the coffee that makes every morning feel easy."},{"kind":"feature","fields":{"headline":"Roasted this week","icon":"leaf"},"narration":"Every bag is roasted this week, so it always tastes fresh."},{"kind":"cta","fields":{"headline":"Order today","button":"Shop now"},"narration":"Order today and taste the difference tomorrow."}]}'

The video goes straight into the library. Read GET /designs/{id} until soundtrack.status is ready, usually under a minute. links.open is the page where the person watches it with sound and makes the MP4; after that, video.download_url returns the MP4 directly for 15 minutes. Text over a field's limit answers 400 invalid_input naming the field.

Change it

PATCH /designs/{id}/story takes only what changes: music, voice, template, format, or scenes by index (fields merge, remove: true deletes, insert: true adds). Every change is a new version. Send expected_updated_at to get 409 STALE_VERSIONrather than overwrite someone else's change.

Events

Instead of polling, subscribe to creative-studio.video.ready (the voice-over and music are done and the video plays with sound) and creative-studio.video.failed (nothing was charged; make the change again to retry). Both carry design_id and version.

Not in the API

AI pictures and AI video clips spend SoftSolz credits, so they are only made in the dashboard. Make pictures with your own tools and add them with POST /assets.