Generate videos with the Berry 1.0 all-in-one model (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.
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”.
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.
{ "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}
{ "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}
{ "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}
{ "prompt": "The scene comes alive, gentle camera push-in", "first_frame": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...", "resolution": "720p", "duration": 5}
{ "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}
{ "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}
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.
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}
Billed on one dimension — resolution unit price × billed duration in seconds.
Resolution
Unit price
480p
$0.050 / second
720p
$0.100 / second
1080p (default)
$0.200 / 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
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
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 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 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, 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.
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.
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.
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.
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.
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.
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.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"CarrotHub Docs","colors":{"primary":"#594BF6","light":"#7E7DFF","dark":"#594BF6"},"logo":{"light":"https://mintcdn.com/carrothub/6rVQwA8-jDnVzV6k/logo/carrothub-light.svg?fit=max\u0026auto=format\u0026n=6rVQwA8-jDnVzV6k\u0026q=85\u0026s=8263206bfee760db1e1ff9f0f78ef780","dark":"https://mintcdn.com/carrothub/6rVQwA8-jDnVzV6k/logo/carrothub-dark.svg?fit=max\u0026auto=format\u0026n=6rVQwA8-jDnVzV6k\u0026q=85\u0026s=fa03655e81d56286b1930d4928c4defd"},"favicon":"https://mintcdn.com/carrothub/6rVQwA8-jDnVzV6k/logo/carrot-icon.svg?fit=max\u0026auto=format\u0026n=6rVQwA8-jDnVzV6k\u0026q=85\u0026s=0548ebc1c082def4f16b1d546b7dcc9b","navbar":{"links":[{"href":"mailto:contact@carrothub.ai","label":"Contact"}],"primary":{"type":"button","label":"CarrotHub","href":"https://carrothub.ai"}},"footer":{"socials":{"discord":"https://discord.gg/pdRwFDsc9z"}},"seo":{"metatags":{"canonical":"https://www.carrothub.ai/docs","title":"CarrotHub Documentation - AI API Gateway \u0026 Routing Platform","description":"Complete API documentation for CarrotHub AI platform. Learn to integrate LLM, image generation, and video generation APIs including OpenAI, Qwen, Wan 2, Midjourney, and more.","keywords":"CarrotHub, AI API, API gateway, LLM, OpenAI, image generation, video generation, Qwen, Wan 2, Midjourney, AI integration, API documentation","og:title":"CarrotHub Documentation - AI API Gateway \u0026 Routing Platform","og:description":"Complete API documentation for CarrotHub AI platform. Learn to integrate LLM, image generation, and video generation APIs including OpenAI, Qwen, Wan 2, Midjourney, and more.","og:image":"https://www.carrothub.ai/docs/logo/carrothub-light.svg","og:url":"https://www.carrothub.ai/docs","og:type":"website","twitter:card":"summary_large_image","twitter:title":"CarrotHub Documentation - AI API Gateway \u0026 Routing Platform","twitter:description":"Complete API documentation for CarrotHub AI platform. Learn to integrate LLM, image generation, and video generation APIs including OpenAI, Qwen, Wan 2, Midjourney, and more.","twitter:image":"https://www.carrothub.ai/docs/logo/carrothub-light.svg","robots":"index, follow","author":"CarrotHub","language":"en"}},"contextual":{"options":["copy","chatgpt","claude","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Community","icon":"discord","href":"https://discord.gg/pdRwFDsc9z"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"carrothub","hasAudioNarration":false,"actualSubdomain":"carrothub","customDomains":["www.carrothub.ai"],"gitSource":{"type":"github","owner":"carrothub-ai","repo":"carrothub","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6af16c2fcebe80f7a56d2253","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"API Reference","count":114},{"language":"default","tag":"Video Generation","count":67},{"language":"default","tag":"Wan 2","count":39},{"language":"default","tag":"Image Generation","count":35},{"language":"default","tag":"CLI","count":15},{"language":"default","tag":"Kling","count":14},{"language":"default","tag":"Berry","count":12},{"language":"default","tag":"Wan 2 Spark","count":12},{"language":"default","tag":"Get Started","count":9},{"language":"default","tag":"MiniMax","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/endpoint/carrothub/berry-1.0/generation","slug":"/api-reference/endpoint/carrothub/berry-1.0/generation","pageMetadata":{"title":"Berry 1.0 Video Generation","openapi":"api-reference/endpoint/carrothub/berry-1.0/berry-1.0.yaml POST /vendors/carrothub/v1/berry-1.0/generation","description":"Create an asynchronous Berry1.0 video generation task.\n\nAt least one of `prompt`, a keyframe field or a reference field must be provided.","href":"/api-reference/endpoint/carrothub/berry-1.0/generation"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Create an asynchronous Berry1.0 video generation task.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"At least one of \", _jsx(_components.code, {\n children: \"prompt\"\n }), \", a keyframe field or a reference field must be provided.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`Generate videos with the Berry 1.0 all-in-one model (`,_jsx(_components.code,{children:`berry-1.0`}),`). A single `,_jsx(_components.code,{children:`generation`}),` endpoint covers\nthree capability sets — the media fields you send decide which one runs:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Media fields sent`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Capability`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{style:{textAlign:`left`},children:[`none (`,_jsx(_components.code,{children:`prompt`}),` only)`]}),_jsx(_components.td,{style:{textAlign:`left`},children:`Text-to-video`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`first_frame`}),` and/or `,_jsx(_components.code,{children:`last_frame`})]}),_jsx(_components.td,{style:{textAlign:`left`},children:`Image-to-video (keyframe mode)`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`reference_images`}),` / `,_jsx(_components.code,{children:`reference_videos`}),` / `,_jsx(_components.code,{children:`reference_audios`}),` / `,_jsx(_components.code,{children:`file`}),` / `,_jsx(_components.code,{children:`link`})]}),_jsx(_components.td,{style:{textAlign:`left`},children:`Reference-to-video (reference mode)`})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Keyframe mode and reference mode are mutually exclusive`}),` — a single request cannot mix fields from\nboth sides.`]}),`\n`,_jsx(Heading,{level:`2`,id:`key-features`,children:`Key Features`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Text-to-video, keyframe-driven image-to-video, and multi-modal reference-to-video in one endpoint`}),`\n`,_jsx(_components.li,{children:`Three resolutions (480p / 720p / 1080p), case-insensitive`}),`\n`,_jsxs(_components.li,{children:[`Six aspect ratios plus `,_jsx(_components.code,{children:`adaptive`}),`, which derives the ratio from intent and input media`]}),`\n`,_jsxs(_components.li,{children:[`2–30 second duration, or `,_jsx(_components.code,{children:`-1`}),` for smart duration picked by the model`]}),`\n`,_jsxs(_components.li,{children:[`Audio output on by default — `,_jsx(_components.strong,{children:`pricing is identical whether audio is on or off`})]}),`\n`,_jsxs(_components.li,{children:[`Image inputs accept both `,_jsx(_components.strong,{children:`URL and Base64`}),`; video / audio inputs are `,_jsx(_components.strong,{children:`URL only`})]}),`\n`,_jsxs(_components.li,{children:[`Reproducible generation with `,_jsx(_components.code,{children:`seed`})]}),`\n`,_jsxs(_components.li,{children:[`Prompt rewriting on by default — set `,_jsx(_components.code,{children:`prompt_extend: false`}),` to stay close to the literal\nprompt text`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`prompt-reference-syntax`,children:`Prompt Reference Syntax`}),`\n`,_jsxs(_components.p,{children:[`In reference mode the `,_jsx(_components.code,{children:`prompt`}),` may refer to inputs by index — “Image 1” or “Video 1”. Images, videos\nand audios are `,_jsx(_components.strong,{children:`counted separately per field`}),`, in array order: the\nfirst item of `,_jsx(_components.code,{children:`reference_images`}),` is “Image 1”, the first item of `,_jsx(_components.code,{children:`reference_videos`}),` is “Video 1”.`]}),`\n`,_jsx(Heading,{level:`2`,id:`image-input-formats`,children:`Image Input Formats`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`first_frame`}),`, `,_jsx(_components.code,{children:`last_frame`}),` and every item of `,_jsx(_components.code,{children:`reference_images`}),` accept three shapes, and the three may\nbe mixed within one `,_jsx(_components.code,{children:`reference_images`}),` array:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`A public HTTP/HTTPS `,_jsx(_components.strong,{children:`URL`})]}),`\n`,_jsxs(_components.li,{children:[`A `,_jsx(_components.strong,{children:`data URI`}),` — `,_jsx(_components.code,{children:`data:image/png;base64,iVBORw0KGgo...`})]}),`\n`,_jsxs(_components.li,{children:[`A `,_jsx(_components.strong,{children:`bare Base64`}),` string with no prefix`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`reference_videos`}),` and `,_jsx(_components.code,{children:`reference_audios`}),` are `,_jsx(_components.strong,{children:`URL only`}),` — Base64 is not accepted there, because a\n100MB video would inflate the request body to roughly 133MB.`]}),`\n`,_jsx(Heading,{level:`2`,id:`output-ownership`,children:`Output Ownership`}),`\n`,_jsx(_components.p,{children:`All content generated through this API belongs entirely to the user. CarrotHub claims no ownership\nrights over any outputs.`}),`\n`,_jsx(Heading,{level:`2`,id:`example-requests`,children:`Example Requests`}),`\n`,_jsx(Heading,{level:`3`,id:`text-to-video`,children:`Text-to-Video`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"A kitten runs across a rooftop under the moonlight, city neon flickering in the distance, cinematic quality, smooth camera movement.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"resolution\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1080p\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ratio\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"16:9\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"duration\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`5`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`first-frame-image-to-video`,children:`First-Frame Image-to-Video`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"A graffiti youth comes alive from a concrete wall and performs a fast-paced rap under a lone street lamp at night.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"first_frame\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com/rap.png\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"resolution\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"720p\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"duration\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`5`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`first-and-last-frame`,children:`First and Last Frame`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"A young girl gradually shifts from a smile to laughter, the camera slowly pushes in, background light warms from cool to warm tones.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"first_frame\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com/first.png\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"last_frame\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com/last.jpg\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"resolution\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1080p\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ratio\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"16:9\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"duration\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`5`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`first-frame-via-base64`,children:`First Frame via Base64`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"The scene comes alive, gentle camera push-in\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"first_frame\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"resolution\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"720p\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"duration\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`5`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`reference-to-video-multi-subject`,children:`Reference-to-Video (Multi-Subject)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`13`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`13`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"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.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"reference_images\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://example.com/girl.jpg\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://example.com/object2.png\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://example.com/object3.png\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://example.com/chair4.png\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"reference_videos\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com/role.mp4\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"resolution\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"720p\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ratio\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"adaptive\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"duration\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`smart-duration-with-silent-output`,children:`Smart Duration with Silent Output`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Cinematic drone shot over a snowy mountain range\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"duration\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`-1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"audio\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"seed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`42`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`literal-prompt-rewriting-disabled`,children:`Literal Prompt (Rewriting Disabled)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"A golden retriever running through a field of sunflowers at sunset, cinematic lighting, camera slowly pushes in, warm rim light on the fur\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"resolution\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1080p\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ratio\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"16:9\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"duration\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`5`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt_extend\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`file-and-link-inputs`,children:`File and Link Inputs`}),`\n`,_jsxs(_components.p,{children:[`Both fields are optional single HTTP/HTTPS URL strings and belong to reference mode. They cannot be combined with `,_jsx(_components.code,{children:`first_frame`}),` or `,_jsx(_components.code,{children:`last_frame`}),`, and `,_jsx(_components.code,{children:`file`}),` and `,_jsx(_components.code,{children:`link`}),` cannot be sent together.`]}),`\n`,_jsxs(_components.p,{children:[`These combinations are mutually exclusive in the public contract and JSON Schema. The gateway does not synchronously reject combinations involving `,_jsx(_components.code,{children:`file`}),` or `,_jsx(_components.code,{children:`link`}),`; it forwards them to the upstream service, which reports incompatibility through the asynchronous task error.`]}),`\n`,_jsx(Heading,{level:`3`,id:`file-url`,children:`File URL`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`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.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Create a product video from this brief\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"file\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com/product-brief.pdf\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"resolution\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1080p\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"duration\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`link-url`,children:`Link URL`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`link`}),` must point to a public web page that is accessible without authentication.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Create a news summary video from this article\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"link\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com/articles/product-launch\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"resolution\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1080p\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"duration\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`pricing`,children:`Pricing`}),`\n`,_jsxs(_components.p,{children:[`Billed on one dimension — `,_jsx(_components.strong,{children:`resolution unit price × billed duration in seconds`}),`.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Resolution`}),_jsx(_components.th,{style:{textAlign:`right`},children:`Unit price`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`480p`}),_jsx(_components.td,{style:{textAlign:`right`},children:`$0.050 / second`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`720p`}),_jsx(_components.td,{style:{textAlign:`right`},children:`$0.100 / second`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`1080p (default)`}),_jsx(_components.td,{style:{textAlign:`right`},children:`$0.200 / second`})]})]})]}),`\n`,_jsx(_components.p,{children:`Both the input video and the output video are billed, by video seconds:`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`billed duration = input video duration + output video duration`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Input video duration`}),` — the actual duration, in seconds, of the video supplied in\n`,_jsx(_components.code,{children:`reference_videos`}),`; a request with no video input contributes 0 seconds here`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Output video duration`}),` — the duration, in seconds, of the video that was successfully generated`]}),`\n`,_jsxs(_components.li,{children:[`A `,_jsx(_components.strong,{children:`failed task is not billed`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`audio: false`}),` does `,_jsx(_components.strong,{children:`not`}),` reduce the price`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`parameters`,children:`Parameters`}),`\n`,_jsx(Heading,{level:`3`,id:`prompt`,children:`prompt`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Type`}),`: string, conditionally required`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Max length`}),`: 20000 characters`]}),`\n`,_jsxs(_components.li,{children:[`Over-length prompts are `,_jsx(_components.strong,{children:`not rejected`}),` — they are passed through and truncated upstream`]}),`\n`,_jsxs(_components.li,{children:[`At least one of `,_jsx(_components.code,{children:`prompt`}),`, a keyframe field, or a reference field must be provided`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`first_frame-/-last_frame`,children:`first_frame / last_frame`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Type`}),`: string (URL, data URI, or bare Base64), optional`]}),`\n`,_jsx(_components.li,{children:`At most one image each; used strictly as the first / last frame of the video`}),`\n`,_jsx(_components.li,{children:`Keyframe mode — cannot be combined with any reference-mode field`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`reference_images`,children:`reference_images`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Type`}),`: array of strings (URL, data URI, or bare Base64 — mixable), optional`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Max items`}),`: 10`]}),`\n`,_jsx(_components.li,{children:`Reference mode — cannot be combined with keyframe fields`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`reference_videos`,children:`reference_videos`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Type`}),`: array of URI strings, optional. `,_jsx(_components.strong,{children:`URL only, no Base64`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Max items`}),`: 5, total duration ≤ 15s`]}),`\n`,_jsxs(_components.li,{children:[`This gateway checks only the recognizable file extension (`,_jsx(_components.code,{children:`.mp4`}),` / `,_jsx(_components.code,{children:`.mov`}),`); extensionless URLs such\nas signed links are passed through`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`reference_audios`,children:`reference_audios`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Type`}),`: array of URI strings, optional. `,_jsx(_components.strong,{children:`URL only, no Base64`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Max items`}),`: 5, total duration ≤ 15s`]}),`\n`,_jsxs(_components.li,{children:[`Extension check is `,_jsx(_components.code,{children:`.wav`}),` / `,_jsx(_components.code,{children:`.mp3`}),`; extensionless URLs are passed through`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`resolution`,children:`resolution`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Options`}),`: `,_jsx(_components.code,{children:`480p`}),` / `,_jsx(_components.code,{children:`720p`}),` / `,_jsx(_components.code,{children:`1080p`}),` (case-insensitive)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Default`}),`: `,_jsx(_components.code,{children:`1080p`})]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`ratio`,children:`ratio`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Options`}),`: `,_jsx(_components.code,{children:`adaptive`}),` / `,_jsx(_components.code,{children:`16:9`}),` / `,_jsx(_components.code,{children:`4:3`}),` / `,_jsx(_components.code,{children:`1:1`}),` / `,_jsx(_components.code,{children:`3:4`}),` / `,_jsx(_components.code,{children:`9:16`}),` (case-insensitive)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Default`}),`: `,_jsx(_components.code,{children:`adaptive`}),`, which derives the ratio from intent and input media`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`duration`,children:`duration`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Range`}),`: integer 2–30 inclusive, or `,_jsx(_components.code,{children:`-1`}),` for smart duration`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Default`}),`: 5`]}),`\n`,_jsx(_components.li,{children:`With video input, the combined input + output duration must be ≤ 30s (validated upstream)`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`audio`,children:`audio`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Type`}),`: boolean`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Default`}),`: `,_jsx(_components.code,{children:`true`})]}),`\n`,_jsxs(_components.li,{children:[`Whether the output video carries an audio track. `,_jsx(_components.strong,{children:`Pricing is identical either way.`})]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`seed`,children:`seed`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Range`}),`: 0–2147483647, nullable`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Default`}),`: `,_jsx(_components.code,{children:`null`}),` (auto-generated seed)`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`prompt_extend`,children:`prompt_extend`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Type`}),`: boolean`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Default`}),`: `,_jsx(_components.code,{children:`true`})]}),`\n`,_jsxs(_components.li,{children:[`Whether upstream rewrites (expands) the prompt before generation. Rewriting usually improves motion\nand cinematography on short prompts; set `,_jsx(_components.code,{children:`false`}),` to keep generation close to the literal prompt text`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`input-requirements`,children:`Input Requirements`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Field`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Formats`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Size`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Other`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`first_frame`}),` / `,_jsx(_components.code,{children:`last_frame`}),` / `,_jsx(_components.code,{children:`reference_images`})]}),_jsx(_components.td,{style:{textAlign:`left`},children:`JPEG, JPG, PNG (no alpha), BMP, WEBP`}),_jsx(_components.td,{style:{textAlign:`left`},children:`≤ 20MB`}),_jsx(_components.td,{style:{textAlign:`left`},children:`side 240–8000px, ratio ≤ 8:1`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`reference_videos`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`mp4, mov`}),_jsx(_components.td,{style:{textAlign:`left`},children:`≤ 100MB`}),_jsx(_components.td,{style:{textAlign:`left`},children:`side 240–4096px, ratio ≤ 8:1, each 1–15s and ≤ 15s total`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`reference_audios`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`wav, mp3`}),_jsx(_components.td,{style:{textAlign:`left`},children:`≤ 15MB`}),_jsx(_components.td,{style:{textAlign:`left`},children:`each 1–15s and ≤ 15s total`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Berry 1.0 Video Generation","openapi":"api-reference/endpoint/carrothub/berry-1.0/berry-1.0.yaml POST /vendors/carrothub/v1/berry-1.0/generation","description":"Create an asynchronous Berry1.0 video generation task.\n\nAt least one of `prompt`, a keyframe field or a reference field must be provided.","href":"/api-reference/endpoint/carrothub/berry-1.0/generation"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Key Features","slug":"key-features","depth":2,"children":[]},{"title":"Prompt Reference Syntax","slug":"prompt-reference-syntax","depth":2,"children":[]},{"title":"Image Input Formats","slug":"image-input-formats","depth":2,"children":[]},{"title":"Output Ownership","slug":"output-ownership","depth":2,"children":[]},{"title":"Example Requests","slug":"example-requests","depth":2,"children":[{"title":"Text-to-Video","slug":"text-to-video","depth":3,"children":[]},{"title":"First-Frame Image-to-Video","slug":"first-frame-image-to-video","depth":3,"children":[]},{"title":"First and Last Frame","slug":"first-and-last-frame","depth":3,"children":[]},{"title":"First Frame via Base64","slug":"first-frame-via-base64","depth":3,"children":[]},{"title":"Reference-to-Video (Multi-Subject)","slug":"reference-to-video-multi-subject","depth":3,"children":[]},{"title":"Smart Duration with Silent Output","slug":"smart-duration-with-silent-output","depth":3,"children":[]},{"title":"Literal Prompt (Rewriting Disabled)","slug":"literal-prompt-rewriting-disabled","depth":3,"children":[]}]},{"title":"File and Link Inputs","slug":"file-and-link-inputs","depth":2,"children":[{"title":"File URL","slug":"file-url","depth":3,"children":[]},{"title":"Link URL","slug":"link-url","depth":3,"children":[]}]},{"title":"Pricing","slug":"pricing","depth":2,"children":[]},{"title":"Parameters","slug":"parameters","depth":2,"children":[{"title":"prompt","slug":"prompt","depth":3,"children":[]},{"title":"first_frame / last_frame","slug":"first_frame-/-last_frame","depth":3,"children":[]},{"title":"reference_images","slug":"reference_images","depth":3,"children":[]},{"title":"reference_videos","slug":"reference_videos","depth":3,"children":[]},{"title":"reference_audios","slug":"reference_audios","depth":3,"children":[]},{"title":"resolution","slug":"resolution","depth":3,"children":[]},{"title":"ratio","slug":"ratio","depth":3,"children":[]},{"title":"duration","slug":"duration","depth":3,"children":[]},{"title":"audio","slug":"audio","depth":3,"children":[]},{"title":"seed","slug":"seed","depth":3,"children":[]},{"title":"prompt_extend","slug":"prompt_extend","depth":3,"children":[]}]},{"title":"Input Requirements","slug":"input-requirements","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create Generation Task","description":"Create an asynchronous Berry1.0 video generation task.\n\nAt least one of `prompt`, a keyframe field or a reference field must be provided.","operationId":"berry_1_0_generation","responses":{"200":"66ad1a31-efa3-4da8-b09a-6e134583e690","400":"e111dc2a-a562-4f22-8309-bbbe4787b362"},"requestBody":"2171fc2d-9c39-4bfa-a2d3-276173ad4caf","method":"post","type":"path","servers":["087ddc15-6824-4cb4-a555-af474c1eb7eb"],"security":["010e3c14-7c32-46b2-b4e5-a597a68006fd"],"path":"/vendors/carrothub/v1/berry-1.0/generation","baseUrlOptions":["https://api.carrothub.ai/"],"title":"Create Generation Task","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"description":"All-in-One video generation. At least one of `prompt`, a reference field, or a keyframe field\nmust be provided.\n\nTwo mutually exclusive input modes:\n- Reference mode: `reference_images` / `reference_videos` / `reference_audios` / `file` / `link`\n- Keyframe mode: `first_frame` / `last_frame`","properties":{"prompt":{"oneOf":[{"type":"string","description":"Text prompt describing the desired video. Up to 20000 characters — over-length prompts are\n**not rejected**, they are\npassed through and truncated upstream. Required unless a keyframe or reference input is given.","uniqueKey":"prompt.oneOf.0","typeLabel":"string"},{"type":"null","description":"Text prompt describing the desired video. Up to 20000 characters — over-length prompts are\n**not rejected**, they are\npassed through and truncated upstream. Required unless a keyframe or reference input is given.","uniqueKey":"prompt.oneOf.1","typeLabel":"null"}],"uniqueKey":"prompt","typeLabel":"string | null"},"first_frame":{"oneOf":[{"type":"string","description":"First-frame image, strictly used as the first frame of the video. Accepts a public\nHTTP/HTTPS **URL**, a `data:image/\u003ctype>;base64,...` **data URI**, or a **bare Base64**\nstring. Keyframe mode; cannot be combined with reference-mode fields.\n\nUpstream format requirements (validated upstream, not by this gateway):\nJPEG/JPG/PNG (no alpha)/BMP/WEBP, side 240–8000px, ratio ≤8:1, ≤20MB.","uniqueKey":"first_frame.oneOf.0","typeLabel":"string"},{"type":"null","description":"First-frame image, strictly used as the first frame of the video. Accepts a public\nHTTP/HTTPS **URL**, a `data:image/\u003ctype>;base64,...` **data URI**, or a **bare Base64**\nstring. Keyframe mode; cannot be combined with reference-mode fields.\n\nUpstream format requirements (validated upstream, not by this gateway):\nJPEG/JPG/PNG (no alpha)/BMP/WEBP, side 240–8000px, ratio ≤8:1, ≤20MB.","uniqueKey":"first_frame.oneOf.1","typeLabel":"null"}],"uniqueKey":"first_frame","typeLabel":"string | null"},"last_frame":{"oneOf":[{"type":"string","description":"Last-frame image, strictly used as the last frame of the video. Same input formats and\nupstream constraints as `first_frame`. Keyframe mode; cannot be combined with\nreference-mode fields.","uniqueKey":"last_frame.oneOf.0","typeLabel":"string"},{"type":"null","description":"Last-frame image, strictly used as the last frame of the video. Same input formats and\nupstream constraints as `first_frame`. Keyframe mode; cannot be combined with\nreference-mode fields.","uniqueKey":"last_frame.oneOf.1","typeLabel":"null"}],"uniqueKey":"last_frame","typeLabel":"string | null"},"reference_images":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"reference_images.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Reference images, up to 10. Each item accepts a public HTTP/HTTPS **URL**, a\n`data:image/\u003ctype>;base64,...` **data URI**, or a **bare Base64** string; the three\nshapes may be mixed within one array. Referenced in `prompt` as \"Image 1\", \"Image 2\", …\nin array order. Reference mode; cannot be combined with keyframe fields.\n\nUpstream format requirements: JPEG/JPG/PNG (no alpha)/BMP/WEBP, side 240–8000px,\nratio ≤8:1, ≤20MB.","maxItems":10,"uniqueKey":"reference_images.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Reference images, up to 10. Each item accepts a public HTTP/HTTPS **URL**, a\n`data:image/\u003ctype>;base64,...` **data URI**, or a **bare Base64** string; the three\nshapes may be mixed within one array. Referenced in `prompt` as \"Image 1\", \"Image 2\", …\nin array order. Reference mode; cannot be combined with keyframe fields.\n\nUpstream format requirements: JPEG/JPG/PNG (no alpha)/BMP/WEBP, side 240–8000px,\nratio ≤8:1, ≤20MB.","uniqueKey":"reference_images.oneOf.1","typeLabel":"null"}],"uniqueKey":"reference_images","typeLabel":"string[] | null"},"reference_videos":{"oneOf":[{"type":"array","items":{"type":"string","format":"uri","uniqueKey":"reference_videos.oneOf.0.items.[INDEX]","typeLabel":"string\u003curi>"},"description":"Reference videos, up to 5, total duration ≤15s. **URL only** — Base64 is not accepted\nhere (a 100MB video would inflate the request body to ~133MB). Referenced in `prompt`\nas \"Video 1\", \"Video 2\", … in array order. Reference mode; cannot be combined with\nkeyframe fields.\n\nUpstream format requirements: mp4/mov, side 240–4096px, ratio ≤8:1, each 1–15s, ≤100MB.\nThis gateway checks only the recognizable file extension (`.mp4` / `.mov`);\nextensionless URLs such as signed links are passed through.","maxItems":5,"uniqueKey":"reference_videos.oneOf.0","typeLabel":"string\u003curi>[]"},{"type":"null","description":"Reference videos, up to 5, total duration ≤15s. **URL only** — Base64 is not accepted\nhere (a 100MB video would inflate the request body to ~133MB). Referenced in `prompt`\nas \"Video 1\", \"Video 2\", … in array order. Reference mode; cannot be combined with\nkeyframe fields.\n\nUpstream format requirements: mp4/mov, side 240–4096px, ratio ≤8:1, each 1–15s, ≤100MB.\nThis gateway checks only the recognizable file extension (`.mp4` / `.mov`);\nextensionless URLs such as signed links are passed through.","uniqueKey":"reference_videos.oneOf.1","typeLabel":"null"}],"uniqueKey":"reference_videos","typeLabel":"string\u003curi>[] | null"},"reference_audios":{"oneOf":[{"type":"array","items":{"type":"string","format":"uri","uniqueKey":"reference_audios.oneOf.0.items.[INDEX]","typeLabel":"string\u003curi>"},"description":"Reference audios, up to 5, total duration ≤15s. **URL only** — Base64 is not accepted here.\nReference mode; cannot be combined with keyframe fields.\n\nUpstream format requirements: wav/mp3, each 1–15s, ≤15MB. This gateway checks only the\nrecognizable file extension (`.wav` / `.mp3`); extensionless URLs are passed through.","maxItems":5,"uniqueKey":"reference_audios.oneOf.0","typeLabel":"string\u003curi>[]"},{"type":"null","description":"Reference audios, up to 5, total duration ≤15s. **URL only** — Base64 is not accepted here.\nReference mode; cannot be combined with keyframe fields.\n\nUpstream format requirements: wav/mp3, each 1–15s, ≤15MB. This gateway checks only the\nrecognizable file extension (`.wav` / `.mp3`); extensionless URLs are passed through.","uniqueKey":"reference_audios.oneOf.1","typeLabel":"null"}],"uniqueKey":"reference_audios","typeLabel":"string\u003curi>[] | null"},"file":{"oneOf":[{"type":"string","description":"Reference file URL. HTTP/HTTPS only; at most one file. Supported formats: docx, doc, xlsx,\nxls, pptx, ppt, pdf, txt, key, pages, numbers, md. Maximum size is 100MB. The upstream\nspecification limits PDF, DOCX, DOC, PPTX, PPT, KEY, and PAGES files to 50 pages.\nMutually exclusive with `link` and keyframe-mode fields.","format":"uri","pattern":"^https?://","uniqueKey":"file.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","description":"Reference file URL. HTTP/HTTPS only; at most one file. Supported formats: docx, doc, xlsx,\nxls, pptx, ppt, pdf, txt, key, pages, numbers, md. Maximum size is 100MB. The upstream\nspecification limits PDF, DOCX, DOC, PPTX, PPT, KEY, and PAGES files to 50 pages.\nMutually exclusive with `link` and keyframe-mode fields.","uniqueKey":"file.oneOf.1","typeLabel":"null"}],"uniqueKey":"file","typeLabel":"string\u003curi> | null"},"link":{"oneOf":[{"type":"string","description":"Public web page URL. HTTP/HTTPS only; the page must be accessible without authentication.\nAt most one link. Mutually exclusive with `file` and keyframe-mode fields.","format":"uri","pattern":"^https?://","uniqueKey":"link.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","description":"Public web page URL. HTTP/HTTPS only; the page must be accessible without authentication.\nAt most one link. Mutually exclusive with `file` and keyframe-mode fields.","uniqueKey":"link.oneOf.1","typeLabel":"null"}],"uniqueKey":"link","typeLabel":"string\u003curi> | null"},"resolution":{"type":"string","description":"Output resolution (case-insensitive). 2k / 4k require `berry-1.0-pro`.","enum":["480p","720p","1080p"],"default":"1080p","uniqueKey":"resolution","typeLabel":"enum\u003cstring>"},"ratio":{"type":"string","description":"Aspect ratio (case-insensitive). `adaptive` derives the ratio from intent and input media.","enum":["16:9","4:3","1:1","3:4","9:16","adaptive"],"default":"adaptive","uniqueKey":"ratio","typeLabel":"enum\u003cstring>"},"duration":{"type":"integer","description":"Video duration in seconds, 2–30 inclusive, or `-1` for smart duration\n(upstream picks the length from intent / content / media). With video input, the combined\ninput + output duration must be ≤30s — validated upstream.","default":5,"uniqueKey":"duration","typeLabel":"integer"},"audio":{"type":"boolean","description":"Whether the output video includes an audio track. Pricing is identical either way.","default":true,"uniqueKey":"audio","typeLabel":"boolean"},"seed":{"oneOf":[{"type":"integer","description":"Random seed [0, 2147483647]. null or omitted for an auto-generated seed.","maximum":2147483647,"minimum":0,"uniqueKey":"seed.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Random seed [0, 2147483647]. null or omitted for an auto-generated seed.","uniqueKey":"seed.oneOf.1","typeLabel":"null"}],"uniqueKey":"seed","typeLabel":"integer | null"},"prompt_extend":{"type":"boolean","description":"Whether upstream rewrites (expands) the prompt before generation. Enabled by default:\nrewriting usually improves motion and cinematography on short prompts. Set to `false` to\nkeep generation close to the literal prompt text.","default":true,"uniqueKey":"prompt_extend","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"prompt":"\u003cstring>","first_frame":"\u003cstring>","last_frame":"\u003cstring>","reference_images":["\u003cstring>"],"reference_videos":["\u003cstring>"],"reference_audios":["\u003cstring>"],"file":"\u003cstring>","link":"\u003cstring>","resolution":"1080p","ratio":"adaptive","duration":5,"audio":true,"seed":1073741823,"prompt_extend":true}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"66ad1a31-efa3-4da8-b09a-6e134583e690":{"description":"OK - Task created successfully","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"task_info":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string","description":"UUID of the task","format":"uuid","isRequired":true,"uniqueKey":"task_info.id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","description":"Task status (pending when created)","enum":["pending"],"isRequired":true,"uniqueKey":"task_info.status","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","description":"Task creation timestamp (ISO 8601)","format":"date-time","isRequired":true,"uniqueKey":"task_info.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","description":"Task last update timestamp (ISO 8601)","format":"date-time","isRequired":true,"uniqueKey":"task_info.updated_at","typeLabel":"string\u003cdate-time>"}},"required":["id","status","created_at","updated_at"],"uniqueKey":"task_info","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"task_info":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"pending","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"e111dc2a-a562-4f22-8309-bbbe4787b362":{"description":"Bad Request - payload validation failed","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"task_info":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string","description":"UUID of the task","format":"uuid","isRequired":true,"uniqueKey":"task_info.id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","description":"Task status (always failed for error responses)","enum":["failed"],"isRequired":true,"uniqueKey":"task_info.status","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","description":"Task creation timestamp (ISO 8601)","format":"date-time","isRequired":true,"uniqueKey":"task_info.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","description":"Task last update timestamp (ISO 8601)","format":"date-time","isRequired":true,"uniqueKey":"task_info.updated_at","typeLabel":"string\u003cdate-time>"},"error":{"type":"object","additionalProperties":true,"properties":{"code":{"type":"integer","description":"CarrotHub Error code","example":2001,"uniqueKey":"task_info.error.code","typeLabel":"integer"},"title":{"type":"string","description":"CarrotHub Error title","example":"Invalid Request","uniqueKey":"task_info.error.title","typeLabel":"string"},"detail":{"type":"string","description":"CarrotHub Error detail","example":"cannot mix the reference mode (reference_images / reference_videos / reference_audios) with the keyframe mode (first_frame / last_frame)","uniqueKey":"task_info.error.detail","typeLabel":"string"}},"isRequired":true,"uniqueKey":"task_info.error","typeLabel":"object"}},"required":["id","status","created_at","updated_at","error"],"uniqueKey":"task_info","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"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)"}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"010e3c14-7c32-46b2-b4e5-a597a68006fd":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"087ddc15-6824-4cb4-a555-af474c1eb7eb":{"url":"https://api.carrothub.ai/"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/endpoint/carrothub/berry-1.0/berry-1.0.yaml"},"subdomain":"carrothub","siteName":"CarrotHub Docs","title":"CarrotHub Documentation - AI API Gateway \u0026 Routing Platform","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-12T16:43:55.507Z","originalFileLocation":"api-reference/endpoint/carrothub/berry-1.0/generation.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create an asynchronous Berry1.0 video generation task. At least one of prompt, a keyframe field or a reference field must be provided.\">\u003cmeta data-mint-head name=\"keywords\" content=\"CarrotHub, AI API, API gateway, LLM, OpenAI, image generation, video generation, Qwen, Wan 2, Midjourney, AI integration, API documentation\">\u003cmeta data-mint-head name=\"application-name\" content=\"CarrotHub Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/carrothub/hYKGbov6tEAOAamr/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/carrothub/hYKGbov6tEAOAamr/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/carrothub/hYKGbov6tEAOAamr/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/carrothub/hYKGbov6tEAOAamr/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/carrothub/hYKGbov6tEAOAamr/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/carrothub/hYKGbov6tEAOAamr/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/carrothub/hYKGbov6tEAOAamr/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/carrothub/hYKGbov6tEAOAamr/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/carrothub/hYKGbov6tEAOAamr/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"CarrotHub Documentation - AI API Gateway \u0026amp; Routing Platform\">\u003cmeta data-mint-head property=\"og:description\" content=\"Complete API documentation for CarrotHub AI platform. Learn to integrate LLM, image generation, and video generation APIs including OpenAI, Qwen, Wan 2, Midjourney, and more.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"CarrotHub Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.carrothub.ai/docs/api-reference/endpoint/carrothub/berry-1.0/generation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://www.carrothub.ai/docs/logo/carrothub-light.svg\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"CarrotHub Documentation - AI API Gateway \u0026amp; Routing Platform\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Complete API documentation for CarrotHub AI platform. Learn to integrate LLM, image generation, and video generation APIs including OpenAI, Qwen, Wan 2, Midjourney, and more.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://www.carrothub.ai/docs/logo/carrothub-light.svg\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/carrothub/hYKGbov6tEAOAamr/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"CarrotHub Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#594BF6\">\u003cmeta data-mint-head name=\"author\" content=\"CarrotHub\">\u003cmeta data-mint-head name=\"language\" content=\"en\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.carrothub.ai/docs/api-reference/endpoint/carrothub/berry-1.0/generation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/endpoint/carrothub/berry-1.0/generation.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.carrothub.ai/#organization\",\"name\":\"CarrotHub Docs\",\"url\":\"https://www.carrothub.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/carrothub/6rVQwA8-jDnVzV6k/logo/carrothub-light.svg?fit=max\u0026auto=format\u0026n=6rVQwA8-jDnVzV6k\u0026q=85\u0026s=8263206bfee760db1e1ff9f0f78ef780\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.carrothub.ai/docs#website\",\"name\":\"CarrotHub Docs\",\"url\":\"https://www.carrothub.ai/docs\",\"publisher\":{\"@id\":\"https://www.carrothub.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.carrothub.ai/docs/api-reference/endpoint/carrothub/berry-1.0/generation#webpage\",\"url\":\"https://www.carrothub.ai/docs/api-reference/endpoint/carrothub/berry-1.0/generation\",\"name\":\"Berry 1.0 Video Generation\",\"description\":\"Create an asynchronous Berry1.0 video generation task. At least one of prompt, a keyframe field or a reference field must be provided.\",\"dateModified\":\"2026-10-12T16:43:55.507Z\",\"isPartOf\":{\"@id\":\"https://www.carrothub.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.carrothub.ai/docs/api-reference/endpoint/carrothub/berry-1.0/generation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.carrothub.ai/docs/api-reference/endpoint/carrothub/berry-1.0/generation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Video Generation\",\"item\":\"https://www.carrothub.ai/docs/api-reference/endpoint/alibaba/wan2.6-t2v/generation\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Berry 1.0 Video Generation\",\"item\":\"https://www.carrothub.ai/docs/api-reference/endpoint/carrothub/berry-1.0/generation\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.carrothub.ai/docs/api-reference/endpoint/carrothub/berry-1.0/generation#apireference\",\"headline\":\"Berry 1.0 Video Generation\",\"name\":\"Berry 1.0 Video Generation\",\"description\":\"Create an asynchronous Berry1.0 video generation task. At least one of prompt, a keyframe field or a reference field must be provided.\",\"url\":\"https://www.carrothub.ai/docs/api-reference/endpoint/carrothub/berry-1.0/generation\",\"mainEntityOfPage\":{\"@id\":\"https://www.carrothub.ai/docs/api-reference/endpoint/carrothub/berry-1.0/generation#webpage\"},\"image\":\"https://www.carrothub.ai/docs/logo/carrothub-light.svg\",\"dateModified\":\"2026-10-12T16:43:55.507Z\",\"publisher\":{\"@id\":\"https://www.carrothub.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://www.carrothub.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"CarrotHub Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"CarrotHub Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/endpoint/carrothub/berry-1.0/generation.md","siteName":"CarrotHub Docs","nav":{"global":{"anchors":[{"anchor":"Community","icon":"discord","href":"https://discord.gg/pdRwFDsc9z"}]},"tabs":[{"tab":"Get Started","pages":[{"title":"Get Started","href":"/get-started/welcome"}]},{"tab":"API Reference","groups":[{"group":"Reference","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Account","pages":[{"title":"Get account balance","openapi":"api-reference/endpoint/user/billing/balance.yaml GET /user/billing/balance","href":"/api-reference/endpoint/user/billing/balance"}]},{"group":"LLM","pages":[{"group":"OpenAI Format","pages":[{"title":"Create Chat Completion","openapi":"api-reference/endpoint/openai/openai.yaml POST /vendors/openai/v1/chat/completions","href":"/api-reference/endpoint/openai/chat"},{"title":"Supported Models","href":"/api-reference/endpoint/openai/models"}]}]},{"group":"Image Generation","pages":[{"group":"Wan 2","pages":[{"group":"Wan 2.6 Text-To-Image","pages":[{"title":"Wan 2.6 Text-To-Image Generation","openapi":"api-reference/endpoint/alibaba/wan2.6-t2i/wan2.6-t2i.yaml POST /vendors/alibaba/v1/wan2.6-t2i/generation","href":"/api-reference/endpoint/alibaba/wan2.6-t2i/generation"},{"title":"Wan 2.6 Text-To-Image Task","openapi":"api-reference/endpoint/alibaba/wan2.6-t2i/wan2.6-t2i.yaml GET /vendors/alibaba/v1/wan2.6-t2i/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.6-t2i/generation-task"},{"title":"Delete Wan 2.6 Text-To-Image Task","openapi":"api-reference/endpoint/alibaba/wan2.6-t2i/wan2.6-t2i.yaml DELETE /vendors/alibaba/v1/wan2.6-t2i/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.6-t2i/delete-task"}]},{"group":"Wan 2.6 Image-To-Image","pages":[{"title":"Wan 2.6 Image-To-Image Generation","openapi":"api-reference/endpoint/alibaba/wan2.6-image/wan2.6-image.yaml POST /vendors/alibaba/v1/wan2.6-image/generation","href":"/api-reference/endpoint/alibaba/wan2.6-image/generation"},{"title":"Wan 2.6 Image-To-Image Task","openapi":"api-reference/endpoint/alibaba/wan2.6-image/wan2.6-image.yaml GET /vendors/alibaba/v1/wan2.6-image/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.6-image/generation-task"},{"title":"Delete Wan 2.6 Image-To-Image Task","openapi":"api-reference/endpoint/alibaba/wan2.6-image/wan2.6-image.yaml DELETE /vendors/alibaba/v1/wan2.6-image/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.6-image/delete-task"}]},{"group":"Wan 2.5 Text-To-Image Preview","pages":[{"title":"Wan 2.5 Text-To-Image Preview Generation","openapi":"api-reference/endpoint/alibaba/wan2.5-t2i-preview/wan2.5-t2i-preview.yaml POST /vendors/alibaba/v1/wan2.5-t2i-preview/generation","href":"/api-reference/endpoint/alibaba/wan2.5-t2i-preview/generation"},{"title":"Wan 2.5 Text-To-Image Preview Task","openapi":"api-reference/endpoint/alibaba/wan2.5-t2i-preview/wan2.5-t2i-preview.yaml GET /vendors/alibaba/v1/wan2.5-t2i-preview/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.5-t2i-preview/generation-task"},{"title":"Delete Wan 2.5 Text-To-Image Preview Task","openapi":"api-reference/endpoint/alibaba/wan2.5-t2i-preview/wan2.5-t2i-preview.yaml DELETE /vendors/alibaba/v1/wan2.5-t2i-preview/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.5-t2i-preview/delete-task"}]},{"group":"Wan 2.5 Image-To-Image Preview","pages":[{"title":"Wan 2.5 Image-To-Image Preview Generation","openapi":"api-reference/endpoint/alibaba/wan2.5-i2i-preview/wan2.5-i2i-preview.yaml POST /vendors/alibaba/v1/wan2.5-i2i-preview/generation","href":"/api-reference/endpoint/alibaba/wan2.5-i2i-preview/generation"},{"title":"Wan 2.5 Image-To-Image Preview Task","openapi":"api-reference/endpoint/alibaba/wan2.5-i2i-preview/wan2.5-i2i-preview.yaml GET /vendors/alibaba/v1/wan2.5-i2i-preview/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.5-i2i-preview/generation-task"},{"title":"Delete Wan 2.5 Image-To-Image Preview Task","openapi":"api-reference/endpoint/alibaba/wan2.5-i2i-preview/wan2.5-i2i-preview.yaml DELETE /vendors/alibaba/v1/wan2.5-i2i-preview/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.5-i2i-preview/delete-task"}]}]},{"group":"Qwen Image Max","pages":[{"title":"Qwen Image Max Generation","openapi":"api-reference/endpoint/alibaba/qwen-image-max/qwen-image-max.yaml POST /vendors/alibaba/v1/qwen-image-max/generation","href":"/api-reference/endpoint/alibaba/qwen-image-max/generation"},{"title":"Qwen Image Max Task","openapi":"api-reference/endpoint/alibaba/qwen-image-max/qwen-image-max.yaml GET /vendors/alibaba/v1/qwen-image-max/generation/{task_id}","href":"/api-reference/endpoint/alibaba/qwen-image-max/generation-task"},{"title":"Delete Qwen Image Max Task","openapi":"api-reference/endpoint/alibaba/qwen-image-max/qwen-image-max.yaml DELETE /vendors/alibaba/v1/qwen-image-max/generation/{task_id}","href":"/api-reference/endpoint/alibaba/qwen-image-max/delete-task"}]},{"group":"Qwen Image Edit Max","pages":[{"title":"Qwen Image Edit Max Generation","openapi":"api-reference/endpoint/alibaba/qwen-image-edit-max/qwen-image-edit-max.yaml POST /vendors/alibaba/v1/qwen-image-edit-max/generation","href":"/api-reference/endpoint/alibaba/qwen-image-edit-max/generation"},{"title":"Qwen Image Edit Max Task","openapi":"api-reference/endpoint/alibaba/qwen-image-edit-max/qwen-image-edit-max.yaml GET /vendors/alibaba/v1/qwen-image-edit-max/generation/{task_id}","href":"/api-reference/endpoint/alibaba/qwen-image-edit-max/generation-task"},{"title":"Delete Qwen Image Edit Max Task","openapi":"api-reference/endpoint/alibaba/qwen-image-edit-max/qwen-image-edit-max.yaml DELETE /vendors/alibaba/v1/qwen-image-edit-max/generation/{task_id}","href":"/api-reference/endpoint/alibaba/qwen-image-edit-max/delete-task"}]},{"group":"Nano Banana Pro","pages":[{"title":"🍌 Nano Banana Pro Image Generation","openapi":"api-reference/endpoint/google/nano-banana-pro/openapi.yaml POST /vendors/google/v1/nano-banana-pro/generation","href":"/api-reference/endpoint/google/nano-banana-pro/generation"},{"title":"🍌 Nano Banana Pro Generation Task","openapi":"api-reference/endpoint/google/nano-banana-pro/openapi.yaml GET /vendors/google/v1/nano-banana-pro/generation/{task_id}","href":"/api-reference/endpoint/google/nano-banana-pro/generation-task"},{"title":"Delete Nano Banana Pro Generation Task","openapi":"api-reference/endpoint/google/nano-banana-pro/openapi.yaml DELETE /vendors/google/v1/nano-banana-pro/generation/{task_id}","href":"/api-reference/endpoint/google/nano-banana-pro/delete-task"},{"title":"🍌 Nano Banana Pro Image Edit","openapi":"api-reference/endpoint/google/nano-banana-pro/openapi.yaml POST /vendors/google/v1/nano-banana-pro/edit","href":"/api-reference/endpoint/google/nano-banana-pro/edit"},{"title":"🍌 Nano Banana Pro Edit Task","openapi":"api-reference/endpoint/google/nano-banana-pro/openapi.yaml GET /vendors/google/v1/nano-banana-pro/edit/{task_id}","href":"/api-reference/endpoint/google/nano-banana-pro/edit-task"}]},{"group":"Nano Banana 2","pages":[{"title":"🍌 Nano Banana 2 Image Generation","openapi":"api-reference/endpoint/google/nano-banana-2/openapi.yaml POST /vendors/google/v1/nano-banana-2/generation","href":"/api-reference/endpoint/google/nano-banana-2/generation"},{"title":"🍌 Nano Banana 2 Generation Task","openapi":"api-reference/endpoint/google/nano-banana-2/openapi.yaml GET /vendors/google/v1/nano-banana-2/generation/{task_id}","href":"/api-reference/endpoint/google/nano-banana-2/generation-task"},{"title":"Delete Nano Banana 2 Generation Task","openapi":"api-reference/endpoint/google/nano-banana-2/openapi.yaml DELETE /vendors/google/v1/nano-banana-2/generation/{task_id}","href":"/api-reference/endpoint/google/nano-banana-2/delete-task"},{"title":"🍌 Nano Banana 2 Image Edit","openapi":"api-reference/endpoint/google/nano-banana-2/openapi.yaml POST /vendors/google/v1/nano-banana-2/edit","href":"/api-reference/endpoint/google/nano-banana-2/edit"},{"title":"🍌 Nano Banana 2 Edit Task","openapi":"api-reference/endpoint/google/nano-banana-2/openapi.yaml GET /vendors/google/v1/nano-banana-2/edit/{task_id}","href":"/api-reference/endpoint/google/nano-banana-2/edit-task"}]},{"group":"Midjourney","pages":[{"title":"Diffusion","openapi":"api-reference/endpoint/midjourney/midjourney.yaml POST /vendors/midjourney/v1/tob/diffusion","href":"/api-reference/endpoint/midjourney/diffusion"},{"title":"Diffusion","openapi":"api-reference/endpoint/midjourney/midjourney.yaml GET /vendors/midjourney/v1/tob/diffusion/{task_id}","href":"/api-reference/endpoint/midjourney/diffuison-task"}]},{"group":"GPT Image 2","pages":[{"title":"GPT Image 2 Image Generation","openapi":"api-reference/endpoint/openai/gpt-image-2/openapi.yaml POST /vendors/openai/v1/gpt-image-2/generation","href":"/api-reference/endpoint/openai/gpt-image-2/generation"},{"title":"GPT Image 2 Generation Task","openapi":"api-reference/endpoint/openai/gpt-image-2/openapi.yaml GET /vendors/openai/v1/gpt-image-2/generation/{task_id}","href":"/api-reference/endpoint/openai/gpt-image-2/generation-task"},{"title":"Delete GPT Image 2 Generation Task","openapi":"api-reference/endpoint/openai/gpt-image-2/openapi.yaml DELETE /vendors/openai/v1/gpt-image-2/generation/{task_id}","href":"/api-reference/endpoint/openai/gpt-image-2/delete-task"},{"title":"GPT Image 2 Image Edit","openapi":"api-reference/endpoint/openai/gpt-image-2/openapi.yaml POST /vendors/openai/v1/gpt-image-2/edit","href":"/api-reference/endpoint/openai/gpt-image-2/edit"},{"title":"GPT Image 2 Edit Task","openapi":"api-reference/endpoint/openai/gpt-image-2/openapi.yaml GET /vendors/openai/v1/gpt-image-2/edit/{task_id}","href":"/api-reference/endpoint/openai/gpt-image-2/edit-task"}]}]},{"group":"Video Generation","pages":[{"group":"Wan 2","pages":[{"group":"Wan 2.6 Text-To-Video","pages":[{"title":"Wan 2.6 Text-To-Video Generation","openapi":"api-reference/endpoint/alibaba/wan2.6-t2v/wan2.6-t2v.yaml POST /vendors/alibaba/v1/wan2.6-t2v/generation","href":"/api-reference/endpoint/alibaba/wan2.6-t2v/generation"},{"title":"Wan 2.6 Text-To-Video Task","openapi":"api-reference/endpoint/alibaba/wan2.6-t2v/wan2.6-t2v.yaml GET /vendors/alibaba/v1/wan2.6-t2v/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.6-t2v/generation-task"},{"title":"Delete Wan 2.6 Text-To-Video Task","openapi":"api-reference/endpoint/alibaba/wan2.6-t2v/wan2.6-t2v.yaml DELETE /vendors/alibaba/v1/wan2.6-t2v/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.6-t2v/delete-task"}]},{"group":"Wan 2.6 Image-To-Video","pages":[{"title":"Wan 2.6 Image-To-Video Generation","openapi":"api-reference/endpoint/alibaba/wan2.6-i2v/wan2.6-i2v.yaml POST /vendors/alibaba/v1/wan2.6-i2v/generation","href":"/api-reference/endpoint/alibaba/wan2.6-i2v/generation"},{"title":"Wan 2.6 Image-To-Video Task","openapi":"api-reference/endpoint/alibaba/wan2.6-i2v/wan2.6-i2v.yaml GET /vendors/alibaba/v1/wan2.6-i2v/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.6-i2v/generation-task"},{"title":"Delete Wan 2.6 Image-To-Video Task","openapi":"api-reference/endpoint/alibaba/wan2.6-i2v/wan2.6-i2v.yaml DELETE /vendors/alibaba/v1/wan2.6-i2v/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.6-i2v/delete-task"}]},{"group":"Wan 2.5 Text-To-Video Preview","pages":[{"title":"Wan 2.5 Text-To-Video Preview Generation","openapi":"api-reference/endpoint/alibaba/wan2.5-t2v-preview/wan2.5-t2v-preview.yaml POST /vendors/alibaba/v1/wan2.5-t2v-preview/generation","href":"/api-reference/endpoint/alibaba/wan2.5-t2v-preview/generation"},{"title":"Wan 2.5 Text-To-Video Preview Task","openapi":"api-reference/endpoint/alibaba/wan2.5-t2v-preview/wan2.5-t2v-preview.yaml GET /vendors/alibaba/v1/wan2.5-t2v-preview/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.5-t2v-preview/generation-task"},{"title":"Delete Wan 2.5 Text-To-Video Preview Task","openapi":"api-reference/endpoint/alibaba/wan2.5-t2v-preview/wan2.5-t2v-preview.yaml DELETE /vendors/alibaba/v1/wan2.5-t2v-preview/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.5-t2v-preview/delete-task"}]},{"group":"Wan 2.5 Image-To-Video Preview","pages":[{"title":"Wan 2.5 Image-To-Video Preview Generation","openapi":"api-reference/endpoint/alibaba/wan2.5-i2v-preview/wan2.5-i2v-preview.yaml POST /vendors/alibaba/v1/wan2.5-i2v-preview/generation","href":"/api-reference/endpoint/alibaba/wan2.5-i2v-preview/generation"},{"title":"Wan 2.5 Image-To-Video Preview Task","openapi":"api-reference/endpoint/alibaba/wan2.5-i2v-preview/wan2.5-i2v-preview.yaml GET /vendors/alibaba/v1/wan2.5-i2v-preview/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.5-i2v-preview/generation-task"},{"title":"Delete Wan 2.5 Image-To-Video Preview Task","openapi":"api-reference/endpoint/alibaba/wan2.5-i2v-preview/wan2.5-i2v-preview.yaml DELETE /vendors/alibaba/v1/wan2.5-i2v-preview/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.5-i2v-preview/delete-task"}]},{"group":"Wan 2.2 Text-To-Video Plus","pages":[{"title":"Wan 2.2 Text-To-Video Plus Generation","openapi":"api-reference/endpoint/alibaba/wan2.2-t2v-plus/wan2.2-t2v-plus.yaml POST /vendors/alibaba/v1/wan2.2-t2v-plus/generation","href":"/api-reference/endpoint/alibaba/wan2.2-t2v-plus/generation"},{"title":"Wan 2.2 Text-To-Video Plus Task","openapi":"api-reference/endpoint/alibaba/wan2.2-t2v-plus/wan2.2-t2v-plus.yaml GET /vendors/alibaba/v1/wan2.2-t2v-plus/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.2-t2v-plus/generation-task"},{"title":"Delete Wan 2.2 Text-To-Video Plus Task","openapi":"api-reference/endpoint/alibaba/wan2.2-t2v-plus/wan2.2-t2v-plus.yaml DELETE /vendors/alibaba/v1/wan2.2-t2v-plus/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.2-t2v-plus/delete-task"}]},{"group":"Wan 2.2 Image-To-Video Plus","pages":[{"title":"Wan 2.2 Image-To-Video Plus Generation","openapi":"api-reference/endpoint/alibaba/wan2.2-i2v-plus/wan2.2-i2v-plus.yaml POST /vendors/alibaba/v1/wan2.2-i2v-plus/generation","href":"/api-reference/endpoint/alibaba/wan2.2-i2v-plus/generation"},{"title":"Wan 2.2 Image-To-Video Plus Task","openapi":"api-reference/endpoint/alibaba/wan2.2-i2v-plus/wan2.2-i2v-plus.yaml GET /vendors/alibaba/v1/wan2.2-i2v-plus/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.2-i2v-plus/generation-task"},{"title":"Delete Wan 2.2 Image-To-Video Plus Task","openapi":"api-reference/endpoint/alibaba/wan2.2-i2v-plus/wan2.2-i2v-plus.yaml DELETE /vendors/alibaba/v1/wan2.2-i2v-plus/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.2-i2v-plus/delete-task"}]},{"group":"Wan 2.2 Image-To-Video Flash","pages":[{"title":"Wan 2.2 Image-To-Video Flash Generation","openapi":"api-reference/endpoint/alibaba/wan2.2-i2v-flash/wan2.2-i2v-flash.yaml POST /vendors/alibaba/v1/wan2.2-i2v-flash/generation","href":"/api-reference/endpoint/alibaba/wan2.2-i2v-flash/generation"},{"title":"Wan 2.2 Image-To-Video Flash Task","openapi":"api-reference/endpoint/alibaba/wan2.2-i2v-flash/wan2.2-i2v-flash.yaml GET /vendors/alibaba/v1/wan2.2-i2v-flash/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.2-i2v-flash/generation-task"},{"title":"Delete Wan 2.2 Image-To-Video Flash Task","openapi":"api-reference/endpoint/alibaba/wan2.2-i2v-flash/wan2.2-i2v-flash.yaml DELETE /vendors/alibaba/v1/wan2.2-i2v-flash/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.2-i2v-flash/delete-task"}]},{"group":"Wan 2.1 Keyframe-To-Video Plus","pages":[{"title":"Wan 2.1 Keyframe-To-Video Plus Generation","openapi":"api-reference/endpoint/alibaba/wan2.1-kf2v-plus/wan2.1-kf2v-plus.yaml POST /vendors/alibaba/v1/wan2.1-kf2v-plus/generation","href":"/api-reference/endpoint/alibaba/wan2.1-kf2v-plus/generation"},{"title":"Wan 2.1 Keyframe-To-Video Plus Task","openapi":"api-reference/endpoint/alibaba/wan2.1-kf2v-plus/wan2.1-kf2v-plus.yaml GET /vendors/alibaba/v1/wan2.1-kf2v-plus/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.1-kf2v-plus/generation-task"},{"title":"Delete Wan 2.1 Keyframe-To-Video Plus Task","openapi":"api-reference/endpoint/alibaba/wan2.1-kf2v-plus/wan2.1-kf2v-plus.yaml DELETE /vendors/alibaba/v1/wan2.1-kf2v-plus/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.1-kf2v-plus/delete-task"}]},{"group":"Wan 2.1 Video Ace Plus","pages":[{"title":"Wan 2.1 Video Ace Plus Generation","openapi":"api-reference/endpoint/alibaba/wan2.1-vace-plus/wan2.1-vace-plus.yaml POST /vendors/alibaba/v1/wan2.1-vace-plus/generation","href":"/api-reference/endpoint/alibaba/wan2.1-vace-plus/generation"},{"title":"Wan 2.1 Video Ace Plus Task","openapi":"api-reference/endpoint/alibaba/wan2.1-vace-plus/wan2.1-vace-plus.yaml GET /vendors/alibaba/v1/wan2.1-vace-plus/generation/{task_id}","href":"/api-reference/endpoint/alibaba/wan2.1-vace-plus/generation-task"},{"title":"Delete Wan 2.1 Video Ace Plus Task","openapi":"api-reference/endpoint/alibaba/wan2.1-vace-plus/wan2.1-vace-plus.yaml DELETE /vendors/alibaba/v1/wan2.1-vace-plus/generation/{task_id}","description":"Permanently delete a task.\n\n**Note:** Tasks in `processing` or `retrying` status cannot be deleted.","href":"/api-reference/endpoint/alibaba/wan2.1-vace-plus/delete-task"}]}]},{"group":"Berry","pages":[{"group":"Berry 1.0","pages":[{"title":"Berry 1.0 Video Generation","openapi":"api-reference/endpoint/carrothub/berry-1.0/berry-1.0.yaml POST /vendors/carrothub/v1/berry-1.0/generation","href":"/api-reference/endpoint/carrothub/berry-1.0/generation"},{"title":"Berry 1.0 Video Generation Task","openapi":"api-reference/endpoint/carrothub/berry-1.0/berry-1.0.yaml GET /vendors/carrothub/v1/berry-1.0/generation/{task_id}","description":"Retrieve the status and result of a generation task","href":"/api-reference/endpoint/carrothub/berry-1.0/generation-task"},{"title":"Delete Berry 1.0 Video Generation Task","openapi":"api-reference/endpoint/carrothub/berry-1.0/berry-1.0.yaml DELETE /vendors/carrothub/v1/berry-1.0/generation/{task_id}","href":"/api-reference/endpoint/carrothub/berry-1.0/delete-task"}]},{"group":"Berry 1.0 Turbo","pages":[{"title":"Berry 1.0 Turbo Video Generation","openapi":"api-reference/endpoint/carrothub/berry-1.0-turbo/berry-1.0-turbo.yaml POST /vendors/carrothub/v1/berry-1.0-turbo/generation","href":"/api-reference/endpoint/carrothub/berry-1.0-turbo/generation"},{"title":"Berry 1.0 Turbo Video Generation Task","openapi":"api-reference/endpoint/carrothub/berry-1.0-turbo/berry-1.0-turbo.yaml GET /vendors/carrothub/v1/berry-1.0-turbo/generation/{task_id}","href":"/api-reference/endpoint/carrothub/berry-1.0-turbo/generation-task"},{"title":"Delete Berry 1.0 Turbo Video Generation Task","openapi":"api-reference/endpoint/carrothub/berry-1.0-turbo/berry-1.0-turbo.yaml DELETE /vendors/carrothub/v1/berry-1.0-turbo/generation/{task_id}","href":"/api-reference/endpoint/carrothub/berry-1.0-turbo/delete-task"}]},{"group":"Berry 1.0 Pro","pages":[{"title":"Berry 1.0 Pro Video Generation","openapi":"api-reference/endpoint/carrothub/berry-1.0-pro/berry-1.0-pro.yaml POST /vendors/carrothub/v1/berry-1.0-pro/generation","href":"/api-reference/endpoint/carrothub/berry-1.0-pro/generation"},{"title":"Berry 1.0 Pro Video Generation Task","openapi":"api-reference/endpoint/carrothub/berry-1.0-pro/berry-1.0-pro.yaml GET /vendors/carrothub/v1/berry-1.0-pro/generation/{task_id}","href":"/api-reference/endpoint/carrothub/berry-1.0-pro/generation-task"},{"title":"Delete Berry 1.0 Pro Video Generation Task","openapi":"api-reference/endpoint/carrothub/berry-1.0-pro/berry-1.0-pro.yaml DELETE /vendors/carrothub/v1/berry-1.0-pro/generation/{task_id}","href":"/api-reference/endpoint/carrothub/berry-1.0-pro/delete-task"}]},{"group":"Berry 1.0 Pro Turbo","pages":[{"title":"Berry 1.0 Pro Turbo Video Generation","openapi":"api-reference/endpoint/carrothub/berry-1.0-pro-turbo/berry-1.0-pro-turbo.yaml POST /vendors/carrothub/v1/berry-1.0-pro-turbo/generation","href":"/api-reference/endpoint/carrothub/berry-1.0-pro-turbo/generation"},{"title":"Berry 1.0 Pro Turbo Video Generation Task","openapi":"api-reference/endpoint/carrothub/berry-1.0-pro-turbo/berry-1.0-pro-turbo.yaml GET /vendors/carrothub/v1/berry-1.0-pro-turbo/generation/{task_id}","href":"/api-reference/endpoint/carrothub/berry-1.0-pro-turbo/generation-task"},{"title":"Delete Berry 1.0 Pro Turbo Video Generation Task","openapi":"api-reference/endpoint/carrothub/berry-1.0-pro-turbo/berry-1.0-pro-turbo.yaml DELETE /vendors/carrothub/v1/berry-1.0-pro-turbo/generation/{task_id}","href":"/api-reference/endpoint/carrothub/berry-1.0-pro-turbo/delete-task"}]}]},{"group":"Wan 2 Spark","pages":[{"group":"Wan 2.6 Text-To-Video Spark","pages":[{"title":"Wan 2.6 Text-To-Video Spark Generation","openapi":"api-reference/endpoint/carrothub/wan2.6-t2v-spark/wan2.6-t2v-spark.yaml POST /vendors/carrothub/v1/wan2.6-t2v-spark/generation","href":"/api-reference/endpoint/carrothub/wan2.6-t2v-spark/generation"},{"title":"Wan 2.6 Text-To-Video Spark Task","openapi":"api-reference/endpoint/carrothub/wan2.6-t2v-spark/wan2.6-t2v-spark.yaml GET /vendors/carrothub/v1/wan2.6-t2v-spark/generation/{task_id}","href":"/api-reference/endpoint/carrothub/wan2.6-t2v-spark/generation-task"},{"title":"Delete Wan 2.6 Text-To-Video Spark Task","openapi":"api-reference/endpoint/carrothub/wan2.6-t2v-spark/wan2.6-t2v-spark.yaml DELETE /vendors/carrothub/v1/wan2.6-t2v-spark/generation/{task_id}","href":"/api-reference/endpoint/carrothub/wan2.6-t2v-spark/delete-task"}]},{"group":"Wan 2.6 Image-To-Video Spark","pages":[{"title":"Wan 2.6 Image-To-Video Spark Generation","openapi":"api-reference/endpoint/carrothub/wan2.6-i2v-spark/wan2.6-i2v-spark.yaml POST /vendors/carrothub/v1/wan2.6-i2v-spark/generation","href":"/api-reference/endpoint/carrothub/wan2.6-i2v-spark/generation"},{"title":"Wan 2.6 Image-To-Video Spark Task","openapi":"api-reference/endpoint/carrothub/wan2.6-i2v-spark/wan2.6-i2v-spark.yaml GET /vendors/carrothub/v1/wan2.6-i2v-spark/generation/{task_id}","href":"/api-reference/endpoint/carrothub/wan2.6-i2v-spark/generation-task"},{"title":"Delete Wan 2.6 Image-To-Video Spark Task","openapi":"api-reference/endpoint/carrothub/wan2.6-i2v-spark/wan2.6-i2v-spark.yaml DELETE /vendors/carrothub/v1/wan2.6-i2v-spark/generation/{task_id}","href":"/api-reference/endpoint/carrothub/wan2.6-i2v-spark/delete-task"}]},{"group":"Wan 2.5 Text-To-Video Spark","pages":[{"title":"Wan 2.5 Text-To-Video Spark Generation","openapi":"api-reference/endpoint/carrothub/wan2.5-t2v-spark/wan2.5-t2v-spark.yaml POST /vendors/carrothub/v1/wan2.5-t2v-spark/generation","href":"/api-reference/endpoint/carrothub/wan2.5-t2v-spark/generation"},{"title":"Wan 2.5 Text-To-Video Spark Task","openapi":"api-reference/endpoint/carrothub/wan2.5-t2v-spark/wan2.5-t2v-spark.yaml GET /vendors/carrothub/v1/wan2.5-t2v-spark/generation/{task_id}","href":"/api-reference/endpoint/carrothub/wan2.5-t2v-spark/generation-task"},{"title":"Delete Wan 2.5 Text-To-Video Spark Task","openapi":"api-reference/endpoint/carrothub/wan2.5-t2v-spark/wan2.5-t2v-spark.yaml DELETE /vendors/carrothub/v1/wan2.5-t2v-spark/generation/{task_id}","href":"/api-reference/endpoint/carrothub/wan2.5-t2v-spark/delete-task"}]},{"group":"Wan 2.5 Image-To-Video Spark","pages":[{"title":"Wan 2.5 Image-To-Video Spark Generation","openapi":"api-reference/endpoint/carrothub/wan2.5-i2v-spark/wan2.5-i2v-spark.yaml POST /vendors/carrothub/v1/wan2.5-i2v-spark/generation","href":"/api-reference/endpoint/carrothub/wan2.5-i2v-spark/generation"},{"title":"Wan 2.5 Image-To-Video Spark Task","openapi":"api-reference/endpoint/carrothub/wan2.5-i2v-spark/wan2.5-i2v-spark.yaml GET /vendors/carrothub/v1/wan2.5-i2v-spark/generation/{task_id}","href":"/api-reference/endpoint/carrothub/wan2.5-i2v-spark/generation-task"},{"title":"Delete Wan 2.5 Image-To-Video Spark Task","openapi":"api-reference/endpoint/carrothub/wan2.5-i2v-spark/wan2.5-i2v-spark.yaml DELETE /vendors/carrothub/v1/wan2.5-i2v-spark/generation/{task_id}","href":"/api-reference/endpoint/carrothub/wan2.5-i2v-spark/delete-task"}]}]},{"group":"Kling","pages":[{"group":"Kling V3 Omni Text-To-Video","pages":[{"title":"Kling V3 Omni Text to Video","openapi":"api-reference/endpoint/klingai/kling-v3-omni/kling-v3-omni-text-to-video.yaml POST /vendors/klingai/v1/kling-v3-omni/text-to-video/generation","href":"/api-reference/endpoint/klingai/kling-v3-omni/text-to-video"},{"title":"Kling V3 Omni Text to Video Task","openapi":"api-reference/endpoint/klingai/kling-v3-omni/kling-v3-omni-text-to-video.yaml GET /vendors/klingai/v1/kling-v3-omni/text-to-video/generation/{task_id}","href":"/api-reference/endpoint/klingai/kling-v3-omni/text-to-video-task"}]},{"group":"Kling V3 Omni Image-To-Video","pages":[{"title":"Kling V3 Omni Image to Video","openapi":"api-reference/endpoint/klingai/kling-v3-omni/kling-v3-omni-image-to-video.yaml POST /vendors/klingai/v1/kling-v3-omni/image-to-video/generation","href":"/api-reference/endpoint/klingai/kling-v3-omni/image-to-video"},{"title":"Kling V3 Omni Image to Video Task","openapi":"api-reference/endpoint/klingai/kling-v3-omni/kling-v3-omni-image-to-video.yaml GET /vendors/klingai/v1/kling-v3-omni/image-to-video/generation/{task_id}","href":"/api-reference/endpoint/klingai/kling-v3-omni/image-to-video-task"}]},{"group":"Kling V3 Omni Reference Image-To-Video","pages":[{"title":"Kling V3 Omni Reference Image to Video","openapi":"api-reference/endpoint/klingai/kling-v3-omni/kling-v3-omni-reference-image-to-video.yaml POST /vendors/klingai/v1/kling-v3-omni/reference-image-to-video/generation","href":"/api-reference/endpoint/klingai/kling-v3-omni/reference-image-to-video"},{"title":"Kling V3 Omni Reference Image to Video Task","openapi":"api-reference/endpoint/klingai/kling-v3-omni/kling-v3-omni-reference-image-to-video.yaml GET /vendors/klingai/v1/kling-v3-omni/reference-image-to-video/generation/{task_id}","href":"/api-reference/endpoint/klingai/kling-v3-omni/reference-image-to-video-task"}]},{"group":"Kling V3 Omni Reference Video-To-Video","pages":[{"title":"Kling V3 Omni Reference Video to Video","openapi":"api-reference/endpoint/klingai/kling-v3-omni/kling-v3-omni-reference-video-to-video.yaml POST /vendors/klingai/v1/kling-v3-omni/reference-video-to-video/generation","href":"/api-reference/endpoint/klingai/kling-v3-omni/reference-video-to-video"},{"title":"Kling V3 Omni Reference Video to Video Task","openapi":"api-reference/endpoint/klingai/kling-v3-omni/kling-v3-omni-reference-video-to-video.yaml GET /vendors/klingai/v1/kling-v3-omni/reference-video-to-video/generation/{task_id}","href":"/api-reference/endpoint/klingai/kling-v3-omni/reference-video-to-video-task"}]},{"group":"Kling V3 Omni Video-To-Video Edit","pages":[{"title":"Kling V3 Omni Video to Video Edit","openapi":"api-reference/endpoint/klingai/kling-v3-omni/kling-v3-omni-video-to-video-edit.yaml POST /vendors/klingai/v1/kling-v3-omni/video-to-video/edit","href":"/api-reference/endpoint/klingai/kling-v3-omni/video-to-video-edit"},{"title":"Kling V3 Omni Video to Video Edit Task","openapi":"api-reference/endpoint/klingai/kling-v3-omni/kling-v3-omni-video-to-video-edit.yaml GET /vendors/klingai/v1/kling-v3-omni/video-to-video/edit/{task_id}","href":"/api-reference/endpoint/klingai/kling-v3-omni/video-to-video-edit-task"}]},{"group":"Kling V3.0 Text-To-Video","pages":[{"title":"Kling V3.0 Text to Video","openapi":"api-reference/endpoint/klingai/kling-v3/openapi.yaml POST /vendors/klingai/v1/kling-v3/text-to-video/generation","href":"/api-reference/endpoint/klingai/kling-v3/text-to-video"},{"title":"Kling V3.0 Text to Video Task","openapi":"api-reference/endpoint/klingai/kling-v3/openapi.yaml GET /vendors/klingai/v1/kling-v3/text-to-video/generation/{task_id}","href":"/api-reference/endpoint/klingai/kling-v3/text-to-video-task"}]},{"group":"Kling V3.0 Image-To-Video","pages":[{"title":"Kling V3.0 Image to Video","openapi":"api-reference/endpoint/klingai/kling-v3/openapi.yaml POST /vendors/klingai/v1/kling-v3/image-to-video/generation","href":"/api-reference/endpoint/klingai/kling-v3/image-to-video"},{"title":"Kling V3.0 Image to Video Task","openapi":"api-reference/endpoint/klingai/kling-v3/openapi.yaml GET /vendors/klingai/v1/kling-v3/image-to-video/generation/{task_id}","href":"/api-reference/endpoint/klingai/kling-v3/image-to-video-task"}]}]},{"group":"Midjourney","pages":[{"title":"Video Diffusion","openapi":"api-reference/endpoint/midjourney/midjourney.yaml POST /vendors/midjourney/v1/tob/video-diffusion","href":"/api-reference/endpoint/midjourney/video-diffusion"},{"title":"Video Diffusion","openapi":"api-reference/endpoint/midjourney/midjourney.yaml GET /vendors/midjourney/v1/tob/video-diffusion/{task_id}","href":"/api-reference/endpoint/midjourney/video-diffusion-task"}]}]},{"group":"Speech Generation","pages":[{"group":"MiniMax","pages":[{"group":"Speech 2.8 HD Text-To-Speech","pages":[{"title":"MiniMax Speech 2.8 HD Text to Speech","openapi":"api-reference/endpoint/minimax/speech-2.8-hd/speech-2.8-hd.yaml POST /vendors/minimax/v1/speech-2.8-hd/text-to-speech/generation","href":"/api-reference/endpoint/minimax/speech-2.8-hd/text-to-speech"},{"title":"MiniMax Speech 2.8 HD Text to Speech Task","openapi":"api-reference/endpoint/minimax/speech-2.8-hd/speech-2.8-hd.yaml GET /vendors/minimax/v1/speech-2.8-hd/text-to-speech/generation/{task_id}","href":"/api-reference/endpoint/minimax/speech-2.8-hd/text-to-speech-task"}]},{"group":"Speech 2.8 Turbo Text-To-Speech","pages":[{"title":"MiniMax Speech 2.8 Turbo Text to Speech","openapi":"api-reference/endpoint/minimax/speech-2.8-turbo/speech-2.8-turbo.yaml POST /vendors/minimax/v1/speech-2.8-turbo/text-to-speech/generation","href":"/api-reference/endpoint/minimax/speech-2.8-turbo/text-to-speech"},{"title":"MiniMax Speech 2.8 Turbo Text to Speech Task","openapi":"api-reference/endpoint/minimax/speech-2.8-turbo/speech-2.8-turbo.yaml GET /vendors/minimax/v1/speech-2.8-turbo/text-to-speech/generation/{task_id}","href":"/api-reference/endpoint/minimax/speech-2.8-turbo/text-to-speech-task"}]}]}]},{"group":"Music Generation","pages":[{"group":"MiniMax","pages":[{"group":"Music 2.5 Text-To-Music","pages":[{"title":"MiniMax Music 2.5 Text to Music","openapi":"api-reference/endpoint/minimax/music-2.5/music-2.5.yaml POST /vendors/minimax/v1/music-2.5/text-to-music/generation","href":"/api-reference/endpoint/minimax/music-2.5/text-to-music"},{"title":"MiniMax Music 2.5 Text to Music Task","openapi":"api-reference/endpoint/minimax/music-2.5/music-2.5.yaml GET /vendors/minimax/v1/music-2.5/text-to-music/generation/{task_id}","href":"/api-reference/endpoint/minimax/music-2.5/text-to-music-task"}]},{"group":"Music 2.0 Text-To-Music","pages":[{"title":"MiniMax Music 2.0 Text to Music","openapi":"api-reference/endpoint/minimax/music-2.0/music-2.0.yaml POST /vendors/minimax/v1/music-2.0/text-to-music/generation","href":"/api-reference/endpoint/minimax/music-2.0/text-to-music"},{"title":"MiniMax Music 2.0 Text to Music Task","openapi":"api-reference/endpoint/minimax/music-2.0/music-2.0.yaml GET /vendors/minimax/v1/music-2.0/text-to-music/generation/{task_id}","href":"/api-reference/endpoint/minimax/music-2.0/text-to-music-task"}]}]}]}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli/quickstart"}]},{"tab":"Legal","pages":[{"title":"Legal","href":"/legal/user-privacy-policy"}]}]},"basePath":"","title":"CarrotHub Documentation - AI API Gateway \u0026 Routing Platform","buildId":"dpl_2AK98Hxhwu4fUXpx9atbv41cC328","deploymentId":"dpl_2AK98Hxhwu4fUXpx9atbv41cC328","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-EBSrFTg1.js","utils-Y_7TcRh4.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D1wvvkPH.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-aT0ty6oN.js","snippetPresets-DoNRuyJc.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-CXRajFpn.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BAyOsINj.js","shallow-CIcHqV1v.js","getApiPlaygroundDisplay-C5igZwEf.js","CodeSnippet-BFWnQLNh.js","CodeSnippets-Cx2mFgZW.js","Page-DCFaZE46.js","getPastedJson-BOy09PZp.js","icon-BwmYtB6R.js","MethodPill-DAIhq-iu.js","DuplicateIcon-DFM8Q3ph.js","createIcon-0UdvzB4Z.js","DynamicMarkdown-DYYZTGpa.js","SectionHeading-BFCDRUuH.js","axios-vUo_bRtp.js","Markdown-C6TcKjiR.js","clsx-Y_UC780V.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-PCbBHBTv.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-D4q_oRML.js"]}