Fabeo

Change one scene's spoken line. Same as edit_scene(narration=...), which is preferred: on a rendered video, apply it with regenerate_scene(mode='narration'), which re-writes the scene's prompts so the clip speaks the new line.

edit_scene_narration

Estimate the maximum credits a render would cost (only clip generation is billed, ~1 credit per rendered second; failed renders are refunded in full). For regenerate_scene pass the chosen scenes' total duration. Always share this with the user before approving a script or regenerating.

estimate_cost

Show the account's subscription plan and remaining credits, how much this connection may still spend (its safety limit, separate from the credits), and links to the account's plan and billing details. Check it before a render if credits may be short.

get_account

One product: title, description, extra context, its brand and client, and every stored photo of the product, brand and client (image_key, url, source) -- show them to the user and pass the chosen image_keys as create_video's catalog_image_keys.

get_product

For clients that can make HTTP requests (e.g. Claude Code): a one-hour presigned upload for one reference image (png/jpg). Upload it with an HTTP multipart POST (every upload.fields entry as a form field, then the file as 'file'), then pass the returned reference_image_key in create_video's reference_image_keys. One call per image, up to 5. rights_confirmed must be true: first tell the user that they must own the image or hold the rights to use it and that Fabeo isn't responsible for infringement, and get their OK. Chat apps: use get_reference_upload_page or upload_reference_image.

get_reference_upload_url

Let the user upload reference photos (a person, a product) from their own device: returns a one-hour upload_page_url to give them. They pick up to 5 PNG/JPEG photos there and confirm they hold the rights to them. Use this in chat apps (Claude, ChatGPT), which can't upload files themselves. When the user says they're done, call check_reference_upload, then create_video(reference_upload_id=...).

get_reference_upload_page

Check a job's progress -- share it with the user while they wait: stage ('step 4 of 5: rendering video clips (3 of 6 scenes rendered)'), progress_percent (0-100) and per-stage statuses, plus a next_action hint. A render moves SCRIPT -> AUDIO -> KEY_FRAMES -> CLIP_GENERATION -> VIDEO_STITCH. Follow next_action rather than 'status' alone: while regenerate_scene runs, status stays COMPLETED and next_action says Regenerating (video_url is still the previous version until then). On a failure it gives the reason and a credits entry with what the job was actually charged and refunded.

get_job_status

Read one scene as the renderer sees it: narration, visual description, reference images, and for each clip its MiniMax H3 positive_prompt (picture + the narration it speaks) and whether it opens on a user start frame. prompts_stale=true means a narration/visual edit is saved but not rendered yet (regenerate_scene mode='narration' applies it). Read this before writing a positive_prompt with edit_scene.

get_scene_prompts

Get a one-hour upload URL for the user's own start frame (PNG) for one clip of a rendered scene. Upload it (multipart POST: upload.fields, then the file as 'file'), then call edit_scene(video_id, scene_id, clip_index, keyframe='upload', positive_prompt=...) and regenerate_scene with the mode it returns.

get_start_frame_upload_url

Start here with a new user, or when unsure what to make: what Fabeo makes, the ways to start (brief, template, product, own photos, own voice, quick clip), the seven video styles, limits, costs, template categories, and this account's plan and credits.

get_started

Get one video: status, playable video_url once rendered, and its scenes in order (scene_id, narration, visual description, duration, clip_count, reference images). Use get_scene_prompts for a rendered scene's clip prompts.

get_video

Let the user upload their own voice recording from their device: returns a one-hour upload_page_url to give them (one MP3/WAV/M4A/OGG file, up to 60s and 4 MB; they confirm they hold the rights to it there). Use in chat apps, which can't upload files. When they say they're done, call check_audio_upload, then create_video_from_audio or set_scene_audio with the audio_upload_id.

get_audio_upload_page

For clients that can make HTTP requests (e.g. Claude Code): a one-hour presigned upload for one voice recording (mp3/wav/m4a/ogg, up to 60s). Upload it with an HTTP multipart POST (every upload.fields entry as a form field, then the file as 'file'), then pass the returned audio_key to create_video_from_audio or set_scene_audio. rights_confirmed must be true: first tell the user they must own the recording or hold the rights to it (including the speaker's consent) and that Fabeo isn't responsible for infringement, and get their OK. Chat apps: use get_audio_upload_page or upload_audio.

get_audio_upload_url

Browse Fabeo's proven template videos -- a quick way to a good video: copy one with create_from_template and adapt it to the user's product. Without video_type: the template categories and how many each has (e.g. product_demo, social_ad, ugc_style, before_after, animation, cinematic_trailer, explainer -- the result is authoritative). With video_type (optionally aspect_ratio '9:16' or '16:9'): each template's idea and a preview_url the user can watch -- show them as links and let the user choose.

list_templates

List videos in the account, newest first. Pass next_page_token from a previous response to fetch the next page. At most one of client_id, brand_id, product_id may be set.

list_videos

Re-render some scenes of a FINISHED video and re-stitch it. Spends credits only for the re-rendered clip seconds of those scenes (~1 per second; key frames, voice and stitching are free; refunded in full if it fails) -- estimate_cost and the user's OK first. Use the regenerate_mode that edit_scene returned: - 'narration': applies narration / visual_description edits -- re-writes those scenes' prompts, then new voice, key frames and clips. - 'images': new key frames, then new clips (after keyframe='variant'). - 'clips': new clips from the current prompts, start frames and durations (after a positive_prompt, keyframe='upload' or duration_seconds edit); also a plain re-roll. Refuses 'images'/'clips' for a scene whose narration/visual edit is not applied yet. After set_scene_audio use 'narration'. If the user still dislikes the voice after a narration fix, suggest their own recording (get_audio_upload_page, then set_scene_audio) rather than more re-rolls.

regenerate_scene

Re-render every clip of a finished video, or retry a video whose render failed at the clip/stitch step (e.g. it ran out of credits). Spends credits for the clip seconds it renders, charged like a new render: a failed clip render was already refunded in full, so the user does not pay twice. Scenes edited since the last render are re-written into their prompts first. For failures at other steps use retry_step.

regenerate_video

Resume a FAILED video on the same job, keeping its script and every edit -- follow get_job_status's next_action. A failed script is written again for free (it then comes back for review). A render that failed before or during clip rendering or stitching carries on to the finished video and spends credits like the original render (estimate_cost and the user's OK first). After a content-policy block, rewrite the flagged scenes with edit_scene and pass content_edited=true. Not for a job that is still running or looks stuck.

retry_step

Replace one scene's AI voice with the user's own recording -- the fallback when the AI voice mispronounces words, handles a regional language or accent badly, or adds gibberish or stray sounds that editing the narration didn't fix. The scene then shows the person speaking the recording, lip-synced, and is exactly as long as it (up to 60s). Pass audio_key or audio_upload_id (see get_audio_upload_page / upload_audio); narration (optional) is what the recording says, so the scene's text and visuals match it. remove=true goes back to the AI voice. Nothing is re-rendered here: on a rendered video apply it with regenerate_scene(mode='narration') (estimate_cost and the user's OK first).

set_scene_audio

Store a reference image (a person's photo / character sheet, a product shot) from a public https link to a PNG or JPEG file (max 10 MB); returns a reference_image_key for create_video. rights_confirmed must be true: first tell the user By uploading, you confirm that you own these images or hold every right and permission needed to use them in videos (including the consent of any person shown), and that Fabeo is not responsible for any copyright, trademark, privacy or other infringement arising from images you upload. and get their OK. For photos on the user's device use get_reference_upload_page instead.

upload_reference_image

Store the user's voice recording from a public https link to an MP3/WAV/M4A/OGG file (up to 60s, 25 MB); returns an audio_key for create_video_from_audio or set_scene_audio. rights_confirmed must be true: first tell the user By uploading, you confirm that you own this recording or hold every right and permission needed to use it in videos (including the consent of anyone whose voice is in it), and that Fabeo is not responsible for any copyright, privacy or other infringement arising from audio you upload. and get their OK. For a file on the user's device use get_audio_upload_page instead.

upload_audio