Zelko API

POST /api/generate-image
Authorization: Bearer <supabase_access_token>
Content-Type: multipart/form-data

import { supabase } from "@/lib/supabase";

const { data: { session } } = await supabase.auth.getSession();
const token = session?.access_token;

{
  "assetId": "a1b2c3d4-...",     // null in demo mode
  "outputUrl": "https://fal.media/files/...",
  "creditsUsed": 2
}

const formData = new FormData();
formData.append("file", roomPhoto);           // File object
formData.append("operation", "staging");
formData.append("style", "Modern");
formData.append("roomType", "living_room");
formData.append("orgId", session.user.org_id);
formData.append("preserveStructure", "true");

const res = await fetch("/api/generate-image", {
  method: "POST",
  headers: { Authorization: `Bearer ${session.access_token}` },
  body: formData,
});

const { outputUrl, creditsUsed } = await res.json();
// outputUrl → CDN URL of the staged room image

formData.append("operation", "style_swap");
formData.append("referenceFile", referencePhoto);  // upgrades to kontext/max
// Model automatically switches to fal-ai/flux-pro/kontext/max
// Prompt: "Transform room in first image to match style in second image"

// type: "listing"
{
  "description": "Welcome to this stunning Modern masterpiece...",
  "compliance": {
    "compliance_check": "PASS",
    "violations": [],
    "suggestions": []
  }
}

// type: "social"
{
  "instagram": "✨ Just listed! This beautifully staged...",
  "facebook": "NEW LISTING at 123 Sunset Blvd...",
  "linkedin": "Excited to present this exceptional property..."
}

// type: "taglines"
{
  "taglines": [
    "Where Modern Luxury Meets Timeless Comfort",
    "Your Dream Home Awaits on Sunset Blvd",
    "Elevated Living in the Heart of the City"
  ]
}

const res = await fetch("/api/generate-copy", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    type: "listing",
    orgId: "demo",
    propertyDetails: {
      address: "123 Sunset Blvd, Los Angeles, CA",
      bedrooms: "4",
      bathrooms: "3",
      sqft: "2400",
      type: "Single Family",
      notes: "Newly renovated kitchen, pool, mountain views",
    },
  }),
});

const { description, compliance } = await res.json();
// compliance.compliance_check === "PASS" | "FAIL"

// Connect Zapier
await fetch("/api/integrations/zapier", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    orgId: "your-org-uuid",
    webhook_url: "https://hooks.zapier.com/hooks/catch/123456/abcdef/",
  }),
});

// Connect Follow Up Boss
await fetch("/api/integrations/fub", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ orgId: "your-org-uuid", api_key: "fub_xxxxxxxxxx" }),
});

// Connect HubSpot
await fetch("/api/integrations/hubspot", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ orgId: "your-org-uuid", access_token: "pat-na1-xxx" }),
});

await fetch("/api/integrations/zapier", {
  method: "DELETE",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ orgId: "your-org-uuid" }),
});

{ "connected": true }

{
  "event":        "asset.completed",
  "asset_id":     "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "output_url":   "https://fal.media/files/generated-room.jpg",
  "operation":    "staging",
  "style":        "Modern",
  "room_type":    "living_room",
  "credits_used": 2,
  "org_id":       "org-uuid-here",
  "timestamp":    "2026-03-14T12:34:56.789Z"
}

type Asset = {
  id:                 string;          // UUID
  project_id:         string | null;   // FK → projects.id
  org_id:             string;          // FK → organizations.id
  type:               "image" | "video" | "text" | "flyer" | "social";
  subtype:            string | null;   // operation key, e.g. "staging"
  input_url:          string | null;   // original uploaded photo
  output_url:         string | null;   // generated result (fal.media CDN)
  generation_params:  Record<string, unknown> | null;
  model_used:         string | null;   // e.g. "fal-ai/flux-pro/kontext"
  credits_cost:       number;
  status:             "pending" | "processing" | "completed" | "failed";
  created_at:         string;          // ISO 8601
};

type Organization = {
  id:                 string;
  name:               string;
  owner_id:           string;          // FK → auth.users.id
  plan:               "free" | "starter" | "professional" | "agency" | "enterprise";
  credits_remaining:  number;
  stripe_customer_id: string | null;
  white_label_config: Record<string, unknown> | null;
  created_at:         string;
};

type Project = {
  id:             string;
  org_id:         string;
  address:        string;
  city:           string | null;
  property_type:  "residential" | "commercial" | "land" | "multi-family" | null;
  status:         "active" | "archived";
  thumbnail_url:  string | null;
  created_at:     string;
  updated_at:     string;
};

type OrgIntegration = {
  id:         string;
  org_id:     string;
  provider:   "zapier" | "fub" | "hubspot";
  config:     {
    webhook_url?:   string;  // Zapier
    api_key?:       string;  // Follow Up Boss
    access_token?:  string;  // HubSpot
  };
  enabled:    boolean;
  created_at: string;
  updated_at: string;
};

-- Atomic credit deduction (prevents overdraft under concurrent load)
select deduct_org_credits(p_org_id := 'org-uuid', p_amount := 2);

-- Adds credits (Stripe webhook on purchase)
select add_org_credits(p_org_id := 'org-uuid', p_amount := 50);

-- Every deduction is logged in credits_ledger
-- amount is negative for usage, positive for purchases/refunds