API Reference - AI Providers

Base URL

https://labs.levor.io/api/ai-providers

כל הבקשות דורשות אימות (Cookie session או API Token).

ספקים (Providers)

GET /providers

קבלת רשימת כל ספקי ה-AI

Response:

{
    "providers": [
        {
            "id": 1,
            "code": "anthropic",
            "display_name": "Anthropic",
            "description_he": "מודלי Claude של Anthropic",
            "brand_color": "#D97706",
            "is_active": true,
            "models": [...]
        }
    ]
}

GET /providers/{id}

קבלת פרטי ספק ספציפי

פרמטר	סוג	תיאור
`id`	integer	חובה מזהה הספק

מודלים (Models)

GET /models

קבלת רשימת כל המודלים

פרמטר	סוג	תיאור
`provider_id`	integer	אופציונלי סינון לפי ספק
`category`	string	אופציונלי flagship, fast, vision

ניהול תקציב (Budget)

GET /budget

קבלת רשימת הגדרות תקציב

{
    "success": true,
    "budgets": [
        {
            "id": 1,
            "name": "תקציב חודשי",
            "budget_type": "monthly",
            "amount": 100.00,
            "alert_threshold": 80,
            "provider_id": 1,
            "provider_name": "Anthropic"
        }
    ]
}

POST /budget

יצירת הגדרת תקציב חדשה

Request Body:

{
    "name": "תקציב יומי Anthropic",
    "budget_type": "daily",  // daily | monthly
    "amount": 50.00,
    "alert_threshold": 80,   // אחוז להתראה
    "provider_id": 1,        // אופציונלי - null = כל הספקים
    "currency": "USD"
}

GET /budget/status

קבלת סטטוס התקציבים עם התראות

{
    "success": true,
    "status": [
        {
            "budget": {...},
            "current_cost": 35.50,
            "percentage": 71.0,
            "remaining": 14.50,
            "is_alert": false,
            "is_exceeded": false
        }
    ],
    "has_alerts": false
}

PUT /budget/{id}

עדכון הגדרת תקציב

DELETE /budget/{id}

מחיקת הגדרת תקציב

השוואות (Compare)

GET /compare/costs

השוואת עלויות בין ספקים

פרמטר	סוג	תיאור
`days`	integer	אופציונלי מספר ימים (ברירת מחדל: 30)

Response:

{
    "success": true,
    "period_days": 30,
    "total_cost": 125.50,
    "comparison": [
        {
            "provider_id": 1,
            "provider_name": "Anthropic",
            "brand_color": "#D97706",
            "total_cost": 75.30,
            "request_count": 150,
            "input_tokens": 50000,
            "output_tokens": 80000,
            "cost_per_request": 0.502,
            "percentage": 60
        }
    ]
}

GET /compare/models

השוואת שימוש בין מודלים

GET /pricing

השוואת מחירי מודלים

{
    "success": true,
    "pricing": [
        {
            "model_id": 6,
            "model_name": "Gemini 1.5 Flash",
            "provider_name": "Google AI",
            "input_cost_per_1k": 0.000075,
            "output_cost_per_1k": 0.0003,
            "avg_cost_per_1k": 0.000187,
            "context_window": 1000000,
            "quality_rating": 4,
            "speed_rating": 5
        }
    ],
    "cheapest": {...},
    "most_expensive": {...}
}

ייצוא (Export)

GET /export/usage

ייצוא נתוני שימוש

פרמטר	סוג	תיאור
`format`	string	אופציונלי csv \| json (ברירת מחדל: json)
`days`	integer	אופציונלי מספר ימים
`provider_id`	integer	אופציונלי סינון לפי ספק

GET /export/summary

דוח סיכום

{
    "success": true,
    "report": {
        "period": "30 ימים אחרונים",
        "generated_at": "2025-12-01T12:00:00",
        "summary": {
            "total_requests": 500,
            "total_cost": 125.50,
            "total_tokens": 250000
        },
        "by_provider": [...],
        "by_day": [...]
    }
}

בריאות (Health)

GET /health-history

היסטוריית בדיקות בריאות

{
    "success": true,
    "history": [
        {
            "id": 1,
            "provider_id": 1,
            "provider_name": "Anthropic",
            "is_healthy": true,
            "response_time_ms": 150,
            "checked_at": "2025-12-01T12:00:00"
        }
    ],
    "uptime_percentage": 99.5
}

POST /health-history/record

רישום בדיקת בריאות חדשה

Fallback

GET /fallback

קבלת הגדרות Fallback

POST /fallback

יצירת הגדרת Fallback

{
    "primary_provider_id": 1,
    "fallback_provider_id": 2,
    "trigger_on_error": true,
    "trigger_on_timeout": true,
    "trigger_on_rate_limit": true,
    "max_retries": 2
}

PUT /fallback/{id}

עדכון הגדרת Fallback

DELETE /fallback/{id}

מחיקת הגדרת Fallback

אימות (Validate)

POST /validate-key

אימות API Key לפני שמירה

Request:

{
    "provider_code": "anthropic",
    "api_key": "sk-ant-api03-xxx..."
}

Response:

{
    "success": true,
    "is_valid": true,
    "message": "API Key תקין ופעיל"
}