API Documentation

{
  "type": "image",
  "prompt": "A sunset over mountains",
  "model": "imagen4",
  "referenceImages": {
    "mode": "ingredients",
    "images": [
      {
        "name": "reference_1.jpg",
        "data": "data:image/jpeg;base64,/9j/4AAQSkZ...",
        "mimeType": "image/jpeg"
      }
    ]
  }
}

{
  "type": "image",
  "prompt": "@\"test Character\" man in home",
  "model": "nano_banana2",
  "referenceImages": {
    "mode": "tag",
    "characters": ["test Character"]
  }
}

// Names must match the assets already in your Flow project.
const characters = ['sara girl', 'ahmed boy', 'magic forest'];

// Quote any name that contains a space.
const scenes = [
  '@"sara girl" walks into @"magic forest" at sunrise',
  '@"sara girl" and @"ahmed boy" find a glowing lantern',
  '@"ahmed boy" holds the lantern high, @"magic forest" lights up',
];

for (const prompt of scenes) {
  const res = await fetch('https://autoflow-api.aboessa101.workers.dev/api/jobs', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      type: 'image',            // or 'video'
      prompt,
      model: 'nano_banana2',
      aspectRatio: 'landscape',
      referenceImages: { mode: 'tag', characters },
    }),
  });

  const { jobId } = await res.json();
  console.log('queued scene:', jobId);
}

{
  "image": "data:image/png;base64,iVBORw0KGgo...",
  "width": 1024,
  "format": "image/webp",
  "quality": 85
}

// request
{ "image": "data:image/png;base64,iVBORw0KGgo..." }

// response
{
  "success": true,
  "info": { "fileSize": 915443, "width": 1600, "height": 1200, "format": "image/png" }
}

{
  "image": "data:image/png;base64,iVBORw0KGgo...",
  "mask":  "data:image/png;base64,iVBORw0KGgo..."
}

import { pipeline } from '@huggingface/transformers';

// Runs in the browser / extension via WebGPU or WASM.
const segmenter = await pipeline('background-removal', 'briaai/RMBG-1.4');
const [{ mask }] = await segmenter(imageUrl);

// Send the mask alongside the original image.
const res = await fetch('https://autoflow-api.aboessa101.workers.dev/api/images/remove-background', {
  method: 'POST',
  headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({ image: originalDataUrl, mask: maskDataUrl }),
});

const { image } = await res.json(); // PNG cutout with transparency