cicora.ai
מפרט APIיצירת תמונות

תמונות

צרו תמונות דרך נתיב אחד ובחרו פרמטרים מיכולות המודל שנבחר.

מדריך שילוב: בחרו פרמטרים ויכולות זמינות בהגדרות ה-API של החשבון ובקטלוג המודלים של הסביבה שלכם.

יצירת תוכן

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

אל תשתמשו במודל טקסט כמזהה מודל לתמונות: בחרו את המודל לפי סוגי הקלט והפלט שלו בקטלוג.

בקשת יצירת תמונה
bash
curl --request POST https://cicora.ai/api/v1/images \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "google/gemini-2.5-flash-image",
    "prompt": "A precise editorial illustration of a delivery route at dusk",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "n": 1
  }'

חומרי עזר ועריכה

  • שלחו תמונות עזר דרך input_references רק בצורה שבה המודל שנבחר תומך.
  • המרת תמונה לתמונה ועריכה משתמשות באותו נתיב /images, עם ההפניה למקור והנחיית טקסט.
  • בדקו סוג MIME, גודל וזכויות של קובץ קלט לפני שליחתו.

קבלת התוצר

בתשובה התואמת, קראו את data[].b64_json כבייטים של תמונה; media_type יכול לזהות את התבנית. שמרו מטא-נתונים עם ההנחיה והמודל.

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