メインコンテンツへスキップ

Mage API · 画像モデル

Seedream API

Seedream(厳格なフィルター付き)

POST https://api.mage.space/v1/seedream/generate

ひと目でわかる概要

Seedream APIでは、POST https://api.mage.space/v1/seedream/generate を通じて、Mage上でSeedream 5.5とその他5つのバリアントを実行できます。デフォルト設定のリクエストは42 Gems(約$0.042)で、サブスクリプションは不要です。Seedreamでは、保存済みのCharactersや、プロンプト内で@handleを指定したReferencesを利用できます。

  • 画像出力
  • 6バリアント
  • 421枚あたりのGems(デフォルト)
  • $0.042米ドル換算の目安

概要

Seedream APIでできること

ByteDanceのSeedream。下書き向けのSeedream 5.0 Flashから、最新でデフォルトのSeedream 5.5まで揃っています。緻密なシーン、読みやすい文字、最大10件のリファレンスやCharactersからの編集に対応し、Seedream 4.5では最大4Kまで可能です。厳格なフィルター:各実行の前に、プロンプトと最初の画像がチェックされます。

ByteDanceのSeedream画像生成モデルファミリーです。精細なシーン、読みやすいテキスト、最大10枚のリファレンスまたはCharactersを使った編集に対応しています。Seedream 5.5(`seedream-5.5`)は最新でデフォルトのモデルで、よりリアルな画像、より鮮明な小さい文字、より安定した繰り返し編集を実現します。Seedream 5.0 Pro(`seedream-5.0-pro`)は前世代のフラッグシップです。Seedream 5.0 Flash(`seedream-5.0-flash`)は入力画像込みの均一料金で、2Kまたは入力画像ありの場合は最安です(プロンプトのみの1Kでは Seedream 5.5 のほうが低料金です)。Seedream 5.0 Lite(`seedream-5.0-lite`)は最大3Kに対応します。Seedream 4.5(`seedream-4.5`)は最大4Kに対応します。そしてSeedream 4.0(`seedream-4.0`)です。厳格フィルター:Mageは実行前にプロンプトと最初の画像をチェックします。拒否されたリクエストは理由とともに `content_blocked` で失敗し、返金されます。

入力として image、additional_images を受け付けます。

クイックスタート

Seedream APIを呼び出す

MAGE_API_KEYを設定し、/seedream/generate に送信して、リクエストが完了するまで status_url をポーリングします。

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seedream/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": "seedream-5.5"
}' | 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('seedream', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'seedream-5.5',
});

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

mage = Mage()  # reads MAGE_API_KEY

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

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

モデル

Seedreamのmodel_idの値

model_idを送信してバリアントを選択します。指定しない場合はデフォルトが実行されます。

model_id名前デフォルト
seedream-4.0Seedream 4.0
seedream-4.5Seedream 4.5
seedream-5.0-liteSeedream 5.0 Lite
seedream-5.0-proSeedream 5.0 Pro
seedream-5.0-flashSeedream 5.0 Flash
seedream-5.5Seedream 5.5はい

オプション

Seedreamのパラメータ

全バリアントで使用できる値です。バリアントによっては選択肢が少ない場合があります。バリアントごとのオプションはドキュメントに記載されています。

フィールド値
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K, 3K, 4K

入力

Seedreamが受け付けるメディア入力

いずれも、httpsのURL、データURL、または最大100 MBのアップロードで送信できます。

フィールド役割
image参照画像。
additional_images追加の参照画像。

その他の画像モデル

MageのほかのAI画像生成API

FAQ

よくある質問

Seedream APIの料金はいくらですか?
デフォルト設定(Seedream 5.5)でのSeedreamリクエストは42 Gems、約$0.042です。解像度、長さ、バリアントを変更すると料金も変わります。正確な請求額はレスポンスで確認できます。生成に失敗した場合は返金されますが、Mageのコンテンツポリシーによりブロックされた場合は返金されません。
Seedream APIのエンドポイントは何ですか?
MageのAPIキーを入れた Authorization: Bearer ヘッダーを付けて、POST https://api.mage.space/v1/seedream/generate に送信します。レスポンスには、結果をポーリングするための status_url が含まれます。
どのSeedreamモデルを呼び出せますか?
seedream-4.0(Seedream 4.0)、seedream-4.5(Seedream 4.5)、seedream-5.0-lite(Seedream 5.0 Lite)、seedream-5.0-pro(Seedream 5.0 Pro)、seedream-5.0-flash(Seedream 5.0 Flash)、seedream-5.5(Seedream 5.5)。デフォルトはSeedream 5.5です。
Seedreamはリファレンス画像やキャラクターに対応していますか?
Seedreamは image、additional_images を受け付けます。保存したキャラクターやリファレンスは、プロンプト内の @handle で指定できます。
ClaudeやChatGPTからSeedreamを使えますか?
はい。Mage MCPサーバーをClaude、ChatGPT、Claude Code、Grok、Cursorに接続し、Seedreamを名前で指定してください。アシスタントが get_model でオプションを読み取り、生成前に料金を伝えます。
Seedreamの生成結果はどのくらい保存されますか?
生成結果と入力データは30日間保存されます。残したいものは自分のストレージにダウンロードしてください。

Mageで開発を始めよう

アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。