API Reference

X-API-Key: isa_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

curl -X POST "https://ufsovdkahowhttxisneo.supabase.co/functions/v1/api-generate" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: isa_your_key_here" \
  -d '{
    "prompt": "Create an engaging caption for a new coffee shop opening",
    "platform": "instagram",
    "mode": "marketing",
    "type": "text"
  }'

{
  "success": true,
  "type": "text",
  "data": {
    "content": "☕ Your morning just got better! Grand opening this Saturday — come taste the difference. Fresh roasts, cozy vibes, and baristas who actually care. 📍 123 Main St\n\n#CoffeeShop #GrandOpening #LocalCoffee #MorningVibes",
    "platform": "instagram",
    "mode": "marketing"
  },
  "credits": {
    "used": 1,
    "remaining": 499
  }
}

curl -X POST "https://ufsovdkahowhttxisneo.supabase.co/functions/v1/api-generate" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: isa_your_key_here" \
  -d '{
    "prompt": "A vibrant flat lay of workout gear — dumbbells, protein shaker, and running shoes on a clean white surface",
    "platform": "instagram",
    "type": "image"
  }'

{
  "success": true,
  "type": "image",
  "data": {
    "image_url": "data:image/png;base64,iVBORw0KGgo...",
    "prompt": "A vibrant flat lay of workout gear...",
    "platform": "instagram"
  },
  "credits": {
    "used": 2,
    "remaining": 498
  }
}

{
  "messages": [
    {
      "role": "user",
      "content": "Create a caption for my bakery's new croissant flavor"
    },
    {
      "role": "assistant",
      "content": "🥐 Meet our newest obsession: Brown Butter Hazelnut Croissant. Layers of golden pastry, a nutty swirl inside, and a crunch that'll stop your scroll. Available starting Friday."
    },
    {
      "role": "user",
      "content": "Perfect — now make a shorter version for Twitter"
    }
  ],
  "platform": "twitter",
  "mode": "social",
  "type": "text"
}

{
  "success": true,           // boolean — always true on 200
  "type": "text",            // echoes request type
  "data": {
    "content": "...",        // ready-to-post text
    "platform": "instagram", // echoed platform
    "mode": "marketing"      // echoed mode
  },
  "credits": {
    "used": 1,               // credits consumed by this request
    "remaining": 499         // your balance after this request
  }
}

{
  "success": true,
  "type": "image",
  "data": {
    "image_url": "data:image/png;base64,...", // full data URI
    "prompt": "...",         // echoed prompt
    "platform": "instagram"  // echoed platform
  },
  "credits": {
    "used": 2,
    "remaining": 498
  }
}

{
  "error": "Invalid platform",
  "valid_platforms": ["instagram","twitter","facebook","linkedin","tiktok","youtube","pinterest","threads"],
  "received": "snapchat"
}

{ "error": "Invalid API key" }

{
  "error": "Insufficient credits",
  "message": "This request requires 2 credits, you have 1",
  "balance": 1,
  "required": 2
}

{
  "method": "POST",
  "url": "https://ufsovdkahowhttxisneo.supabase.co/functions/v1/api-generate",
  "headers": {
    "Content-Type": "application/json",
    "X-API-Key": "{{ $env.ISOCIALIZE_API_KEY }}"
  },
  "body": {
    "prompt": "{{ $json.prompt }}",
    "platform": "{{ $json.platform }}",
    "mode": "social",
    "type": "text"
  }
}

import os
import requests

API_KEY = os.environ["ISOCIALIZE_API_KEY"]
ENDPOINT = "https://ufsovdkahowhttxisneo.supabase.co/functions/v1/api-generate"

def generate(prompt: str, platform: str = "instagram", mode: str = "social", content_type: str = "text") -> dict:
    response = requests.post(
        ENDPOINT,
        headers={
            "Content-Type": "application/json",
            "X-API-Key": API_KEY,
        },
        json={
            "prompt": prompt,
            "platform": platform,
            "mode": mode,
            "type": content_type,
        },
        timeout=30,
    )
    response.raise_for_status()
    return response.json()

# Generate a caption
result = generate(
    prompt="Coffee shop grand opening this Saturday",
    platform="instagram",
    mode="marketing",
)
print(result["data"]["content"])
print(f"Credits remaining: {result['credits']['remaining']}")

const ENDPOINT = "https://ufsovdkahowhttxisneo.supabase.co/functions/v1/api-generate";

interface GenerateOptions {
  prompt: string;
  platform?: "instagram" | "twitter" | "facebook" | "linkedin" | "tiktok" | "youtube" | "pinterest" | "threads";
  mode?: "social" | "marketing" | "personal" | "business";
  type?: "text" | "image";
}

async function generate(options: GenerateOptions) {
  const res = await fetch(ENDPOINT, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-API-Key": process.env.ISOCIALIZE_API_KEY!,
    },
    body: JSON.stringify(options),
  });

  if (!res.ok) {
    const err = await res.json();
    throw new Error(err.error || `HTTP ${res.status}`);
  }

  return res.json();
}

// Usage
const result = await generate({
  prompt: "Write a thought leadership post about remote work trends",
  platform: "linkedin",
  mode: "business",
});

console.log(result.data.content);
console.log(`Credits remaining: ${result.credits.remaining}`);

https://ai.isocialize.me/openapi.json