OpenAI: DALL·E 3
DALL·E 3可根據書面場景需求生成圖片。請以確切模型ID openai/dall-e-3或其別名dall-e-3使用圖片生成方法，再儲存每個回傳圖片URL與隨附結果。文件所列起始請求會根據文字產生一張1024x1024圖片。
- Ailoot Ultra · Images
POST /v1/images/generationsopenai/dall-e-3 - Ailoot Ultra · Images
POST /v1/images/generationsdall-e-3
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。
DALL·E 3是OpenAI的文生圖模型。可使用書面需求建立插畫、場景概念，或設計的視覺方向。請在提示詞中描述主體、環境、構圖、光線與處理方式。例如，概念需求可以要求黃昏時小店旁的外送自行車、從街上觀看、清楚的前景主體，以及克制的配色。
請使用POST /v1/images/generations，並提供application/json主體。確切公開模型ID為openai/dall-e-3；已允許的別名dall-e-3會選擇相同模型卡片。文件所列起始請求形式包含model、prompt、n:1與size:"1024x1024"。n為選用整數，預設為1。請傳送stream:false，或省略stream，以取得完整JSON結果。使用非空文字prompt，並讓此請求聚焦於一份完整圖片需求。提供的方法是根據文字生成圖片。
請明確說明對使用位置重要的要求。編輯插畫可以指明核心概念，以及用來表達它的物件。場景概念可以指定攝影機位置、時段，以及構圖哪些部分周圍需要留白。必須出現在圖片中的確切文字，應與場景描述分開，再於使用選定結果前檢查生成文字與視覺配置。
生成回應為JSON，包含created時間戳記與data陣列。文件所列結果項目包含url，也可能包含revised_prompt、prompt_filter_results與content_filter_results。請將這些欄位連同完整回應保留，並下載每個回傳Ailoot簽署URL中的圖片。Ailoot簽署檔案連結自簽發起有效24小時。檔案儲存前，請保留確切回傳URL，包含查詢字串；並依實際回應或檔案位元組判定儲存圖片的格式。
請將回傳圖片檔案視為可用設計素材，JSON則是隨附生成紀錄。放入網頁、簡報或應用程式前，請依提供需求檢視圖片。若回應不完整或傳送結果不確定，請保留原始請求識別碼與回傳資訊，並檢查既有嘗試，不要只為找回缺少結果而建立另一張圖片。取得已儲存結果時，請使用相同API金鑰呼叫GET /v1/media/assets?family=image，並依序處理每個next_cursor。資產ID出現在各個回傳的/v1/media/assets/{asset_id}/content URL，以及其媒體庫紀錄中。針對每個選定紀錄讀取GET /v1/media/assets/{asset_id}，並下載其確切content_url。若檔案請求回傳404且代碼為link_expired，請再次讀取同一資產，取得更新連結。更新資產連結不需要另一個圖片生成請求。
Ailoot Ultra · Images POST /v1/images/generations openai/dall-e-3
openai/dall-e-3openai/dall-e-3dall-e-3
入門
DALL·E 3可根據書面場景需求生成圖片。請以確切模型ID openai/dall-e-3或其別名dall-e-3使用圖片生成方法，再儲存每個回傳圖片URL與隨附結果。文件所列起始請求會根據文字產生一張1024x1024圖片。
- 接受的輸入
- 文字
- 結果
- 圖片
Ailoot 可用 · 輸入與方法
Ailoot Ultra · Images POST /v1/images/generations
- 輸入
text- 輸出
image- 輸出格式
- 圖片檔案
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 openai/dall-e-3 | 預設值— |
欄位prompt | 類型string | 要求必填 | 值與限制 | 預設值— |
欄位stream | 類型boolean | 要求選填 | 值與限制 false | 預設值false |
欄位n | 類型integer | 要求選填 | 值與限制 1 | 預設值— |
欄位size | 類型string | 要求選填 | 值與限制 1024x1024 | 預設值— |
方法參數與生命週期
| 參數 | 規格 |
|---|---|
參數content_type | 規格application/json |
參數required | 規格model, prompt |
參數optional | 規格stream, n, size |
參數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.32768 生成前估算 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": "openai/dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')
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 openai/dall-e-3, dall-e-3
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
Ailoot Ultra · Images POST /v1/images/generations dall-e-3
dall-e-3openai/dall-e-3dall-e-3
入門
DALL·E 3可根據書面場景需求生成圖片。請以確切模型ID openai/dall-e-3或其別名dall-e-3使用圖片生成方法，再儲存每個回傳圖片URL與隨附結果。文件所列起始請求會根據文字產生一張1024x1024圖片。
- 接受的輸入
- 文字
- 結果
- 圖片
Ailoot 可用 · 輸入與方法
Ailoot Ultra · Images POST /v1/images/generations
- 輸入
text- 輸出
image- 輸出格式
- 圖片檔案
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 dall-e-3 | 預設值— |
欄位prompt | 類型string | 要求必填 | 值與限制 | 預設值— |
欄位stream | 類型boolean | 要求選填 | 值與限制 false | 預設值false |
欄位n | 類型integer | 要求選填 | 值與限制 1 | 預設值— |
欄位size | 類型string | 要求選填 | 值與限制 1024x1024 | 預設值— |
方法參數與生命週期
| 參數 | 規格 |
|---|---|
參數content_type | 規格application/json |
參數required | 規格model, prompt |
參數optional | 規格stream, n, size |
參數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.32768 生成前估算 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": "dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')
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 openai/dall-e-3, dall-e-3
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
FAQ · OpenAI: DALL·E 3
- 可以使用哪些輸入與結果？
POST /v1/images/generations·openai/dall-e-3:text→imagePOST /v1/images/generations·dall-e-3:text→image- 請求使用哪些欄位？
POST /v1/images/generations·openai/dall-e-3:model,prompt,stream,n,sizePOST /v1/images/generations·dall-e-3:model,prompt,stream,n,size