Prefy — AI Platform Skill

Quick Start

# Chat completion (OpenAI-compatible, streaming)
curl https://prefy.com/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PREFY_API_KEY" \
  -d '{"model":"conductor:fast","messages":[{"role":"user","content":"Hello"}],"stream":true}'

Authentication

All endpoints require Authorization: Bearer <key> header.

• Conductor API: Use Prefy API key (starts with pc_)
• Server/Agent APIs: Use Supabase JWT token

Conductor AI — Smart Model Router

POST https://prefy.com/api/v1/chat/completions

OpenAI-compatible. Drop-in replacement. Supports streaming.

Models

Strategies

Append strategy to conductor model name:

• :fast — Gemini Flash / Groq (cheapest, fastest)
• :quality — GPT-4o / Claude (best quality)
• :creative — High temperature, diverse outputs
• :private — Routes through privacy-first providers

Web Search

POST https://prefy.com/api/v1/search

{"query": "latest AI news", "max_results": 5}

Returns Tavily search results with snippets.

Image Generation

POST https://prefy.com/api/v1/images/generate

{"prompt": "a sunset over mountains", "model": "flux-schnell"}

Returns base64 image. Uses Together AI FLUX Schnell (free tier).

Server Management

Provision and manage dedicated VPS servers.

• POST /api/v1/servers/checkout — Create Stripe checkout for server plan
• POST /api/v1/servers/command — Send command to server agent
• GET /api/v1/servers/hetzner — List user's servers

Server Plans

Agent Commands

Send via POST /api/v1/servers/command:

{"serverId": "...", "command": "stats"}

Available: stats, ollama list/pull/run/rm, cron list/add/remove, bot connect/stop/status, shell <cmd>

Agent API

POST https://prefy.com/api/v1/agent

Intelligent agent with memory, web search, intent detection.

{"message": "Find flights from Dubai to London next week", "userId": "..."}

Auto-detects intent: chat, search, flights, hotels, call.

AutoCall (Phone Calls)

POST https://prefy.com/api/v1/autocall

AI phone calls to restaurants/hotels (Vapi + ElevenLabs).

{
  "phone": "+971...",
  "venue_name": "Restaurant Name",
  "task": "Book table for 2, Friday 8pm",
  "language": "en"
}

Events & Activities

GET https://prefy.com/api/v1/events?city=Dubai

Returns upcoming events and activities for a city.

Rate Limits

Docs

Full documentation: https://prefy.com/docs