Seedream 5.0 Pro
Seedream 5.0 Pro以確切ID doubao-seedream-5-0-pro-260628，根據文字與參考圖片建立圖片。文件所述工作流程涵蓋新場景、指定修改、多個參考素材的組合，以及相關圖片集。請以清楚需求指定每個參考素材的用途，再保留每張完成圖片及其生成設定。
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。
Seedream 5.0 Pro是獨立圖片模型doubao-seedream-5-0-pro-260628。文件所列任務包含生成新圖片、修改提供的圖片，以及根據文字或視覺參考建立相關圖片集。在Ailoot Ultra中，請使用POST /v1/images/generations的圖片方法，提供確切model字串，以及描述預期結果的prompt。
新圖片需求可指定主體、視角、配置、光線與視覺處理。以圖片引導修改時，請描述修訂內容，以及應延續的來源元素。使用多個參考素材時，請明確分配用途：一張圖片可定義人物或產品，另一張則提供服裝、場景或配置。使用文件所述URL工作流程時，請將image設為可存取的圖片URL字串陣列；在提示詞中清楚說明這些用途，有助於評估完成圖片實際遵循哪些元素。
製作協調一致的圖片集時，sequential_image_generation:auto會啟用相關圖片生成，disabled則請求單張圖片。sequential_image_generation_options.max_images為1至15的整數，預設為15。製作包裝概念集時，請指定共同視覺處理方式，以及每張圖片所需的特定項目，並設定合適上限。請檢查實際回傳數量，因為max_images指定的是上限。
Pro範例明確使用size:2K。選用的seed範圍為-1至2147483647；省略時會自動選擇種子。watermark為布林值，文件所列tools陣列包含type:web_search。要求修訂時，請保留有用的構圖，並在需求中修改一項可見要求，以便將新結果與選定圖片比較。
選擇response_format:url可取得圖片連結，b64_json則可取得編碼後的圖片資料。此Ailoot方法會在單次非串流JSON回應中回傳完整圖片集；請設定stream:false或省略此欄位。儲存每個data[]項目，並將usage.generated_images連同回應保留。解碼每個b64_json值，或擷取每個回傳的Ailoot簽署URL。Ailoot會將完成圖片儲存為您擁有的媒體資產，並在URL結果中回傳Ailoot簽署URL。透過GET /v1/media/assets?family=image尋找資產紀錄，並依序處理每個next_cursor。使用各個實際asset_id呼叫GET /v1/media/assets/{asset_id}，以讀取其content_url。若簽署連結回傳link_expired，請再次讀取同一資產，取得更新的content_url。傳送不完整時，請保留原始操作資訊與所有回傳結果，再於啟動另一次生成前檢查這些既有結果。
Ailoot Ultra · Images POST /v1/images/generations doubao-seedream-5-0-pro-260628
doubao-seedream-5-0-pro-260628
doubao-seedream-5-0-pro-260628入門
Seedream 5.0 Pro以確切ID doubao-seedream-5-0-pro-260628，根據文字與參考圖片建立圖片。文件所述工作流程涵蓋新場景、指定修改、多個參考素材的組合，以及相關圖片集。請以清楚需求指定每個參考素材的用途，再保留每張完成圖片及其生成設定。
- 接受的輸入
- 文字 · 圖片
- 結果
- 圖片
Ailoot 可用 · 輸入與方法
Ailoot Ultra · Images POST /v1/images/generations
- 輸入
text,image- 輸出
image- 輸出格式
- 圖片檔案
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 doubao-seedream-5-0-pro-260628 | 預設值— |
欄位prompt | 類型string | 要求必填 | 值與限制 | 預設值— |
欄位image | 類型array | 要求選填 | 值與限制 | 預設值— |
欄位sequential_image_generation | 類型string | 要求選填 | 值與限制 auto, disabled | 預設值— |
欄位sequential_image_generation_options | 類型object | 要求選填 | 值與限制 | 預設值— |
欄位sequential_image_generation_options.max_images | 類型integer | 要求必填 | 值與限制 | 預設值— |
欄位response_format | 類型string | 要求選填 | 值與限制 | 預設值— |
欄位size | 類型string | 要求選填 | 值與限制 2K, 4K | 預設值— |
欄位stream | 類型boolean | 要求選填 | 值與限制 false | 預設值— |
欄位watermark | 類型boolean | 要求選填 | 值與限制 | 預設值— |
欄位seed | 類型integer | 要求選填 | 值與限制 | 預設值— |
欄位tools | 類型array | 要求選填 | 值與限制 | 預設值— |
方法參數與生命週期
| 參數 | 規格 |
|---|---|
參數content_type | 規格application/json |
參數required | 規格model, prompt |
參數optional | 規格image, sequential_image_generation, sequential_image_generation_options, response_format, size, stream, watermark, seed, tools |
參數material_types | 規格text, image |
參數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": "doubao-seedream-5-0-pro-260628", "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 doubao-seedream-5-0-pro-260628
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
FAQ · Seedream 5.0 Pro
- 可以使用哪些輸入與結果？
POST /v1/images/generations·doubao-seedream-5-0-pro-260628:text,image→image- 請求使用哪些欄位？
POST /v1/images/generations·doubao-seedream-5-0-pro-260628:model,prompt,image,sequential_image_generation,sequential_image_generation_options,response_format,size,stream,watermark,seed,tools