VisionFly.ai API Documentation

# Upload an image to VisionFly CDN
curl -X POST "https://api.visionfly.ai/cdn/upload" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@/path/to/image.jpg" \
  -F "project=my-website"

# Response:
# {
#   "imageId": "img_abc123xyz",
#   "url": "https://img.visionfly.ai/img_abc123xyz",
#   "size": 245000,
#   "contentType": "image/jpeg"
# }

// Upload image to CDN
const formData = new FormData();
formData.append('file', imageFile);
formData.append('project', 'my-website');

const response = await fetch('https://api.visionfly.ai/cdn/upload', {
  method: 'POST',
  headers: { 'X-API-Key': 'YOUR_API_KEY' },
  body: formData
});

const { imageId, url } = await response.json();

// Use the CDN URL with transformations
const optimizedUrl = `https://img.visionfly.ai/${imageId}?w=800&f=webp&q=85`;

// React component example
function CDNImage({ imageId, width, height }) {
  const src = `https://img.visionfly.ai/${imageId}?w=${width}&h=${height}&f=webp`;
  return <img src={src} alt="CDN optimized" loading="lazy" />;
}

# List all images in your CDN library
curl -X GET "https://api.visionfly.ai/cdn/images" \
  -H "X-API-Key: YOUR_API_KEY"

# Filter by project
curl -X GET "https://api.visionfly.ai/cdn/images?project=my-website&limit=50" \
  -H "X-API-Key: YOUR_API_KEY"

# Get usage statistics
curl -X GET "https://api.visionfly.ai/cdn/usage" \
  -H "X-API-Key: YOUR_API_KEY"

# Resize and convert to WebP with smart optimization
curl -L -X GET "https://api.visionfly.ai/image?" \
  "src=https://example.com/photo.jpg&"\
  "w=800&h=600&"\
  "f=WEBP&q=85&opt=true" \
  -H "X-API-Key: YOUR_API_KEY \
  --output optimized.webp

# Apply multiple transformations
curl -L -X GET "https://api.visionfly.ai/image?"\
  "src=https://example.com/photo.jpg&"\
  "w=1200&fit=cover&"\
  "bri=20&con=15&sat=10&"\
  "sharp=5&opt=true" \
  -H "X-API-Key: YOUR_API_KEY" \
  --output enhanced.webp

// Using fetch API
const apiKey = 'YOUR_API_KEY';
const sourceUrl = 'https://example.com/photo.jpg';

const params = new URLSearchParams({
  src: sourceUrl,
  w: 800,
  h: 600,
  f: 'WEBP',
  q: 85,
  opt: 'true'  // Enable smart optimization
});

fetch(`https://api.visionfly.ai/image?${params}`, {
  headers: {
    'X-API-Key': apiKey
  }
})
  .then(response => response.blob())
  .then(blob => {
    const url = URL.createObjectURL(blob);
    // Use the image URL
    document.querySelector('img').src = url;
  });

// React component example
function OptimizedImage({ src, width, height }) {
  const apiKey = process.env.NEXT_PUBLIC_VISIONFLY_API_KEY;

  const imageUrl = `https://api.visionfly.ai/image?` +
    `src=${encodeURIComponent(src)}&` +
    `w=${width}&h=${height}&f=WEBP&q=85&opt=true`;

  return (
    <img
      src={imageUrl}
      alt="Optimized"
      loading="lazy"
      style={{ width, height }}
    />
  );
}

import requests
from urllib.parse import urlencode

api_key = 'YOUR_API_KEY'
source_url = 'https://example.com/photo.jpg'

params = {
    'src': source_url,
    'w': 800,
    'h': 600,
    'f': 'WEBP',
    'q': 85,
    'opt': True  # Enable smart optimization
}

response = requests.get(
    f'https://api.visionfly.ai/image?{urlencode(params)}',
    headers={'X-API-Key': api_key}
)

if response.status_code == 200:
    with open('optimized.webp', 'wb') as f:
        f.write(response.content)
    print('Image saved successfully!')
else:
    print(f'Error: {response.status_code}')

# Using with PIL/Pillow
from PIL import Image
from io import BytesIO

response = requests.get(
    f'https://api.visionfly.ai/image?{urlencode(params)}',
    headers={'X-API-Key': api_key}
)

image = Image.open(BytesIO(response.content))
image.show()

<?php
$apiKey = 'YOUR_API_KEY';
$sourceUrl = 'https://example.com/photo.jpg';

$params = http_build_query([
    'src' => $sourceUrl,
    'w' => 800,
    'h' => 600,
    'f' => 'WEBP',
    'q' => 85,
    'opt' => 'true'  // Enable smart optimization
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.visionfly.ai/image?$params");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-API-Key: $apiKey"
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    file_put_contents('optimized.webp', $response);
    echo 'Image saved successfully!';
} else {
    echo "Error: $httpCode";
}

// Helper function for generating image URLs
function visionfly_url($src, $options = []) {
    $params = array_merge(['src' => $src], $options);
    return 'https://api.visionfly.ai/image?' . http_build_query($params);
}

// Usage in HTML
$imageUrl = visionfly_url('https://example.com/photo.jpg', [
    'w' => 800,
    'h' => 600,
    'f' => 'WEBP',
    'opt' => 'true'
]);
echo "<img src='$imageUrl' alt='Optimized'>";
?>