Mage API · 圖片模型

Stable Diffusion XL API

針對寫實風格調校的 SDXL

取得 API 金鑰在試玩區體驗 Stable Diffusion XL
POST https://api.mage.space/v1/stable_diffusion_xl/generate

重點速覽

Stable Diffusion XL API 透過 Mage 在 POST https://api.mage.space/v1/stable_diffusion_xl/generate 執行 Stable Diffusion XL。以預設設定發送請求費用為 10 Gems(約 $0.01),無需訂閱。Stable Diffusion XL 不支援 @handle 提及。

總覽

Stable Diffusion XL API 的功能

經典的 Stable Diffusion XL,針對寫實效果調校。支援文字生成圖片,或以一張輸入圖片生成,價格實惠。

針對寫實效果調校的 Stable Diffusion XL,可選擇加入一張輸入圖片。

支援 image 作為輸入。

快速開始

呼叫 Stable Diffusion XL API

設定 MAGE_API_KEY,提交至 /stable_diffusion_xl/generate,然後輪詢 status_url,直到請求完成。

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/stable_diffusion_xl/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('stable_diffusion_xl', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: '6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("stable_diffusion_xl", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80",
})

print(request["result"]["url"])

模型

Stable Diffusion XL 的 model_id 值

傳入 model_id 即可選擇版本。未指定時,請求會使用預設版本。

model_id名稱預設
6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80Stable Diffusion XL是

選項

Stable Diffusion XL 參數

以下為所有版本可接受的值;個別版本可能提供較少選項。各版本的選項請參閱文件。

欄位可用值
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21

輸入

Stable Diffusion XL 支援的媒體輸入

每個輸入可使用 https URL、data URL,或上傳最大 100 MB 的檔案。

欄位用途
image參考圖片。

更多圖片模型

Mage 上的其他圖片生成 API

圖片 · 10 Gems 起

Z-Image API

Mage 上最快的圖片模型

圖片 · 20 Gems 起

Anima API

專為動漫打造

圖片 · 35 Gems 起

Chroma API

開放權重,基於 Flux 打造

圖片 · 每次 40 Gems 起

Flux 2 API

支援長提示詞與多重參考編輯

圖片 · 每次 9 Gems 起

GPT Image 2 API

精準遵循提示詞,文字清晰易讀

圖片 · 75 Gems 起

Grok Image API

Grok Imagine,提供三種品質等級

常見問題

常見問題

Stable Diffusion XL API 的費用是多少?

以預設設定(Stable Diffusion XL)發送一次 Stable Diffusion XL 請求需 10 Gems,約 $0.01。其他解析度、長度與版本會影響價格,確切費用會顯示在回應中。生成失敗會退還 Gems;遭 Mage 內容政策攔截的則不予退還。

Stable Diffusion XL API 的端點是什麼?

請對 https://api.mage.space/v1/stable_diffusion_xl/generate 發送 POST 請求,並在 Authorization: Bearer 標頭中帶入你的 Mage API 金鑰。回應會包含 status_url,可用來輪詢取得結果。

可以呼叫哪些 Stable Diffusion XL 模型?

6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80。預設為 Stable Diffusion XL。

Stable Diffusion XL 支援參考圖片或角色嗎?

Stable Diffusion XL 可接受 image。Stable Diffusion XL 不支援 @handle 提及。

可以在 Claude 或 ChatGPT 中使用 Stable Diffusion XL 嗎?

可以。將 Mage MCP 伺服器連接到 Claude、ChatGPT、Claude Code、Grok 或 Cursor,然後直接指名要用 Stable Diffusion XL。你的助理會用 get_model 讀取可用選項,並在生成前告知價格。

Stable Diffusion XL 的結果會保存多久?

結果與輸入內容會保存 30 天。想留存的內容,請自行下載到你的儲存空間。

開始使用 Mage 打造你的作品

一個帳號、一份 Gems 餘額,通用所有模型。只需為你生成的內容付費。

取得 API 金鑰在試玩區體驗 Stable Diffusion XL

相關內容