cabina-vision

Endpoint

POST /functions/v1/cabina-vision

Overview

The cabina-vision edge function handles the complete AI image generation pipeline:

Load balances API keys from pool
Uploads user photo to CDN
Fetches AI prompt for selected style
Creates Kie.ai generation task
Polls for completion (up to 45 seconds)
Stores result in Supabase Storage
Records generation in database
Deducts credits (event or user)
Sends notifications (push/email/WhatsApp)

This function is critical for both B2C and B2B (event) workflows.

Request

Headers

Authorization

string

required

Bearer token with Supabase anon key

Authorization: Bearer <SUPABASE_ANON_KEY>

Content-Type

string

required

Must be application/json

Body Parameters

user_photo

string

required

Base64-encoded image or public URLFormat: data:image/png;base64,iVBORw0KG... or https://...Max size: ~5MB (before encoding)

model_id

string

required

Style identifier from styles_metadata tableExamples: pb_a, suit_b, jhonw_c

aspect_ratio

string

default:"9:16"

Output image aspect ratioOptions: 1:1, 4:3, 3:4, 16:9, 9:16

user_id

uuid

Authenticated user ID (for B2C mode)Mutually exclusive with event_id

event_id

uuid

Event ID (for B2B/event mode)Mutually exclusive with user_id

guest_id

string

Temporary guest identifier for event modeUsed for: Storage path and analytics

string

Email address to send notification (optional)

phone

string

Phone number for WhatsApp notification (optional)

action

string

default:"generate"

Operation typeOptions:

generate - Create new generation
check - Check status of existing task

taskId

string

Kie.ai task ID (required when action=check)

Response

Success Response (Immediate)

{
  "success": true,
  "image_url": "https://elesttjfwfhvzdvldytn.supabase.co/storage/v1/object/public/generations/results/guest_123_1234567890.png"
}

success

boolean

Always true for successful generations

image_url

string

Public URL to the generated image

Polling Response (Still Processing)

{
  "success": true,
  "taskId": "kie-task-abc123",
  "state": "waiting"
}

taskId

string

Kie.ai task identifier for status checks

state

string

Current task state: waiting, processing, success, or fail

Error Response

{
  "error": "UPLOAD_FOTO -> KIE_CREATETASK -> KIE_402: Saldo insuficiente en la cuenta de IA.",
  "success": false
}

Code Examples

Generate Image (Event Mode)

import { supabase } from './supabaseClient';

const generateEventPhoto = async (
  photoBase64: string,
  styleId: string,
  eventId: string,
  guestId: string
) => {
  const { data, error } = await supabase.functions.invoke('cabina-vision', {
    body: {
      user_photo: photoBase64,
      model_id: styleId,
      aspect_ratio: '9:16',
      event_id: eventId,
      guest_id: guestId
    }
  });

  if (error) throw error;
  
  if (data.taskId) {
    // Still processing, poll for result
    return pollForResult(data.taskId);
  }
  
  return data.image_url;
};

const pollForResult = async (taskId: string): Promise<string> => {
  const maxAttempts = 20;
  let attempts = 0;

  while (attempts < maxAttempts) {
    await new Promise(r => setTimeout(r, 3000)); // Wait 3s
    
    const { data } = await supabase.functions.invoke('cabina-vision', {
      body: {
        action: 'check',
        taskId: taskId
      }
    });

    if (data.state === 'success') {
      return data.image_url;
    }
    
    if (data.state === 'fail') {
      throw new Error('Generation failed');
    }
    
    attempts++;
  }
  
  throw new Error('Generation timeout');
};

Generate Image (B2C Mode)

const generateUserPhoto = async (
  photoBase64: string,
  styleId: string,
  userId: string,
  email: string
) => {
  const { data, error } = await supabase.functions.invoke('cabina-vision', {
    body: {
      user_photo: photoBase64,
      model_id: styleId,
      user_id: userId,
      email: email
    }
  });

  if (error) throw error;
  return data.image_url;
};

Check Task Status

const checkGenerationStatus = async (taskId: string) => {
  const { data, error } = await supabase.functions.invoke('cabina-vision', {
    body: {
      action: 'check',
      taskId: taskId
    }
  });

  if (error) throw error;
  
  return {
    state: data.state,
    imageUrl: data.image_url
  };
};

Implementation Details

API Key Load Balancing

The function selects the least-recently-used active API key:

const { data: poolData } = await supabase
  .from('api_key_pool')
  .select('id, api_key')
  .eq('is_active', true)
  .order('last_used_at', { ascending: true })
  .limit(1)
  .maybeSingle();

const currentApiKey = poolData?.api_key || fallbackKey;

From source: supabase/functions/cabina-vision/index.ts:32-38

Credit Deduction (Event Mode)

Credits are decremented atomically via RPC:

if (event_id) {
  const { data: creditOk, error } = await supabase.rpc(
    'increment_event_credit',
    { p_event_id: event_id }
  );
  
  if (!creditOk) {
    throw new Error('Event credits exhausted');
  }
}

From source: supabase/functions/cabina-vision/index.ts:69-83

Photo Upload Pipeline

Two-tier upload strategy:

Primary: Kie.ai CDN upload
Fallback: Supabase Storage bucket

// Try Kie.ai upload
const upRes = await fetch('https://kieai.redpandaai.co/api/file-base64-upload', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${apiKey}` },
  body: JSON.stringify({ base64Data: user_photo })
});

// Fallback to Supabase if failed
if (!publicPhotoUrl) {
  const { error } = await supabase.storage
    .from('user_photos')
    .upload(fileName, binaryData);
}

From source: supabase/functions/cabina-vision/index.ts:90-135

AI Generation Request

Uses Kie.ai Nano Banana Pro model:

const createRes = await fetch('https://api.kie.ai/api/v1/jobs/createTask', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${apiKey}` },
  body: JSON.stringify({
    model: 'nano-banana-pro',
    input: {
      prompt: masterPrompt,
      image_input: [publicPhotoUrl],
      aspect_ratio: '9:16',
      resolution: '2K',
      output_format: 'png'
    }
  })
});

From source: supabase/functions/cabina-vision/index.ts:152-165

Internal Polling

Function polls for up to 45 seconds before returning task ID:

let attempts = 0;
while (attempts < 15) {
  await new Promise(r => setTimeout(r, 3000)); // 3s delay
  
  const queryRes = await fetch(
    `https://api.kie.ai/api/v1/jobs/recordInfo?taskId=${taskId}`
  );
  
  if (state === 'success') {
    kieImageUrl = queryData.data.resultUrl;
    break;
  }
  
  attempts++;
}

From source: supabase/functions/cabina-vision/index.ts:185-216

Error Codes

UPLOAD_FAIL

string

Photo upload failed on both Kie.ai and SupabaseSolution: Check image size and format

KIE_402

string

Insufficient AI credits in Kie.ai accountSolution: Top up Kie.ai account or add backup API key to pool

KIE_401

string

Invalid Kie.ai API credentialsSolution: Verify BANANA_API_KEY secret is correct

RPC_DENIED

string

Event has no remaining creditsSolution: Allocate more credits to the event

KIE_FAILED_STATE

string

AI generation task failedSolution: Check Kie.ai dashboard for details, retry with different photo

Environment Variables

SUPABASE_URL

string

required

Auto-injected by Supabase

SUPABASE_SERVICE_ROLE_KEY

string

required

Auto-injected by Supabase

BANANA_API_KEY

string

required

Kie.ai API key (fallback if pool is empty)Set via: supabase secrets set BANANA_API_KEY=your-key

Performance

Typical Response Times:

Upload + Task creation: 2-5 seconds
AI generation: 10-30 seconds
Storage + DB write: 1-2 seconds
Total: 15-40 seconds

Optimization Tips:

Use multiple API keys in pool to distribute load
Pre-compress images client-side to reduce upload time
Consider client-side polling instead of server-side for faster response

Next Steps

Payment Webhook

Mercado Pago integration

AI Model Integration

Deep dive into AI pipeline

Setup & Deployment

Database

API Reference

Integration

Endpoint

Overview

Request

Headers

Body Parameters

Response

Success Response (Immediate)

Polling Response (Still Processing)

Error Response

Code Examples

Generate Image (Event Mode)

Generate Image (B2C Mode)

Check Task Status

Implementation Details

API Key Load Balancing

Credit Deduction (Event Mode)

Photo Upload Pipeline

AI Generation Request

Internal Polling

Error Codes

Environment Variables

Performance

Next Steps

Payment Webhook

AI Model Integration

Build docs developers (and LLMs) love

Setup & Deployment

Database

API Reference

Integration

​Endpoint

​Overview

​Request

​Headers

​Body Parameters

​Response

​Success Response (Immediate)

​Polling Response (Still Processing)

​Error Response

​Code Examples

​Generate Image (Event Mode)

​Generate Image (B2C Mode)

​Check Task Status

​Implementation Details

​API Key Load Balancing

​Credit Deduction (Event Mode)

​Photo Upload Pipeline

​AI Generation Request

​Internal Polling

​Error Codes

​Environment Variables

​Performance

​Next Steps

Payment Webhook

AI Model Integration

Build docs developers (and LLMs) love

Endpoint

Overview

Request

Headers

Body Parameters

Response

Success Response (Immediate)

Polling Response (Still Processing)

Error Response

Code Examples

Generate Image (Event Mode)

Generate Image (B2C Mode)

Check Task Status

Implementation Details

API Key Load Balancing

Credit Deduction (Event Mode)

Photo Upload Pipeline

AI Generation Request

Internal Polling

Error Codes

Environment Variables

Performance

Next Steps