Zhipu: CogView 4
CogView 4 הוא מודל הטקסט לתמונה של Zhipu, הזמין ב-Ailoot Ultra תחת המזהה המדויק cogview-4. ספקו תיאור סצנה כדי ליצור איור, סביבת מוצר או קונספט חזותי. הבקרות המתועדות כוללות גודל תמונה, איכות standard או hd ו-watermark_enabled; התגובה מספקת כתובות URL לתמונות שיש לשמור את כולן.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
CogView 4 הופך תיאור תמונה כתוב לתמונות פלט. בחרו ב-cogview-4 ב-POST /v1/images/generations וספקו prompt כמחרוזת טקסט. הקלטים הנדרשים הם model ו-prompt. השתמשו בתיאור כדי לפרט את הנושא הראשי, מיקומו, הסצנה שסביבו והעיבוד החזותי שברצונכם להעריך.
לסביבת מוצר, תארו את העצם, המשטח שמתחתיו, הרקע וכיוון האור. לאיור, הגדירו את הדמויות או העצמים, האווירה הרצויה והקומפוזיציה. אם התמונה תופיע לצד כותרת או תיאור מוצר, ציינו היכן הקומפוזיציה צריכה להשאיר שטח פנוי. בדקו את התוצאה מול הדרישות הקונקרטיות האלה לפני שילובה בעיצוב.
הנחיות הגודל הייעודיות ל-CogView מפרטות 1024x1024, 768x1344, 864x1152, 1344x768, 1152x864, 1440x720 ו-720x1440. ההנחיות לגודל מותאם אישית קובעות שכל צלע תהיה בין 512 ל-2048 פיקסלים, באורך המתחלק ב-16, ובסך הכול לא יותר מ-2^21 פיקסלים. התאימו את המסגור למיקום: איור לאורך, סצנת מוצר מרובעת ותמונה רחבה דורשים קומפוזיציות שונות לצד מידות שונות.
quality מקבל standard או hd, כאשר standard מתועד כברירת המחדל של CogView. watermark_enabled הוא ערך בוליאני עם ברירת מחדל מתועדת של true. מחרוזת user_id אופציונלית מזהה את משתמש הקצה וחייבת להכיל 6 עד 128 תווים. שמרו את המזהה הזה בנפרד מה-prompt היצירתי. שינויים באיכות או בגודל צריכים ללוות שימוש מיועד ברור לתמונה, ולא להחליף את התיאור של מה שצריך להופיע בה.
היצירה מחזירה תגובת JSON סינכרונית המכילה created ו-data. כל פריט data[] מספק url. הורידו כל תמונה שהוחזרה ושמרו את התגובה לצד התיאור וההגדרות שנבחרו; אל תשמרו רק את הפריט הראשון רק מפני שהתצוגה המקדימה מציגה תמונה אחת. החוזה המתועד אינו מוסיף לבקשת התמונה הזו שלב נפרד של בדיקת מצב משימה, כפי שנעשה בווידאו. אם התגובה נקטעת או חלקית, שמרו את פרטי הבקשה המקורית ואת התוצאה שהתקבלה לפני שתחליטו אם מתאימה בקשת יצירה נוספת. Ailoot שומר את התמונות האלה כנכסי מדיה בבעלותכם ומחזיר קישורים חתומים של Ailoot. מצאו את רשומות הנכסים דרך GET /v1/media/assets?family=image, תוך מעקב אחר כל next_cursor. קראו GET /v1/media/assets/{asset_id} עם כל asset_id בפועל כדי לקבל את content_url שלו; קראו שוב את אותו נכס אם הקישור החתום שלו פג.
Ailoot Ultra · Images POST /v1/images/generations cogview-4
cogview-4התחלה
CogView 4 הוא מודל הטקסט לתמונה של Zhipu, הזמין ב-Ailoot Ultra תחת המזהה המדויק cogview-4. ספקו תיאור סצנה כדי ליצור איור, סביבת מוצר או קונספט חזותי. הבקרות המתועדות כוללות גודל תמונה, איכות standard או hd ו-watermark_enabled; התגובה מספקת כתובות URL לתמונות שיש לשמור את כולן.
- סוגי קלט נתמכים
- טקסט
- תוצאות
- תמונות
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · Images POST /v1/images/generations
- סוגי קלט
text- סוגי פלט
image- פורמט פלט
- קובץ תמונה
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות cogview-4 | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות | ברירת מחדל— |
שדהsize | סוגstring | דרישהרשות | ערכים ומגבלות 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728 | ברירת מחדל1280x1280 |
שדהuser_id | סוגstring | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
שדהquality | סוגstring | דרישהרשות | ערכים ומגבלות hd, standard | ברירת מחדל— |
שדהwatermark_enabled | סוגboolean | דרישהרשות | ערכים ומגבלות | ברירת מחדלtrue |
שדהstream | סוגboolean | דרישהרשות | ערכים ומגבלות false | ברירת מחדל— |
פרמטרים ומחזור חיים של השיטה
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטmodel, prompt |
פרמטרoptional | מפרטsize, user_id, quality, watermark_enabled, stream |
פרמטרmaterial_types | מפרטtext |
פרמטרconditions | מפרטUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
מחזור חיים: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
תעריפים
אופן חישוב החיוב הסופי
התעריפים המוצגים מספקים אומדן לעלות לפני היצירה. החיוב הסופי מחושב לפי העלות שנרשמה עבור היצירה המקורית. משך הפלט שנמדד והכמויות החזויות אינם הכמות הסופית לחיוב.
מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.
- מצב מהיר
- לא צוין כאשר נבחר מצב מהיר
- מצב Flex
- לא צוין כאשר נבחר מצב flex
- מאמץ חשיבה מרבי
- לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)
תעריפים משוערים להשוואה
מחירים לפי תצורה
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | טבלת תעריפים | כמות חזויה | חיוב |
|---|---|---|---|
| תצורהתעריפי בסיס לטוקנים | טבלת תעריפיםתעריף בסיס | כמות חזויה— | חיוב קלט · טוקני קלט · אומדן להשוואה בלבד — / 1K טוקנים פלט · טוקני פלט · אומדן להשוואה בלבד — / 1K טוקנים קלט · קריאה מהמטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד — / 1K טוקנים |
| תצורהEstimated generation cost | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | חיוב קלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.09 אומדן לפני היצירה This estimate is not an additional charge or a fixed rate for the completed generation. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
דוגמאות לבקשות
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "cogview-4", "prompt": "A calm studio product photograph with a plain background."}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
קבלה ושמירה של תוצאות
Ailoot Ultra · Images
הורידו כל תמונה שהוחזרה או שמרו את תוכן ה-Base64 שלה
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
שמירת כל התוצאות שהושלמו
שמרו כל תמונה שהושלמה; אחזרו אותה מכל URL שהוחזר או פענחו את תוכן ה-Base64 שלה.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
כשצריך לבדוק את התגובה המקורית
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
כינויים
כינויים למודל
Ailoot Ultra cogview-4
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
FAQ · Zhipu: CogView 4
- אילו קלטים ותוצאות זמינים?
POST /v1/images/generations·cogview-4:text→image- באילו שדות הבקשה משתמשת?
POST /v1/images/generations·cogview-4:model,prompt,size,user_id,quality,watermark_enabled,stream