Mage API · 画像モデル
Stable Diffusion XL API
フォトリアル向けにチューニングされた SDXL
POST https://api.mage.space/v1/stable_diffusion_xl/generateひと目でわかる概要
Stable Diffusion XL API は、POST https://api.mage.space/v1/stable_diffusion_xl/generate を通じて Mage 上で Stable Diffusion XL を実行します。デフォルト設定でのリクエストは 10 Gems(約 $0.01)で、サブスクリプションは不要です。Stable Diffusion XL は @handle のメンションには対応していません。
- 画像出力
- 1バリアント
- 101枚あたりのGems(デフォルト)
- $0.01米ドル換算の目安
概要
Stable Diffusion XL API でできること
フォトリアルな出力に向けてチューニングされた、定番の Stable Diffusion XL。テキストからの画像生成も、入力画像1枚からの生成も、お手頃な価格で利用できます。
フォトリアルな出力に向けてチューニングされた 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 | 名前 | デフォルト |
|---|---|---|
| 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | Stable Diffusion XL | はい |
オプション
Stable Diffusion XL のパラメーター
全バリアントで使用できる値です。バリアントによっては選択肢が少ない場合があります。バリアントごとのオプションはドキュメントに記載されています。
| フィールド | 値 |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
入力
Stable Diffusion XL が受け付けるメディア入力
いずれも、httpsのURL、データURL、または最大100 MBのアップロードで送信できます。
| フィールド | 役割 |
|---|---|
| image | 参照画像。 |
その他の画像モデル
MageのほかのAI画像生成API
Z-Image API
Mageで最速の画像生成モデル
Anima API
アニメ特化
Chroma API
Fluxベースのオープンウェイトモデル
Flux 2 API
長いプロンプトや複数参照での編集に対応
GPT Image 2 API
的確なプロンプト反映と読みやすい文字
Grok Image API
Grok Imagine、2つのティア
FAQ
よくある質問
Stable Diffusion XL APIの料金はいくらですか?
Stable Diffusion XL APIのエンドポイントは何ですか?
呼び出せるStable Diffusion XLモデルは?
Stable Diffusion XLは参照画像やキャラクターに対応していますか?
Stable Diffusion XLをClaudeやChatGPTから使えますか?
Stable Diffusion XLの生成結果はどのくらい保存されますか?
Mageで開発を始めよう
アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。