Zhipu: CogView 4
CogView 4是Zhipu的文生圖模型，可在Ailoot Ultra中以確切ID cogview-4使用。提供場景描述即可建立插畫、產品情境或視覺概念。文件所列控制項包含圖片尺寸、standard或hd品質，以及watermark_enabled；回應會提供圖片URL，請全部儲存。
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。
CogView 4可將書面圖片需求轉換為圖片輸出。在POST /v1/images/generations中選擇cogview-4，並以文字字串提供prompt。必填輸入為model與prompt。請在需求中描述主要主體、擺放位置、周圍場景，以及想要評估的視覺處理方式。
製作產品情境時，請描述物件、下方表面、背景與光線方向。製作插畫時，請指定人物或物件、預期氛圍與構圖。若圖片將放在標題或產品說明旁，請說明構圖何處須留白。將圖片用於版面前，請依這些具體要求檢視結果。
CogView專屬尺寸指引列出1024x1024、768x1344、864x1152、1344x768、1152x864、1440x720與720x1440。其自訂尺寸指引要求每邊介於512至2048像素，且可被16整除，總像素數不超過2^21像素。請依放置位置調整取景：直式插畫、正方形產品場景與寬幅視覺素材，除了尺寸不同，也需要不同構圖。
quality接受standard或hd，文件記載的CogView預設值為standard。watermark_enabled為布林值，文件記載的預設值為true。選用的user_id字串用於識別終端使用者，長度必須為6至128個字元。請將此識別碼與創意提示詞分開。調整品質或尺寸時，應同時明確說明圖片的預期用途，不能以這些設定取代對畫面內容的描述。
生成會回傳包含created與data的同步JSON回應。每個data[]項目提供一個url。請下載每張回傳圖片，並將回應連同需求與所選設定一併保存；不要只因預覽顯示一張圖片，就只保留第一個項目。文件所述介面契約並未為此圖片請求引入另行輪詢、類似影片的工作步驟。若回應中斷或不完整，請先保留原始請求資訊與已收到的結果，再決定是否適合提出另一個建立請求。Ailoot會將這些圖片儲存為您擁有的媒體資產，並回傳Ailoot簽署連結。透過GET /v1/media/assets?family=image尋找資產紀錄，並依序處理每個next_cursor。使用各個實際asset_id讀取GET /v1/media/assets/{asset_id}，取得其content_url；若簽署連結到期，請再次讀取同一資產。
Ailoot Ultra · Images POST /v1/images/generations cogview-4
cogview-4入門
CogView 4是Zhipu的文生圖模型，可在Ailoot Ultra中以確切ID 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 調整值時
供比較的預估費率
各設定的價格
請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。
| 設定 | 費率表 | 預估數量 | 費用 |
|---|---|---|---|
| 設定基礎 token 費率 | 費率表基本費率 | 預估數量— | 費用 輸入 · 輸入 Token · 僅供比較的估算 — / 1K Token 輸出 · 輸出 Token · 僅供比較的估算 — / 1K Token 輸入 · 讀取快取 · 僅供比較的估算 — / 1K Token 輸入 · 寫入快取 · 僅供比較的估算 — / 1K Token 輸入 · 寫入快取，1 小時 · 僅供比較的估算 — / 1K Token |
| 設定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
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
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