MuleRouter Documentation - AI API Gateway & Routing Platform

Create Generation Task

curl --request POST \
  --url https://api.mulerouter.ai/vendors/carrothub/v1/berry-1.0-turbo/generation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "first_frame": "<string>",
  "last_frame": "<string>",
  "reference_images": [
    "<string>"
  ],
  "reference_videos": [
    "<string>"
  ],
  "reference_audios": [
    "<string>"
  ],
  "file": "<string>",
  "link": "<string>",
  "resolution": "1080p",
  "ratio": "adaptive",
  "duration": 5,
  "audio": true,
  "seed": 1073741823,
  "prompt_extend": true
}
'

import requests

url = "https://api.mulerouter.ai/vendors/carrothub/v1/berry-1.0-turbo/generation"

payload = {
    "prompt": "<string>",
    "first_frame": "<string>",
    "last_frame": "<string>",
    "reference_images": ["<string>"],
    "reference_videos": ["<string>"],
    "reference_audios": ["<string>"],
    "file": "<string>",
    "link": "<string>",
    "resolution": "1080p",
    "ratio": "adaptive",
    "duration": 5,
    "audio": True,
    "seed": 1073741823,
    "prompt_extend": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    prompt: '<string>',
    first_frame: '<string>',
    last_frame: '<string>',
    reference_images: ['<string>'],
    reference_videos: ['<string>'],
    reference_audios: ['<string>'],
    file: '<string>',
    link: '<string>',
    resolution: '1080p',
    ratio: 'adaptive',
    duration: 5,
    audio: true,
    seed: 1073741823,
    prompt_extend: true
  })
};

fetch('https://api.mulerouter.ai/vendors/carrothub/v1/berry-1.0-turbo/generation', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.mulerouter.ai/vendors/carrothub/v1/berry-1.0-turbo/generation",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'prompt' => '<string>',
    'first_frame' => '<string>',
    'last_frame' => '<string>',
    'reference_images' => [
        '<string>'
    ],
    'reference_videos' => [
        '<string>'
    ],
    'reference_audios' => [
        '<string>'
    ],
    'file' => '<string>',
    'link' => '<string>',
    'resolution' => '1080p',
    'ratio' => 'adaptive',
    'duration' => 5,
    'audio' => true,
    'seed' => 1073741823,
    'prompt_extend' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.mulerouter.ai/vendors/carrothub/v1/berry-1.0-turbo/generation"

	payload := strings.NewReader("{\n  \"prompt\": \"<string>\",\n  \"first_frame\": \"<string>\",\n  \"last_frame\": \"<string>\",\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"reference_videos\": [\n    \"<string>\"\n  ],\n  \"reference_audios\": [\n    \"<string>\"\n  ],\n  \"file\": \"<string>\",\n  \"link\": \"<string>\",\n  \"resolution\": \"1080p\",\n  \"ratio\": \"adaptive\",\n  \"duration\": 5,\n  \"audio\": true,\n  \"seed\": 1073741823,\n  \"prompt_extend\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.mulerouter.ai/vendors/carrothub/v1/berry-1.0-turbo/generation")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"<string>\",\n  \"first_frame\": \"<string>\",\n  \"last_frame\": \"<string>\",\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"reference_videos\": [\n    \"<string>\"\n  ],\n  \"reference_audios\": [\n    \"<string>\"\n  ],\n  \"file\": \"<string>\",\n  \"link\": \"<string>\",\n  \"resolution\": \"1080p\",\n  \"ratio\": \"adaptive\",\n  \"duration\": 5,\n  \"audio\": true,\n  \"seed\": 1073741823,\n  \"prompt_extend\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.mulerouter.ai/vendors/carrothub/v1/berry-1.0-turbo/generation")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"<string>\",\n  \"first_frame\": \"<string>\",\n  \"last_frame\": \"<string>\",\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"reference_videos\": [\n    \"<string>\"\n  ],\n  \"reference_audios\": [\n    \"<string>\"\n  ],\n  \"file\": \"<string>\",\n  \"link\": \"<string>\",\n  \"resolution\": \"1080p\",\n  \"ratio\": \"adaptive\",\n  \"duration\": 5,\n  \"audio\": true,\n  \"seed\": 1073741823,\n  \"prompt_extend\": true\n}"

response = http.request(request)
puts response.read_body

{
  "task_info": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "status": "pending",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

{
  "task_info": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "status": "failed",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "error": {
      "code": 2001,
      "title": "Invalid Request",
      "detail": "cannot mix the reference mode (reference_images / reference_videos / reference_audios) with the keyframe mode (first_frame / last_frame)"
    }
  }
}

POST

vendors

carrothub

berry-1.0-turbo

generation

Create Generation Task

curl --request POST \
  --url https://api.mulerouter.ai/vendors/carrothub/v1/berry-1.0-turbo/generation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "first_frame": "<string>",
  "last_frame": "<string>",
  "reference_images": [
    "<string>"
  ],
  "reference_videos": [
    "<string>"
  ],
  "reference_audios": [
    "<string>"
  ],
  "file": "<string>",
  "link": "<string>",
  "resolution": "1080p",
  "ratio": "adaptive",
  "duration": 5,
  "audio": true,
  "seed": 1073741823,
  "prompt_extend": true
}
'

import requests

url = "https://api.mulerouter.ai/vendors/carrothub/v1/berry-1.0-turbo/generation"

payload = {
    "prompt": "<string>",
    "first_frame": "<string>",
    "last_frame": "<string>",
    "reference_images": ["<string>"],
    "reference_videos": ["<string>"],
    "reference_audios": ["<string>"],
    "file": "<string>",
    "link": "<string>",
    "resolution": "1080p",
    "ratio": "adaptive",
    "duration": 5,
    "audio": True,
    "seed": 1073741823,
    "prompt_extend": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    prompt: '<string>',
    first_frame: '<string>',
    last_frame: '<string>',
    reference_images: ['<string>'],
    reference_videos: ['<string>'],
    reference_audios: ['<string>'],
    file: '<string>',
    link: '<string>',
    resolution: '1080p',
    ratio: 'adaptive',
    duration: 5,
    audio: true,
    seed: 1073741823,
    prompt_extend: true
  })
};

fetch('https://api.mulerouter.ai/vendors/carrothub/v1/berry-1.0-turbo/generation', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.mulerouter.ai/vendors/carrothub/v1/berry-1.0-turbo/generation",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'prompt' => '<string>',
    'first_frame' => '<string>',
    'last_frame' => '<string>',
    'reference_images' => [
        '<string>'
    ],
    'reference_videos' => [
        '<string>'
    ],
    'reference_audios' => [
        '<string>'
    ],
    'file' => '<string>',
    'link' => '<string>',
    'resolution' => '1080p',
    'ratio' => 'adaptive',
    'duration' => 5,
    'audio' => true,
    'seed' => 1073741823,
    'prompt_extend' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.mulerouter.ai/vendors/carrothub/v1/berry-1.0-turbo/generation"

	payload := strings.NewReader("{\n  \"prompt\": \"<string>\",\n  \"first_frame\": \"<string>\",\n  \"last_frame\": \"<string>\",\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"reference_videos\": [\n    \"<string>\"\n  ],\n  \"reference_audios\": [\n    \"<string>\"\n  ],\n  \"file\": \"<string>\",\n  \"link\": \"<string>\",\n  \"resolution\": \"1080p\",\n  \"ratio\": \"adaptive\",\n  \"duration\": 5,\n  \"audio\": true,\n  \"seed\": 1073741823,\n  \"prompt_extend\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.mulerouter.ai/vendors/carrothub/v1/berry-1.0-turbo/generation")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"<string>\",\n  \"first_frame\": \"<string>\",\n  \"last_frame\": \"<string>\",\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"reference_videos\": [\n    \"<string>\"\n  ],\n  \"reference_audios\": [\n    \"<string>\"\n  ],\n  \"file\": \"<string>\",\n  \"link\": \"<string>\",\n  \"resolution\": \"1080p\",\n  \"ratio\": \"adaptive\",\n  \"duration\": 5,\n  \"audio\": true,\n  \"seed\": 1073741823,\n  \"prompt_extend\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.mulerouter.ai/vendors/carrothub/v1/berry-1.0-turbo/generation")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"<string>\",\n  \"first_frame\": \"<string>\",\n  \"last_frame\": \"<string>\",\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"reference_videos\": [\n    \"<string>\"\n  ],\n  \"reference_audios\": [\n    \"<string>\"\n  ],\n  \"file\": \"<string>\",\n  \"link\": \"<string>\",\n  \"resolution\": \"1080p\",\n  \"ratio\": \"adaptive\",\n  \"duration\": 5,\n  \"audio\": true,\n  \"seed\": 1073741823,\n  \"prompt_extend\": true\n}"

response = http.request(request)
puts response.read_body

{
  "task_info": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "status": "pending",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

{
  "task_info": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "status": "failed",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "error": {
      "code": 2001,
      "title": "Invalid Request",
      "detail": "cannot mix the reference mode (reference_images / reference_videos / reference_audios) with the keyframe mode (first_frame / last_frame)"
    }
  }
}

Overview

Generate videos with the Berry 1.0 Turbo all-in-one model (berry-1.0-turbo) — the faster tier of berry-1.0. A single generation endpoint covers three capability sets — the media fields you send decide which one runs:

Media fields sent	Capability
none (`prompt` only)	Text-to-video
`first_frame` and/or `last_frame`	Image-to-video (keyframe mode)
`reference_images` / `reference_videos` / `reference_audios` / `file` / `link`	Reference-to-video (reference mode)

Keyframe mode and reference mode are mutually exclusive — a single request cannot mix fields from both sides.

Key Features

Text-to-video, keyframe-driven image-to-video, and multi-modal reference-to-video in one endpoint
Three resolutions (480p / 720p / 1080p), case-insensitive
Six aspect ratios plus adaptive, which derives the ratio from intent and input media
2–30 second duration, or -1 for smart duration picked by the model
Audio output on by default — pricing is identical whether audio is on or off
Image inputs accept both URL and Base64; video / audio inputs are URL only
Reproducible generation with seed
Prompt rewriting on by default — set prompt_extend: false to stay close to the literal prompt text

Prompt Reference Syntax

In reference mode the prompt may refer to inputs by index — “Image 1” or “Video 1”. Images, videos and audios are counted separately per field, in array order: the first item of reference_images is “Image 1”, the first item of reference_videos is “Video 1”.

Image Input Formats

first_frame, last_frame and every item of reference_images accept three shapes, and the three may be mixed within one reference_images array:

A public HTTP/HTTPS URL
A data URI — data:image/png;base64,iVBORw0KGgo...
A bare Base64 string with no prefix

reference_videos and reference_audios are URL only — Base64 is not accepted there, because a 100MB video would inflate the request body to roughly 133MB.

Output Ownership

All content generated through this API belongs entirely to the user. MuleRouter claims no ownership rights over any outputs.

Example Requests

Text-to-Video

{
  "prompt": "A kitten runs across a rooftop under the moonlight, city neon flickering in the distance, cinematic quality, smooth camera movement.",
  "resolution": "1080p",
  "ratio": "16:9",
  "duration": 5
}

First-Frame Image-to-Video

{
  "prompt": "A graffiti youth comes alive from a concrete wall and performs a fast-paced rap under a lone street lamp at night.",
  "first_frame": "https://example.com/rap.png",
  "resolution": "720p",
  "duration": 5
}

First and Last Frame

{
  "prompt": "A young girl gradually shifts from a smile to laughter, the camera slowly pushes in, background light warms from cool to warm tones.",
  "first_frame": "https://example.com/first.png",
  "last_frame": "https://example.com/last.jpg",
  "resolution": "1080p",
  "ratio": "16:9",
  "duration": 5
}

First Frame via Base64

{
  "prompt": "The scene comes alive, gentle camera push-in",
  "first_frame": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
  "resolution": "720p",
  "duration": 5
}

Reference-to-Video (Multi-Subject)

{
  "prompt": "Video 1 holds Image 3, plays a soothing country folk song on the chair from Image 4, and says, 'The sunshine is so nice today.' Image 1, holding Image 2, walks past Video 1 and places Image 2 on the table.",
  "reference_images": [
    "https://example.com/girl.jpg",
    "https://example.com/object2.png",
    "https://example.com/object3.png",
    "https://example.com/chair4.png"
  ],
  "reference_videos": ["https://example.com/role.mp4"],
  "resolution": "720p",
  "ratio": "adaptive",
  "duration": 10
}

Smart Duration with Silent Output

{
  "prompt": "Cinematic drone shot over a snowy mountain range",
  "duration": -1,
  "audio": false,
  "seed": 42
}

Literal Prompt (Rewriting Disabled)

{
  "prompt": "A golden retriever running through a field of sunflowers at sunset, cinematic lighting, camera slowly pushes in, warm rim light on the fur",
  "resolution": "1080p",
  "ratio": "16:9",
  "duration": 5,
  "prompt_extend": false
}

File and Link Inputs

Both fields are optional single HTTP/HTTPS URL strings and belong to reference mode. They cannot be combined with first_frame or last_frame, and file and link cannot be sent together. These combinations are mutually exclusive in the public contract and JSON Schema. The gateway does not synchronously reject combinations involving file or link; it forwards them to the upstream service, which reports incompatibility through the asynchronous task error.

File URL

file supports docx, doc, xlsx, xls, pptx, ppt, pdf, txt, key, pages, numbers, and md files up to 100MB. PDF, DOCX, DOC, PPTX, PPT, KEY, and PAGES files are limited to 50 pages.

{
  "prompt": "Create a product video from this brief",
  "file": "https://example.com/product-brief.pdf",
  "resolution": "1080p",
  "duration": 10
}

Link URL

link must point to a public web page that is accessible without authentication.

{
  "prompt": "Create a news summary video from this article",
  "link": "https://example.com/articles/product-launch",
  "resolution": "1080p",
  "duration": 10
}

Pricing

Billed on one dimension — resolution unit price × billed duration in seconds.

Resolution	Unit price
480p	$0.068 / second
720p	$0.140 / second
1080p (default)	$0.280 / second

Both the input video and the output video are billed, by video seconds: billed duration = input video duration + output video duration

Input video duration — the actual duration, in seconds, of the video supplied in reference_videos; a request with no video input contributes 0 seconds here
Output video duration — the duration, in seconds, of the video that was successfully generated
A failed task is not billed
audio: false does not reduce the price

Parameters

prompt

Type: string, conditionally required
Max length: 20000 characters
Over-length prompts are not rejected — they are passed through and truncated upstream
At least one of prompt, a keyframe field, or a reference field must be provided

first_frame / last_frame

Type: string (URL, data URI, or bare Base64), optional
At most one image each; used strictly as the first / last frame of the video
Keyframe mode — cannot be combined with any reference-mode field

reference_images

Type: array of strings (URL, data URI, or bare Base64 — mixable), optional
Max items: 10
Reference mode — cannot be combined with keyframe fields

reference_videos

Type: array of URI strings, optional. URL only, no Base64
Max items: 5, total duration ≤ 15s
This gateway checks only the recognizable file extension (.mp4 / .mov); extensionless URLs such as signed links are passed through

reference_audios

Type: array of URI strings, optional. URL only, no Base64
Max items: 5, total duration ≤ 15s
Extension check is .wav / .mp3; extensionless URLs are passed through

resolution

Options: 480p / 720p / 1080p (case-insensitive)
Default: 1080p

ratio

Options: adaptive / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 (case-insensitive)
Default: adaptive, which derives the ratio from intent and input media

duration

Range: integer 2–30 inclusive, or -1 for smart duration
Default: 5
With video input, the combined input + output duration must be ≤ 30s (validated upstream)

audio

Type: boolean
Default: true
Whether the output video carries an audio track. Pricing is identical either way.

seed

Range: 0–2147483647, nullable
Default: null (auto-generated seed)

prompt_extend

Type: boolean
Default: true
Whether upstream rewrites (expands) the prompt before generation. Rewriting usually improves motion and cinematography on short prompts; set false to keep generation close to the literal prompt text

Input Requirements

Field	Formats	Size	Other
`first_frame` / `last_frame` / `reference_images`	JPEG, JPG, PNG (no alpha), BMP, WEBP	≤ 20MB	side 240–8000px, ratio ≤ 8:1
`reference_videos`	mp4, mov	≤ 100MB	side 240–4096px, ratio ≤ 8:1, each 1–15s and ≤ 15s total
`reference_audios`	wav, mp3	≤ 15MB	each 1–15s and ≤ 15s total

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

All-in-One video generation. At least one of prompt, a reference field, or a keyframe field must be provided.

Two mutually exclusive input modes:

Reference mode: reference_images / reference_videos / reference_audios / file / link
Keyframe mode: first_frame / last_frame

prompt

string | null

Text prompt describing the desired video. Up to 20000 characters — over-length prompts are not rejected, they are passed through and truncated upstream. Required unless a keyframe or reference input is given.

first_frame

string | null

First-frame image, strictly used as the first frame of the video. Accepts a public HTTP/HTTPS URL, a data:image/<type>;base64,... data URI, or a bare Base64 string. Keyframe mode; cannot be combined with reference-mode fields.

Upstream format requirements (validated upstream, not by this gateway): JPEG/JPG/PNG (no alpha)/BMP/WEBP, side 240–8000px, ratio ≤8:1, ≤20MB.

last_frame

string | null

Last-frame image, strictly used as the last frame of the video. Same input formats and upstream constraints as first_frame. Keyframe mode; cannot be combined with reference-mode fields.

reference_images

string[] | null

Reference images, up to 10. Each item accepts a public HTTP/HTTPS URL, a data:image/<type>;base64,... data URI, or a bare Base64 string; the three shapes may be mixed within one array. Referenced in prompt as "Image 1", "Image 2", … in array order. Reference mode; cannot be combined with keyframe fields.

Upstream format requirements: JPEG/JPG/PNG (no alpha)/BMP/WEBP, side 240–8000px, ratio ≤8:1, ≤20MB.

Maximum array length: 10

reference_videos

string<uri>[] | null

Reference videos, up to 5, total duration ≤15s. URL only — Base64 is not accepted here (a 100MB video would inflate the request body to ~133MB). Referenced in prompt as "Video 1", "Video 2", … in array order. Reference mode; cannot be combined with keyframe fields.

Upstream format requirements: mp4/mov, side 240–4096px, ratio ≤8:1, each 1–15s, ≤100MB. This gateway checks only the recognizable file extension (.mp4 / .mov); extensionless URLs such as signed links are passed through.

Maximum array length: 5

reference_audios

string<uri>[] | null

Reference audios, up to 5, total duration ≤15s. URL only — Base64 is not accepted here. Reference mode; cannot be combined with keyframe fields.

Upstream format requirements: wav/mp3, each 1–15s, ≤15MB. This gateway checks only the recognizable file extension (.wav / .mp3); extensionless URLs are passed through.

Maximum array length: 5

file

string<uri> | null

Reference file URL. HTTP/HTTPS only; at most one file. Supported formats: docx, doc, xlsx, xls, pptx, ppt, pdf, txt, key, pages, numbers, md. Maximum size is 100MB. The upstream specification limits PDF, DOCX, DOC, PPTX, PPT, KEY, and PAGES files to 50 pages. Mutually exclusive with link and keyframe-mode fields.

Pattern: ^https?://

link

string<uri> | null

Public web page URL. HTTP/HTTPS only; the page must be accessible without authentication. At most one link. Mutually exclusive with file and keyframe-mode fields.

Pattern: ^https?://

resolution

enum<string>

default:1080p

Output resolution (case-insensitive). 2k / 4k require berry-1.0-pro-turbo.

Available options:

480p,

720p,

1080p

ratio

enum<string>

default:adaptive

Aspect ratio (case-insensitive). adaptive derives the ratio from intent and input media.

Available options:

16:9,

4:3,

1:1,

3:4,

9:16,

adaptive

duration

integer

default:5

Video duration in seconds, 2–30 inclusive, or -1 for smart duration (upstream picks the length from intent / content / media). With video input, the combined input + output duration must be ≤30s — validated upstream.

audio

boolean

default:true

Whether the output video includes an audio track. Pricing is identical either way.

seed

integer | null

Random seed [0, 2147483647]. null or omitted for an auto-generated seed.

Required range: 0 <= x <= 2147483647

prompt_extend

boolean

default:true

Whether upstream rewrites (expands) the prompt before generation. Enabled by default: rewriting usually improves motion and cinematography on short prompts. Set to false to keep generation close to the literal prompt text.

Response

OK - Task created successfully

task_info

object

Show child attributes

​Overview

​Key Features

​Prompt Reference Syntax

​Image Input Formats

​Output Ownership

​Example Requests

​Text-to-Video

​First-Frame Image-to-Video

​First and Last Frame

​First Frame via Base64

​Reference-to-Video (Multi-Subject)

​Smart Duration with Silent Output

​Literal Prompt (Rewriting Disabled)

​File and Link Inputs

​File URL

​Link URL

​Pricing

​Parameters

​prompt

​first_frame / last_frame

​reference_images

​reference_videos

​reference_audios

​resolution

​ratio

​duration

​audio

​seed

​prompt_extend

​Input Requirements

Authorizations

Body

Response

Overview

Key Features

Prompt Reference Syntax

Image Input Formats

Output Ownership

Example Requests

Text-to-Video

First-Frame Image-to-Video

First and Last Frame

First Frame via Base64

Reference-to-Video (Multi-Subject)

Smart Duration with Silent Output

Literal Prompt (Rewriting Disabled)

File and Link Inputs

File URL

Link URL

Pricing

Parameters

prompt

first_frame / last_frame

reference_images

reference_videos

reference_audios

resolution

ratio

duration

audio

seed

prompt_extend

Input Requirements