יצירת תוכן
בקשה כוללת מודל, הנחיה ורק פרמטרי תוצר רלוונטיים: גודל, יחס ממדים, תבנית או מספר תוצאות.
אל תשתמשו במודל טקסט כמזהה מודל לתמונות: בחרו את המודל לפי סוגי הקלט והפלט שלו בקטלוג.
בקשת יצירת תמונה
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 יכול לזהות את התבנית. שמרו מטא-נתונים עם ההנחיה והמודל.
אל תפרסמו תוצאה חלקית כסופית. במסירה בהזרמה, הבחינו בין אירוע טיוטה לתוצר שהושלם.