Zhipu: CogView 4 250304
CogView 4 250304是用於文生圖、另行命名的CogView 4選擇器cogview-4-250304。當工作流程需要保留此確切模型身分時，可搭配書面場景需求、CogView專屬尺寸、品質與浮水印設定使用。它會透過同步圖片生成回應傳回圖片URL。
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。
CogView 4 250304是Zhipu在CogView圖片生成系列中命名為cogview-4-250304的模型。若要在創意工作流程中保留此版本，請使用完整選擇器。其Ailoot Ultra方法為POST /v1/images/generations，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，以及項目內含url的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-250304
cogview-4-250304入門
CogView 4 250304是用於文生圖、另行命名的CogView 4選擇器cogview-4-250304。當工作流程需要保留此確切模型身分時，可搭配書面場景需求、CogView專屬尺寸、品質與浮水印設定使用。它會透過同步圖片生成回應傳回圖片URL。
- 接受的輸入
- 文字
- 結果
- 圖片
Ailoot 可用 · 輸入與方法
Ailoot Ultra · Images POST /v1/images/generations
- 輸入
text- 輸出
image- 輸出格式
- 圖片檔案
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 cogview-4-250304 | 預設值— |
欄位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-250304", "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-250304
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
FAQ · Zhipu: CogView 4 250304
- 可以使用哪些輸入與結果？
POST /v1/images/generations·cogview-4-250304:text→image- 請求使用哪些欄位？
POST /v1/images/generations·cogview-4-250304:model,prompt,size,user_id,quality,watermark_enabled,stream