curl -X POST https://api.vibepeak.ai/v1/land \
  -H "Authorization: Bearer vpk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "source_image_url": "https://example.com/land/empty-plot.jpg",
    "format": "9:16"
  }'

curl -X POST https://api.vibepeak.ai/v1/land \
  -H "Authorization: Bearer vpk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "source_image_url": "https://example.com/land/empty-plot.jpg",
    "format": "9:16",
    "mask_image_url": "https://example.com/land/mask.png",
    "num_constructions": 5
  }'

curl -X POST https://api.vibepeak.ai/v1/land \
  -H "Authorization: Bearer vpk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "source_image_url": "https://example.com/land/original.jpg",
    "format": "16:9",
    "marked_image_url": "https://example.com/land/marked.jpg",
    "scenes": [
      { "image_url": "https://example.com/land/building1.jpg", "order": 1, "camera_movement": "dolly_in" },
      { "image_url": "https://example.com/land/building2.jpg", "order": 2 },
      { "image_url": "https://example.com/land/building3.jpg", "order": 3 }
    ],
    "script": "Discover the potential of this stunning plot. From raw land to a modern family home, the transformation is breathtaking.",
    "voice_id": "EXAVITQu4vr4xnSDxMaL",
    "language": "en",
    "webhook_url": "https://yourserver.com/webhooks/vibepeak"
  }'

curl -X POST https://api.vibepeak.ai/v1/land \
  -H "Authorization: Bearer vpk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "source_image_url": "https://example.com/land/empty-plot.jpg",
    "format": "9:16",
    "voiceover_enabled": false,
    "background_music": true,
    "music_id": "3f9a1c62-5b4e-4a77-9d21-0c8b6e4f1a35",
    "music_kind": "stock"
  }'

const response = await fetch('https://api.vibepeak.ai/v1/land', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer vpk_live_xxxxx',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    source_image_url: 'https://example.com/land/empty-plot.jpg',
    format: '9:16'
  })
});

const task = await response.json();
console.log(`Task created: ${task.task_id}`);
console.log(`Status: ${task.status}`);
console.log(`Credits: ${task.charged_credits}`);
console.log(`Breakdown:`, task.resolution.credits_breakdown);

import requests

response = requests.post(
    'https://api.vibepeak.ai/v1/land',
    headers={
        'Authorization': 'Bearer vpk_live_xxxxx',
        'Content-Type': 'application/json'
    },
    json={
        'source_image_url': 'https://example.com/land/empty-plot.jpg',
        'format': '9:16'
    }
)

task = response.json()
print(f"Task created: {task['task_id']}")
print(f"Status: {task['status']}")
print(f"Credits: {task['charged_credits']}")
print(f"Breakdown: {task['resolution']['credits_breakdown']}")

{
  "task_id": "task_abc123xyz",
  "status": "preparing",
  "message": "Land transformation request accepted",
  "created_at": "2026-08-31T12:15:00.000Z",
  "livemode": true,
  "request_id": "req_xyz123",
  "charged_credits": 40,
  "resolution": {
    "stage": "preparing",
    "progress": 10,
    "credits_breakdown": {
      "base_render": 15,
      "generated_mask": 5,
      "generated_scene_count": 3,
      "generated_scenes": 15,
      "generated_script": 5,
      "total": 40
    },
    "used_overrides": []
  },
  "_links": {
    "self": "/v1/tasks/task_abc123xyz",
    "poll_interval_seconds": 30
  }
}

{
  "task_id": "task_abc123xyz",
  "status": "preparing",
  "message": "Land transformation request accepted",
  "created_at": "2026-08-31T12:15:00.000Z",
  "livemode": true,
  "request_id": "req_xyz123",
  "charged_credits": 15,
  "resolution": {
    "stage": "preparing",
    "progress": 10,
    "credits_breakdown": {
      "base_render": 15,
      "generated_mask": 0,
      "generated_scene_count": 0,
      "generated_scenes": 0,
      "generated_script": 0,
      "total": 15
    },
    "used_overrides": ["marked_image_url", "scenes", "script", "language", "voice_id"]
  },
  "_links": {
    "self": "/v1/tasks/task_abc123xyz",
    "poll_interval_seconds": 30
  }
}

{
  "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": "INVALID_IMAGE_URL",
    "message": "Failed to access image: fetch failed (ENOTFOUND)",
    "request_id": "req_xyz123",
    "details": {
      "invalid_images": ["https://example.com/land/empty-plot.jpg"]
    }
  }
}

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits",
    "request_id": "req_xyz123"
  }
}

{
  "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"
  }
}