External API — Developer Guide

const response = await fetch('https://visionarispace.com/api/v1/convert', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    image_url: 'https://your-cdn.com/product.jpg'
    // Dimensions are auto-detected from the image pixels.
    // Use aspect_ratio: '3:2' for landscape/mural images, or
    // supply width_inches + height_inches for precise control.
  })
});

const data = await response.json();
const jobId = data.job_id;   // e.g. "api_a1b2c3d4..."
// Store jobId in your database or session

$ch = curl_init('https://visionarispace.com/api/v1/convert');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'X-API-Key: YOUR_API_KEY',
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'image_url' => 'https://your-cdn.com/product.jpg'
        // Dimensions are auto-detected from the image pixels.
        // Use 'aspect_ratio' => '3:2' for landscape/mural images, or
        // supply 'width_inches' + 'height_inches' for precise control.
    ])
]);
$data  = json_decode(curl_exec($ch), true);
$jobId = $data['job_id'];  // e.g. "api_a1b2c3d4..."
// Store $jobId in your database or session

async function waitForResult(jobId) {
  while (true) {
    const r = await fetch(`https://visionarispace.com/api/v1/status/${jobId}`, {
      headers: { 'X-API-Key': 'YOUR_API_KEY' }
    });
    const data = await r.json();
    if (data.status === 'completed') break;
    if (data.status === 'failed') throw new Error('Conversion failed');
    await new Promise(res => setTimeout(res, 3000));
  }
  const result = await fetch(`https://visionarispace.com/api/v1/result/${jobId}`, {
    headers: { 'X-API-Key': 'YOUR_API_KEY' }
  }).then(r => r.json());

  return {
    embedUrl:       result.embed_url,         // animated, clickable
    embedUrlStatic: result.embed_url_static   // display only
  };
}