Meta: Muse Image
Muse Image可根據文字與視覺參考建立及修改圖片。使用meta/muse-image與Images方法，描述新構圖，或以既有圖片引導修改。它會在完整回應中回傳圖片輸出，此模型規格未列出原生圖片串流。
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。
Muse Image是Meta的圖片生成模型，確切選擇ID為meta/muse-image。文件所列輸入為文字與圖片，輸出為圖片。請使用POST /v1/images/generations的Images方法，為新視覺素材或參考引導修訂準備書面需求。提示詞應說明要建立什麼，以及哪種視覺關係對結果很重要。
建立新構圖時，請描述主體、場景、光線、配色與視角。若使用位置會影響設計，請加以說明，例如主體須避開文字區域的橫式封面。場景需求可描述石台上的玻璃容器、低視角、清冷晨光與簡潔背景。具體視覺指示能提供可與完成圖片比對的明確細節。
進行修訂時，請透過input_references提供相關圖片，並指出想要的變更。文件所列參考表示形式接受HTTP(S)圖片URL或base64 data URL。請說明哪些來源細節應延續至修訂結果，例如主體形狀、取景或整體色彩處理，並描述應變更的元素。判斷結果是否符合任務時，請將來源與修訂結果一併保留。
此模型的專用規格列出文字與圖片輸入、圖片輸出，以及無原生串流。請將完整圖片回應作為結果。保留完成data陣列中的每張圖片。對於b64_json輸出，請解碼圖片位元組；對於回傳圖片URL，請取得實際圖片檔案。若有回傳media_type，請使用它，並保留隨附回應與usage資訊。
請將所選設定連同視覺需求保留。完成後，依需求檢查主體細節、構圖、與參考素材的關係，以及任何文字。請保留選定輸出、來源參考與提示詞，讓後續修訂能從已知圖片與明確變更開始。
Ailoot Ultra · Images POST /v1/images/generations meta/muse-image
meta/muse-image入門
Muse Image可根據文字與視覺參考建立及修改圖片。使用meta/muse-image與Images方法，描述新構圖，或以既有圖片引導修改。它會在完整回應中回傳圖片輸出，此模型規格未列出原生圖片串流。
- 接受的輸入
- 文字 · 圖片
- 結果
- 圖片
Ailoot 可用 · 輸入與方法
Ailoot Ultra · Images POST /v1/images/generations
- 輸入
text,image- 輸出
image- 輸出格式
- 圖片檔案
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 meta/muse-image | 預設值— |
欄位prompt | 類型string | 要求必填 | 值與限制 | 預設值— |
欄位stream | 類型boolean | 要求選填 | 值與限制 false | 預設值false |
欄位input_references | 類型array | 要求選填 | 值與限制 | 預設值— |
方法參數與生命週期
| 參數 | 規格 |
|---|---|
參數content_type | 規格application/json |
參數required | 規格model, prompt |
參數optional | 規格stream, input_references |
參數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.98304 生成前估算 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": "meta/muse-image", "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 meta/muse-image
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
FAQ · Meta: Muse Image
- 可以使用哪些輸入與結果？
POST /v1/images/generations·meta/muse-image:text,image→image- 請求使用哪些欄位？
POST /v1/images/generations·meta/muse-image:model,prompt,stream,input_references