Video Generation

Brand Overlays API

Add a hook title, a lower-third callout, a review card, a progress bar, a countdown timer, a price tag, an offer badge and a branded end card to any video. Exact text in your brand color. Integrate this model via REST with endpoint docs, parameters, and code examples.

Compare video models Use cases

Credit Cost

2 credits

Type

Video

Get API Key

Create auth keys for apps and agents

See Usage

Track requests, credits, and logs

Buy Credits

Top up prepaid API capacity

API Endpoint

POST

/api/v1/models/brand-overlay/run

Test This Model

Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.

LLM.txt

AI-Ready

For AI assistants

Copy this model's documentation into Claude, GPT, or any AI for instant integration help.

/llm/brand-overlay.txt

OpenAPI Spec

Swagger compatible

Import into Postman, Swagger UI, or generate client SDKs in any language.

/api/openapi

Parameters

Input parameters accepted by this model

Parameter	Type	Description	Default
`video` required	url	Reference video URL.	-
`color`	string	Brand color as #RRGGBB: fills the offer badge and the CTA button. Defaults to #FFE500.	-
`hook_text`	string	Hook title for the first seconds, 5-8 words, e.g. "Octopuses have THREE hearts?".	-
`hook_duration`	number	Seconds the hook stays. Defaults to 2.5. min: 1 \| max: 6	-
`callout_title`	string	Lower third: a benefit ("Ships in 24h") or a name.	-
`callout_subtitle`	string	Second line under the label, e.g. a title or detail.	-
`callout_style`	enum	label (default): a brand-colored box. classic: the broadcast lower third, an accent bar beside a bold name and a lighter title (bottom band on 16:9). `labelclassic`	-
`callout_start`	number	Second the label slides in. Defaults to 3. min: 0 \| max: 600	-
`callout_duration`	number	Seconds it stays. Defaults to 4. min: 1 \| max: 10	-
`review_quote`	string	Review card quote, e.g. "Best mug I have ever owned".	-
`review_name`	string	Who said it, e.g. "Jess, verified buyer".	-
`review_stars`	integer	Stars on the review card. Defaults to 5. min: 1 \| max: 5	-
`review_start`	number	Second the review card appears. Defaults to just after the hook. min: 0 \| max: 600	-
`review_duration`	number	Seconds it stays. Defaults to 4. min: 1 \| max: 10	-
`progress_bar`	boolean	A thin bar in the brand color across the top that fills as the video plays.	-
`countdown_from`	string	Countdown start, e.g. "23:59:59"; the digits tick down each second it is on screen.	-
`countdown_label`	string	Words above the timer. Defaults to "Ends in".	-
`countdown_start`	number	Second the timer appears. Defaults to 0.5, or just after the hook. min: 0 \| max: 600	-
`countdown_duration`	number	Seconds it stays. Defaults to 4. min: 1 \| max: 10	-
`price_now`	string	Price tag, the price to pay, e.g. "$49".	-
`price_was`	string	Old price, shown struck through, e.g. "$79".	-
`price_label`	string	Small line under the price, e.g. "Today only".	-
`price_start`	number	Second the tag appears. Defaults to just after the hook. min: 0 \| max: 600	-
`price_duration`	number	Seconds it stays. Defaults to 4. min: 1 \| max: 10	-
`offer_text`	string	Offer callout headline, e.g. "50% OFF".	-
`offer_subtext`	string	Small line under the offer, e.g. "This week only".	-
`offer_start`	number	Second the offer appears. Defaults to 0.5, or just after the hook. min: 0 \| max: 600	-
`offer_duration`	number	Seconds the callout stays. Defaults to 3. min: 1 \| max: 10	-
`offer_position`	enum	top (default) or bottom, above where captions sit. `topbottom`	-
`end_headline`	string	End card headline. Setting it adds the end card.	-
`end_cta`	string	End card button text, e.g. "Shop now".	-
`end_url`	url	End card web address, e.g. "pixeldojo.ai".	-
`logo_url`	url	End card logo: a PNG (transparent works best) or JPG URL.	-
`end_duration`	number	Seconds the end card holds after the video. Defaults to 3. min: 2 \| max: 5	-

Use saved characters (@Name)

This model takes no reference images, so @Name of a saved character is refused (400) before anything is charged. A saved location, prop or style with a description is inserted as text. For saved characters, use a model that takes reference images, such as Nano Banana Pro or Seedream 5 for images, or Seedance 2.5 or WAN 3.0 for video.

Code Examples

Offer callout and end card — copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/brand-overlay/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://...",
    "color": "#39E508",
    "offer_text": "50% OFF",
    "offer_subtext": "This week only",
    "end_headline": "Your new favorite mug",
    "end_cta": "Shop now",
    "end_url": "example.com"
  }'

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 2,
  "creditsRemaining": 95,
  "expiresAt": "2026-10-20T12:52:31Z"
}

Completed Response

json

{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "video": "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.mp4"
  },
  "creditCost": 2,
  "expiresAt": "2026-10-20T12:52:31Z"
}

LLM Documentation Try in Web UI Get API Key Usage Dashboard Buy Credits