
Seedream 5.5 で透過 PNG を生成する方法:設定とアルファ確認
Seedream 5.5 の透過 PNG 設定、実際のアルファと輪郭の確認、書き出し時の透過保持を解説。EvoLink のリクエスト例とローカル確認コードを掲載。
目次
background を transparent に、output_format を png に設定します。その後、元の出力ファイルをダウンロードしてアルファと輪郭を確認します。プレビューが白いこと、拡張子が .png であること、プロンプトに「透明」と書いたことだけでは、納品素材として使えるとは判断できません。生成前に必要な成果物を決める
アルファチャンネルは、各ピクセルが背後の背景とどう混ざるかを制御します。RGB の色とは別で、白い物体自体は不透明でも、その周囲は透明にできます。部分的なアルファは柔らかい輪郭や影を残せますが、見た目の確認は必要です。
| 必要なもの | 選ぶ方法 | 得られるもの |
|---|---|---|
| 単色背景付きの完成画像 | 通常生成または参照画像編集 | 一枚の平面画像 |
| 切り抜き素材や透過した構図 | 同じモデルの透過 PNG 出力 | アルファ付きの一枚の画像 |
| 個別に動かせる複数要素 | 独立した Layerize モデル | ベース画像、PNG レイヤー、配置メタデータ |
| ネイティブの編集可能な文字や PSD | 生成・分解後に編集アプリを使用 | アプリで再構築した文字オブジェクトやデザイン文書 |
テキストまたは参照画像から生成する
一つの素材を明確に記述する
たとえば「コバルトブルーの陶器製リボン彫刻を一つ、中央に配置し、全体の輪郭を見せる。透明背景に独立させ、文字や周囲の風景は入れない」と指定できます。これは指示例であり、生成済みの結果を示すものではありません。物体と必要な境界を明確にし、不要な背景になりそうなスタジオの壁やテーブルを同時に求めないでください。
API リクエストで出力を明示する
doubao-seedream-5.5 を使います。API キーはサーバー側で管理します。次の例はテキストから画像を生成するもので、参照画像は含めていません。curl -X POST https://api.evolink.ai/v1/images/generations \
-H "Authorization: Bearer $EVOLINK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedream-5.5",
"prompt": "A single cobalt-blue ceramic ribbon sculpture, centered, complete silhouette visible, isolated on a transparent background, no text or surrounding scene.",
"size": "1:1",
"quality": "1.5K",
"background": "transparent",
"output_format": "png"
}'image_urls 配列に追加します。他社のモデル ID や image というフィールドをそのまま流用しないでください。auto は背景の判断をモデルに任せる設定で、透過を保証しません。この EvoLink ルートでは transparent と jpeg の組み合わせは拒否されます。制限とリクエスト仕様の全体は生成・画像編集 API ドキュメントで確認できます。完了を待ち、元ファイルを保存する
id を保存し、次の YOUR_TASK_ID をその値に置き換えて問い合わせます。curl https://api.evolink.ai/v1/tasks/YOUR_TASK_ID \
-H "Authorization: Bearer $EVOLINK_API_KEY"completed になったら返された画像 URL から結果をダウンロードします。failed は失敗として扱い、画像がない状態を正常な出力と考えないでください。HTTPS コールバックも文書化された完了通知方法です。背景のメタデータは参考になりますが、納品前にはファイル自体を確認します。一時的な結果 URL に長期依存せず、早めに自分のコピーを保存してください。results、背景などのモデル固有メタデータは result_data に格納されます。完全なタスク記録をファイルと一緒に保存してください。メタデータの表示だけでファイル確認を代替することはできません。本ガイドでは EvoLink のモデル API リクエストは実行せず、例を仕様と照合し、ファイル確認スクリプトだけをローカルで実行しています。ダウンロードした PNG を確認する
.png に変えてもアルファは作られません。
python -m pip install pillow で Pillow を導入し、次を check_alpha.py として保存して python check_alpha.py asset.png を実行します。import sys
from PIL import Image
with Image.open(sys.argv[1]) as image:
if image.format != "PNG":
raise ValueError("The downloaded file is not PNG")
alpha = image.convert("RGBA").getchannel("A")
minimum, maximum = alpha.getextrema()
print(f"8-bit alpha range: {minimum}..{maximum}")
if minimum == 255:
print("No transparent pixels")
elif maximum == 0:
print("Fully transparent: no visible subject")
else:
print("Transparency exists; inspect edges and subject")配置先の背景で輪郭を確認する

PNG を明るい背景、暗い背景、実際のキャンペーンや UI の色に配置します。納品時の表示サイズで確認し、必要な箇所を拡大します。
- 輪郭に白っぽい、または暗い縁取りがないか確認します。元の参照画像が単色背景なら特に注意します。
- 小さな隙間、髪、毛、細い構造に欠けや背景ピクセルの残りがないか確認します。
- 柔らかい影や半透明部分を配置先と一緒に見ます。すべての輪郭を完全不透明・完全透明にする必要はありません。
- 主体の形、ブランド表記、文字を確認します。技術的に透過していても、商品自体を描き間違えている可能性があります。
白い素材が白い背景で見えなくても、正しい場合があります。別の色で確認してください。主体が使えて輪郭だけに局所的な問題があるなら、次はエディターでの修整が適切かもしれません。物体や構図が間違っているときは再生成し、書き出しの問題を直すためにリクエストを繰り返さないようにします。
納品まで透過を維持する
元の PNG を再利用できるマスターとして保管します。デザインエディターやアプリには画像素材として配置します。画像を動かせても、その中の文字を独立して編集できるわけではありません。最終広告を不透明な画像として書き出す場合も、後の派生版用に透過マスターを別途残します。
アップロード、最適化、書き出しの後に、製品が実際に配信するファイルを確認します。元ファイルが正しくても、処理中にアルファが白背景へ合成されたり、非対応形式に変換されたりする場合があります。モデルの問題と判断したり再生成したりする前に、元ファイルと納品ファイルを比較してください。
| 症状 | 最初に確認すること | 次の対応 |
|---|---|---|
| 白い背景が残る | 実際のリクエスト設定とダウンロードしたアルファ | 元が不透明なら、透過 PNG を明示して要求 |
| 最終レイアウトに市松模様が見える | 模様が画像ピクセルに焼き込まれていないか | 背景を修整するか再生成。プレビュー模様はアルファではない |
| ローカルでは正常、アップロード後は不透明 | 配信形式と処理内容 | 配信経路全体でアルファを保持 |
| 要素を別々に動かせない | 一枚の平面画像だけを要求していないか | 個別要素が必要なら Layerize を使用 |
よくある質問
Seedream 5.5 はテキストだけで透過画像を作れますか?
background: transparent と PNG を選び、参照画像は不要です。参照画像には事前にアルファが必要ですか?
不要です。Seedream 5.5 の参照編集は既存のアルファを要求しません。通常ルートは最大 10 枚の参照画像に対応しますが、使用前に切り抜き結果を確認してください。
プロンプトに「透明背景」と書くだけで十分ですか?
auto はモデルに判断を任せ、プロンプトだけではファイルの実際の内容を確認できません。透過素材に JPEG を指定できますか?
background: transparent と output_format: png を組み合わせます。透過と JPEG の組み合わせは拒否されます。PNG が白く見えるのはなぜですか?
白い背景上で表示されているだけの場合と、ファイル自体に不透明な白背景がある場合があります。元のアルファを確認し、別の色の背景に配置してください。
有効なアルファがあれば輪郭もきれいですか?
保証されません。縁取り、細い構造、柔らかい影、主体の一致、文字を実際の表示サイズで確認します。スクリプトが調べるのはピクセルの透過だけです。
透過出力には Layerize が必要ですか?
不要です。通常生成・編集で一枚の透過 PNG を取得できます。独立した要素と配置メタデータが必要な場合に Layerize を選びます。PSD やネイティブの文字オブジェクトを直接返す機能ではありません。
現在の費用はどこで確認できますか?
出典
- BytePlus Seedream 5.5 機能ガイド:ネイティブ RGBA と出典を明示した画像例。
- EvoLink Seedream 5.5 API ドキュメント:プラットフォームのモデル ID、制御項目、非同期処理。
- W3C PNG 仕様:PNG とアルファ表現。
- Pillow Image リファレンス:ローカルでのチャンネル変換と検査。


