FlashShot Developer API Reference

curl -X POST https://api.flashshot.io/v1/transform \
  -H "Authorization: Bearer fs_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://jrgelectronics.co.za/uploads/raw/watch.jpg",
    "theme_key": "pro_white",
    "format_key": "square",
    "original_filename": "garmin-fenix-7.png"
  }'

const response = await fetch('https://api.flashshot.io/v1/transform', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer fs_live_YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    image: 'https://jrgelectronics.co.za/uploads/raw/watch.jpg',
    theme_key: 'pro_white',
    format_key: 'square',
    original_filename: 'garmin-fenix-7.png'
  })
});

const result = await response.json();
console.log('CDN URL:', result.output_url);
console.log('Job ID:', result.job_id);

import requests

url = "https://api.flashshot.io/v1/transform"
headers = {
    "Authorization": "Bearer fs_live_YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "image": "https://jrgelectronics.co.za/uploads/raw/watch.jpg",
    "theme_key": "pro_white",
    "format_key": "square",
    "original_filename": "garmin-fenix-7.png"
}

res = requests.post(url, json=payload, headers=headers)
print(res.json())

curl -X POST https://api.flashshot.io/v1/refine \
  -H "Authorization: Bearer fs_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "parent_job_id": "job_1788770854344_9a0891c8",
    "custom_prompt": "Soften the white specular highlight on the metal bezel and warm the rim light slightly."
  }'

const response = await fetch('https://api.flashshot.io/v1/refine', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer fs_live_YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    parent_job_id: 'job_1788770854344_9a0891c8',
    custom_prompt: 'Soften the white specular highlight on the metal bezel and warm the rim light slightly.'
  })
});

const result = await response.json();
console.log('Refined CDN URL:', result.output_url);
console.log('Job ID:', result.job_id);

import requests

url = "https://api.flashshot.io/v1/refine"
headers = {
    "Authorization": "Bearer fs_live_YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "parent_job_id": "job_1788770854344_9a0891c8",
    "custom_prompt": "Soften the white specular highlight on the metal bezel and warm the rim light slightly."
}

res = requests.post(url, json=payload, headers=headers)
print(res.json())

curl https://api.flashshot.io/v1/jobs/job_1788770854344_9a0891c8 \
  -H "Authorization: Bearer fs_live_YOUR_API_KEY"

const jobId = 'job_1788770854344_9a0891c8';
const response = await fetch(`https://api.flashshot.io/v1/jobs/${jobId}`, {
  headers: {
    'Authorization': 'Bearer fs_live_YOUR_API_KEY'
  }
});

const result = await response.json();
console.log('Status:', result.job.status);
console.log('Render URL:', result.job.output_url);

import requests

job_id = "job_1788770854344_9a0891c8"
url = f"https://api.flashshot.io/v1/jobs/{job_id}"
headers = {
    "Authorization": "Bearer fs_live_YOUR_API_KEY"
}

res = requests.get(url, headers=headers)
print(res.json())

curl https://api.flashshot.io/v1/themes

const response = await fetch('https://api.flashshot.io/v1/themes');
const { themes, formats } = await response.json();
console.log('Available themes:', themes.map(t => t.key));
console.log('Available formats:', formats.map(f => f.key));

import requests

res = requests.get("https://api.flashshot.io/v1/themes")
data = res.json()
print("Themes:", [t["key"] for t in data.get("themes", [])])
print("Formats:", [f["key"] for f in data.get("formats", [])])

curl https://api.flashshot.io/v1/account \
  -H "Authorization: Bearer fs_live_YOUR_API_KEY"

const response = await fetch('https://api.flashshot.io/v1/account', {
  headers: {
    'Authorization': 'Bearer fs_live_YOUR_API_KEY'
  }
});

const result = await response.json();
console.log('Credits Balance:', result.account.credits.balance);
console.log('Tier:', result.account.tier);

import requests

headers = {
    "Authorization": "Bearer fs_live_YOUR_API_KEY"
}

res = requests.get("https://api.flashshot.io/v1/account", headers=headers)
account = res.json()["account"]
print("Available Credits:", account["credits"]["balance"])

curl https://api.flashshot.io/v1/openapi.json -o openapi.json

const response = await fetch('https://api.flashshot.io/v1/openapi.json');
const openapiSpec = await response.json();
console.log('OpenAPI Version:', openapiSpec.openapi);
console.log('Title:', openapiSpec.info.title);
console.log('Endpoints:', Object.keys(openapiSpec.paths));

import requests

res = requests.get("https://api.flashshot.io/v1/openapi.json")
spec = res.json()
print("API Title:", spec["info"]["title"])
print("Version:", spec["info"]["version"])
print("Available Paths:", list(spec.get("paths", {}).keys()))