{ "error": { "code": "VALIDATION_ERROR", "message": "Land chains must contain 3 to 10 total frames including img0 and img1", "request_id": "req_xyz123", "details": { "field": "scenes", "issues": [ { "path": "scenes", "message": "Land chains must contain 3 to 10 total frames including img0 and img1" } ] } }}
{ "error": { "code": "VALIDATION_ERROR", "message": "Land chains must contain 3 to 10 total frames including img0 and img1", "request_id": "req_xyz123", "details": { "field": "scenes", "issues": [ { "path": "scenes", "message": "Land chains must contain 3 to 10 total frames including img0 and img1" } ] } }}
{ "error": { "code": "ASSET_ACCESS_DENIED", "message": "Asset is not accessible", "request_id": "req_xyz123" }}
{ "error": { "code": "PLAN_REQUIRED", "message": "API access requires a Plus, Pro, Max or Enterprise plan. Please upgrade your subscription.", "request_id": "req_xyz123", "details": { "current_plan": "Free", "required_plans": ["Plus", "Pro", "Max", "Enterprise"] } }}
{ "error": { "code": "CONCURRENCY_LIMIT_EXCEEDED", "message": "You have reached your concurrent task limit of 1. Please wait for existing tasks to complete.", "request_id": "req_xyz123", "details": { "limit": 1, "in_flight": 1, "plan": "Plus" } }}
{ "error": { "code": "SERVICE_UNAVAILABLE", "message": "Land transformation service is temporarily unavailable. Please try again.", "request_id": "req_xyz123" }}
Creates a new land transformation video from a single photo of an empty plot. The system progressively builds the land through chained transitions: raw terrain → marked buildable area → proposed constructions. Each transition is rendered as a cinematic morph, resulting in a fluid visualization of what the land could become.This endpoint is progressive — only source_image_url and format are required. Everything else is optional and resolved server-side if omitted:
No mask? The server auto-detects the buildable area via Gemini.
No scenes? The server generates construction proposals based on terrain analysis.
No script? The server auto-generates a narration script.
When you provide pre-generated assets (scenes[], script, mask_image_url), the server skips the corresponding generation steps. This avoids double-charging for assets you already created.
Request Body
string
required
Publicly accessible URL of a single photo of an empty plot of land.
Must be a valid HTTP(S) URL
Must be an image file (JPEG, PNG, or WebP)
Only one image is accepted
Every image URL in the request is fetched and validated before the task is created. Unreachable images fail with 400 INVALID_IMAGE_URL, and images below the minimum resolution fail with 400 IMAGE_RESOLUTION_TOO_LOW. VibePeak-hosted assets belonging to another account are rejected with 403 ASSET_ACCESS_DENIED.
string
required
Target video format / aspect ratio.
Value
Description
9:16
Vertical video (portrait) — ideal for social media stories and reels
16:9
Horizontal video (landscape) — ideal for websites and presentations
Mask & Area Overrides
string
Optional binary mask image (PNG) marking the buildable area with a neon outline and semi-transparent fill.When provided, the server uses this mask directly and skips auto-detection. Takes precedence over area_polygon.Alias: mask_url is accepted and normalized to mask_image_url. If both are sent, mask_image_url wins.
string
Optional pre-rendered marked terrain image (the img1 frame — the source photo with the buildable area already highlighted).When provided, the server skips the marking render entirely and uses this frame directly. Like mask_image_url and area_polygon, supplying it waives the 5-credit mask charge, and the task reports marking: "mask".It takes precedence over both mask_image_url and area_polygon.
marked_image_url also changes how the frame count is calculated when you supply scenes[] — see Frame Limits.
object[]
Optional polygon coordinates marking the buildable area. Minimum 3 points required.Each point is an object with normalized coordinates:
Show Point properties
number
required
Normalized X coordinate between 0 and 1.
number
required
Normalized Y coordinate between 0 and 1.
Alias: polygon is accepted and normalized to area_polygon.If none of mask_image_url, area_polygon or marked_image_url is provided, the server auto-detects the buildable area using Gemini vision analysis.
Terrain & Construction Overrides
string
Optional terrain type hint, e.g. "urban", "rural" or "industrial".Any non-empty string is accepted — the value is a free-form hint passed to the proposal generator, not a closed enum. If omitted, the server analyzes the image and auto-detects the terrain type.
string[]
Optional array of construction prompts (1-8). One image is generated per prompt in the order provided.When provided, the server skips proposal auto-generation and renders exactly these constructions. Each prompt is still billed as a generated scene.Alias: prompts is accepted and normalized to construction_prompts.
integer
default:"3"
Optional number of constructions to auto-generate (2-8). Default is 3.Ignored if scenes or construction_prompts are provided.
string
Optional style hint that biases auto-generated proposals (e.g., "modern", "rustic", "minimalist").
string
Optional exclusion hint for auto-generated proposals (e.g., "no swimming pools", "no glass facades").
Scene Chain (Fully Resolved)
object[]
Optional fully-resolved scene chain (1-8 items). When provided, the server skips scene generation and renders these frames directly.Each scene is an object with:
Show Scene properties
string
Publicly accessible URL of the scene image. Optional at the schema level, but a scene without an image cannot be rendered — always send it when supplying a resolved chain.
string
Optional prompt that generated this scene.
integer
Optional display order within the chain. Must be 1 or greater — 0 is rejected with 400 VALIDATION_ERROR.
string
Optional per-scene camera movement applied by the WAN renderer.One of traveling_left, traveling_right, traveling_up, traveling_down, dolly_in, dolly_out, arc_left, arc_right. Omitted means the renderer picks the movement.
Providing scenes[] is the recommended path for first-party callers (like the VibePeak web app) that have already generated images interactively. This ensures you are only charged the base render cost (15 credits) and avoids double-charging for generated assets.
Script, Voice & Music Overrides
string
Optional narration script for text-to-speech. Any non-empty string is accepted.
Unlike the narrated slideshow and real-estate endpoints, /v1/land does not enforce a character-count range or reject digits and symbols. For natural pacing aim for roughly 65-85 characters per scene, but this is guidance, not validation.
string
Language code for the auto-generated script and TTS pronunciation (e.g., en, es, de, fr, pt). Minimum 2 characters.
string
Voice ID for narration. You can find available voices using the List Voices endpoint.Defaults to a platform voice if omitted.
number
default:"1"
Speaking rate of the synthesized voiceover. Values below 1 slow it down, above 1 speed it up. The effect depends on the voice and language: most voices follow the value closely, some apply it only partially, and each voice applies its own supported range within these bounds. Range: 0.5 to 2; values outside it are rejected with a validation error. Applies only when VibePeak synthesizes the voiceover, so it has no effect when voiceover_enabled is false.
boolean
Set to false to render the video without narration. When false, the server skips text-to-speech entirely and script / voice_id may be omitted.Omitting this field leaves narration on.
boolean
Set to true to add a background music bed. Omitting this field, or sending false, renders the video without music.
string
Optional Music Library track to pin, as a UUID. Without it, a background_music: true job uses a randomly selected bed.
music_id and music_kind must be sent together — sending one without the other fails with 400 VALIDATION_ERROR (music_id and music_kind must be provided together). A non-UUID value fails with music_id must be a valid UUID.Both fields are only honored when background_music is true; with music off the video stays silent regardless.
string
Which catalogue music_id refers to: stock (Music Library track) or ai (AI-generated track). Required whenever music_id is present.
Subtitle & Elements Configuration
object
Subtitle configuration for word-level animated overlays. Same structure as other video endpoints — see Create Narrated Slideshow for the full field list.On this endpoint the object is passed through to the renderer without field-level validation, so a malformed key is accepted at request time and simply ignored downstream.
object
Configuration for visual elements and branding overlays (watermark, text, intro/outro). Same structure as other video endpoints — see Create Narrated Slideshow.The intro_outro block is fully validated; the rest is passed through to the renderer. Browse the designs in the template gallery, or read the catalogue from GET /v1/intro-outro/templates.As on Create Narrated Slideshow, the overlays are applied after the video renders. The task passes through the transitional intro_outro status while that runs, and if the overlays cannot be applied the task still completes: the video is delivered without them and the result carries an intro_outro_warning.
Unlike the real-estate and narrated-slideshow endpoints, /v1/land does not pre-validate the watermark URL at request time, so it never returns INVALID_WATERMARK_URL. An unreachable watermark surfaces later as a render failure. Verify the URL before submitting.The watermark’s geometry is the exception: it is checked at request time here, exactly as on the other endpoints. When a watermark URL is present and branding is enabled, a size below 2 (single mode only) or an opacity below 5 is rejected with 400 INVALID_WATERMARK_GEOMETRY before any credits are charged.A size or opacity that is not a finite number is rejected the same way. This matters more here than elsewhere: /v1/land validates only the intro_outro block of elements_config and passes the rest through, so a string such as "20" reaches the floor intact and is refused, where the real-estate and narrated-slideshow endpoints would have rejected it earlier as a VALIDATION_ERROR. Send numbers, not numeric strings.Omitting size or opacity is always fine — the renderer’s own defaults (20 and 100) apply, and an absent or null value is never rejected.
Webhook
string
HTTPS URL to receive a webhook notification when the task completes or fails.See Webhooks for payload format and verification details.
Webhook URLs must use HTTPS and cannot point to private/internal networks (SSRF protection). A rejected URL fails with 400 INVALID_WEBHOOK_URL.
Response
Returns a 202 Accepted response. Unlike other video endpoints, land tasks start in the preparing state while the server resolves inputs (auto-detecting the mask, generating scenes, creating the script), and they report credits under charged_credits with a resolution object.
Land responses are deliberately shaped differently from other video endpoints. Land tasks use charged_credits and a resolution object; every other task type uses credits_charged and has no resolution. If you share response-parsing code across endpoints, handle both key names.
string
required
Unique identifier for the task, in the form task_<id>. Use this to poll for status via Get Task.
The task_id sent in the webhook payload is a different identifier (vp_land_<id>, the task’s external id). Correlate webhooks by storing both, or by matching on your own reference — do not assume the webhook task_id can be passed to GET /v1/tasks/{id}.
string
required
Initial task status. Always preparing for land tasks.
true for live keys. Requests made with a vpk_test_ key return false and are not charged — see Test Mode.
string
required
Request identifier, useful when contacting support.
integer
required
Credits actually deducted for this request. See Credit Model for the breakdown.
object
Preparation metadata describing what the server will compute.
Show Resolution properties
string
Current preparation stage — always "preparing" at creation.
integer
Preparation progress percentage (0-100). Starts at 10.
string[]
The request fields you supplied that overrode server-side generation, in canonical order. An explicit background_music: false counts as an override; an omitted field does not.
object
Detailed credit cost breakdown.
Show Credits breakdown properties
integer
Base render cost (15 credits).
integer
Cost for a server-generated mask (5 credits) — 0 if mask_image_url, area_polygon or marked_image_url is provided.
integer
Number of scenes the server will generate.
integer
Total cost for generated scenes (5 credits each).
integer
Cost for a server-generated script (5 credits) — 0 if script is provided.
integer
Total credits charged.
object
Convenience links: self (the poll URL) and poll_interval_seconds.
{ "error": { "code": "VALIDATION_ERROR", "message": "Land chains must contain 3 to 10 total frames including img0 and img1", "request_id": "req_xyz123", "details": { "field": "scenes", "issues": [ { "path": "scenes", "message": "Land chains must contain 3 to 10 total frames including img0 and img1" } ] } }}
{ "error": { "code": "ASSET_ACCESS_DENIED", "message": "Asset is not accessible", "request_id": "req_xyz123" }}
{ "error": { "code": "PLAN_REQUIRED", "message": "API access requires a Plus, Pro, Max or Enterprise plan. Please upgrade your subscription.", "request_id": "req_xyz123", "details": { "current_plan": "Free", "required_plans": ["Plus", "Pro", "Max", "Enterprise"] } }}
{ "error": { "code": "CONCURRENCY_LIMIT_EXCEEDED", "message": "You have reached your concurrent task limit of 1. Please wait for existing tasks to complete.", "request_id": "req_xyz123", "details": { "limit": 1, "in_flight": 1, "plan": "Plus" } }}
{ "error": { "code": "SERVICE_UNAVAILABLE", "message": "Land transformation service is temporarily unavailable. Please try again.", "request_id": "req_xyz123" }}
Credit Model
Land transformation videos use a differentiated credit model based on the work the server performs:
Component
Credits
Condition
Base render
15
Always charged
Generated mask
5
Charged if you do not provide mask_image_url, area_polygon or marked_image_url
Generated scenes
5 per scene
Charged for each scene the server generates (not for pre-provided scenes[])
Generated script
5
Charged if you do not provide script and narration is on. Never charged when voiceover_enabled is false — no script is written for a video without narration
When scenes[] is absent, the number of generated scenes is construction_prompts.length, else num_constructions, else 3.Example costs:
Scenario
Calculation
Total
Minimal (1 image, auto everything)
15 + 5 + 15 + 5
40
With mask, auto scenes + script
15 + 0 + 15 + 5
35
With mask + 5 construction prompts
15 + 0 + 25 + 5
45
Fully resolved (scenes[] + script + marked frame)
15 + 0 + 0 + 0
15
No narration (scenes[] + marked frame + voiceover_enabled: false)
15 + 0 + 0 + 0
15
Assets you pre-provide (scenes[], script, mask_image_url, marked_image_url) are never regenerated and never re-charged. This prevents double-charging for first-party callers that already generated images interactively.
Credits are deducted at creation time. If the job later fails, the credits are refunded automatically — the webhook’s charged_credits reflects the post-refund amount (typically 0).If a task that failed with GENERATION_TIMEOUT later completes (see Polling), the refund stands and nothing is charged again. The task.completed webhook still reports the original price in charged_credits; treat the earlier task.failed webhook as the billing record for that task.
Plan Access
Plan
API Access
Concurrent Tasks
Free
No
—
Starter
No
—
Plus
Yes
1
Pro
Yes
3
Max
Yes
5
Enterprise
Yes
Custom
Frame Limits
The video chain must contain 3 to 10 total frames. How the count is derived depends on whether you supply scenes[]:
Without scenes[] — the count is 2 + n, where n is construction_prompts.length, else num_constructions, else 3. The two implied frames are img0 (original terrain) and img1 (marked terrain).
With scenes[] — the count is 1 + (marked_image_url ? 1 : 0) + scenes.length. img1 is only counted when you actually supply marked_image_url.
A resolved chain of 3 scenes with nomarked_image_url counts as 4 frames, not 5. If you are supplying a chain that already includes the marked frame as its first scene, do not also send marked_image_url — you would count it twice.
Requests outside the 3-10 range fail with 400 VALIDATION_ERROR on the scenes field.
Polling
Land tasks flow through preparing → queued → processing → completed or failed.If the request asked for post-processing, the task also reports a transitional status between processing and its final state, in this order: watermarking, intro_outro, subtitling. Each appears only when the corresponding feature was requested. Treat all three like processing and keep polling — the task always ends in completed or failed. A step that cannot finish does not fail the task: the video is delivered without that refinement and result carries a matching watermark_warning, intro_outro_warning or subtitle_warning. See Asynchronous Processing.
GENERATION_TIMEOUT is the one failure that is not always final. It fires when the render is still running 180 minutes after the task was created. If that render finishes afterwards — VibePeak keeps checking for 48 hours after creation — the task moves from failed to completed, result.video_url is filled in, and a task.completed webhook follows the earlier task.failed one for the same task_id. Treat that later task.completed as the final outcome. Past the 24-hour expiry the task can no longer be polled, so a completion that late reaches you only by webhook. No other failure code changes afterwards, and a task never sends two task.completed webhooks.
While in preparing, GET /v1/tasks/{task_id} returns a resolution object that advances through these stages:
Stage
Progress
preparing
10
marking_resolved
35
terrain_resolved
50
scenes_resolved
70
script_resolved
85
resolved
100
Not every task passes through every stage. Supplying marked_image_url or mask_image_url resolves marking synchronously, so a fully-resolved request skips the intermediate stages and reports resolved / 100 on the first poll. Treat the ladder as monotonic but sparse — do not wait for a specific stage to appear.Once marking is decided, the resolution object also carries marking, generated_image_count and used_overrides. It also carries resolved_inputs — a whitelisted view of what the server actually resolved (source_image_url, format, mask_image_url, area_polygon, terrain_type, scenes, construction_prompts, script), which is how you retrieve the generated scene image URLs and the auto-written script. When voiceover_enabled is false and you sent no script, resolved_inputs.script is an empty string. Your webhook_url and other request fields are deliberately not echoed back. generated_image_count counts server-generated scene images plus one for an auto-generated mask, and stays 0 for a fully-resolved request. On land tasks the GET response uses charged_credits; other task types use credits_charged.
Tasks expire 24 hours after creation. After that, GET /v1/tasks/{task_id} returns 404 TASK_EXPIRED and the video URL is no longer retrievable — download the result before then.
Webhook Payload
When the task completes or fails, a POST request is sent to your webhook_url. See Webhooks for verification.
Webhook Headers
Header
Value
X-VibePeak-Event
task.completed or task.failed
X-VibePeak-Signature
HMAC-SHA256, hex encoded
X-VibePeak-Timestamp
Unix timestamp in seconds
The signed message is {timestamp}.{raw body}, not the body alone. Concatenate the X-VibePeak-Timestamp value, a literal ., and the exact raw request body before computing the HMAC, or verification will fail.
The event name lives in the X-VibePeak-Eventheader, not in the body. There is no event field inside the JSON.
The webhook task_id is the task’s external id (vp_land_<id>), which is not the task_id returned by POST /v1/land (task_<id>) and cannot be passed to GET /v1/tasks/{id}. Store the value returned at creation and correlate on your side.
Notes on the payload:
resolution is the typed shape only — marking, generated_image_count, used_overrides. It does not include stage, progress or credits_breakdown; those appear only on the polling response.
resolution is omitted entirely if marking was never resolved (for example, a failure during preparation).
result carries onlyvideo_url and cover_image_url. There is no duration_seconds, resolution or expires_at inside result.
cover_image_url is present only if cover generation succeeded. Note that it is keyed by the internal task_<id>, while the payload’s task_id is the vp_land_<id> external id.
There is no event, type or timestamp field in the body. Distinguish outcomes with status, or read the X-VibePeak-Event header.
The marking field indicates which method was used to identify the buildable area:
Value
Meaning
mask
A pre-provided marked_image_urlormask_image_url was used. marked_image_url takes precedence when both are sent.
polygon
A pre-provided area_polygon was rasterized into a mask
auto
Gemini auto-detected the buildable area
fullimage
Reserved. Present in the type contract but not currently emitted by any code path — do not branch on it.
Error Codes
Code
Status
Description
VALIDATION_ERROR
400
Invalid request parameters, frame count outside 3-10, order below 1, or music_id/music_kind not sent together
INVALID_IMAGE_URL
400
An image URL is unreachable, not an image, or too large
IMAGE_RESOLUTION_TOO_LOW
400
An image is below the minimum resolution
INVALID_WEBHOOK_URL
400
Webhook URL failed SSRF validation
INVALID_WATERMARK_GEOMETRY
400
The elements_config watermark is enabled but too small or too faint to render (size ≥ 2 and opacity ≥ 5; size is not checked when mode is mosaic). No credits are charged
INVALID_API_KEY
401
Invalid or missing API key
INSUFFICIENT_CREDITS
402
Not enough credits to process the request
ASSET_ACCESS_DENIED
403
A VibePeak-hosted image URL belongs to another account
PLAN_REQUIRED
403
Plan doesn’t include API access
CONCURRENCY_LIMIT_EXCEEDED
409
Concurrent task limit reached
SERVICE_UNAVAILABLE
503
The job could not be enqueued; credits are refunded automatically
Asynchronous failures are reported through the task’s error object and the failure webhook:
Code
Description
GENERATION_FAILED
The land render failed downstream
GENERATION_TIMEOUT
The render was still running 180 minutes after the task was created. Credits are refunded. If the render finishes later, the task can still become completed — see Polling
Poll for status: Use Get Task with the task_id from the 202 response, every 30 seconds.
Wait for webhook: If configured, receive notification when complete — remembering the id difference noted above.
Download video: Access result.video_url within 24 hours of creation.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"VibePeak API","colors":{"primary":"#6366F1","light":"#818CF8","dark":"#4F46E5"},"logo":{"light":"https://mintcdn.com/vibepeak/19EbLYbVzhgj3JxG/logo/vibepeak.png?fit=max\u0026auto=format\u0026n=19EbLYbVzhgj3JxG\u0026q=85\u0026s=bf20e85f3fd209089d4bd0a4f84fbb16","dark":"https://mintcdn.com/vibepeak/LeuztPUvTgXhQe62/logo/vibepeak-dark.png?fit=max\u0026auto=format\u0026n=LeuztPUvTgXhQe62\u0026q=85\u0026s=ea7adea4e435869bd96795007e96121a","href":"/"},"favicon":"https://mintcdn.com/vibepeak/KR6DlXc38Ggbhvki/favicon.svg?fit=max\u0026auto=format\u0026n=KR6DlXc38Ggbhvki\u0026q=85\u0026s=3ce7539953e47d169f99db4ba4dfd17a","api":{},"navbar":{"links":[{"href":"https://app.vibepeak.ai/?utm_source=docs\u0026utm_medium=referral\u0026utm_campaign=api_docs\u0026utm_content=navbar_dashboard","label":"Dashboard"}],"primary":{"type":"button","label":"Get API Key","href":"https://app.vibepeak.ai/account/profile?utm_source=docs\u0026utm_medium=referral\u0026utm_campaign=api_docs\u0026utm_content=navbar_get_api_key"}},"footer":{"socials":{"x":"https://x.com/VibepeakAi","github":"https://github.com/VibePeak-ai","linkedin":"https://linkedin.com/company/vibepeak"}},"seo":{},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","cursor"],"display":"header"},"metadata":{"timestamp":false},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"API Status","icon":"signal","href":"https://vibepeak.statuspage.io/"},{"anchor":"Support","icon":"envelope","href":"mailto:[email protected]"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"vibepeak","hasAudioNarration":false,"actualSubdomain":"vibepeak","customDomains":["docs.vibepeak.ai"],"gitSource":{"type":"github","owner":"vibepeak-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae5c7237734220aadd4524a","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API Reference","count":22},{"language":"default","tag":"Families","count":9},{"language":"default","tag":"Documentation","count":9},{"language":"default","tag":"Videos","count":6},{"language":"default","tag":"Core Concepts","count":6},{"language":"default","tag":"Images","count":4},{"language":"default","tag":"Getting Started","count":3},{"language":"default","tag":"Avatars","count":1},{"language":"default","tag":"Overview","count":1},{"language":"default","tag":"Voices","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","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":"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},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/videos/create-land","slug":"/api-reference/videos/create-land","pageMetadata":{"title":"Create Land Transformation Video","api":"POST /v1/land","description":"Create an AI-powered cinematic video transforming an empty plot of land into proposed constructions","href":"/api-reference/videos/create-land"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create an AI-powered cinematic video transforming an empty plot of land into proposed constructions\"\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={a:`a`,code:`code`,em:`em`,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,Expandable,Heading,Info,Note,ParamField,ResponseField,Table,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Creates a new land transformation video from a single photo of an empty plot. The system progressively builds the land through chained transitions: raw terrain → marked buildable area → proposed constructions. Each transition is rendered as a cinematic morph, resulting in a fluid visualization of what the land could become.`}),`\n`,_jsxs(_components.p,{children:[`This endpoint is `,_jsx(_components.strong,{children:`progressive`}),` — only `,_jsx(_components.code,{children:`source_image_url`}),` and `,_jsx(_components.code,{children:`format`}),` are required. Everything else is optional and resolved server-side if omitted:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`No mask?`}),` The server auto-detects the buildable area via Gemini.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`No scenes?`}),` The server generates construction proposals based on terrain analysis.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`No script?`}),` The server auto-generates a narration script.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`When you provide pre-generated assets (`,_jsx(_components.code,{children:`scenes[]`}),`, `,_jsx(_components.code,{children:`script`}),`, `,_jsx(_components.code,{children:`mask_image_url`}),`), the server skips the corresponding generation steps. This avoids double-charging for assets you already created.`]}),`\n`,_jsx(Heading,{level:`2`,id:`request-body`,children:`Request Body`}),`\n`,_jsxs(ParamField,{body:`source_image_url`,type:`string`,required:true,id:`param-source-image-url`,children:[_jsx(_components.p,{children:`Publicly accessible URL of a single photo of an empty plot of land.`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Must be a valid HTTP(S) URL`}),`\n`,_jsx(_components.li,{children:`Must be an image file (JPEG, PNG, or WebP)`}),`\n`,_jsxs(_components.li,{children:[`Only `,_jsx(_components.strong,{children:`one`}),` image is accepted`]}),`\n`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`Every image URL in the request is fetched and validated before the task is created. Unreachable images fail with `,_jsx(_components.code,{children:`400 INVALID_IMAGE_URL`}),`, and images below the minimum resolution fail with `,_jsx(_components.code,{children:`400 IMAGE_RESOLUTION_TOO_LOW`}),`. VibePeak-hosted assets belonging to another account are rejected with `,_jsx(_components.code,{children:`403 ASSET_ACCESS_DENIED`}),`.`]})})]}),`\n`,_jsxs(ParamField,{body:`format`,type:`string`,required:true,id:`param-format`,children:[_jsx(_components.p,{children:`Target video format / aspect ratio.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`9:16`})}),_jsx(_components.td,{children:`Vertical video (portrait) — ideal for social media stories and reels`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`16:9`})}),_jsx(_components.td,{children:`Horizontal video (landscape) — ideal for websites and presentations`})]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`mask-\u0026-area-overrides`,children:`Mask \u0026 Area Overrides`}),`\n`,_jsxs(ParamField,{body:`mask_image_url`,type:`string`,id:`param-mask-image-url`,children:[_jsx(_components.p,{children:`Optional binary mask image (PNG) marking the buildable area with a neon outline and semi-transparent fill.`}),_jsxs(_components.p,{children:[`When provided, the server uses this mask directly and skips auto-detection. Takes precedence over `,_jsx(_components.code,{children:`area_polygon`}),`.`]}),_jsxs(_components.p,{children:[`Alias: `,_jsx(_components.code,{children:`mask_url`}),` is accepted and normalized to `,_jsx(_components.code,{children:`mask_image_url`}),`. If both are sent, `,_jsx(_components.code,{children:`mask_image_url`}),` wins.`]})]}),`\n`,_jsxs(ParamField,{body:`marked_image_url`,type:`string`,id:`param-marked-image-url`,children:[_jsxs(_components.p,{children:[`Optional pre-rendered `,_jsx(_components.strong,{children:`marked terrain`}),` image (the `,_jsx(_components.code,{children:`img1`}),` frame — the source photo with the buildable area already highlighted).`]}),_jsxs(_components.p,{children:[`When provided, the server skips the marking render entirely and uses this frame directly. Like `,_jsx(_components.code,{children:`mask_image_url`}),` and `,_jsx(_components.code,{children:`area_polygon`}),`, supplying it waives the 5-credit mask charge, and the task reports `,_jsx(_components.code,{children:`marking: \"mask\"`}),`.`]}),_jsxs(_components.p,{children:[`It takes precedence over both `,_jsx(_components.code,{children:`mask_image_url`}),` and `,_jsx(_components.code,{children:`area_polygon`}),`.`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`marked_image_url`}),` also changes how the frame count is calculated when you supply `,_jsx(_components.code,{children:`scenes[]`}),` — see `,_jsx(_components.a,{href:`#frame-limits`,children:`Frame Limits`}),`.`]})})]}),`\n`,_jsxs(ParamField,{body:`area_polygon`,type:`object[]`,id:`param-area-polygon`,children:[_jsx(_components.p,{children:`Optional polygon coordinates marking the buildable area. Minimum 3 points required.`}),_jsx(_components.p,{children:`Each point is an object with normalized coordinates:`}),_jsxs(Expandable,{title:`Point properties`,children:[_jsx(ParamField,{body:`x`,type:`number`,required:true,id:`param-x`,children:_jsx(_components.p,{children:`Normalized X coordinate between 0 and 1.`})}),_jsx(ParamField,{body:`y`,type:`number`,required:true,id:`param-y`,children:_jsx(_components.p,{children:`Normalized Y coordinate between 0 and 1.`})})]}),_jsxs(_components.p,{children:[`Alias: `,_jsx(_components.code,{children:`polygon`}),` is accepted and normalized to `,_jsx(_components.code,{children:`area_polygon`}),`.`]}),_jsxs(_components.p,{children:[`If none of `,_jsx(_components.code,{children:`mask_image_url`}),`, `,_jsx(_components.code,{children:`area_polygon`}),` or `,_jsx(_components.code,{children:`marked_image_url`}),` is provided, the server auto-detects the buildable area using Gemini vision analysis.`]})]}),`\n`,_jsx(Heading,{level:`3`,id:`terrain-\u0026-construction-overrides`,children:`Terrain \u0026 Construction Overrides`}),`\n`,_jsxs(ParamField,{body:`terrain_type`,type:`string`,id:`param-terrain-type`,children:[_jsxs(_components.p,{children:[`Optional terrain type hint, e.g. `,_jsx(_components.code,{children:`\"urban\"`}),`, `,_jsx(_components.code,{children:`\"rural\"`}),` or `,_jsx(_components.code,{children:`\"industrial\"`}),`.`]}),_jsx(_components.p,{children:`Any non-empty string is accepted — the value is a free-form hint passed to the proposal generator, not a closed enum. If omitted, the server analyzes the image and auto-detects the terrain type.`})]}),`\n`,_jsxs(ParamField,{body:`construction_prompts`,type:`string[]`,id:`param-construction-prompts`,children:[_jsx(_components.p,{children:`Optional array of construction prompts (1-8). One image is generated per prompt in the order provided.`}),_jsx(_components.p,{children:`When provided, the server skips proposal auto-generation and renders exactly these constructions. Each prompt is still billed as a generated scene.`}),_jsxs(_components.p,{children:[`Alias: `,_jsx(_components.code,{children:`prompts`}),` is accepted and normalized to `,_jsx(_components.code,{children:`construction_prompts`}),`.`]})]}),`\n`,_jsxs(ParamField,{body:`num_constructions`,type:`integer`,default:`3`,id:`param-num-constructions`,children:[_jsx(_components.p,{children:`Optional number of constructions to auto-generate (2-8). Default is 3.`}),_jsxs(_components.p,{children:[`Ignored if `,_jsx(_components.code,{children:`scenes`}),` or `,_jsx(_components.code,{children:`construction_prompts`}),` are provided.`]})]}),`\n`,_jsx(ParamField,{body:`style`,type:`string`,id:`param-style`,children:_jsxs(_components.p,{children:[`Optional style hint that biases auto-generated proposals (e.g., `,_jsx(_components.code,{children:`\"modern\"`}),`, `,_jsx(_components.code,{children:`\"rustic\"`}),`, `,_jsx(_components.code,{children:`\"minimalist\"`}),`).`]})}),`\n`,_jsx(ParamField,{body:`exclude`,type:`string`,id:`param-exclude`,children:_jsxs(_components.p,{children:[`Optional exclusion hint for auto-generated proposals (e.g., `,_jsx(_components.code,{children:`\"no swimming pools\"`}),`, `,_jsx(_components.code,{children:`\"no glass facades\"`}),`).`]})}),`\n`,_jsx(Heading,{level:`3`,id:`scene-chain-fully-resolved`,children:`Scene Chain (Fully Resolved)`}),`\n`,_jsxs(ParamField,{body:`scenes`,type:`object[]`,id:`param-scenes`,children:[_jsx(_components.p,{children:`Optional fully-resolved scene chain (1-8 items). When provided, the server skips scene generation and renders these frames directly.`}),_jsx(_components.p,{children:`Each scene is an object with:`}),_jsxs(Expandable,{title:`Scene properties`,children:[_jsx(ParamField,{body:`image_url`,type:`string`,id:`param-image-url`,children:_jsx(_components.p,{children:`Publicly accessible URL of the scene image. Optional at the schema level, but a scene without an image cannot be rendered — always send it when supplying a resolved chain.`})}),_jsx(ParamField,{body:`prompt`,type:`string`,id:`param-prompt`,children:_jsx(_components.p,{children:`Optional prompt that generated this scene.`})}),_jsx(ParamField,{body:`order`,type:`integer`,id:`param-order`,children:_jsxs(_components.p,{children:[`Optional display order within the chain. `,_jsx(_components.strong,{children:`Must be 1 or greater`}),` — `,_jsx(_components.code,{children:`0`}),` is rejected with `,_jsx(_components.code,{children:`400 VALIDATION_ERROR`}),`.`]})}),_jsxs(ParamField,{body:`camera_movement`,type:`string`,id:`param-camera-movement`,children:[_jsx(_components.p,{children:`Optional per-scene camera movement applied by the WAN renderer.`}),_jsxs(_components.p,{children:[`One of `,_jsx(_components.code,{children:`traveling_left`}),`, `,_jsx(_components.code,{children:`traveling_right`}),`, `,_jsx(_components.code,{children:`traveling_up`}),`, `,_jsx(_components.code,{children:`traveling_down`}),`, `,_jsx(_components.code,{children:`dolly_in`}),`, `,_jsx(_components.code,{children:`dolly_out`}),`, `,_jsx(_components.code,{children:`arc_left`}),`, `,_jsx(_components.code,{children:`arc_right`}),`. Omitted means the renderer picks the movement.`]})]})]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[`Providing `,_jsx(_components.code,{children:`scenes[]`}),` is the recommended path for first-party callers (like the VibePeak web app) that have already generated images interactively. This ensures you are only charged the base render cost (15 credits) and avoids double-charging for generated assets.`]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`script-voice-\u0026-music-overrides`,children:`Script, Voice \u0026 Music Overrides`}),`\n`,_jsxs(ParamField,{body:`script`,type:`string`,id:`param-script`,children:[_jsx(_components.p,{children:`Optional narration script for text-to-speech. Any non-empty string is accepted.`}),_jsx(Note,{children:_jsxs(_components.p,{children:[`Unlike the `,_jsx(_components.a,{href:`/api-reference/videos/create-narrated-slideshow`,children:`narrated slideshow`}),` and real-estate endpoints, `,_jsx(_components.code,{children:`/v1/land`}),` does `,_jsx(_components.strong,{children:`not`}),` enforce a character-count range or reject digits and symbols. For natural pacing aim for roughly 65-85 characters per scene, but this is guidance, not validation.`]})})]}),`\n`,_jsx(ParamField,{body:`language`,type:`string`,id:`param-language`,children:_jsxs(_components.p,{children:[`Language code for the auto-generated script and TTS pronunciation (e.g., `,_jsx(_components.code,{children:`en`}),`, `,_jsx(_components.code,{children:`es`}),`, `,_jsx(_components.code,{children:`de`}),`, `,_jsx(_components.code,{children:`fr`}),`, `,_jsx(_components.code,{children:`pt`}),`). Minimum 2 characters.`]})}),`\n`,_jsxs(ParamField,{body:`voice_id`,type:`string`,id:`param-voice-id`,children:[_jsxs(_components.p,{children:[`Voice ID for narration. You can find available voices using the `,_jsx(_components.a,{href:`/api-reference/voices/list-voices`,children:`List Voices`}),` endpoint.`]}),_jsx(_components.p,{children:`Defaults to a platform voice if omitted.`})]}),`\n`,_jsx(ParamField,{body:`voice_speed`,type:`number`,default:`1`,id:`param-voice-speed`,children:_jsxs(_components.p,{children:[`Speaking rate of the synthesized voiceover. Values below `,_jsx(_components.code,{children:`1`}),` slow it down, above `,_jsx(_components.code,{children:`1`}),` speed it up. The effect depends on the voice and language: most voices follow the value closely, some apply it only partially, and each voice applies its own supported range within these bounds. Range: `,_jsx(_components.code,{children:`0.5`}),` to `,_jsx(_components.code,{children:`2`}),`; values outside it are rejected with a validation error. Applies only when VibePeak synthesizes the voiceover, so it has no effect when `,_jsx(_components.code,{children:`voiceover_enabled`}),` is `,_jsx(_components.code,{children:`false`}),`.`]})}),`\n`,_jsxs(ParamField,{body:`voiceover_enabled`,type:`boolean`,id:`param-voiceover-enabled`,children:[_jsxs(_components.p,{children:[`Set to `,_jsx(_components.code,{children:`false`}),` to render the video without narration. When `,_jsx(_components.code,{children:`false`}),`, the server skips text-to-speech entirely and `,_jsx(_components.code,{children:`script`}),` / `,_jsx(_components.code,{children:`voice_id`}),` may be omitted.`]}),_jsxs(_components.p,{children:[`Omitting this field leaves narration `,_jsx(_components.strong,{children:`on`}),`.`]})]}),`\n`,_jsx(ParamField,{body:`background_music`,type:`boolean`,id:`param-background-music`,children:_jsxs(_components.p,{children:[`Set to `,_jsx(_components.code,{children:`true`}),` to add a background music bed. Omitting this field, or sending `,_jsx(_components.code,{children:`false`}),`, renders the video without music.`]})}),`\n`,_jsxs(ParamField,{body:`music_id`,type:`string`,id:`param-music-id`,children:[_jsxs(_components.p,{children:[`Optional Music Library track to pin, as a `,_jsx(_components.strong,{children:`UUID`}),`. Without it, a `,_jsx(_components.code,{children:`background_music: true`}),` job uses a randomly selected bed.`]}),_jsxs(Warning,{children:[_jsxs(_components.p,{children:[_jsx(_components.code,{children:`music_id`}),` and `,_jsx(_components.code,{children:`music_kind`}),` must be sent `,_jsx(_components.strong,{children:`together`}),` — sending one without the other fails with `,_jsx(_components.code,{children:`400 VALIDATION_ERROR`}),` (`,_jsx(_components.code,{children:`music_id and music_kind must be provided together`}),`). A non-UUID value fails with `,_jsx(_components.code,{children:`music_id must be a valid UUID`}),`.`]}),_jsxs(_components.p,{children:[`Both fields are only honored when `,_jsx(_components.code,{children:`background_music`}),` is `,_jsx(_components.code,{children:`true`}),`; with music off the video stays silent regardless.`]})]})]}),`\n`,_jsx(ParamField,{body:`music_kind`,type:`string`,id:`param-music-kind`,children:_jsxs(_components.p,{children:[`Which catalogue `,_jsx(_components.code,{children:`music_id`}),` refers to: `,_jsx(_components.code,{children:`stock`}),` (Music Library track) or `,_jsx(_components.code,{children:`ai`}),` (AI-generated track). Required whenever `,_jsx(_components.code,{children:`music_id`}),` is present.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`subtitle-\u0026-elements-configuration`,children:`Subtitle \u0026 Elements Configuration`}),`\n`,_jsxs(ParamField,{body:`subtitle_config`,type:`object`,id:`param-subtitle-config`,children:[_jsxs(_components.p,{children:[`Subtitle configuration for word-level animated overlays. Same structure as other video endpoints — see `,_jsx(_components.a,{href:`/api-reference/videos/create-narrated-slideshow`,children:`Create Narrated Slideshow`}),` for the full field list.`]}),_jsx(_components.p,{children:`On this endpoint the object is passed through to the renderer without field-level validation, so a malformed key is accepted at request time and simply ignored downstream.`})]}),`\n`,_jsxs(ParamField,{body:`elements_config`,type:`object`,id:`param-elements-config`,children:[_jsxs(_components.p,{children:[`Configuration for visual elements and branding overlays (watermark, text, intro/outro). Same structure as other video endpoints — see `,_jsx(_components.a,{href:`/api-reference/videos/create-narrated-slideshow`,children:`Create Narrated Slideshow`}),`.`]}),_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`intro_outro`}),` block is fully validated; the rest is passed through to the renderer. Browse the designs in the `,_jsx(_components.a,{href:`/api-reference/videos/intro-outro-templates`,children:`template gallery`}),`, or read the catalogue from `,_jsx(_components.a,{href:`/api-reference/videos/list-intro-outro-templates`,children:_jsx(_components.code,{children:`GET /v1/intro-outro/templates`})}),`.`]}),_jsxs(_components.p,{children:[`As on `,_jsx(_components.a,{href:`/api-reference/videos/create-narrated-slideshow`,children:`Create Narrated Slideshow`}),`, the overlays are applied `,_jsx(_components.strong,{children:`after`}),` the video renders. The task passes through the transitional `,_jsx(_components.code,{children:`intro_outro`}),` status while that runs, and if the overlays cannot be applied the task still completes: the video is delivered without them and the result carries an `,_jsx(_components.code,{children:`intro_outro_warning`}),`.`]}),_jsxs(Note,{children:[_jsxs(_components.p,{children:[`Unlike the real-estate and narrated-slideshow endpoints, `,_jsx(_components.code,{children:`/v1/land`}),` does `,_jsx(_components.strong,{children:`not`}),` pre-validate the watermark URL at request time, so it never returns `,_jsx(_components.code,{children:`INVALID_WATERMARK_URL`}),`. An unreachable watermark surfaces later as a render failure. Verify the URL before submitting.`]}),_jsxs(_components.p,{children:[`The watermark’s `,_jsx(_components.strong,{children:`geometry`}),` is the exception: it `,_jsx(_components.em,{children:`is`}),` checked at request time here, exactly as on the other endpoints. When a watermark URL is present and branding is enabled, a `,_jsx(_components.code,{children:`size`}),` below 2 (`,_jsx(_components.code,{children:`single`}),` mode only) or an `,_jsx(_components.code,{children:`opacity`}),` below 5 is rejected with `,_jsx(_components.code,{children:`400 INVALID_WATERMARK_GEOMETRY`}),` before any credits are charged.`]}),_jsxs(_components.p,{children:[`A `,_jsx(_components.code,{children:`size`}),` or `,_jsx(_components.code,{children:`opacity`}),` that is `,_jsx(_components.strong,{children:`not a finite number`}),` is rejected the same way. This matters more here than elsewhere: `,_jsx(_components.code,{children:`/v1/land`}),` validates only the `,_jsx(_components.code,{children:`intro_outro`}),` block of `,_jsx(_components.code,{children:`elements_config`}),` and passes the rest through, so a string such as `,_jsx(_components.code,{children:`\"20\"`}),` reaches the floor intact and is refused, where the real-estate and narrated-slideshow endpoints would have rejected it earlier as a `,_jsx(_components.code,{children:`VALIDATION_ERROR`}),`. Send numbers, not numeric strings.`]}),_jsxs(_components.p,{children:[`Omitting `,_jsx(_components.code,{children:`size`}),` or `,_jsx(_components.code,{children:`opacity`}),` is always fine — the renderer’s own defaults (20 and 100) apply, and an absent or `,_jsx(_components.code,{children:`null`}),` value is never rejected.`]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`webhook`,children:`Webhook`}),`\n`,_jsxs(ParamField,{body:`webhook_url`,type:`string`,id:`param-webhook-url`,children:[_jsx(_components.p,{children:`HTTPS URL to receive a webhook notification when the task completes or fails.`}),_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/concepts/webhooks`,children:`Webhooks`}),` for payload format and verification details.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`Webhook URLs must use HTTPS and cannot point to private/internal networks (SSRF protection). A rejected URL fails with `,_jsx(_components.code,{children:`400 INVALID_WEBHOOK_URL`}),`.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`Returns a `,_jsx(_components.code,{children:`202 Accepted`}),` response. Unlike other video endpoints, land tasks start in the `,_jsx(_components.code,{children:`preparing`}),` state while the server resolves inputs (auto-detecting the mask, generating scenes, creating the script), and they report credits under `,_jsx(_components.code,{children:`charged_credits`}),` with a `,_jsx(_components.code,{children:`resolution`}),` object.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Land responses are deliberately shaped differently from other video endpoints.`}),` Land tasks use `,_jsx(_components.code,{children:`charged_credits`}),` and a `,_jsx(_components.code,{children:`resolution`}),` object; every other task type uses `,_jsx(_components.code,{children:`credits_charged`}),` and has no `,_jsx(_components.code,{children:`resolution`}),`. If you share response-parsing code across endpoints, handle both key names.`]})}),`\n`,_jsxs(ResponseField,{name:`task_id`,type:`string`,required:true,id:`param-task-id`,children:[_jsxs(_components.p,{children:[`Unique identifier for the task, in the form `,_jsx(_components.code,{children:`task_\u003cid>`}),`. Use this to poll for status via `,_jsx(_components.a,{href:`/api-reference/videos/get-task`,children:`Get Task`}),`.`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`task_id`}),` sent in the `,_jsx(_components.strong,{children:`webhook`}),` payload is a different identifier (`,_jsx(_components.code,{children:`vp_land_\u003cid>`}),`, the task’s external id). Correlate webhooks by storing both, or by matching on your own reference — do not assume the webhook `,_jsx(_components.code,{children:`task_id`}),` can be passed to `,_jsx(_components.code,{children:`GET /v1/tasks/{id}`}),`.`]})})]}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,required:true,id:`param-status`,children:_jsxs(_components.p,{children:[`Initial task status. Always `,_jsx(_components.code,{children:`preparing`}),` for land tasks.`]})}),`\n`,_jsx(ResponseField,{name:`message`,type:`string`,required:true,id:`param-message`,children:_jsxs(_components.p,{children:[`Human-readable acknowledgement — `,_jsx(_components.code,{children:`\"Land transformation request accepted\"`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`created_at`,type:`string`,required:true,id:`param-created-at`,children:_jsx(_components.p,{children:`ISO 8601 timestamp of task creation.`})}),`\n`,_jsx(ResponseField,{name:`livemode`,type:`boolean`,required:true,id:`param-livemode`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` for live keys. Requests made with a `,_jsx(_components.code,{children:`vpk_test_`}),` key return `,_jsx(_components.code,{children:`false`}),` and are not charged — see `,_jsx(_components.a,{href:`/concepts/test-mode`,children:`Test Mode`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`request_id`,type:`string`,required:true,id:`param-request-id`,children:_jsx(_components.p,{children:`Request identifier, useful when contacting support.`})}),`\n`,_jsx(ResponseField,{name:`charged_credits`,type:`integer`,required:true,id:`param-charged-credits`,children:_jsxs(_components.p,{children:[`Credits actually deducted for this request. See `,_jsx(_components.a,{href:`#credit-model`,children:`Credit Model`}),` for the breakdown.`]})}),`\n`,_jsxs(ResponseField,{name:`resolution`,type:`object`,id:`param-resolution`,children:[_jsx(_components.p,{children:`Preparation metadata describing what the server will compute.`}),_jsxs(Expandable,{title:`Resolution properties`,children:[_jsx(ResponseField,{name:`stage`,type:`string`,id:`param-stage`,children:_jsxs(_components.p,{children:[`Current preparation stage — always `,_jsx(_components.code,{children:`\"preparing\"`}),` at creation.`]})}),_jsx(ResponseField,{name:`progress`,type:`integer`,id:`param-progress`,children:_jsx(_components.p,{children:`Preparation progress percentage (0-100). Starts at 10.`})}),_jsx(ResponseField,{name:`used_overrides`,type:`string[]`,id:`param-used-overrides`,children:_jsxs(_components.p,{children:[`The request fields you supplied that overrode server-side generation, in canonical order. An explicit `,_jsx(_components.code,{children:`background_music: false`}),` counts as an override; an omitted field does not.`]})}),_jsxs(ResponseField,{name:`credits_breakdown`,type:`object`,id:`param-credits-breakdown`,children:[_jsx(_components.p,{children:`Detailed credit cost breakdown.`}),_jsxs(Expandable,{title:`Credits breakdown properties`,children:[_jsx(ResponseField,{name:`base_render`,type:`integer`,id:`param-base-render`,children:_jsx(_components.p,{children:`Base render cost (15 credits).`})}),_jsx(ResponseField,{name:`generated_mask`,type:`integer`,id:`param-generated-mask`,children:_jsxs(_components.p,{children:[`Cost for a server-generated mask (5 credits) — 0 if `,_jsx(_components.code,{children:`mask_image_url`}),`, `,_jsx(_components.code,{children:`area_polygon`}),` or `,_jsx(_components.code,{children:`marked_image_url`}),` is provided.`]})}),_jsx(ResponseField,{name:`generated_scene_count`,type:`integer`,id:`param-generated-scene-count`,children:_jsx(_components.p,{children:`Number of scenes the server will generate.`})}),_jsx(ResponseField,{name:`generated_scenes`,type:`integer`,id:`param-generated-scenes`,children:_jsx(_components.p,{children:`Total cost for generated scenes (5 credits each).`})}),_jsx(ResponseField,{name:`generated_script`,type:`integer`,id:`param-generated-script`,children:_jsxs(_components.p,{children:[`Cost for a server-generated script (5 credits) — 0 if `,_jsx(_components.code,{children:`script`}),` is provided.`]})}),_jsx(ResponseField,{name:`total`,type:`integer`,id:`param-total`,children:_jsx(_components.p,{children:`Total credits charged.`})})]})]})]})]}),`\n`,_jsx(ResponseField,{name:`_links`,type:`object`,id:`param-links`,children:_jsxs(_components.p,{children:[`Convenience links: `,_jsx(_components.code,{children:`self`}),` (the poll URL) and `,_jsx(_components.code,{children:`poll_interval_seconds`}),`.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`response-headers`,children:`Response Headers`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Header`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Location`})}),_jsxs(_components.td,{children:[`URL to poll for task status (`,_jsx(_components.code,{children:`/v1/tasks/{task_id}`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Retry-After`})}),_jsx(_components.td,{children:`Recommended polling interval in seconds (30)`})]})]})]}),`\n`,`\n`,`\n`,_jsx(Heading,{level:`2`,id:`credit-model`,children:`Credit Model`}),`\n`,_jsxs(_components.p,{children:[`Land transformation videos use a `,_jsx(_components.strong,{children:`differentiated credit model`}),` based on the work the server performs:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Component`}),_jsx(_components.th,{children:`Credits`}),_jsx(_components.th,{children:`Condition`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Base render`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`15`}),_jsx(_components.td,{children:`Always charged`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Generated mask`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`5`}),_jsxs(_components.td,{children:[`Charged if you do `,_jsx(_components.strong,{children:`not`}),` provide `,_jsx(_components.code,{children:`mask_image_url`}),`, `,_jsx(_components.code,{children:`area_polygon`}),` or `,_jsx(_components.code,{children:`marked_image_url`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Generated scenes`}),_jsx(_components.td,{children:`5 per scene`}),_jsxs(_components.td,{children:[`Charged for each scene the server generates (not for pre-provided `,_jsx(_components.code,{children:`scenes[]`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Generated script`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`5`}),_jsxs(_components.td,{children:[`Charged if you do `,_jsx(_components.strong,{children:`not`}),` provide `,_jsx(_components.code,{children:`script`}),` and narration is on. Never charged when `,_jsx(_components.code,{children:`voiceover_enabled`}),` is `,_jsx(_components.code,{children:`false`}),` — no script is written for a video without narration`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`When `,_jsx(_components.code,{children:`scenes[]`}),` is absent, the number of generated scenes is `,_jsx(_components.code,{children:`construction_prompts.length`}),`, else `,_jsx(_components.code,{children:`num_constructions`}),`, else 3.`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Example costs:`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Scenario`}),_jsx(_components.th,{children:`Calculation`}),_jsx(_components.th,{children:`Total`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Minimal (1 image, auto everything)`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`15 + 5 + 15 + 5`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.strong,{children:`40`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`With mask, auto scenes + script`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`15 + 0 + 15 + 5`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.strong,{children:`35`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`With mask + 5 construction prompts`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`15 + 0 + 25 + 5`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.strong,{children:`45`})})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Fully resolved (`,_jsx(_components.code,{children:`scenes[]`}),` + `,_jsx(_components.code,{children:`script`}),` + marked frame)`]}),_jsx(_components.td,{\"data-numeric\":`true`,children:`15 + 0 + 0 + 0`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.strong,{children:`15`})})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`No narration (`,_jsx(_components.code,{children:`scenes[]`}),` + marked frame + `,_jsx(_components.code,{children:`voiceover_enabled: false`}),`)`]}),_jsx(_components.td,{\"data-numeric\":`true`,children:`15 + 0 + 0 + 0`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.strong,{children:`15`})})]})]})]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Assets you pre-provide (`,_jsx(_components.code,{children:`scenes[]`}),`, `,_jsx(_components.code,{children:`script`}),`, `,_jsx(_components.code,{children:`mask_image_url`}),`, `,_jsx(_components.code,{children:`marked_image_url`}),`) are `,_jsx(_components.strong,{children:`never regenerated`}),` and `,_jsx(_components.strong,{children:`never re-charged`}),`. This prevents double-charging for first-party callers that already generated images interactively.`]})}),`\n`,_jsxs(_components.p,{children:[`Credits are deducted at creation time. If the job later fails, the credits are `,_jsx(_components.strong,{children:`refunded automatically`}),` — the webhook’s `,_jsx(_components.code,{children:`charged_credits`}),` reflects the post-refund amount (typically `,_jsx(_components.code,{children:`0`}),`).`]}),`\n`,_jsxs(_components.p,{children:[`If a task that failed with `,_jsx(_components.code,{children:`GENERATION_TIMEOUT`}),` later completes (see `,_jsx(_components.a,{href:`#polling`,children:`Polling`}),`), the refund stands and nothing is charged again. The `,_jsx(_components.code,{children:`task.completed`}),` webhook still reports the original price in `,_jsx(_components.code,{children:`charged_credits`}),`; treat the earlier `,_jsx(_components.code,{children:`task.failed`}),` webhook as the billing record for that task.`]}),`\n`,_jsx(Heading,{level:`2`,id:`plan-access`,children:`Plan Access`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Plan`}),_jsx(_components.th,{children:`API Access`}),_jsx(_components.th,{children:`Concurrent Tasks`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Free`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`—`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Starter`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`—`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Plus`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Pro`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`3`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Max`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`5`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Enterprise`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Custom`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`frame-limits`,children:`Frame Limits`}),`\n`,_jsxs(_components.p,{children:[`The video chain must contain `,_jsx(_components.strong,{children:`3 to 10 total frames`}),`. How the count is derived depends on whether you supply `,_jsx(_components.code,{children:`scenes[]`}),`:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`Without `,_jsx(_components.code,{children:`scenes[]`})]}),` — the count is `,_jsx(_components.code,{children:`2 + n`}),`, where `,_jsx(_components.code,{children:`n`}),` is `,_jsx(_components.code,{children:`construction_prompts.length`}),`, else `,_jsx(_components.code,{children:`num_constructions`}),`, else 3. The two implied frames are `,_jsx(_components.code,{children:`img0`}),` (original terrain) and `,_jsx(_components.code,{children:`img1`}),` (marked terrain).`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`With `,_jsx(_components.code,{children:`scenes[]`})]}),` — the count is `,_jsx(_components.code,{children:`1 + (marked_image_url ? 1 : 0) + scenes.length`}),`. `,_jsx(_components.code,{children:`img1`}),` is only counted when you actually supply `,_jsx(_components.code,{children:`marked_image_url`}),`.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`A resolved chain of 3 scenes with `,_jsx(_components.strong,{children:`no`}),` `,_jsx(_components.code,{children:`marked_image_url`}),` counts as 4 frames, not 5. If you are supplying a chain that already includes the marked frame as its first scene, do not also send `,_jsx(_components.code,{children:`marked_image_url`}),` — you would count it twice.`]})}),`\n`,_jsxs(_components.p,{children:[`Requests outside the 3-10 range fail with `,_jsx(_components.code,{children:`400 VALIDATION_ERROR`}),` on the `,_jsx(_components.code,{children:`scenes`}),` field.`]}),`\n`,_jsx(Heading,{level:`2`,id:`polling`,children:`Polling`}),`\n`,_jsxs(_components.p,{children:[`Land tasks flow through `,_jsx(_components.code,{children:`preparing`}),` → `,_jsx(_components.code,{children:`queued`}),` → `,_jsx(_components.code,{children:`processing`}),` → `,_jsx(_components.code,{children:`completed`}),` or `,_jsx(_components.code,{children:`failed`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`If the request asked for post-processing, the task also reports a transitional status between `,_jsx(_components.code,{children:`processing`}),` and its final state, in this order: `,_jsx(_components.code,{children:`watermarking`}),`, `,_jsx(_components.code,{children:`intro_outro`}),`, `,_jsx(_components.code,{children:`subtitling`}),`. Each appears only when the corresponding feature was requested. Treat all three like `,_jsx(_components.code,{children:`processing`}),` and keep polling — the task always ends in `,_jsx(_components.code,{children:`completed`}),` or `,_jsx(_components.code,{children:`failed`}),`. A step that cannot finish does not fail the task: the video is delivered without that refinement and `,_jsx(_components.code,{children:`result`}),` carries a matching `,_jsx(_components.code,{children:`watermark_warning`}),`, `,_jsx(_components.code,{children:`intro_outro_warning`}),` or `,_jsx(_components.code,{children:`subtitle_warning`}),`. See `,_jsx(_components.a,{href:`/concepts/async-processing`,children:`Asynchronous Processing`}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`GENERATION_TIMEOUT`}),` is the one failure that is not always final. It fires when the render is still running `,_jsx(_components.strong,{children:`180 minutes`}),` after the task was created. If that render finishes afterwards — VibePeak keeps checking for 48 hours after creation — the task moves from `,_jsx(_components.code,{children:`failed`}),` to `,_jsx(_components.code,{children:`completed`}),`, `,_jsx(_components.code,{children:`result.video_url`}),` is filled in, and a `,_jsx(_components.code,{children:`task.completed`}),` webhook follows the earlier `,_jsx(_components.code,{children:`task.failed`}),` one for the same `,_jsx(_components.code,{children:`task_id`}),`. Treat that later `,_jsx(_components.code,{children:`task.completed`}),` as the final outcome. Past the 24-hour expiry the task can no longer be polled, so a completion that late reaches you only by webhook. No other failure code changes afterwards, and a task never sends two `,_jsx(_components.code,{children:`task.completed`}),` webhooks.`]})}),`\n`,_jsxs(_components.p,{children:[`While in `,_jsx(_components.code,{children:`preparing`}),`, `,_jsx(_components.code,{children:`GET /v1/tasks/{task_id}`}),` returns a `,_jsx(_components.code,{children:`resolution`}),` object that advances through these stages:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Stage`}),_jsx(_components.th,{children:`Progress`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`preparing`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`10`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`marking_resolved`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`35`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`terrain_resolved`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`50`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`scenes_resolved`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`70`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`script_resolved`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`85`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`resolved`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`100`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Not every task passes through every stage. Supplying `,_jsx(_components.code,{children:`marked_image_url`}),` or `,_jsx(_components.code,{children:`mask_image_url`}),` resolves marking synchronously, so a fully-resolved request skips the intermediate stages and reports `,_jsx(_components.code,{children:`resolved`}),` / 100 on the first poll. Treat the ladder as monotonic but sparse — do not wait for a specific stage to appear.`]}),`\n`,_jsxs(_components.p,{children:[`Once marking is decided, the `,_jsx(_components.code,{children:`resolution`}),` object also carries `,_jsx(_components.code,{children:`marking`}),`, `,_jsx(_components.code,{children:`generated_image_count`}),` and `,_jsx(_components.code,{children:`used_overrides`}),`. It also carries `,_jsx(_components.code,{children:`resolved_inputs`}),` — a whitelisted view of what the server actually resolved (`,_jsx(_components.code,{children:`source_image_url`}),`, `,_jsx(_components.code,{children:`format`}),`, `,_jsx(_components.code,{children:`mask_image_url`}),`, `,_jsx(_components.code,{children:`area_polygon`}),`, `,_jsx(_components.code,{children:`terrain_type`}),`, `,_jsx(_components.code,{children:`scenes`}),`, `,_jsx(_components.code,{children:`construction_prompts`}),`, `,_jsx(_components.code,{children:`script`}),`), which is how you retrieve the generated scene image URLs and the auto-written script. When `,_jsx(_components.code,{children:`voiceover_enabled`}),` is `,_jsx(_components.code,{children:`false`}),` and you sent no `,_jsx(_components.code,{children:`script`}),`, `,_jsx(_components.code,{children:`resolved_inputs.script`}),` is an empty string. Your `,_jsx(_components.code,{children:`webhook_url`}),` and other request fields are deliberately not echoed back. `,_jsx(_components.code,{children:`generated_image_count`}),` counts server-generated scene images plus one for an auto-generated mask, and stays `,_jsx(_components.code,{children:`0`}),` for a fully-resolved request. On land tasks the GET response uses `,_jsx(_components.code,{children:`charged_credits`}),`; other task types use `,_jsx(_components.code,{children:`credits_charged`}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Tasks expire `,_jsx(_components.strong,{children:`24 hours`}),` after creation. After that, `,_jsx(_components.code,{children:`GET /v1/tasks/{task_id}`}),` returns `,_jsx(_components.code,{children:`404 TASK_EXPIRED`}),` and the video URL is no longer retrievable — download the result before then.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`webhook-payload`,children:`Webhook Payload`}),`\n`,_jsxs(_components.p,{children:[`When the task completes or fails, a POST request is sent to your `,_jsx(_components.code,{children:`webhook_url`}),`. See `,_jsx(_components.a,{href:`/concepts/webhooks`,children:`Webhooks`}),` for verification.`]}),`\n`,_jsx(Heading,{level:`3`,id:`webhook-headers`,children:`Webhook Headers`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Header`}),_jsx(_components.th,{children:`Value`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`X-VibePeak-Event`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`task.completed`}),` or `,_jsx(_components.code,{children:`task.failed`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`X-VibePeak-Signature`})}),_jsx(_components.td,{children:`HMAC-SHA256, hex encoded`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`X-VibePeak-Timestamp`})}),_jsx(_components.td,{children:`Unix timestamp in seconds`})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The signed message is `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`{timestamp}.{raw body}`})}),`, not the body alone. Concatenate the `,_jsx(_components.code,{children:`X-VibePeak-Timestamp`}),` value, a literal `,_jsx(_components.code,{children:`.`}),`, and the exact raw request body before computing the HMAC, or verification will fail.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The event name lives in the `,_jsx(_components.code,{children:`X-VibePeak-Event`}),` `,_jsx(_components.strong,{children:`header`}),`, not in the body. There is no `,_jsx(_components.code,{children:`event`}),` field inside the JSON.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`payload`,children:`Payload`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`14`,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:`14`,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:` \"task_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"vp_land_gXATHu1cGcD9Ht9s5-19I\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"completed\"`}),_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:` \"result\"`}),_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:` \"video_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://\u003cproject>.supabase.co/storage/v1/object/public/vibepeak/\u003cuser-id>/projects/land/\u003cproject-id>/final-1788179592692.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:` \"cover_image_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://storage.googleapis.com/vibepeak-api-images/covers/task_yo9RC7ZrE9YuFx4yXbg4N.jpg\"`})]}),`\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:` \"charged_credits\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`15`}),_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:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"marking\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"mask\"`}),_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:` \"used_overrides\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"marked_image_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"scenes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"script\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"language\"`}),_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:` \"generated_image_count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`For failed tasks:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`14`,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:`14`,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:` \"task_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"vp_land_gXATHu1cGcD9Ht9s5-19I\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"failed\"`}),_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:` \"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"GENERATION_FAILED\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Land generation failed\"`})]}),`\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:` \"charged_credits\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_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:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"marking\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"auto\"`}),_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:` \"generated_image_count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`4`}),_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:` \"used_overrides\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: []`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The webhook `,_jsx(_components.code,{children:`task_id`}),` is the task’s `,_jsx(_components.strong,{children:`external id`}),` (`,_jsx(_components.code,{children:`vp_land_\u003cid>`}),`), which is `,_jsx(_components.strong,{children:`not`}),` the `,_jsx(_components.code,{children:`task_id`}),` returned by `,_jsx(_components.code,{children:`POST /v1/land`}),` (`,_jsx(_components.code,{children:`task_\u003cid>`}),`) and cannot be passed to `,_jsx(_components.code,{children:`GET /v1/tasks/{id}`}),`. Store the value returned at creation and correlate on your side.`]})}),`\n`,_jsx(_components.p,{children:`Notes on the payload:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`resolution`}),` is the `,_jsx(_components.strong,{children:`typed`}),` shape only — `,_jsx(_components.code,{children:`marking`}),`, `,_jsx(_components.code,{children:`generated_image_count`}),`, `,_jsx(_components.code,{children:`used_overrides`}),`. It does `,_jsx(_components.strong,{children:`not`}),` include `,_jsx(_components.code,{children:`stage`}),`, `,_jsx(_components.code,{children:`progress`}),` or `,_jsx(_components.code,{children:`credits_breakdown`}),`; those appear only on the polling response.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`resolution`}),` is omitted entirely if marking was never resolved (for example, a failure during preparation).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`result`}),` carries `,_jsx(_components.strong,{children:`only`}),` `,_jsx(_components.code,{children:`video_url`}),` and `,_jsx(_components.code,{children:`cover_image_url`}),`. There is no `,_jsx(_components.code,{children:`duration_seconds`}),`, `,_jsx(_components.code,{children:`resolution`}),` or `,_jsx(_components.code,{children:`expires_at`}),` inside `,_jsx(_components.code,{children:`result`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`cover_image_url`}),` is present only if cover generation succeeded. Note that it is keyed by the internal `,_jsx(_components.code,{children:`task_\u003cid>`}),`, while the payload’s `,_jsx(_components.code,{children:`task_id`}),` is the `,_jsx(_components.code,{children:`vp_land_\u003cid>`}),` external id.`]}),`\n`,_jsxs(_components.li,{children:[`There is no `,_jsx(_components.code,{children:`event`}),`, `,_jsx(_components.code,{children:`type`}),` or `,_jsx(_components.code,{children:`timestamp`}),` field in the body. Distinguish outcomes with `,_jsx(_components.code,{children:`status`}),`, or read the `,_jsx(_components.code,{children:`X-VibePeak-Event`}),` header.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`marking`}),` field indicates which method was used to identify the buildable area:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`mask`})}),_jsxs(_components.td,{children:[`A pre-provided `,_jsx(_components.code,{children:`marked_image_url`}),` `,_jsx(_components.strong,{children:`or`}),` `,_jsx(_components.code,{children:`mask_image_url`}),` was used. `,_jsx(_components.code,{children:`marked_image_url`}),` takes precedence when both are sent.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`polygon`})}),_jsxs(_components.td,{children:[`A pre-provided `,_jsx(_components.code,{children:`area_polygon`}),` was rasterized into a mask`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`auto`})}),_jsx(_components.td,{children:`Gemini auto-detected the buildable area`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`fullimage`})}),_jsx(_components.td,{children:`Reserved. Present in the type contract but not currently emitted by any code path — do not branch on it.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`error-codes`,children:`Error Codes`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`VALIDATION_ERROR`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsxs(_components.td,{children:[`Invalid request parameters, frame count outside 3-10, `,_jsx(_components.code,{children:`order`}),` below 1, or `,_jsx(_components.code,{children:`music_id`}),`/`,_jsx(_components.code,{children:`music_kind`}),` not sent together`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_IMAGE_URL`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:`An image URL is unreachable, not an image, or too large`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`IMAGE_RESOLUTION_TOO_LOW`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:`An image is below the minimum resolution`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_WEBHOOK_URL`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:`Webhook URL failed SSRF validation`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_WATERMARK_GEOMETRY`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsxs(_components.td,{children:[`The `,_jsx(_components.code,{children:`elements_config`}),` watermark is enabled but too small or too faint to render (`,_jsx(_components.code,{children:`size`}),` ≥ 2 and `,_jsx(_components.code,{children:`opacity`}),` ≥ 5; `,_jsx(_components.code,{children:`size`}),` is not checked when `,_jsx(_components.code,{children:`mode`}),` is `,_jsx(_components.code,{children:`mosaic`}),`). No credits are charged`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_API_KEY`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:`Invalid or missing API key`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`INSUFFICIENT_CREDITS`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`402`}),_jsx(_components.td,{children:`Not enough credits to process the request`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ASSET_ACCESS_DENIED`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:`A VibePeak-hosted image URL belongs to another account`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`PLAN_REQUIRED`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:`Plan doesn’t include API access`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`CONCURRENCY_LIMIT_EXCEEDED`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:`Concurrent task limit reached`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`SERVICE_UNAVAILABLE`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`503`}),_jsx(_components.td,{children:`The job could not be enqueued; credits are refunded automatically`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Asynchronous failures are reported through the task’s `,_jsx(_components.code,{children:`error`}),` object and the failure webhook:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GENERATION_FAILED`})}),_jsx(_components.td,{children:`The land render failed downstream`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GENERATION_TIMEOUT`})}),_jsxs(_components.td,{children:[`The render was still running 180 minutes after the task was created. Credits are refunded. If the render finishes later, the task can still become `,_jsx(_components.code,{children:`completed`}),` — see `,_jsx(_components.a,{href:`#polling`,children:`Polling`})]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/concepts/error-handling`,children:`Error Handling`}),` for more details.`]}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next Steps`}),`\n`,_jsx(_components.p,{children:`After creating a task:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Poll for status`}),`: Use `,_jsx(_components.a,{href:`/api-reference/videos/get-task`,children:`Get Task`}),` with the `,_jsx(_components.code,{children:`task_id`}),` from the 202 response, every 30 seconds.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Wait for webhook`}),`: If configured, receive notification when complete — remembering the id difference noted above.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Download video`}),`: Access `,_jsx(_components.code,{children:`result.video_url`}),` within 24 hours of creation.`]}),`\n`]})]})}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":"Create Land Transformation Video","api":"POST /v1/land","description":"Create an AI-powered cinematic video transforming an empty plot of land into proposed constructions","href":"/api-reference/videos/create-land"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,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,Expandable,Heading,Info,Note,ParamField,RequestExample,ResponseExample,ResponseField,Table,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Creates a new land transformation video from a single photo of an empty plot. The system progressively builds the land through chained transitions: raw terrain → marked buildable area → proposed constructions. Each transition is rendered as a cinematic morph, resulting in a fluid visualization of what the land could become.`}),`\n`,_jsxs(_components.p,{children:[`This endpoint is `,_jsx(_components.strong,{children:`progressive`}),` — only `,_jsx(_components.code,{children:`source_image_url`}),` and `,_jsx(_components.code,{children:`format`}),` are required. Everything else is optional and resolved server-side if omitted:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`No mask?`}),` The server auto-detects the buildable area via Gemini.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`No scenes?`}),` The server generates construction proposals based on terrain analysis.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`No script?`}),` The server auto-generates a narration script.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`When you provide pre-generated assets (`,_jsx(_components.code,{children:`scenes[]`}),`, `,_jsx(_components.code,{children:`script`}),`, `,_jsx(_components.code,{children:`mask_image_url`}),`), the server skips the corresponding generation steps. This avoids double-charging for assets you already created.`]}),`\n`,_jsx(Heading,{level:`2`,id:`request-body`,children:`Request Body`}),`\n`,_jsxs(ParamField,{body:`source_image_url`,type:`string`,required:true,id:`param-source-image-url`,children:[_jsx(_components.p,{children:`Publicly accessible URL of a single photo of an empty plot of land.`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Must be a valid HTTP(S) URL`}),`\n`,_jsx(_components.li,{children:`Must be an image file (JPEG, PNG, or WebP)`}),`\n`,_jsxs(_components.li,{children:[`Only `,_jsx(_components.strong,{children:`one`}),` image is accepted`]}),`\n`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`Every image URL in the request is fetched and validated before the task is created. Unreachable images fail with `,_jsx(_components.code,{children:`400 INVALID_IMAGE_URL`}),`, and images below the minimum resolution fail with `,_jsx(_components.code,{children:`400 IMAGE_RESOLUTION_TOO_LOW`}),`. VibePeak-hosted assets belonging to another account are rejected with `,_jsx(_components.code,{children:`403 ASSET_ACCESS_DENIED`}),`.`]})})]}),`\n`,_jsxs(ParamField,{body:`format`,type:`string`,required:true,id:`param-format`,children:[_jsx(_components.p,{children:`Target video format / aspect ratio.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`9:16`})}),_jsx(_components.td,{children:`Vertical video (portrait) — ideal for social media stories and reels`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`16:9`})}),_jsx(_components.td,{children:`Horizontal video (landscape) — ideal for websites and presentations`})]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`mask-\u0026-area-overrides`,children:`Mask \u0026 Area Overrides`}),`\n`,_jsxs(ParamField,{body:`mask_image_url`,type:`string`,id:`param-mask-image-url`,children:[_jsx(_components.p,{children:`Optional binary mask image (PNG) marking the buildable area with a neon outline and semi-transparent fill.`}),_jsxs(_components.p,{children:[`When provided, the server uses this mask directly and skips auto-detection. Takes precedence over `,_jsx(_components.code,{children:`area_polygon`}),`.`]}),_jsxs(_components.p,{children:[`Alias: `,_jsx(_components.code,{children:`mask_url`}),` is accepted and normalized to `,_jsx(_components.code,{children:`mask_image_url`}),`. If both are sent, `,_jsx(_components.code,{children:`mask_image_url`}),` wins.`]})]}),`\n`,_jsxs(ParamField,{body:`marked_image_url`,type:`string`,id:`param-marked-image-url`,children:[_jsxs(_components.p,{children:[`Optional pre-rendered `,_jsx(_components.strong,{children:`marked terrain`}),` image (the `,_jsx(_components.code,{children:`img1`}),` frame — the source photo with the buildable area already highlighted).`]}),_jsxs(_components.p,{children:[`When provided, the server skips the marking render entirely and uses this frame directly. Like `,_jsx(_components.code,{children:`mask_image_url`}),` and `,_jsx(_components.code,{children:`area_polygon`}),`, supplying it waives the 5-credit mask charge, and the task reports `,_jsx(_components.code,{children:`marking: \"mask\"`}),`.`]}),_jsxs(_components.p,{children:[`It takes precedence over both `,_jsx(_components.code,{children:`mask_image_url`}),` and `,_jsx(_components.code,{children:`area_polygon`}),`.`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`marked_image_url`}),` also changes how the frame count is calculated when you supply `,_jsx(_components.code,{children:`scenes[]`}),` — see `,_jsx(_components.a,{href:`#frame-limits`,children:`Frame Limits`}),`.`]})})]}),`\n`,_jsxs(ParamField,{body:`area_polygon`,type:`object[]`,id:`param-area-polygon`,children:[_jsx(_components.p,{children:`Optional polygon coordinates marking the buildable area. Minimum 3 points required.`}),_jsx(_components.p,{children:`Each point is an object with normalized coordinates:`}),_jsxs(Expandable,{title:`Point properties`,children:[_jsx(ParamField,{body:`x`,type:`number`,required:true,id:`param-x`,children:_jsx(_components.p,{children:`Normalized X coordinate between 0 and 1.`})}),_jsx(ParamField,{body:`y`,type:`number`,required:true,id:`param-y`,children:_jsx(_components.p,{children:`Normalized Y coordinate between 0 and 1.`})})]}),_jsxs(_components.p,{children:[`Alias: `,_jsx(_components.code,{children:`polygon`}),` is accepted and normalized to `,_jsx(_components.code,{children:`area_polygon`}),`.`]}),_jsxs(_components.p,{children:[`If none of `,_jsx(_components.code,{children:`mask_image_url`}),`, `,_jsx(_components.code,{children:`area_polygon`}),` or `,_jsx(_components.code,{children:`marked_image_url`}),` is provided, the server auto-detects the buildable area using Gemini vision analysis.`]})]}),`\n`,_jsx(Heading,{level:`3`,id:`terrain-\u0026-construction-overrides`,children:`Terrain \u0026 Construction Overrides`}),`\n`,_jsxs(ParamField,{body:`terrain_type`,type:`string`,id:`param-terrain-type`,children:[_jsxs(_components.p,{children:[`Optional terrain type hint, e.g. `,_jsx(_components.code,{children:`\"urban\"`}),`, `,_jsx(_components.code,{children:`\"rural\"`}),` or `,_jsx(_components.code,{children:`\"industrial\"`}),`.`]}),_jsx(_components.p,{children:`Any non-empty string is accepted — the value is a free-form hint passed to the proposal generator, not a closed enum. If omitted, the server analyzes the image and auto-detects the terrain type.`})]}),`\n`,_jsxs(ParamField,{body:`construction_prompts`,type:`string[]`,id:`param-construction-prompts`,children:[_jsx(_components.p,{children:`Optional array of construction prompts (1-8). One image is generated per prompt in the order provided.`}),_jsx(_components.p,{children:`When provided, the server skips proposal auto-generation and renders exactly these constructions. Each prompt is still billed as a generated scene.`}),_jsxs(_components.p,{children:[`Alias: `,_jsx(_components.code,{children:`prompts`}),` is accepted and normalized to `,_jsx(_components.code,{children:`construction_prompts`}),`.`]})]}),`\n`,_jsxs(ParamField,{body:`num_constructions`,type:`integer`,default:`3`,id:`param-num-constructions`,children:[_jsx(_components.p,{children:`Optional number of constructions to auto-generate (2-8). Default is 3.`}),_jsxs(_components.p,{children:[`Ignored if `,_jsx(_components.code,{children:`scenes`}),` or `,_jsx(_components.code,{children:`construction_prompts`}),` are provided.`]})]}),`\n`,_jsx(ParamField,{body:`style`,type:`string`,id:`param-style`,children:_jsxs(_components.p,{children:[`Optional style hint that biases auto-generated proposals (e.g., `,_jsx(_components.code,{children:`\"modern\"`}),`, `,_jsx(_components.code,{children:`\"rustic\"`}),`, `,_jsx(_components.code,{children:`\"minimalist\"`}),`).`]})}),`\n`,_jsx(ParamField,{body:`exclude`,type:`string`,id:`param-exclude`,children:_jsxs(_components.p,{children:[`Optional exclusion hint for auto-generated proposals (e.g., `,_jsx(_components.code,{children:`\"no swimming pools\"`}),`, `,_jsx(_components.code,{children:`\"no glass facades\"`}),`).`]})}),`\n`,_jsx(Heading,{level:`3`,id:`scene-chain-fully-resolved`,children:`Scene Chain (Fully Resolved)`}),`\n`,_jsxs(ParamField,{body:`scenes`,type:`object[]`,id:`param-scenes`,children:[_jsx(_components.p,{children:`Optional fully-resolved scene chain (1-8 items). When provided, the server skips scene generation and renders these frames directly.`}),_jsx(_components.p,{children:`Each scene is an object with:`}),_jsxs(Expandable,{title:`Scene properties`,children:[_jsx(ParamField,{body:`image_url`,type:`string`,id:`param-image-url`,children:_jsx(_components.p,{children:`Publicly accessible URL of the scene image. Optional at the schema level, but a scene without an image cannot be rendered — always send it when supplying a resolved chain.`})}),_jsx(ParamField,{body:`prompt`,type:`string`,id:`param-prompt`,children:_jsx(_components.p,{children:`Optional prompt that generated this scene.`})}),_jsx(ParamField,{body:`order`,type:`integer`,id:`param-order`,children:_jsxs(_components.p,{children:[`Optional display order within the chain. `,_jsx(_components.strong,{children:`Must be 1 or greater`}),` — `,_jsx(_components.code,{children:`0`}),` is rejected with `,_jsx(_components.code,{children:`400 VALIDATION_ERROR`}),`.`]})}),_jsxs(ParamField,{body:`camera_movement`,type:`string`,id:`param-camera-movement`,children:[_jsx(_components.p,{children:`Optional per-scene camera movement applied by the WAN renderer.`}),_jsxs(_components.p,{children:[`One of `,_jsx(_components.code,{children:`traveling_left`}),`, `,_jsx(_components.code,{children:`traveling_right`}),`, `,_jsx(_components.code,{children:`traveling_up`}),`, `,_jsx(_components.code,{children:`traveling_down`}),`, `,_jsx(_components.code,{children:`dolly_in`}),`, `,_jsx(_components.code,{children:`dolly_out`}),`, `,_jsx(_components.code,{children:`arc_left`}),`, `,_jsx(_components.code,{children:`arc_right`}),`. Omitted means the renderer picks the movement.`]})]})]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[`Providing `,_jsx(_components.code,{children:`scenes[]`}),` is the recommended path for first-party callers (like the VibePeak web app) that have already generated images interactively. This ensures you are only charged the base render cost (15 credits) and avoids double-charging for generated assets.`]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`script-voice-\u0026-music-overrides`,children:`Script, Voice \u0026 Music Overrides`}),`\n`,_jsxs(ParamField,{body:`script`,type:`string`,id:`param-script`,children:[_jsx(_components.p,{children:`Optional narration script for text-to-speech. Any non-empty string is accepted.`}),_jsx(Note,{children:_jsxs(_components.p,{children:[`Unlike the `,_jsx(_components.a,{href:`/api-reference/videos/create-narrated-slideshow`,children:`narrated slideshow`}),` and real-estate endpoints, `,_jsx(_components.code,{children:`/v1/land`}),` does `,_jsx(_components.strong,{children:`not`}),` enforce a character-count range or reject digits and symbols. For natural pacing aim for roughly 65-85 characters per scene, but this is guidance, not validation.`]})})]}),`\n`,_jsx(ParamField,{body:`language`,type:`string`,id:`param-language`,children:_jsxs(_components.p,{children:[`Language code for the auto-generated script and TTS pronunciation (e.g., `,_jsx(_components.code,{children:`en`}),`, `,_jsx(_components.code,{children:`es`}),`, `,_jsx(_components.code,{children:`de`}),`, `,_jsx(_components.code,{children:`fr`}),`, `,_jsx(_components.code,{children:`pt`}),`). Minimum 2 characters.`]})}),`\n`,_jsxs(ParamField,{body:`voice_id`,type:`string`,id:`param-voice-id`,children:[_jsxs(_components.p,{children:[`Voice ID for narration. You can find available voices using the `,_jsx(_components.a,{href:`/api-reference/voices/list-voices`,children:`List Voices`}),` endpoint.`]}),_jsx(_components.p,{children:`Defaults to a platform voice if omitted.`})]}),`\n`,_jsx(ParamField,{body:`voice_speed`,type:`number`,default:`1`,id:`param-voice-speed`,children:_jsxs(_components.p,{children:[`Speaking rate of the synthesized voiceover. Values below `,_jsx(_components.code,{children:`1`}),` slow it down, above `,_jsx(_components.code,{children:`1`}),` speed it up. The effect depends on the voice and language: most voices follow the value closely, some apply it only partially, and each voice applies its own supported range within these bounds. Range: `,_jsx(_components.code,{children:`0.5`}),` to `,_jsx(_components.code,{children:`2`}),`; values outside it are rejected with a validation error. Applies only when VibePeak synthesizes the voiceover, so it has no effect when `,_jsx(_components.code,{children:`voiceover_enabled`}),` is `,_jsx(_components.code,{children:`false`}),`.`]})}),`\n`,_jsxs(ParamField,{body:`voiceover_enabled`,type:`boolean`,id:`param-voiceover-enabled`,children:[_jsxs(_components.p,{children:[`Set to `,_jsx(_components.code,{children:`false`}),` to render the video without narration. When `,_jsx(_components.code,{children:`false`}),`, the server skips text-to-speech entirely and `,_jsx(_components.code,{children:`script`}),` / `,_jsx(_components.code,{children:`voice_id`}),` may be omitted.`]}),_jsxs(_components.p,{children:[`Omitting this field leaves narration `,_jsx(_components.strong,{children:`on`}),`.`]})]}),`\n`,_jsx(ParamField,{body:`background_music`,type:`boolean`,id:`param-background-music`,children:_jsxs(_components.p,{children:[`Set to `,_jsx(_components.code,{children:`true`}),` to add a background music bed. Omitting this field, or sending `,_jsx(_components.code,{children:`false`}),`, renders the video without music.`]})}),`\n`,_jsxs(ParamField,{body:`music_id`,type:`string`,id:`param-music-id`,children:[_jsxs(_components.p,{children:[`Optional Music Library track to pin, as a `,_jsx(_components.strong,{children:`UUID`}),`. Without it, a `,_jsx(_components.code,{children:`background_music: true`}),` job uses a randomly selected bed.`]}),_jsxs(Warning,{children:[_jsxs(_components.p,{children:[_jsx(_components.code,{children:`music_id`}),` and `,_jsx(_components.code,{children:`music_kind`}),` must be sent `,_jsx(_components.strong,{children:`together`}),` — sending one without the other fails with `,_jsx(_components.code,{children:`400 VALIDATION_ERROR`}),` (`,_jsx(_components.code,{children:`music_id and music_kind must be provided together`}),`). A non-UUID value fails with `,_jsx(_components.code,{children:`music_id must be a valid UUID`}),`.`]}),_jsxs(_components.p,{children:[`Both fields are only honored when `,_jsx(_components.code,{children:`background_music`}),` is `,_jsx(_components.code,{children:`true`}),`; with music off the video stays silent regardless.`]})]})]}),`\n`,_jsx(ParamField,{body:`music_kind`,type:`string`,id:`param-music-kind`,children:_jsxs(_components.p,{children:[`Which catalogue `,_jsx(_components.code,{children:`music_id`}),` refers to: `,_jsx(_components.code,{children:`stock`}),` (Music Library track) or `,_jsx(_components.code,{children:`ai`}),` (AI-generated track). Required whenever `,_jsx(_components.code,{children:`music_id`}),` is present.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`subtitle-\u0026-elements-configuration`,children:`Subtitle \u0026 Elements Configuration`}),`\n`,_jsxs(ParamField,{body:`subtitle_config`,type:`object`,id:`param-subtitle-config`,children:[_jsxs(_components.p,{children:[`Subtitle configuration for word-level animated overlays. Same structure as other video endpoints — see `,_jsx(_components.a,{href:`/api-reference/videos/create-narrated-slideshow`,children:`Create Narrated Slideshow`}),` for the full field list.`]}),_jsx(_components.p,{children:`On this endpoint the object is passed through to the renderer without field-level validation, so a malformed key is accepted at request time and simply ignored downstream.`})]}),`\n`,_jsxs(ParamField,{body:`elements_config`,type:`object`,id:`param-elements-config`,children:[_jsxs(_components.p,{children:[`Configuration for visual elements and branding overlays (watermark, text, intro/outro). Same structure as other video endpoints — see `,_jsx(_components.a,{href:`/api-reference/videos/create-narrated-slideshow`,children:`Create Narrated Slideshow`}),`.`]}),_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`intro_outro`}),` block is fully validated; the rest is passed through to the renderer. Browse the designs in the `,_jsx(_components.a,{href:`/api-reference/videos/intro-outro-templates`,children:`template gallery`}),`, or read the catalogue from `,_jsx(_components.a,{href:`/api-reference/videos/list-intro-outro-templates`,children:_jsx(_components.code,{children:`GET /v1/intro-outro/templates`})}),`.`]}),_jsxs(_components.p,{children:[`As on `,_jsx(_components.a,{href:`/api-reference/videos/create-narrated-slideshow`,children:`Create Narrated Slideshow`}),`, the overlays are applied `,_jsx(_components.strong,{children:`after`}),` the video renders. The task passes through the transitional `,_jsx(_components.code,{children:`intro_outro`}),` status while that runs, and if the overlays cannot be applied the task still completes: the video is delivered without them and the result carries an `,_jsx(_components.code,{children:`intro_outro_warning`}),`.`]}),_jsxs(Note,{children:[_jsxs(_components.p,{children:[`Unlike the real-estate and narrated-slideshow endpoints, `,_jsx(_components.code,{children:`/v1/land`}),` does `,_jsx(_components.strong,{children:`not`}),` pre-validate the watermark URL at request time, so it never returns `,_jsx(_components.code,{children:`INVALID_WATERMARK_URL`}),`. An unreachable watermark surfaces later as a render failure. Verify the URL before submitting.`]}),_jsxs(_components.p,{children:[`The watermark’s `,_jsx(_components.strong,{children:`geometry`}),` is the exception: it `,_jsx(_components.em,{children:`is`}),` checked at request time here, exactly as on the other endpoints. When a watermark URL is present and branding is enabled, a `,_jsx(_components.code,{children:`size`}),` below 2 (`,_jsx(_components.code,{children:`single`}),` mode only) or an `,_jsx(_components.code,{children:`opacity`}),` below 5 is rejected with `,_jsx(_components.code,{children:`400 INVALID_WATERMARK_GEOMETRY`}),` before any credits are charged.`]}),_jsxs(_components.p,{children:[`A `,_jsx(_components.code,{children:`size`}),` or `,_jsx(_components.code,{children:`opacity`}),` that is `,_jsx(_components.strong,{children:`not a finite number`}),` is rejected the same way. This matters more here than elsewhere: `,_jsx(_components.code,{children:`/v1/land`}),` validates only the `,_jsx(_components.code,{children:`intro_outro`}),` block of `,_jsx(_components.code,{children:`elements_config`}),` and passes the rest through, so a string such as `,_jsx(_components.code,{children:`\"20\"`}),` reaches the floor intact and is refused, where the real-estate and narrated-slideshow endpoints would have rejected it earlier as a `,_jsx(_components.code,{children:`VALIDATION_ERROR`}),`. Send numbers, not numeric strings.`]}),_jsxs(_components.p,{children:[`Omitting `,_jsx(_components.code,{children:`size`}),` or `,_jsx(_components.code,{children:`opacity`}),` is always fine — the renderer’s own defaults (20 and 100) apply, and an absent or `,_jsx(_components.code,{children:`null`}),` value is never rejected.`]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`webhook`,children:`Webhook`}),`\n`,_jsxs(ParamField,{body:`webhook_url`,type:`string`,id:`param-webhook-url`,children:[_jsx(_components.p,{children:`HTTPS URL to receive a webhook notification when the task completes or fails.`}),_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/concepts/webhooks`,children:`Webhooks`}),` for payload format and verification details.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`Webhook URLs must use HTTPS and cannot point to private/internal networks (SSRF protection). A rejected URL fails with `,_jsx(_components.code,{children:`400 INVALID_WEBHOOK_URL`}),`.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`Returns a `,_jsx(_components.code,{children:`202 Accepted`}),` response. Unlike other video endpoints, land tasks start in the `,_jsx(_components.code,{children:`preparing`}),` state while the server resolves inputs (auto-detecting the mask, generating scenes, creating the script), and they report credits under `,_jsx(_components.code,{children:`charged_credits`}),` with a `,_jsx(_components.code,{children:`resolution`}),` object.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Land responses are deliberately shaped differently from other video endpoints.`}),` Land tasks use `,_jsx(_components.code,{children:`charged_credits`}),` and a `,_jsx(_components.code,{children:`resolution`}),` object; every other task type uses `,_jsx(_components.code,{children:`credits_charged`}),` and has no `,_jsx(_components.code,{children:`resolution`}),`. If you share response-parsing code across endpoints, handle both key names.`]})}),`\n`,_jsxs(ResponseField,{name:`task_id`,type:`string`,required:true,id:`param-task-id`,children:[_jsxs(_components.p,{children:[`Unique identifier for the task, in the form `,_jsx(_components.code,{children:`task_\u003cid>`}),`. Use this to poll for status via `,_jsx(_components.a,{href:`/api-reference/videos/get-task`,children:`Get Task`}),`.`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`task_id`}),` sent in the `,_jsx(_components.strong,{children:`webhook`}),` payload is a different identifier (`,_jsx(_components.code,{children:`vp_land_\u003cid>`}),`, the task’s external id). Correlate webhooks by storing both, or by matching on your own reference — do not assume the webhook `,_jsx(_components.code,{children:`task_id`}),` can be passed to `,_jsx(_components.code,{children:`GET /v1/tasks/{id}`}),`.`]})})]}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,required:true,id:`param-status`,children:_jsxs(_components.p,{children:[`Initial task status. Always `,_jsx(_components.code,{children:`preparing`}),` for land tasks.`]})}),`\n`,_jsx(ResponseField,{name:`message`,type:`string`,required:true,id:`param-message`,children:_jsxs(_components.p,{children:[`Human-readable acknowledgement — `,_jsx(_components.code,{children:`\"Land transformation request accepted\"`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`created_at`,type:`string`,required:true,id:`param-created-at`,children:_jsx(_components.p,{children:`ISO 8601 timestamp of task creation.`})}),`\n`,_jsx(ResponseField,{name:`livemode`,type:`boolean`,required:true,id:`param-livemode`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` for live keys. Requests made with a `,_jsx(_components.code,{children:`vpk_test_`}),` key return `,_jsx(_components.code,{children:`false`}),` and are not charged — see `,_jsx(_components.a,{href:`/concepts/test-mode`,children:`Test Mode`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`request_id`,type:`string`,required:true,id:`param-request-id`,children:_jsx(_components.p,{children:`Request identifier, useful when contacting support.`})}),`\n`,_jsx(ResponseField,{name:`charged_credits`,type:`integer`,required:true,id:`param-charged-credits`,children:_jsxs(_components.p,{children:[`Credits actually deducted for this request. See `,_jsx(_components.a,{href:`#credit-model`,children:`Credit Model`}),` for the breakdown.`]})}),`\n`,_jsxs(ResponseField,{name:`resolution`,type:`object`,id:`param-resolution`,children:[_jsx(_components.p,{children:`Preparation metadata describing what the server will compute.`}),_jsxs(Expandable,{title:`Resolution properties`,children:[_jsx(ResponseField,{name:`stage`,type:`string`,id:`param-stage`,children:_jsxs(_components.p,{children:[`Current preparation stage — always `,_jsx(_components.code,{children:`\"preparing\"`}),` at creation.`]})}),_jsx(ResponseField,{name:`progress`,type:`integer`,id:`param-progress`,children:_jsx(_components.p,{children:`Preparation progress percentage (0-100). Starts at 10.`})}),_jsx(ResponseField,{name:`used_overrides`,type:`string[]`,id:`param-used-overrides`,children:_jsxs(_components.p,{children:[`The request fields you supplied that overrode server-side generation, in canonical order. An explicit `,_jsx(_components.code,{children:`background_music: false`}),` counts as an override; an omitted field does not.`]})}),_jsxs(ResponseField,{name:`credits_breakdown`,type:`object`,id:`param-credits-breakdown`,children:[_jsx(_components.p,{children:`Detailed credit cost breakdown.`}),_jsxs(Expandable,{title:`Credits breakdown properties`,children:[_jsx(ResponseField,{name:`base_render`,type:`integer`,id:`param-base-render`,children:_jsx(_components.p,{children:`Base render cost (15 credits).`})}),_jsx(ResponseField,{name:`generated_mask`,type:`integer`,id:`param-generated-mask`,children:_jsxs(_components.p,{children:[`Cost for a server-generated mask (5 credits) — 0 if `,_jsx(_components.code,{children:`mask_image_url`}),`, `,_jsx(_components.code,{children:`area_polygon`}),` or `,_jsx(_components.code,{children:`marked_image_url`}),` is provided.`]})}),_jsx(ResponseField,{name:`generated_scene_count`,type:`integer`,id:`param-generated-scene-count`,children:_jsx(_components.p,{children:`Number of scenes the server will generate.`})}),_jsx(ResponseField,{name:`generated_scenes`,type:`integer`,id:`param-generated-scenes`,children:_jsx(_components.p,{children:`Total cost for generated scenes (5 credits each).`})}),_jsx(ResponseField,{name:`generated_script`,type:`integer`,id:`param-generated-script`,children:_jsxs(_components.p,{children:[`Cost for a server-generated script (5 credits) — 0 if `,_jsx(_components.code,{children:`script`}),` is provided.`]})}),_jsx(ResponseField,{name:`total`,type:`integer`,id:`param-total`,children:_jsx(_components.p,{children:`Total credits charged.`})})]})]})]})]}),`\n`,_jsx(ResponseField,{name:`_links`,type:`object`,id:`param-links`,children:_jsxs(_components.p,{children:[`Convenience links: `,_jsx(_components.code,{children:`self`}),` (the poll URL) and `,_jsx(_components.code,{children:`poll_interval_seconds`}),`.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`response-headers`,children:`Response Headers`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Header`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Location`})}),_jsxs(_components.td,{children:[`URL to poll for task status (`,_jsx(_components.code,{children:`/v1/tasks/{task_id}`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Retry-After`})}),_jsx(_components.td,{children:`Recommended polling interval in seconds (30)`})]})]})]}),`\n`,_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`cURL (Minimal — 1 image)`,numberOfLines:`7`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.vibepeak.ai/v1/land`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer vpk_live_xxxxx\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"source_image_url\": \"https://example.com/land/empty-plot.jpg\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"format\": \"9:16\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL (With mask and more constructions)`,numberOfLines:`9`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.vibepeak.ai/v1/land`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer vpk_live_xxxxx\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"source_image_url\": \"https://example.com/land/empty-plot.jpg\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"format\": \"9:16\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"mask_image_url\": \"https://example.com/land/mask.png\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"num_constructions\": 5`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL (Fully resolved — short-circuit)`,numberOfLines:`18`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`18`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.vibepeak.ai/v1/land`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer vpk_live_xxxxx\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"source_image_url\": \"https://example.com/land/original.jpg\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"format\": \"16:9\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"marked_image_url\": \"https://example.com/land/marked.jpg\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"scenes\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` { \"image_url\": \"https://example.com/land/building1.jpg\", \"order\": 1, \"camera_movement\": \"dolly_in\" },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` { \"image_url\": \"https://example.com/land/building2.jpg\", \"order\": 2 },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` { \"image_url\": \"https://example.com/land/building3.jpg\", \"order\": 3 }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"script\": \"Discover the potential of this stunning plot. From raw land to a modern family home, the transformation is breathtaking.\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"voice_id\": \"EXAVITQu4vr4xnSDxMaL\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"voice_speed\": 0.9,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"language\": \"en\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"webhook_url\": \"https://yourserver.com/webhooks/vibepeak\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL (No narration, with pinned music)`,numberOfLines:`11`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`11`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.vibepeak.ai/v1/land`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer vpk_live_xxxxx\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"source_image_url\": \"https://example.com/land/empty-plot.jpg\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"format\": \"9:16\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"voiceover_enabled\": false,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"background_music\": true,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"music_id\": \"3f9a1c62-5b4e-4a77-9d21-0c8b6e4f1a35\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"music_kind\": \"stock\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js`,numberOfLines:`17`,language:`javascript`,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:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`17`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://api.vibepeak.ai/v1/land'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'POST'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_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:` 'Authorization'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Bearer vpk_live_xxxxx'`}),_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:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'application/json'`})]}),`\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:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` source_image_url:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://example.com/land/empty-plot.jpg'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` format:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '9:16'`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` })`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` task`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`Task created: \"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`task`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`task_id`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`Status: \"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`task`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`status`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`Credits: \"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`task`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`charged_credits`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`Breakdown:`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`task`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`resolution`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`credits_breakdown`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`19`,language:`python`,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:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`19`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.post(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.vibepeak.ai/v1/land'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_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:` 'Authorization'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Bearer vpk_live_xxxxx'`}),_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:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'application/json'`})]}),`\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:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` json`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_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:` 'source_image_url'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://example.com/land/empty-plot.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:` 'format'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'9:16'`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`task `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response.json()`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Task created: `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`task[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'task_id'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Status: `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`task[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'status'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Credits: `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`task[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'charged_credits'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Breakdown: `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`task[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'resolution'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`][`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'credits_breakdown'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`]})})})]}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`202 Accepted (Minimal)`,numberOfLines:`26`,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:`26`,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:` \"task_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"task_abc123xyz\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"preparing\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Land transformation request accepted\"`}),_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:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-08-31T12:15:00.000Z\"`}),_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:` \"livemode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"req_xyz123\"`}),_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:` \"charged_credits\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`40`}),_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:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"stage\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"preparing\"`}),_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:` \"progress\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10`}),_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:` \"credits_breakdown\"`}),_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:` \"base_render\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`15`}),_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:` \"generated_mask\"`}),_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:` \"generated_scene_count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3`}),_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:` \"generated_scenes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`15`}),_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:` \"generated_script\"`}),_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:` \"total\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`40`})]}),`\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:` \"used_overrides\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: []`})]}),`\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:` \"_links\"`}),_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:` \"self\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/v1/tasks/task_abc123xyz\"`}),_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:` \"poll_interval_seconds\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`30`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`202 Accepted (Fully Resolved)`,numberOfLines:`26`,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:`26`,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:` \"task_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"task_abc123xyz\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"preparing\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Land transformation request accepted\"`}),_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:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-08-31T12:15:00.000Z\"`}),_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:` \"livemode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"req_xyz123\"`}),_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:` \"charged_credits\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`15`}),_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:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"stage\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"preparing\"`}),_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:` \"progress\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10`}),_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:` \"credits_breakdown\"`}),_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:` \"base_render\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`15`}),_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:` \"generated_mask\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_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:` \"generated_scene_count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_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:` \"generated_scenes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_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:` \"generated_script\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_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:` \"total\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`15`})]}),`\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:` \"used_overrides\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"marked_image_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"scenes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"script\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"language\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"voice_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\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:` \"_links\"`}),_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:` \"self\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/v1/tasks/task_abc123xyz\"`}),_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:` \"poll_interval_seconds\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`30`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`400 Bad Request (Validation Error)`,numberOfLines:`16`,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:`16`,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:` \"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"VALIDATION_ERROR\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Land chains must contain 3 to 10 total frames including img0 and img1\"`}),_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:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"req_xyz123\"`}),_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:` \"details\"`}),_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:` \"field\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"scenes\"`}),_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:` \"issues\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\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:` \"path\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"scenes\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Land chains must contain 3 to 10 total frames including img0 and img1\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`400 Bad Request (Invalid Image URL)`,numberOfLines:`10`,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:`10`,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:` \"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"INVALID_IMAGE_URL\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Failed to access image: fetch failed (ENOTFOUND)\"`}),_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:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"req_xyz123\"`}),_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:` \"details\"`}),_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:` \"invalid_images\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com/land/empty-plot.jpg\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`402 Payment Required`,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:` \"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"INSUFFICIENT_CREDITS\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Insufficient credits\"`}),_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:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"req_xyz123\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`403 Forbidden (Asset Access)`,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:` \"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ASSET_ACCESS_DENIED\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Asset is not accessible\"`}),_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:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"req_xyz123\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`403 Forbidden (Plan)`,numberOfLines:`11`,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:`11`,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:` \"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"PLAN_REQUIRED\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"API access requires a Plus, Pro, Max or Enterprise plan. Please upgrade your subscription.\"`}),_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:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"req_xyz123\"`}),_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:` \"details\"`}),_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:` \"current_plan\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Free\"`}),_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:` \"required_plans\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Plus\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Pro\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Max\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Enterprise\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`409 Conflict`,numberOfLines:`12`,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:`12`,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:` \"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CONCURRENCY_LIMIT_EXCEEDED\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"You have reached your concurrent task limit of 1. Please wait for existing tasks to complete.\"`}),_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:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"req_xyz123\"`}),_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:` \"details\"`}),_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:` \"limit\"`}),_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:` \"in_flight\"`}),_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:` \"plan\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Plus\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`503 Service Unavailable`,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:` \"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"SERVICE_UNAVAILABLE\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Land transformation service is temporarily unavailable. Please try again.\"`}),_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:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"req_xyz123\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`credit-model`,children:`Credit Model`}),`\n`,_jsxs(_components.p,{children:[`Land transformation videos use a `,_jsx(_components.strong,{children:`differentiated credit model`}),` based on the work the server performs:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Component`}),_jsx(_components.th,{children:`Credits`}),_jsx(_components.th,{children:`Condition`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Base render`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`15`}),_jsx(_components.td,{children:`Always charged`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Generated mask`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`5`}),_jsxs(_components.td,{children:[`Charged if you do `,_jsx(_components.strong,{children:`not`}),` provide `,_jsx(_components.code,{children:`mask_image_url`}),`, `,_jsx(_components.code,{children:`area_polygon`}),` or `,_jsx(_components.code,{children:`marked_image_url`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Generated scenes`}),_jsx(_components.td,{children:`5 per scene`}),_jsxs(_components.td,{children:[`Charged for each scene the server generates (not for pre-provided `,_jsx(_components.code,{children:`scenes[]`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Generated script`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`5`}),_jsxs(_components.td,{children:[`Charged if you do `,_jsx(_components.strong,{children:`not`}),` provide `,_jsx(_components.code,{children:`script`}),` and narration is on. Never charged when `,_jsx(_components.code,{children:`voiceover_enabled`}),` is `,_jsx(_components.code,{children:`false`}),` — no script is written for a video without narration`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`When `,_jsx(_components.code,{children:`scenes[]`}),` is absent, the number of generated scenes is `,_jsx(_components.code,{children:`construction_prompts.length`}),`, else `,_jsx(_components.code,{children:`num_constructions`}),`, else 3.`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Example costs:`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Scenario`}),_jsx(_components.th,{children:`Calculation`}),_jsx(_components.th,{children:`Total`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Minimal (1 image, auto everything)`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`15 + 5 + 15 + 5`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.strong,{children:`40`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`With mask, auto scenes + script`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`15 + 0 + 15 + 5`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.strong,{children:`35`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`With mask + 5 construction prompts`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`15 + 0 + 25 + 5`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.strong,{children:`45`})})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Fully resolved (`,_jsx(_components.code,{children:`scenes[]`}),` + `,_jsx(_components.code,{children:`script`}),` + marked frame)`]}),_jsx(_components.td,{\"data-numeric\":`true`,children:`15 + 0 + 0 + 0`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.strong,{children:`15`})})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`No narration (`,_jsx(_components.code,{children:`scenes[]`}),` + marked frame + `,_jsx(_components.code,{children:`voiceover_enabled: false`}),`)`]}),_jsx(_components.td,{\"data-numeric\":`true`,children:`15 + 0 + 0 + 0`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.strong,{children:`15`})})]})]})]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Assets you pre-provide (`,_jsx(_components.code,{children:`scenes[]`}),`, `,_jsx(_components.code,{children:`script`}),`, `,_jsx(_components.code,{children:`mask_image_url`}),`, `,_jsx(_components.code,{children:`marked_image_url`}),`) are `,_jsx(_components.strong,{children:`never regenerated`}),` and `,_jsx(_components.strong,{children:`never re-charged`}),`. This prevents double-charging for first-party callers that already generated images interactively.`]})}),`\n`,_jsxs(_components.p,{children:[`Credits are deducted at creation time. If the job later fails, the credits are `,_jsx(_components.strong,{children:`refunded automatically`}),` — the webhook’s `,_jsx(_components.code,{children:`charged_credits`}),` reflects the post-refund amount (typically `,_jsx(_components.code,{children:`0`}),`).`]}),`\n`,_jsxs(_components.p,{children:[`If a task that failed with `,_jsx(_components.code,{children:`GENERATION_TIMEOUT`}),` later completes (see `,_jsx(_components.a,{href:`#polling`,children:`Polling`}),`), the refund stands and nothing is charged again. The `,_jsx(_components.code,{children:`task.completed`}),` webhook still reports the original price in `,_jsx(_components.code,{children:`charged_credits`}),`; treat the earlier `,_jsx(_components.code,{children:`task.failed`}),` webhook as the billing record for that task.`]}),`\n`,_jsx(Heading,{level:`2`,id:`plan-access`,children:`Plan Access`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Plan`}),_jsx(_components.th,{children:`API Access`}),_jsx(_components.th,{children:`Concurrent Tasks`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Free`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`—`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Starter`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`—`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Plus`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Pro`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`3`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Max`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`5`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Enterprise`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Custom`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`frame-limits`,children:`Frame Limits`}),`\n`,_jsxs(_components.p,{children:[`The video chain must contain `,_jsx(_components.strong,{children:`3 to 10 total frames`}),`. How the count is derived depends on whether you supply `,_jsx(_components.code,{children:`scenes[]`}),`:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`Without `,_jsx(_components.code,{children:`scenes[]`})]}),` — the count is `,_jsx(_components.code,{children:`2 + n`}),`, where `,_jsx(_components.code,{children:`n`}),` is `,_jsx(_components.code,{children:`construction_prompts.length`}),`, else `,_jsx(_components.code,{children:`num_constructions`}),`, else 3. The two implied frames are `,_jsx(_components.code,{children:`img0`}),` (original terrain) and `,_jsx(_components.code,{children:`img1`}),` (marked terrain).`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`With `,_jsx(_components.code,{children:`scenes[]`})]}),` — the count is `,_jsx(_components.code,{children:`1 + (marked_image_url ? 1 : 0) + scenes.length`}),`. `,_jsx(_components.code,{children:`img1`}),` is only counted when you actually supply `,_jsx(_components.code,{children:`marked_image_url`}),`.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`A resolved chain of 3 scenes with `,_jsx(_components.strong,{children:`no`}),` `,_jsx(_components.code,{children:`marked_image_url`}),` counts as 4 frames, not 5. If you are supplying a chain that already includes the marked frame as its first scene, do not also send `,_jsx(_components.code,{children:`marked_image_url`}),` — you would count it twice.`]})}),`\n`,_jsxs(_components.p,{children:[`Requests outside the 3-10 range fail with `,_jsx(_components.code,{children:`400 VALIDATION_ERROR`}),` on the `,_jsx(_components.code,{children:`scenes`}),` field.`]}),`\n`,_jsx(Heading,{level:`2`,id:`polling`,children:`Polling`}),`\n`,_jsxs(_components.p,{children:[`Land tasks flow through `,_jsx(_components.code,{children:`preparing`}),` → `,_jsx(_components.code,{children:`queued`}),` → `,_jsx(_components.code,{children:`processing`}),` → `,_jsx(_components.code,{children:`completed`}),` or `,_jsx(_components.code,{children:`failed`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`If the request asked for post-processing, the task also reports a transitional status between `,_jsx(_components.code,{children:`processing`}),` and its final state, in this order: `,_jsx(_components.code,{children:`watermarking`}),`, `,_jsx(_components.code,{children:`intro_outro`}),`, `,_jsx(_components.code,{children:`subtitling`}),`. Each appears only when the corresponding feature was requested. Treat all three like `,_jsx(_components.code,{children:`processing`}),` and keep polling — the task always ends in `,_jsx(_components.code,{children:`completed`}),` or `,_jsx(_components.code,{children:`failed`}),`. A step that cannot finish does not fail the task: the video is delivered without that refinement and `,_jsx(_components.code,{children:`result`}),` carries a matching `,_jsx(_components.code,{children:`watermark_warning`}),`, `,_jsx(_components.code,{children:`intro_outro_warning`}),` or `,_jsx(_components.code,{children:`subtitle_warning`}),`. See `,_jsx(_components.a,{href:`/concepts/async-processing`,children:`Asynchronous Processing`}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`GENERATION_TIMEOUT`}),` is the one failure that is not always final. It fires when the render is still running `,_jsx(_components.strong,{children:`180 minutes`}),` after the task was created. If that render finishes afterwards — VibePeak keeps checking for 48 hours after creation — the task moves from `,_jsx(_components.code,{children:`failed`}),` to `,_jsx(_components.code,{children:`completed`}),`, `,_jsx(_components.code,{children:`result.video_url`}),` is filled in, and a `,_jsx(_components.code,{children:`task.completed`}),` webhook follows the earlier `,_jsx(_components.code,{children:`task.failed`}),` one for the same `,_jsx(_components.code,{children:`task_id`}),`. Treat that later `,_jsx(_components.code,{children:`task.completed`}),` as the final outcome. Past the 24-hour expiry the task can no longer be polled, so a completion that late reaches you only by webhook. No other failure code changes afterwards, and a task never sends two `,_jsx(_components.code,{children:`task.completed`}),` webhooks.`]})}),`\n`,_jsxs(_components.p,{children:[`While in `,_jsx(_components.code,{children:`preparing`}),`, `,_jsx(_components.code,{children:`GET /v1/tasks/{task_id}`}),` returns a `,_jsx(_components.code,{children:`resolution`}),` object that advances through these stages:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Stage`}),_jsx(_components.th,{children:`Progress`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`preparing`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`10`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`marking_resolved`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`35`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`terrain_resolved`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`50`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`scenes_resolved`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`70`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`script_resolved`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`85`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`resolved`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`100`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Not every task passes through every stage. Supplying `,_jsx(_components.code,{children:`marked_image_url`}),` or `,_jsx(_components.code,{children:`mask_image_url`}),` resolves marking synchronously, so a fully-resolved request skips the intermediate stages and reports `,_jsx(_components.code,{children:`resolved`}),` / 100 on the first poll. Treat the ladder as monotonic but sparse — do not wait for a specific stage to appear.`]}),`\n`,_jsxs(_components.p,{children:[`Once marking is decided, the `,_jsx(_components.code,{children:`resolution`}),` object also carries `,_jsx(_components.code,{children:`marking`}),`, `,_jsx(_components.code,{children:`generated_image_count`}),` and `,_jsx(_components.code,{children:`used_overrides`}),`. It also carries `,_jsx(_components.code,{children:`resolved_inputs`}),` — a whitelisted view of what the server actually resolved (`,_jsx(_components.code,{children:`source_image_url`}),`, `,_jsx(_components.code,{children:`format`}),`, `,_jsx(_components.code,{children:`mask_image_url`}),`, `,_jsx(_components.code,{children:`area_polygon`}),`, `,_jsx(_components.code,{children:`terrain_type`}),`, `,_jsx(_components.code,{children:`scenes`}),`, `,_jsx(_components.code,{children:`construction_prompts`}),`, `,_jsx(_components.code,{children:`script`}),`), which is how you retrieve the generated scene image URLs and the auto-written script. When `,_jsx(_components.code,{children:`voiceover_enabled`}),` is `,_jsx(_components.code,{children:`false`}),` and you sent no `,_jsx(_components.code,{children:`script`}),`, `,_jsx(_components.code,{children:`resolved_inputs.script`}),` is an empty string. Your `,_jsx(_components.code,{children:`webhook_url`}),` and other request fields are deliberately not echoed back. `,_jsx(_components.code,{children:`generated_image_count`}),` counts server-generated scene images plus one for an auto-generated mask, and stays `,_jsx(_components.code,{children:`0`}),` for a fully-resolved request. On land tasks the GET response uses `,_jsx(_components.code,{children:`charged_credits`}),`; other task types use `,_jsx(_components.code,{children:`credits_charged`}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Tasks expire `,_jsx(_components.strong,{children:`24 hours`}),` after creation. After that, `,_jsx(_components.code,{children:`GET /v1/tasks/{task_id}`}),` returns `,_jsx(_components.code,{children:`404 TASK_EXPIRED`}),` and the video URL is no longer retrievable — download the result before then.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`webhook-payload`,children:`Webhook Payload`}),`\n`,_jsxs(_components.p,{children:[`When the task completes or fails, a POST request is sent to your `,_jsx(_components.code,{children:`webhook_url`}),`. See `,_jsx(_components.a,{href:`/concepts/webhooks`,children:`Webhooks`}),` for verification.`]}),`\n`,_jsx(Heading,{level:`3`,id:`webhook-headers`,children:`Webhook Headers`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Header`}),_jsx(_components.th,{children:`Value`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`X-VibePeak-Event`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`task.completed`}),` or `,_jsx(_components.code,{children:`task.failed`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`X-VibePeak-Signature`})}),_jsx(_components.td,{children:`HMAC-SHA256, hex encoded`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`X-VibePeak-Timestamp`})}),_jsx(_components.td,{children:`Unix timestamp in seconds`})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The signed message is `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`{timestamp}.{raw body}`})}),`, not the body alone. Concatenate the `,_jsx(_components.code,{children:`X-VibePeak-Timestamp`}),` value, a literal `,_jsx(_components.code,{children:`.`}),`, and the exact raw request body before computing the HMAC, or verification will fail.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The event name lives in the `,_jsx(_components.code,{children:`X-VibePeak-Event`}),` `,_jsx(_components.strong,{children:`header`}),`, not in the body. There is no `,_jsx(_components.code,{children:`event`}),` field inside the JSON.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`payload`,children:`Payload`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`14`,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:`14`,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:` \"task_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"vp_land_gXATHu1cGcD9Ht9s5-19I\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"completed\"`}),_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:` \"result\"`}),_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:` \"video_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://\u003cproject>.supabase.co/storage/v1/object/public/vibepeak/\u003cuser-id>/projects/land/\u003cproject-id>/final-1788179592692.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:` \"cover_image_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://storage.googleapis.com/vibepeak-api-images/covers/task_yo9RC7ZrE9YuFx4yXbg4N.jpg\"`})]}),`\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:` \"charged_credits\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`15`}),_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:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"marking\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"mask\"`}),_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:` \"used_overrides\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"marked_image_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"scenes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"script\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"language\"`}),_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:` \"generated_image_count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`For failed tasks:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`14`,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:`14`,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:` \"task_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"vp_land_gXATHu1cGcD9Ht9s5-19I\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"failed\"`}),_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:` \"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"GENERATION_FAILED\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Land generation failed\"`})]}),`\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:` \"charged_credits\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_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:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"marking\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"auto\"`}),_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:` \"generated_image_count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`4`}),_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:` \"used_overrides\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: []`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The webhook `,_jsx(_components.code,{children:`task_id`}),` is the task’s `,_jsx(_components.strong,{children:`external id`}),` (`,_jsx(_components.code,{children:`vp_land_\u003cid>`}),`), which is `,_jsx(_components.strong,{children:`not`}),` the `,_jsx(_components.code,{children:`task_id`}),` returned by `,_jsx(_components.code,{children:`POST /v1/land`}),` (`,_jsx(_components.code,{children:`task_\u003cid>`}),`) and cannot be passed to `,_jsx(_components.code,{children:`GET /v1/tasks/{id}`}),`. Store the value returned at creation and correlate on your side.`]})}),`\n`,_jsx(_components.p,{children:`Notes on the payload:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`resolution`}),` is the `,_jsx(_components.strong,{children:`typed`}),` shape only — `,_jsx(_components.code,{children:`marking`}),`, `,_jsx(_components.code,{children:`generated_image_count`}),`, `,_jsx(_components.code,{children:`used_overrides`}),`. It does `,_jsx(_components.strong,{children:`not`}),` include `,_jsx(_components.code,{children:`stage`}),`, `,_jsx(_components.code,{children:`progress`}),` or `,_jsx(_components.code,{children:`credits_breakdown`}),`; those appear only on the polling response.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`resolution`}),` is omitted entirely if marking was never resolved (for example, a failure during preparation).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`result`}),` carries `,_jsx(_components.strong,{children:`only`}),` `,_jsx(_components.code,{children:`video_url`}),` and `,_jsx(_components.code,{children:`cover_image_url`}),`. There is no `,_jsx(_components.code,{children:`duration_seconds`}),`, `,_jsx(_components.code,{children:`resolution`}),` or `,_jsx(_components.code,{children:`expires_at`}),` inside `,_jsx(_components.code,{children:`result`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`cover_image_url`}),` is present only if cover generation succeeded. Note that it is keyed by the internal `,_jsx(_components.code,{children:`task_\u003cid>`}),`, while the payload’s `,_jsx(_components.code,{children:`task_id`}),` is the `,_jsx(_components.code,{children:`vp_land_\u003cid>`}),` external id.`]}),`\n`,_jsxs(_components.li,{children:[`There is no `,_jsx(_components.code,{children:`event`}),`, `,_jsx(_components.code,{children:`type`}),` or `,_jsx(_components.code,{children:`timestamp`}),` field in the body. Distinguish outcomes with `,_jsx(_components.code,{children:`status`}),`, or read the `,_jsx(_components.code,{children:`X-VibePeak-Event`}),` header.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`marking`}),` field indicates which method was used to identify the buildable area:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`mask`})}),_jsxs(_components.td,{children:[`A pre-provided `,_jsx(_components.code,{children:`marked_image_url`}),` `,_jsx(_components.strong,{children:`or`}),` `,_jsx(_components.code,{children:`mask_image_url`}),` was used. `,_jsx(_components.code,{children:`marked_image_url`}),` takes precedence when both are sent.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`polygon`})}),_jsxs(_components.td,{children:[`A pre-provided `,_jsx(_components.code,{children:`area_polygon`}),` was rasterized into a mask`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`auto`})}),_jsx(_components.td,{children:`Gemini auto-detected the buildable area`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`fullimage`})}),_jsx(_components.td,{children:`Reserved. Present in the type contract but not currently emitted by any code path — do not branch on it.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`error-codes`,children:`Error Codes`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`VALIDATION_ERROR`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsxs(_components.td,{children:[`Invalid request parameters, frame count outside 3-10, `,_jsx(_components.code,{children:`order`}),` below 1, or `,_jsx(_components.code,{children:`music_id`}),`/`,_jsx(_components.code,{children:`music_kind`}),` not sent together`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_IMAGE_URL`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:`An image URL is unreachable, not an image, or too large`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`IMAGE_RESOLUTION_TOO_LOW`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:`An image is below the minimum resolution`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_WEBHOOK_URL`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:`Webhook URL failed SSRF validation`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_WATERMARK_GEOMETRY`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsxs(_components.td,{children:[`The `,_jsx(_components.code,{children:`elements_config`}),` watermark is enabled but too small or too faint to render (`,_jsx(_components.code,{children:`size`}),` ≥ 2 and `,_jsx(_components.code,{children:`opacity`}),` ≥ 5; `,_jsx(_components.code,{children:`size`}),` is not checked when `,_jsx(_components.code,{children:`mode`}),` is `,_jsx(_components.code,{children:`mosaic`}),`). No credits are charged`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_API_KEY`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:`Invalid or missing API key`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`INSUFFICIENT_CREDITS`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`402`}),_jsx(_components.td,{children:`Not enough credits to process the request`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ASSET_ACCESS_DENIED`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:`A VibePeak-hosted image URL belongs to another account`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`PLAN_REQUIRED`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:`Plan doesn’t include API access`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`CONCURRENCY_LIMIT_EXCEEDED`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:`Concurrent task limit reached`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`SERVICE_UNAVAILABLE`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`503`}),_jsx(_components.td,{children:`The job could not be enqueued; credits are refunded automatically`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Asynchronous failures are reported through the task’s `,_jsx(_components.code,{children:`error`}),` object and the failure webhook:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GENERATION_FAILED`})}),_jsx(_components.td,{children:`The land render failed downstream`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GENERATION_TIMEOUT`})}),_jsxs(_components.td,{children:[`The render was still running 180 minutes after the task was created. Credits are refunded. If the render finishes later, the task can still become `,_jsx(_components.code,{children:`completed`}),` — see `,_jsx(_components.a,{href:`#polling`,children:`Polling`})]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/concepts/error-handling`,children:`Error Handling`}),` for more details.`]}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next Steps`}),`\n`,_jsx(_components.p,{children:`After creating a task:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Poll for status`}),`: Use `,_jsx(_components.a,{href:`/api-reference/videos/get-task`,children:`Get Task`}),` with the `,_jsx(_components.code,{children:`task_id`}),` from the 202 response, every 30 seconds.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Wait for webhook`}),`: If configured, receive notification when complete — remembering the id difference noted above.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Download video`}),`: Access `,_jsx(_components.code,{children:`result.video_url`}),` within 24 hours of creation.`]}),`\n`]})]})}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":"Create Land Transformation Video","api":"POST /v1/land","description":"Create an AI-powered cinematic video transforming an empty plot of land into proposed constructions","href":"/api-reference/videos/create-land"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Request Body","slug":"request-body","depth":2,"children":[{"title":"Mask \u0026 Area Overrides","slug":"mask-\u0026-area-overrides","depth":3,"children":[]},{"title":"Terrain \u0026 Construction Overrides","slug":"terrain-\u0026-construction-overrides","depth":3,"children":[]},{"title":"Scene Chain (Fully Resolved)","slug":"scene-chain-fully-resolved","depth":3,"children":[]},{"title":"Script, Voice \u0026 Music Overrides","slug":"script-voice-\u0026-music-overrides","depth":3,"children":[]},{"title":"Subtitle \u0026 Elements Configuration","slug":"subtitle-\u0026-elements-configuration","depth":3,"children":[]},{"title":"Webhook","slug":"webhook","depth":3,"children":[]}]},{"title":"Response","slug":"response","depth":2,"children":[{"title":"Response Headers","slug":"response-headers","depth":3,"children":[]}]},{"title":"Credit Model","slug":"credit-model","depth":2,"children":[]},{"title":"Plan Access","slug":"plan-access","depth":2,"children":[]},{"title":"Frame Limits","slug":"frame-limits","depth":2,"children":[]},{"title":"Polling","slug":"polling","depth":2,"children":[]},{"title":"Webhook Payload","slug":"webhook-payload","depth":2,"children":[{"title":"Webhook Headers","slug":"webhook-headers","depth":3,"children":[]},{"title":"Payload","slug":"payload","depth":3,"children":[]}]},{"title":"Error Codes","slug":"error-codes","depth":2,"children":[]},{"title":"Next Steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL (Minimal — 1 image)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"7\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -X\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> https://api.vibepeak.ai/v1/land\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Authorization: Bearer vpk_live_xxxxx\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Content-Type: application/json\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -d\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"source_image_url\": \"https://example.com/land/empty-plot.jpg\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"format\": \"9:16\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"cURL (With mask and more constructions)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"9\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -X\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> https://api.vibepeak.ai/v1/land\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Authorization: Bearer vpk_live_xxxxx\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Content-Type: application/json\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -d\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"source_image_url\": \"https://example.com/land/empty-plot.jpg\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"format\": \"9:16\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"mask_image_url\": \"https://example.com/land/mask.png\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"num_constructions\": 5\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"cURL (Fully resolved — short-circuit)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"18\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -X\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> https://api.vibepeak.ai/v1/land\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Authorization: Bearer vpk_live_xxxxx\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Content-Type: application/json\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -d\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"source_image_url\": \"https://example.com/land/original.jpg\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"format\": \"16:9\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"marked_image_url\": \"https://example.com/land/marked.jpg\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"scenes\": [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> { \"image_url\": \"https://example.com/land/building1.jpg\", \"order\": 1, \"camera_movement\": \"dolly_in\" },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> { \"image_url\": \"https://example.com/land/building2.jpg\", \"order\": 2 },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> { \"image_url\": \"https://example.com/land/building3.jpg\", \"order\": 3 }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"script\": \"Discover the potential of this stunning plot. From raw land to a modern family home, the transformation is breathtaking.\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"voice_id\": \"EXAVITQu4vr4xnSDxMaL\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"voice_speed\": 0.9,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"language\": \"en\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"webhook_url\": \"https://yourserver.com/webhooks/vibepeak\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"cURL (No narration, with pinned music)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"11\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -X\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> https://api.vibepeak.ai/v1/land\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Authorization: Bearer vpk_live_xxxxx\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Content-Type: application/json\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -d\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"source_image_url\": \"https://example.com/land/empty-plot.jpg\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"format\": \"9:16\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"voiceover_enabled\": false,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"background_music\": true,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"music_id\": \"3f9a1c62-5b4e-4a77-9d21-0c8b6e4f1a35\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"music_kind\": \"stock\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Node.js","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"javascript\">\u003ccode language=\"javascript\" numberOfLines=\"17\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> response\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\"> fetch\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'https://api.vibepeak.ai/v1/land'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> method:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'POST'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> headers:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Authorization'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Bearer vpk_live_xxxxx'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Content-Type'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'application/json'\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> body:\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> JSON\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">stringify\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">({\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> source_image_url:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'https://example.com/land/empty-plot.jpg'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> format:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '9:16'\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> })\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">});\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> task\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> response\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">json\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">();\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">console\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">log\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`Task created: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">${\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">task\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">task_id\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">console\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">log\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`Status: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">${\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">task\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">status\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">console\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">log\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`Credits: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">${\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">task\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">charged_credits\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">console\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">log\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`Breakdown:`\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">task\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">resolution\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">credits_breakdown\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Python","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"python\">\u003ccode language=\"python\" numberOfLines=\"19\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">import\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">response \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests.post(\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'https://api.vibepeak.ai/v1/land'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\"> headers\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Authorization'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'Bearer vpk_live_xxxxx'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Content-Type'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'application/json'\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\"> json\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'source_image_url'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'https://example.com/land/empty-plot.jpg'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'format'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'9:16'\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">task \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> response.json()\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#DCDCAA\">print\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">f\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Task created: \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">{\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">task[\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'task_id'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">]\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#DCDCAA\">print\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">f\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Status: \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">{\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">task[\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'status'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">]\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#DCDCAA\">print\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">f\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Credits: \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">{\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">task[\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'charged_credits'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">]\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#DCDCAA\">print\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">f\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Breakdown: \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">{\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">task[\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'resolution'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">][\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'credits_breakdown'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">]\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"202 Accepted (Minimal)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"26\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"task_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"task_abc123xyz\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"preparing\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Land transformation request accepted\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"created_at\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-08-31T12:15:00.000Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"livemode\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"request_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"req_xyz123\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"charged_credits\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">40\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"resolution\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"stage\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"preparing\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"progress\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">10\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"credits_breakdown\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"base_render\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">15\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"generated_mask\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">5\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"generated_scene_count\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">3\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"generated_scenes\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">15\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"generated_script\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">5\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"total\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">40\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"used_overrides\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: []\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"_links\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"self\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"/v1/tasks/task_abc123xyz\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"poll_interval_seconds\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">30\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"202 Accepted (Fully Resolved)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"26\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"task_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"task_abc123xyz\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"preparing\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Land transformation request accepted\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"created_at\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-08-31T12:15:00.000Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"livemode\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"request_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"req_xyz123\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"charged_credits\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">15\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"resolution\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"stage\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"preparing\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"progress\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">10\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"credits_breakdown\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"base_render\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">15\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"generated_mask\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">0\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"generated_scene_count\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">0\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"generated_scenes\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">0\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"generated_script\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">0\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"total\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">15\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"used_overrides\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"marked_image_url\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"scenes\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"script\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"language\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"voice_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"_links\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"self\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"/v1/tasks/task_abc123xyz\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"poll_interval_seconds\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">30\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"400 Bad Request (Validation Error)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"16\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"VALIDATION_ERROR\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Land chains must contain 3 to 10 total frames including img0 and img1\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"request_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"req_xyz123\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"details\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"field\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"scenes\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"issues\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"path\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"scenes\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Land chains must contain 3 to 10 total frames including img0 and img1\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"400 Bad Request (Invalid Image URL)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"10\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"INVALID_IMAGE_URL\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Failed to access image: fetch failed (ENOTFOUND)\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"request_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"req_xyz123\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"details\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"invalid_images\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://example.com/land/empty-plot.jpg\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"402 Payment Required","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"7\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"INSUFFICIENT_CREDITS\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Insufficient credits\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"request_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"req_xyz123\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"403 Forbidden (Asset Access)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"7\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ASSET_ACCESS_DENIED\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Asset is not accessible\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"request_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"req_xyz123\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"403 Forbidden (Plan)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"11\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"PLAN_REQUIRED\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"API access requires a Plus, Pro, Max or Enterprise plan. Please upgrade your subscription.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"request_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"req_xyz123\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"details\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"current_plan\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Free\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"required_plans\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Plus\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Pro\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Max\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Enterprise\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"409 Conflict","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"12\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"CONCURRENCY_LIMIT_EXCEEDED\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"You have reached your concurrent task limit of 1. Please wait for existing tasks to complete.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"request_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"req_xyz123\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"details\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"limit\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"in_flight\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"plan\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Plus\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"503 Service Unavailable","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"7\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"SERVICE_UNAVAILABLE\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Land transformation service is temporarily unavailable. Please try again.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"request_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"req_xyz123\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Create Land Transformation Video","path":"/v1/land","method":"post","request":{"security":[],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"source_image_url":[{"type":"string","description":"Publicly accessible URL of a single photo of an empty plot of land. Must be a valid HTTP(S) URL Must be an image file (JPEG, PNG, or WebP) Only one image is accepted","required":true}],"format":[{"type":"string","description":"Target video format / aspect ratio. Value Description `9:16` Vertical video (portrait) — ideal for social media stories and reels `16:9` Horizontal video (landscape) — ideal for websites and presentations","required":true}],"mask_image_url":[{"type":"string","description":"Optional binary mask image (PNG) marking the buildable area with a neon outline and semi-transparent fill. When provided, the server uses this mask directly and skips auto-detection. Takes precedence over `area_polygon` . Alias: `mask_url` is accepted and normalized to `mask_image_url` . If both are sent, `mask_image_url` wins."}],"marked_image_url":[{"type":"string","description":"Optional pre-rendered marked terrain image (the `img1` frame — the source photo with the buildable area already highlighted). When provided, the server skips the marking render entirely and uses this frame directly. Like `mask_image_url` and `area_polygon` , supplying it waives the 5-credit mask charge, and the task reports `marking: \"mask\"` . It takes precedence over both `mask_image_url` and `area_polygon` ."}],"area_polygon":[{"type":"array","items":[{"type":"object","properties":{"x":[{"type":"number","description":"Normalized X coordinate between 0 and 1.","required":true}],"y":[{"type":"number","description":"Normalized Y coordinate between 0 and 1.","required":true}]}}],"description":"Optional polygon coordinates marking the buildable area. Minimum 3 points required. Each point is an object with normalized coordinates: Alias: `polygon` is accepted and normalized to `area_polygon` . If none of `mask_image_url` , `area_polygon` or `marked_image_url` is provided, the server auto-detects the buildable area using Gemini vision analysis."}],"terrain_type":[{"type":"string","description":"Optional terrain type hint, e.g. `\"urban\"` , `\"rural\"` or `\"industrial\"` . Any non-empty string is accepted — the value is a free-form hint passed to the proposal generator, not a closed enum. If omitted, the server analyzes the image and auto-detects the terrain type."}],"construction_prompts":[{"type":"array","items":[{"type":"string"}],"description":"Optional array of construction prompts (1-8). One image is generated per prompt in the order provided. When provided, the server skips proposal auto-generation and renders exactly these constructions. Each prompt is still billed as a generated scene. Alias: `prompts` is accepted and normalized to `construction_prompts` ."}],"num_constructions":[{"type":"integer","description":"Optional number of constructions to auto-generate (2-8). Default is 3. Ignored if `scenes` or `construction_prompts` are provided."}],"style":[{"type":"string","description":"Optional style hint that biases auto-generated proposals (e.g., `\"modern\"` , `\"rustic\"` , `\"minimalist\"` )."}],"exclude":[{"type":"string","description":"Optional exclusion hint for auto-generated proposals (e.g., `\"no swimming pools\"` , `\"no glass facades\"` )."}],"scenes":[{"type":"array","items":[{"type":"object","properties":{"image_url":[{"type":"string","description":"Publicly accessible URL of the scene image. Optional at the schema level, but a scene without an image cannot be rendered — always send it when supplying a resolved chain."}],"prompt":[{"type":"string","description":"Optional prompt that generated this scene."}],"order":[{"type":"integer","description":"Optional display order within the chain. Must be 1 or greater — `0` is rejected with `400 VALIDATION_ERROR` ."}],"camera_movement":[{"type":"string","description":"Optional per-scene camera movement applied by the WAN renderer. One of `traveling_left` , `traveling_right` , `traveling_up` , `traveling_down` , `dolly_in` , `dolly_out` , `arc_left` , `arc_right` . Omitted means the renderer picks the movement."}]}}],"description":"Optional fully-resolved scene chain (1-8 items). When provided, the server skips scene generation and renders these frames directly. Each scene is an object with:"}],"script":[{"type":"string","description":"Optional narration script for text-to-speech. Any non-empty string is accepted."}],"language":[{"type":"string","description":"Language code for the auto-generated script and TTS pronunciation (e.g., `en` , `es` , `de` , `fr` , `pt` ). Minimum 2 characters."}],"voice_id":[{"type":"string","description":"Voice ID for narration. You can find available voices using the List Voices endpoint. Defaults to a platform voice if omitted."}],"voice_speed":[{"type":"number","description":"Speaking rate of the synthesized voiceover. Values below `1` slow it down, above `1` speed it up. The effect depends on the voice and language: most voices follow the value closely, some apply it only partially, and each voice applies its own supported range within these bounds. Range: `0.5` to `2` ; values outside it are rejected with a validation error. Applies only when VibePeak synthesizes the voiceover, so it has no effect when `voiceover_enabled` is `false` ."}],"voiceover_enabled":[{"type":"boolean","description":"Set to `false` to render the video without narration. When `false` , the server skips text-to-speech entirely and `script` / `voice_id` may be omitted. Omitting this field leaves narration on ."}],"background_music":[{"type":"boolean","description":"Set to `true` to add a background music bed. Omitting this field, or sending `false` , renders the video without music."}],"music_id":[{"type":"string","description":"Optional Music Library track to pin, as a UUID . Without it, a `background_music: true` job uses a randomly selected bed."}],"music_kind":[{"type":"string","description":"Which catalogue `music_id` refers to: `stock` (Music Library track) or `ai` (AI-generated track). Required whenever `music_id` is present."}],"subtitle_config":[{"type":"object","properties":{},"description":"Subtitle configuration for word-level animated overlays. Same structure as other video endpoints — see Create Narrated Slideshow for the full field list. On this endpoint the object is passed through to the renderer without field-level validation, so a malformed key is accepted at request time and simply ignored downstream."}],"elements_config":[{"type":"object","properties":{},"description":"Configuration for visual elements and branding overlays (watermark, text, intro/outro). Same structure as other video endpoints — see Create Narrated Slideshow . The `intro_outro` block is fully validated; the rest is passed through to the renderer. Browse the designs in the template gallery , or read the catalogue from `GET /v1/intro-outro/templates` . As on Create Narrated Slideshow , the overlays are applied after the video renders. The task passes through the transitional `intro_outro` status while that runs, and if the overlays cannot be applied the task still completes: the video is delivered without them and the result carries an `intro_outro_warning` ."}],"webhook_url":[{"type":"string","description":"HTTPS URL to receive a webhook notification when the task completes or fails. See Webhooks for payload format and verification details."}]}}],"examples":{"example":{"value":{"source_image_url":"\u003cstring>","format":"\u003cstring>","mask_image_url":"\u003cstring>","marked_image_url":"\u003cstring>","area_polygon":[{"x":123,"y":123}],"terrain_type":"\u003cstring>","construction_prompts":["\u003cstring>"],"num_constructions":123,"style":"\u003cstring>","exclude":"\u003cstring>","scenes":[{"image_url":"\u003cstring>","prompt":"\u003cstring>","order":123,"camera_movement":"\u003cstring>"}],"script":"\u003cstring>","language":"\u003cstring>","voice_id":"\u003cstring>","voice_speed":123,"voiceover_enabled":true,"background_music":true,"music_id":"\u003cstring>","music_kind":"\u003cstring>","subtitle_config":{},"elements_config":{},"webhook_url":"\u003cstring>"}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"task_id":[{"type":"string","description":"Unique identifier for the task, in the form `task_\u003cid>` . Use this to poll for status via Get Task .","required":true}],"status":[{"type":"string","description":"Initial task status. Always `preparing` for land tasks.","required":true}],"message":[{"type":"string","description":"Human-readable acknowledgement — `\"Land transformation request accepted\"` .","required":true}],"created_at":[{"type":"string","description":"ISO 8601 timestamp of task creation.","required":true}],"livemode":[{"type":"boolean","description":"`true` for live keys. Requests made with a `vpk_test_` key return `false` and are not charged — see Test Mode .","required":true}],"request_id":[{"type":"string","description":"Request identifier, useful when contacting support.","required":true}],"charged_credits":[{"type":"integer","description":"Credits actually deducted for this request. See Credit Model for the breakdown.","required":true}],"resolution":[{"type":"object","properties":{"stage":[{"type":"string","description":"Current preparation stage — always `\"preparing\"` at creation."}],"progress":[{"type":"integer","description":"Preparation progress percentage (0-100). Starts at 10."}],"used_overrides":[{"type":"array","items":[{"type":"string"}],"description":"The request fields you supplied that overrode server-side generation, in canonical order. An explicit `background_music: false` counts as an override; an omitted field does not."}],"credits_breakdown":[{"type":"object","properties":{"base_render":[{"type":"integer","description":"Base render cost (15 credits)."}],"generated_mask":[{"type":"integer","description":"Cost for a server-generated mask (5 credits) — 0 if `mask_image_url` , `area_polygon` or `marked_image_url` is provided."}],"generated_scene_count":[{"type":"integer","description":"Number of scenes the server will generate."}],"generated_scenes":[{"type":"integer","description":"Total cost for generated scenes (5 credits each)."}],"generated_script":[{"type":"integer","description":"Cost for a server-generated script (5 credits) — 0 if `script` is provided."}],"total":[{"type":"integer","description":"Total credits charged."}]},"description":"Detailed credit cost breakdown."}]},"description":"Preparation metadata describing what the server will compute."}],"_links":[{"type":"object","properties":{},"description":"Convenience links: `self` (the poll URL) and `poll_interval_seconds` ."}]}}],"examples":{"example":{"value":{"task_id":"\u003cstring>","status":"\u003cstring>","message":"\u003cstring>","created_at":"\u003cstring>","livemode":true,"request_id":"\u003cstring>","charged_credits":123,"resolution":{"stage":"\u003cstring>","progress":123,"used_overrides":["\u003cstring>"],"credits_breakdown":{"base_render":123,"generated_mask":123,"generated_scene_count":123,"generated_scenes":123,"generated_script":123,"total":123}},"_links":{}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"vibepeak","siteName":"VibePeak API","title":"Create Land Transformation Video - VibePeak API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T13:36:43.785Z","originalFileLocation":"api-reference/videos/create-land.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 AI-powered cinematic video transforming an empty plot of land into proposed constructions\">\u003cmeta data-mint-head name=\"application-name\" content=\"VibePeak API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/vibepeak/WEFMqbnZHGgWkMrC/_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=\"/mintlify-assets/_mintlify/favicons/vibepeak/WEFMqbnZHGgWkMrC/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/vibepeak/WEFMqbnZHGgWkMrC/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/vibepeak/WEFMqbnZHGgWkMrC/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/vibepeak/WEFMqbnZHGgWkMrC/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/vibepeak/WEFMqbnZHGgWkMrC/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/vibepeak/WEFMqbnZHGgWkMrC/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/vibepeak/WEFMqbnZHGgWkMrC/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/vibepeak/WEFMqbnZHGgWkMrC/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Land Transformation Video - VibePeak API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create an AI-powered cinematic video transforming an empty plot of land into proposed constructions\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"VibePeak API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.vibepeak.ai/api-reference/videos/create-land\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://vibepeak.mintlify.site/_mintlify/api/og/v2?division=Videos\u0026amp;title=Create+Land+Transformation+Video\u0026amp;description=Create+an+AI-powered+cinematic+video+transforming+an+empty+plot+of+land+into+proposed+constructions\u0026amp;theme=7c923acadb6581409e9a0306\u0026amp;signature=c6c785832052750fea1a9913fc29fbe466fb417969a147d7b10c837ad299556e\">\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=\"Create Land Transformation Video - VibePeak API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create an AI-powered cinematic video transforming an empty plot of land into proposed constructions\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://vibepeak.mintlify.site/_mintlify/api/og/v2?division=Videos\u0026amp;title=Create+Land+Transformation+Video\u0026amp;description=Create+an+AI-powered+cinematic+video+transforming+an+empty+plot+of+land+into+proposed+constructions\u0026amp;theme=7c923acadb6581409e9a0306\u0026amp;signature=c6c785832052750fea1a9913fc29fbe466fb417969a147d7b10c837ad299556e\">\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=\"/mintlify-assets/_mintlify/favicons/vibepeak/WEFMqbnZHGgWkMrC/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"VibePeak API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.vibepeak.ai/api-reference/videos/create-land\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/videos/create-land.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.vibepeak.ai/#organization\",\"name\":\"VibePeak API\",\"url\":\"https://docs.vibepeak.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/vibepeak/19EbLYbVzhgj3JxG/logo/vibepeak.png?fit=max\u0026auto=format\u0026n=19EbLYbVzhgj3JxG\u0026q=85\u0026s=bf20e85f3fd209089d4bd0a4f84fbb16\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.vibepeak.ai#website\",\"name\":\"VibePeak API\",\"url\":\"https://docs.vibepeak.ai\",\"publisher\":{\"@id\":\"https://docs.vibepeak.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.vibepeak.ai/api-reference/videos/create-land#webpage\",\"url\":\"https://docs.vibepeak.ai/api-reference/videos/create-land\",\"name\":\"Create Land Transformation Video\",\"description\":\"Create an AI-powered cinematic video transforming an empty plot of land into proposed constructions\",\"dateModified\":\"2026-10-30T13:36:43.785Z\",\"isPartOf\":{\"@id\":\"https://docs.vibepeak.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.vibepeak.ai/api-reference/videos/create-land#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.vibepeak.ai/api-reference/videos/create-land#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Videos\",\"item\":\"https://docs.vibepeak.ai/api-reference/videos/create-living-property\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Land Transformation Video\",\"item\":\"https://docs.vibepeak.ai/api-reference/videos/create-land\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.vibepeak.ai/api-reference/videos/create-land#apireference\",\"headline\":\"Create Land Transformation Video\",\"name\":\"Create Land Transformation Video\",\"description\":\"Create an AI-powered cinematic video transforming an empty plot of land into proposed constructions\",\"url\":\"https://docs.vibepeak.ai/api-reference/videos/create-land\",\"mainEntityOfPage\":{\"@id\":\"https://docs.vibepeak.ai/api-reference/videos/create-land#webpage\"},\"dateModified\":\"2026-10-30T13:36:43.785Z\",\"publisher\":{\"@id\":\"https://docs.vibepeak.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.vibepeak.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"VibePeak API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"VibePeak API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/videos/create-land.md","siteName":"VibePeak API","nav":{"global":{"anchors":[{"anchor":"API Status","icon":"signal","href":"https://vibepeak.statuspage.io/"},{"anchor":"Support","icon":"envelope","href":"mailto:[email protected]"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Introduction","href":"/api-reference/introduction"}]},{"group":"Avatars","pages":[{"title":"List Avatars","api":"GET /v1/avatars","href":"/api-reference/avatars/list-avatars"}]},{"group":"Voices","pages":[{"title":"List Voices","api":"GET /v1/voices","href":"/api-reference/voices/list-voices"}]},{"group":"Videos","pages":[{"title":"Create Living Property Video","api":"POST /v1/real-estate/living-property","href":"/api-reference/videos/create-living-property"},{"title":"Create Narrated Slideshow","api":"POST /v1/real-estate/narrated-slideshow","description":"Create an AI-powered real estate narrated slideshow video","href":"/api-reference/videos/create-narrated-slideshow"},{"title":"Create Land Transformation Video","api":"POST /v1/land","href":"/api-reference/videos/create-land"},{"title":"Get Task Status","api":"GET /v1/tasks/{taskId}","description":"Retrieve the current status of a video generation task","href":"/api-reference/videos/get-task"},{"title":"Intro \u0026 Outro Templates","href":"/api-reference/videos/intro-outro-templates"},{"title":"List Intro \u0026 Outro Templates","api":"GET /v1/intro-outro/templates","href":"/api-reference/videos/list-intro-outro-templates"}]},{"group":"Families","pages":[{"title":"Preset Families","href":"/api-reference/families/preset-families"},{"title":"List Families","api":"GET /v1/families","href":"/api-reference/families/list-families"},{"title":"Create Family","api":"POST /v1/families","href":"/api-reference/families/create-family"},{"title":"Get Family","api":"GET /v1/families/{idOrSlug}","href":"/api-reference/families/get-family"},{"title":"Delete Family","api":"DELETE /v1/families/{familyId}","href":"/api-reference/families/delete-family"},{"title":"Add Family Member","api":"POST /v1/families/{familyId}/members","href":"/api-reference/families/add-family-member"},{"title":"Update Family Member","api":"PATCH /v1/families/{familyId}/members/{index}","href":"/api-reference/families/update-family-member"},{"title":"Regenerate Family Member Portrait","api":"POST /v1/families/{familyId}/members/{index}/regenerate","href":"/api-reference/families/regenerate-family-member"},{"title":"Remove Family Member","api":"DELETE /v1/families/{familyId}/members/{index}","href":"/api-reference/families/remove-family-member"}]},{"group":"Images","pages":[{"title":"Create Property Showcase","api":"POST /v1/real-estate/property-showcase","href":"/api-reference/images/create-property-showcase"},{"title":"Edit Property Showcase","api":"POST /v1/real-estate/property-showcase/edit","href":"/api-reference/images/edit-property-showcase"},{"title":"Showcase Templates","href":"/api-reference/images/property-showcase-templates"},{"title":"Custom Templates","href":"/api-reference/images/custom-templates"}]}]}]},"basePath":"","title":"Create Land Transformation Video - VibePeak API","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","CodeSnippet-eoRjC4Le.js","getApiPlaygroundDisplay-CZyAPlR2.js","Page-Cr9IwkK7.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js"]}