---
title: "Explainer scene · סצנת הסבר מצוירת — estimate"
method: POST
path: "/v1/effects/explainer-scene/estimate"
tags: ["Effects · Overlays & graphics"]
---

# Explainer scene · סצנת הסבר מצוירת — estimate

`POST /v1/effects/explainer-scene/estimate`

## Request

- Base URL: `https://apihub.co.il`
- URL: `https://apihub.co.il/v1/effects/explainer-scene/estimate`
- Auth: HTTP bearer

Price the request without executing it. Same body as `POST /v1/effects/explainer-scene`.

## Request body

- object
  - `at` object: Start at a word (instead of a time)
    - `edge` 'start' | 'end', required: The moment the word starts, or the moment it ends
    - `word` string, required: The word's id (w0001…)
    - `offset_ms` number: Shift in ms, applied after the cuts (default 0)
  - `keep` object[]: Keep only these spans of the video (seconds) — every join between them is a cut a transition plays on
    - `end` number, required
    - `start` number, required
  - `text` string: The words — same as params.text
  - `trim` object: Use only this part of the video (seconds)
    - `end` number
    - `start` number
  - `start` number: seconds on the output — when it starts (default: the effect's own)
  - `words` object[]: Your own timed words (ms) instead of a transcript
    - `id` string
    - `end` number, required
    - `text` string, required
    - `start` number, required
  - `during` object: Start and end with a stretch of words (instead of a time and a duration)
    - `to` string, required: Id of the last word
    - `from` string, required: Id of the first word
    - `pad_end_ms` number: End this much later (default 0)
    - `pad_start_ms` number: Start this much earlier (default 0)
  - `output` object
    - `fit` 'crop' | 'blur' | 'pad': When the aspect ratio changes: crop the edges, blurred copy behind, or solid bars
    - `fps` number
    - `format` 'mp4' | 'webm' | 'mov' | 'gif' | 'mp3' | 'wav' | 'm4a' | 'jpg' | 'png'
    - `quality` 'draft' | 'standard' | 'high': high (default) = best picture; draft renders fastest for previews
    - `background` string: Bar colour for fit=pad
    - `resolution` '480' | '720' | '1080' | 'source': Short side in pixels (1080 = Full HD). `source` keeps the input size, max 1080
    - `aspect_ratio` 'original' | '9:16' | '16:9' | '1:1' | '4:5' | '4:3': 9:16 for Reels/TikTok/Shorts, 1:1 or 4:5 for feed, 16:9 for YouTube
  - `params` object: The effect's own settings (every field has a default)
    - `done` string: end: the button's word once pressed
    - `font` string: Font family — GET /v1/studio/fonts (a Hebrew text falls back to a Hebrew font)
    - `from` number: counter: where it starts
    - `kind` 'title' | 'logo' | 'versus' | 'cards' | 'counter' | 'chat' | 'app' | 'devices' | 'graph' | 'site' | 'editor' | 'end': The layout of this beat
    - `name` string: app: the name in the greeting
    - `ring` string: end: the text in the countdown ring (1:00)
    - `rows` object[]: app: the task cards (label, tag chip, value = % done, note)
      - `tag` string
      - `note` string
      - `label` string, required
      - `value` string
    - `text` string: app: the greeting · site: the small tag · end: the card's line (*marks*)
    - `items` object[]: The layout's items: cards (label + icon), the chat's steps (label + value), the app's three stat tiles (label + value, tag = unit), devices, the network's nodes, the site's products (label + value = price), versus [the old way, yours]
      - `tag` string
      - `icon` 'video' | 'mic' | 'captions' | 'globe' | 'phone' | 'laptop' | 'chat' | 'sparkles' | 'chart' | 'music' | 'image' | 'megaphone' | 'check' | 'bolt' | 'clock' | 'user' | 'mail' | 'play' | 'wand' | 'terminal' | 'heart' | 'cart' | 'bell' | 'scissors' | 'layers' | 'send' | 'translate' | 'star' | 'calendar' | 'agent'
      - `label` string, required
      - `value` string
    - `label` string: The layout's own word: the logo's name, the network's centre, the site's brand, the editor's preview, the counter's small label, the app's section, the ending's small label, the chat window's name
    - `serif` string: Font family — GET /v1/studio/fonts (a Hebrew text falls back to a Hebrew font)
    - `theme` 'dark' | 'cream' | 'accent' | 'lavender': The plate: dark, cream, the accent colour or lavender
    - `title` string: The big title; *a phrase* = the accent in italic serif; \n = a new line
    - `typed` boolean: chat: the request is already in the box (the beat after the one that typed it)
    - `value` number: counter: where the number lands
    - `accent` string: The accent: the marked words, the pills, the highlights
    - `button` string: site / end: the button's word
    - `prefix` string: counter: before the number (₪, $)
    - `prompt` string: chat: the request typed into the box
    - `suffix` string: counter: after it (%, דקות)
    - `address` string: site: the address shown in the bar (only shown, never opened)
    - `caption` string: A short line lower down; *a word* = on an accent pill
    - `decimals` integer: counter: decimals
    - `logo_url` string, uri: logo / versus: your logo (PNG / JPG)
  - `duration` number: seconds — how long it lasts
  - `video_url` string, uri: The video to put it on — leave out for the plain canvas
  - `language_code` string: Spoken language for the automatic transcript, e.g. he, en
  - `transcript_id` string: Reuse a transcript (captions effects)

## Response `200`

Estimate

- Estimate
  - `operation` string
  - `estimated_credits` number
  - `credits_to_reserve` number
  - `estimated_usage` object
  - `note` string, nullable
  - `balance` object
    - `available` number
  - `sufficient` boolean

## Changes

- **2026-10-19** `a8caa42835ce`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai/changes/v1/effects/explainer-scene/estimate/post.md)

---

[API](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai.md) · [All operations](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai/revisions/a8caa42835ce?raw)