Skip to main content
POST

認証

string
必須
すべてのAPIエンドポイントはBearer Token認証が必要ですAPIキーの取得:APIキー管理ページにアクセスしてAPIキーを取得してくださいリクエストヘッダーに追加:
単一画像モデルseedream-5-0-pro はリクエスト1回につき1枚のみ生成します(レイヤー分解を除く)。次のパラメータは拒否されます(HTTP 400、タスク作成なし、課金なし):
  • n > 1
  • sequential_image_generation(グループ生成は非対応)
  • stream(ストリーミングは非対応)
  • tools(Web検索は非対応)
  • image_urls が 10 枚を超える

インタラクティブ編集

プロンプトで <point> / <bbox> 座標を使用するか、手書き注釈付き画像をアップロードして、編集位置を正確に指定します。
  • 点座標:<point>x y</point>(1 点を指定し、影響範囲はモデルが判断します)
  • バウンディングボックス座標:<bbox>x1 y1 x2 y2</bbox>(左上と右下の座標を指定し、編集領域のサイズを正確に制御します)

レイヤー分解

1枚の画像をベース画像と最大16個の透過PNGレイヤーに分解し、位置と重なり順の情報を返します。

Body

string
デフォルト:"seedream-5-0-pro"
必須
画像生成モデル名
  • seedream-5-0-pro(推奨)
  • 互換エイリアス:seedream-5.0-pro
boolean
デフォルト:"false"
画像タスクを送信する前にコンテンツモデレーションを実行するかどうかを指定します。
  • trueomni-moderation-latest でプロンプトと入力画像を審査
  • false または省略:審査リクエストを行わず、審査コストや遅延を追加しない(デフォルト)
string
必須
画像生成のテキスト説明layer_decomposition: true の場合は省略可能です。省略すると、モデルが画像内の主要要素を自動識別して分離します。中国語と英語に加え、ロシア語、アラビア語、フィリピン語、タイ語、トルコ語、韓国語、マレー語、スペイン語、ポルトガル語、インドネシア語、フランス語、ドイツ語、ベトナム語、日本語のネイティブ文字生成に対応します。
ヒント: 600 英単語以内に抑えてください。説明が長すぎるとディテールが失われる可能性があります。
string
デフォルト:"1K"
解像度ティア(小文字も可)。API Martの拡張フィールドで、ティアを size に直接指定する場合と同等です。
  • 1K(デフォルト)
  • 1.5K(1K と同価格で画質が良い — 特段の理由がなければ 1.5K を推奨)
  • 2K
3K / 4K など未対応の段階は 400 を返します。ティア形式の sizeresolution を同時に指定した場合は、size が優先されます。
size正確なピクセル値(例:2048x1024)の場合、本フィールドは無視され、寸法は size のみで決まります。
string
デフォルト:"auto"
ティアキーワード、アスペクト比、auto、または正確なピクセル寸法を指定します。

形式 ①:解像度ティア(推奨)

ティアは size に直接記述するか、API Mart拡張フィールド resolution で指定できます:
2つの形式は同等です。ティアだけを指定する場合は、プロンプトで用途(例:「縦長ポスター」「横長カバー」)を説明し、モデルにアスペクト比を選択させます。

形式 ②:ティア + アスペクト比

resolution と併用。対応比率:
  • 1:14:33:416:99:163:22:32:11:221:9
  • 16x9 形式の x 区切りも可
  • 2x12:11x21:2 と同じです。x は小文字で、空白は使用できません。
  • auto(デフォルト):解像度段階のみ適用;最終比率は prompt / 参照画像から決定
リスト外の比率(例:9:21)は 400 — 1:1 への暗黙のフォールバックなし段階 × 比率 → 出力ピクセル:

形式 ③:正確なピクセル

sizewidthxheight の場合、ピクセルがそのまま使われ resolution は適用されません。2048X1024 / 2048×1024 も可。
制限は幅と高さのに対するもので、各辺単独ではありません。例:512×512 は小さすぎ(400);2048×1024 は有効。
string
デフォルト:"opaque"
出力背景モード:
  • opaque: 不透明背景(デフォルト)
  • transparent: 透過背景
transparent は、アルファチャネルを持つ1枚の入力画像を使用する画像から画像へのリクエストでのみ利用でき、output_format: "png" も必要です。
boolean
デフォルト:"false"
画像をレイヤーに分解するかどうか。有効にすると、1枚のベース画像と最大16個のアルファチャネル付きPNGレイヤーを返します。PNGまたはJPEG画像を1枚だけ指定します。総ピクセル数は [262144, 36000000]、サイズは30 MB以下である必要があります。size1K1.5K2Kauto のみを受け付け、デフォルトは auto です。output_format はベース画像の形式だけを制御し、分解レイヤーは常にPNGです。
object
デフォルト:"{\"mode\":\"standard\"}"
プロンプト最適化モード:
  • standard: 高品質な標準モード(デフォルト)
フラット形式 "optimize_prompt_options.mode": "standard" も使用できます。
integer
デフォルト:"1"
生成する画像数。1 のみ対応します。グループ画像生成には seedream-5-0-lite を使用してください。
array
参照画像 URL リスト。単一 / 複数参照の image-to-image 用、最大 10 枚2 つの形式:1. 公開 URL
  • http:// または https://
  • 例:https://example.com/image.jpg
2. Base64(Data URI)
  • 形式:data:image/<format>;base64,<data><format>小文字必須
  • 例:data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
画像ごとの制限:
  • 形式:jpeg / png / webp / bmp / tiff / gif / heic / heif
  • アスペクト比(w/h):[1/16, 16]
  • 各辺 > 14 px
  • サイズ ≤ 30 MB
  • 総ピクセル ≤ 6000×6000(36,000,000)
課金: 最初の参照画像は無料;追加の各画像に固定の追加料金。
string
デフォルト:"jpeg"
出力画像フォーマット
  • jpeg(デフォルト)
  • png
互換: response_formatoutput_format と同等;その他の値は jpeg として扱われます。
boolean
デフォルト:"false"
右下に “AI generated” ウォーターマークを付けるか
  • true:ウォーターマークあり
  • false:なし(デフォルト)

リクエスト例

テキストから画像(段階 + 比率)

テキストから画像(正確なピクセル)

複数参照

推奨:1.5K 同価格で高画質

レイヤー分解

0–1000 に正規化した <bbox> 座標で、抽出する要素を正確に指定できます:

インタラクティブ編集

画像内の手書き注釈を自然言語で説明します:
または <point> / <bbox> で位置を正確に指定します:

アルファチャネル編集

完全な例:タスクを送信して画像を取得

次のスクリプトは、非同期タスクの送信、ステータスのポーリング、失敗状態の処理、最終画像URLの取得までのフローを示します。実行前に YOUR_API_KEY を置き換えてください。
Python
成功時、タスク照会エンドポイントは次を返します:
返却画像はプラットフォーム管理のストレージにミラーされます。それでも自社システムへ速やかにダウンロードして永続保存し、結果URLを永久ストレージとして扱わないでください。

完全なcURLシナリオ

複数画像の合成(参照画像は最大10枚)

正確なピクセル、プロンプト最適化、透かし

透過レイヤーを分解して個別に編集

まず、元画像を分解します:
次に、透過レイヤーのURLを取得し、個別に編集します:

レイヤー分解レスポンスと復元

urlsizesoutput_formatslayers 配列はインデックスごとに対応し、インデックス 0 は常にベース画像です:
z_index の昇順でレイヤーを合成します。絶対座標で出力ベース画像上に復元する場合:
任意の W × H キャンバス上に復元するには、正規化座標を使用します:
レイヤー分解は画像ごとに課金されます。タスク送信時に最大17枚分を事前承認します。完了後は各出力を実際のピクセル数でティア判定して個別に精算し、過剰な事前承認額は自動返金します。残高は17枚分の事前承認をカバーする必要があり、size: "auto" は2Kティアで事前承認されます。

課金について

出力は実際の総ピクセル数で区分します(約 2.61M = 2,601,124):
  • 1.5K は 1K と同額(いずれも $0.045)。
  • size が正確ピクセルのとき、課金は実際の出力面積で決まり、resolution は影響しません(例:size: "2048x2048" → $0.09)。
  • 参照画像の 1 枚目は無料、2 枚目以降は加算。
  • タスク失敗時は自動で全額返金。

レイヤー分解の事前承認と精算

タスク送信時に最終的なレイヤー数と寸法が不明なため、事前承認はリクエストに基づく保守的なルールで行われます:
  • 正確なピクセル:指定したピクセル面積でティア判定。
  • 1K / 1.5K:1Kティアで事前承認。
  • 2K:2Kティアで事前承認。
  • auto:最大2Kで出力できるため、2Kティアで事前承認。
完了後、ベース画像と実際の各レイヤーを実ピクセル面積で個別にティア判定して合算します。過剰な事前承認額は自動返金されます。レイヤーは通常ベース画像より大幅に小さいため、2Kティアで事前承認されたタスクでも、最終的にすべて1Kティアで精算される場合があります。
例:1080×1080 の入力を10枚の画像に分解する場合、17枚 × 2Kティア で事前承認します。最終的10枚がすべち261万ピクセル以下なら、10枚 × 1Kティア で精算し、残額を自動返金します。

よくあるエラー

⏱️ 生成に時間がかかります:1Kは約90秒、2Kは約160秒(品質優先)。5〜10秒ごとにタスクステータスを取得し、クライアントのタイムアウトを 5分 に設定してください。生成結果は速やかに保存してください。

レスポンス

integer
レスポンスステータスコード
array
レスポンスデータ配列