Seedream 5.0
Seedream 5.0可依書面需求建立圖片,並支援以圖片引導的修改及相關圖片集。在Ailoot Ultra中使用bytedance-seed/seedream-5-0;確切別名doubao-seedream-5-0-260128會選取相同模型。請描述場景或修改內容,清楚指定每個參考素材的用途,並儲存每張回傳圖片以供檢視。
- Ailoot Ultra · Images
POST /v1/images/generationsbytedance-seed/seedream-5-0 - Ailoot Ultra · Images
POST /v1/images/generationsdoubao-seedream-5-0-260128
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項,依所選方法列於下方。
Seedream 5.0是支援文生圖、圖生圖與相關圖片工作流程的圖片生成模型。Ailoot Ultra提供的識別名稱為bytedance-seed/seedream-5-0,另有別名doubao-seedream-5-0-260128。請將model與prompt傳送至POST /v1/images/generations來請求圖片。建立新構圖時,請描述主體、配置、光線與視覺處理;進行修改時,請說明想要的修訂與須保留的來源細節。
使用文件所述的圖片引導URL工作流程時,請將image設為可存取的圖片URL字串陣列,並在提示詞中指定每個參考素材的用途。例如,以一張圖片定義產品,另一張呈現想要的配置,再於提示詞中說明這些用途。換裝需求可指定第一張參考圖中的人物,以及第二張中的服裝。請將生成的物件、服裝或主體與原圖比對,不要直接假定所有細節都已保留。
相關圖片生成使用sequential_image_generation。disabled會請求一張圖片;auto則讓模型判斷是否適合生成圖片集。sequential_image_generation_options.max_images將請求圖片集的數量限制在1至15,文件記載的預設值為15。製作四季插畫系列時,請指定共同場景、四季的差異與max_images:4。該值為上限,因此請檢查實際回傳的項目數量。
文件範例使用size:2K。選用的seed為-1至2147483647的整數;省略時會自動選擇種子。watermark為布林值。模型文件也列出含有type:web_search的tools項目。即使使用參考素材或搜尋控制項,仍須明確說明場景需求:例如產品插畫應描述哪些外觀細節須延續,以及場景的哪些部分可以變更。
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 bytedance-seed/seedream-5-0
bytedance-seed/seedream-5-0bytedance-seed/seedream-5-0doubao-seedream-5-0-260128
入門
Seedream 5.0可依書面需求建立圖片,並支援以圖片引導的修改及相關圖片集。在Ailoot Ultra中使用bytedance-seed/seedream-5-0;確切別名doubao-seedream-5-0-260128會選取相同模型。請描述場景或修改內容,清楚指定每個參考素材的用途,並儲存每張回傳圖片以供檢視。
- 接受的輸入
- 文字 · 圖片
- 結果
- 圖片
Ailoot 可用 · 輸入與方法
Ailoot Ultra · Images POST /v1/images/generations
- 輸入
text,image- 輸出
image- 輸出格式
- 圖片檔案
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 bytedance-seed/seedream-5-0 | 預設值— |
欄位prompt | 類型string | 要求必填 | 值與限制 | 預設值— |
欄位stream | 類型boolean | 要求選填 | 值與限制 false | 預設值false |
欄位image | 類型array | 要求選填 | 值與限制 | 預設值— |
方法參數與生命週期
| 參數 | 規格 |
|---|---|
參數content_type | 規格application/json |
參數required | 規格model, prompt |
參數optional | 規格stream, image |
參數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": "bytedance-seed/seedream-5-0", "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 bytedance-seed/seedream-5-0, doubao-seedream-5-0-260128
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
Ailoot Ultra · Images POST /v1/images/generations doubao-seedream-5-0-260128
doubao-seedream-5-0-260128bytedance-seed/seedream-5-0doubao-seedream-5-0-260128
入門
Seedream 5.0可依書面需求建立圖片,並支援以圖片引導的修改及相關圖片集。在Ailoot Ultra中使用bytedance-seed/seedream-5-0;確切別名doubao-seedream-5-0-260128會選取相同模型。請描述場景或修改內容,清楚指定每個參考素材的用途,並儲存每張回傳圖片以供檢視。
- 接受的輸入
- 文字 · 圖片
- 結果
- 圖片
Ailoot 可用 · 輸入與方法
Ailoot Ultra · Images POST /v1/images/generations
- 輸入
text,image- 輸出
image- 輸出格式
- 圖片檔案
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 doubao-seedream-5-0-260128 | 預設值— |
欄位prompt | 類型string | 要求必填 | 值與限制 | 預設值— |
欄位stream | 類型boolean | 要求選填 | 值與限制 false | 預設值false |
欄位image | 類型array | 要求選填 | 值與限制 | 預設值— |
方法參數與生命週期
| 參數 | 規格 |
|---|---|
參數content_type | 規格application/json |
參數required | 規格model, prompt |
參數optional | 規格stream, image |
參數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-260128", "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 bytedance-seed/seedream-5-0, doubao-seedream-5-0-260128
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
FAQ · Seedream 5.0
- 可以使用哪些輸入與結果?
POST /v1/images/generations·bytedance-seed/seedream-5-0:text,image→imagePOST /v1/images/generations·doubao-seedream-5-0-260128:text,image→image- 請求使用哪些欄位?
POST /v1/images/generations·bytedance-seed/seedream-5-0:model,prompt,stream,imagePOST /v1/images/generations·doubao-seedream-5-0-260128:model,prompt,stream,image