Kolbo Developer API — מדריך מפתחים מלא בעברית

למה API ולא סתם ממשק ווב?

אם אתה מפתח, הממשק הגרפי של Kolbo הוא רק ההתחלה. ה-Kolbo Developer API מאפשר לך לשלב יצירת תמונות, וידאו, מוזיקה ודיבור ישירות לתוך האפליקציה שלך — בלי שהמשתמש שלך אפילו יצטרך לדעת ש-Kolbo קיים מאחורי הקלעים.

חברות שבונות כלי קונטנט, פלטפורמות e-commerce, SaaS ליוצרים — כולן יכולות לרתום מעל 100 מודלי AI דרך endpoint אחד, מבלי לנהל מפתחות API נפרדים לכל ספק.

התחלה מהירה — מ-API Key ל-Request ראשון ב-5 דקות

שלב 1: קבלת API Key

היכנס לדשבורד של Kolbo, עבור להגדרות החשבון ולחץ על "Generate API Key". המפתח יופיע פעם אחת — שמור אותו מיד.

שלב 2: הגנרציה הראשונה שלך

curl -X POST https://api.kolbo.ai/v1/generate/image \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a futuristic Tel Aviv skyline at sunset, cinematic",
    "width": 1024,
    "height": 1024
  }'

התגובה תחזיר generation_id. זה הבסיס של כל האינטגרציה — פולינג על סטטוס.

מודל הפולינג — איך Kolbo API עובד

Kolbo לא מחזיר תוצאה מיידית — זה הגיוני, כי מודלי AI לוקחים זמן. הזרימה היא:

1. שלח בקשה → קבל generation_id
2. פול על הסטטוס בכל 2-3 שניות:

   GET /v1/generate/{generation_id}/status
   

3. כשהסטטוס הוא completed — קבל את ה-URL לקובץ המוגמר

זה מאפשר לך לבנות UX אסינכרוני נקי — progress bar, notifications, העדפות שמירה — בלי לחסום את הממשק.

Smart Select — תן לאלגוריתם לבחור את המודל

לא בטוח איזה מודל הכי מתאים לפרומפט? השמט את שדה ה-model ו-Kolbo יבחר אוטומטית את המודל הטוב ביותר עבור הבקשה שלך:

{
  "prompt": "hyperrealistic product photo of a smartwatch on marble",
  "width": 1024,
  "height": 1024
}

Smart Select מנתח את הפרומפט, סוג המדיה, ומטרות איכות/מהירות — ומפנה למודל המתאים: כברירת מחדל Nano Banana 2 (הבחירה הכל-יכולה), Nano Banana Pro לרזולוציה גבוהה וטקסט, ו-GPT Image 2 לאיכות עליונה ולטקסט בתוך התמונה (לרבות עברית). זה אידיאלי כשאתה בונה כלי שמגיש סוגי תוכן שונים ולא רוצה לנהל לוגיקת בחירת מודל בקוד שלך.

כל ה-Endpoints במקום אחד

דוגמאות קוד — JavaScript ו-Python

JavaScript (Node.js)

async function generateImage(prompt) {
  const res = await fetch("https://api.kolbo.ai/v1/generate/image", {
    method: "POST",
    headers: {
      "X-API-Key": process.env.KOLBO_API_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ prompt, width: 1024, height: 1024 }),
  });

  const { generation_id } = await res.json();

  // פולינג עד לסיום
  while (true) {
    await new Promise((r) => setTimeout(r, 2500));
    const status = await fetch(
      `https://api.kolbo.ai/v1/generate/${generation_id}/status`,
      { headers: { "X-API-Key": process.env.KOLBO_API_KEY } }
    ).then((r) => r.json());

    if (status.status === "completed") return status.result_url;
    if (status.status === "failed") throw new Error("Generation failed");
  }
}

Python

import os, time, requests

API_KEY = os.environ["KOLBO_API_KEY"]
BASE = "https://api.kolbo.ai/v1"
HEADERS = {"X-API-Key": API_KEY, "Content-Type": "application/json"}

def generate_image(prompt: str) -> str:
    res = requests.post(f"{BASE}/generate/image", json={
        "prompt": prompt, "width": 1024, "height": 1024
    }, headers=HEADERS)
    generation_id = res.json()["generation_id"]

    while True:
        time.sleep(2.5)
        status = requests.get(
            f"{BASE}/generate/{generation_id}/status", headers=HEADERS
        ).json()
        if status["status"] == "completed":
            return status["result_url"]
        if status["status"] == "failed":
            raise RuntimeError("Generation failed")

Visual DNA API — עקביות ויזואלית בקנה מידה

אחד הדברים הכי שימושיים ל-SaaS ולמותגים הוא Visual DNA: אתה מגדיר "זהות ויזואלית" אחת — פלטת צבעים, סגנון, קומפוזיציה — ואז כל גנרציה עתידית נשארת עקבית עם המותג.

curl -X POST https://api.kolbo.ai/v1/visual-dna \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"reference_images": ["url1", "url2"], "name": "My Brand DNA"}'

לאחר מכן, העבר visual_dna_id בכל בקשת תמונה — והמודל ישמור על הסגנון אוטומטית. שימושי במיוחד לקמפיינים שמייצרים עשרות ווריאציות.

מערכת הקרדיטים

ה-API פועל על קרדיטים — כל סוג מדיה צורך כמות שונה בהתאם למורכבות. תמונה סטנדרטית עולה פחות מוידאו של 10 שניות, שעולה פחות מגנרציה תלת-מימדית. הדשבורד של Kolbo מציג צריכה בזמן אמת, כך שאתה תמיד יודע איפה אתה עומד.

לשאילתת יתרה בתוך הקוד:

GET /v1/credits/balance

אינטגרציית MCP — Kolbo ב-Claude Code

אם אתה עובד עם Claude Code או AI agents, Kolbo מציע MCP server שמאפשר לסוכני AI להשתמש ב-Kolbo API ישירות — כלומר, הסוכן יכול ליצור תמונות, וידאו ומוזיקה כחלק מזרימת עבודה אוטומטית, בלי שתכתוב wrapper code. זה פותח דלת לצינורות יצירת תוכן אוטומטיים לחלוטין.

מתי להשתמש ב-API לעומת ממשק הווב?

השתמש ב-API כשאתה:

• בונה אפליקציה או SaaS שצריכה AI content בתהליך
• מבצע יצירת תוכן בקנה מידה (מאות/אלפי פריטים)
• צריך לשלב יצירת מדיה בתוך workflow אוטומטי
• רוצה white-label — המשתמש שלך לא רואה את Kolbo

השתמש בממשק הווב כשאתה:

• עובד ידנית וניסיוני על פרויקט ספציפי
• צריך Creative Director לקמפיין חד-פעמי
• מנסה מודלים ופרומפטים לפני שמשלב ב-production

הצטרף לאלפי מפתחים שכבר משלבים

Kolbo Developer API הוא הדרך הקצרה ביותר ממחשבה לתוכן — בלי לנהל עשרות מפתחות API, בלי לדאוג לעדכוני מודלים, ובלי לבנות infrastructure של AI מאפס.

100+ מודלים. endpoint אחד. קרדיטים שמשרתים כל סוג מדיה.

רוצה להתחיל? נסה את Kolbo בחינם — קבל גישה מיידית ל-API, צור את ה-API Key הראשון שלך, ובנה את הגנרציה הראשונה שלך תוך דקות.