Seedgream 4.5 API の使用方法

CometAPI
AnnaDec 9, 2025
Seedgream 4.5 API の使用方法

Seedream 4.5は、テキストから画像への生成／画像編集モデルであるSeedreamファミリーの最新進化版（Byte/BytePlusの研究開発による）です。公式のBytePlusエンドポイントおよび複数のサードパーティプラットフォーム（CometAPIなどのマルチモデルゲートウェイ経由の統合アクセスを含む）で展開が進んでおり、被写体の一貫性、タイポグラフィ／テキストレンダリング、マルチ画像編集の忠実度が向上しています。

本記事は、Seedream 4.5 APIの実践的なプロフェッショナルガイドです。セットアップ手順、認証とリクエストパターン、プロンプトとパラメータのベストプラクティス、編集とマルチ画像ワークフロー、エラーハンドリング、デプロイメントパターン、法的／安全面の考慮事項を実用的に解説します。

Seedream 4.5とは？

Seedream 4.5は、Seedreamファミリーの最新イテレーションであり、高忠実度のテキストから画像の生成とコンテキスト認識型の画像編集（image-to-image、複数参照による編集、インペインティング／アウトペインティング、タイポグラフィと高密度テキストの処理）に特化したマルチモーダル画像生成・編集モデルです。従来のSeedreamリリースと比べて、4.5はマルチ画像ワークフローにおける被写体の一貫性の改善、参照ディテールの厳密な保持、タイポグラフィの忠実度向上（画像内テキスト）、そして“high quality”設定で最大4K／超高精細までの出力品質を強化しています。これらの改善は、スケールされたアーキテクチャと更新されたプロンプトチューニング／エンジン側のヒューリスティクスにより実現されています。

重要な理由：4.5はプロフェッショナルなクリエイティブタスク（バッチでの製品バリエーション、ブランド整合性のあるマルチ画像編集、高解像度の印刷向けアセット）に対応するよう意図的に設計されており、参照画像と特殊な編集操作により細やかなコントロールを可能にします。

コア機能

  • テキストから画像の生成（単発およびバッチ）：1〜15枚の画像を1回のAPI呼び出しで生成。速度と解像度のトレードオフがある品質モード（Basic／High）を選択可能。
  • 画像編集（i2i／インペインティング／アウトペインティング）： 1枚以上の参照画像を使用可能。複数参照間でディテールや空間関係を保持。
  • 複数参照のブレンディング＆要素コピー： 1ジョブにつき約10枚までの参照画像で、ライティングやパースを整合させつつ要素移植が可能。
  • 高いタイポグラフィ／高密度テキストのレンダリング： テキストや看板を含む画像の扱いを改善（モックアップ、製品ラベル、UIスクリーンショットに有用）。
  • ストリーミング／プログレッシブ出力： 一部のデプロイメントエンドポイントでは生成中に部分的な結果を受け取れるストリーミング出力に対応。

CometAPI経由でSeedream 4.5 APIを使うには？

以下は、モデルパラメータとしてSeedream 4.5を公開するアグリゲーターであるCometAPIを使って画像を生成する、実践的でそのまま使える手順です。CometAPIは、1つのAPIキーで数十／数百のモデルにアクセスでき、安定した統一的なRESTインターフェイスを提供します。CometAPIのドキュメントには、doubao-seedream-4-5-251128というモデルエイリアスと標準的な画像生成エンドポイントが記載されています。

ハイレベルな手順

  1. CometAPIに登録してAPIキーを取得します。
  2. 画像生成エンドポイント（POST https://api.cometapi.com/v1/images/generations）で、モデルパラメータをSeedream 4.5の識別子（例：doubao-seedream-4-5-251128）に設定します。
  3. プロンプト、任意の参照画像（アグリゲーターによりURLまたはmultipartアップロード）、出力サイズ／品質、その他のパラメータを含めます。
  4. 生成された画像URL（またはbase64）とメタデータを含むJSONレスポンスを受け取ります。

リクエストタイプとモード

Seedream 4.5は一般的に次をサポートします：

  • テキスト → 画像（テキストプロンプトから新規画像）
  • 画像 → 画像（参照画像＋プロンプトでスタイライズ変換）
  • 画像編集／インペインティング（マスク＋編集指示で対象領域を変更）
    ホスト型APIは非同期タスクモード（ジョブを送信 → taskIdでポーリング）に対応しており、長時間レンダリングやバッチワークフローに適しています。生成リンクは時間制限がある場合が多く（例：一部ゲートウェイでは24時間有効）、保存／エクスポート計画が必要です。

curl の例（テキスト→画像、単一プロンプト）

curl -X POST "https://api.cometapi.com/v1/images/generations" \
  -H "Authorization: Bearer COMETAPI_KEY_GOES_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4-5-251128",
    "prompt": "A cinematic portrait of a cyberpunk fox in neon rain, 4k, detailed lighting, film grain",
    "n": 3,
    "width": 2048,
    "height": 2048,
    "quality": "high",     # or "basic"
    "seed": 12345,
    "style": "photorealistic"
  }'

注記

  • COMETAPI_KEY_GOES_HEREを自身のCometAPIキーに置き換えてください。
  • nパラメータは1回の呼び出しで複数のバリエーションを生成（オーバーヘッド削減）。
  • quality: "high"は通常、より高い解像度／計算コストにマッピングされます（しばしば4K対応）。

Python requests の例（テキスト→画像＋結果保存）

import requests, base64, os

API_URL = "https://api.cometapi.com/v1/images/generations"
API_KEY = os.environ.get("COMETAPI_KEY")  # set env var for safety

payload = {
  "model": "doubao-seedream-4-5-251128",
  "prompt": "Studio shot of a ceramic mug on a wooden table, warm natural light, ultra-detailed, 2k",
  "n": 2,
  "width": 1024,
  "height": 1024,
  "quality": "basic"
}

resp = requests.post(API_URL, json=payload, headers={
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
})
resp.raise_for_status()
data = resp.json()

# Example: each item has 'b64_json' or 'url' depending on provider
for i, item in enumerate(data.get("data", [])):
    img_b64 = item.get("b64_json")
    if img_b64:
        img_bytes = base64.b64decode(img_b64)
        with open(f"seedream_result_{i}.png", "wb") as f:
            f.write(img_bytes)
    else:
        print("Image URL:", item.get("url"))

このパターンの理由 アグリゲーターは一般的にbase64ペイロードまたはホストされたURLのいずれかを返します。上記のコードは両方に対応します。エンドポイントは通常task_idを返します。ステータスがsucceededになるまでGET /tasks/{task_id}エンドポイントをポーリングし、その後結果をダウンロードします。多くのプロバイダーは、このパターンを簡素化するSDKを提供しています。

画像品質を最適化し、テキストの可読性を保つには？

  1. 一貫したコンテキストと色合わせのために参照画像を使用する。
  2. プロンプトでタイポグラフィを明示的に指定する（フォントファミリー、太さ、配置）。確実な可読性が必要な場合は、二次ステップで正確なテキストをオーバーレイすることを検討する。
  3. 2段階のプロセスを実行する：（a）ベースの構図を生成；（b）高解像度でクローズアップやラベル領域に焦点を当てた再レンダリングまたは編集。

Seedream 4.5向けのプロンプトの書き方

プロンプトエンジニアリングの原則

  • 明示的に記述する：被写体、動作、スタイル、レンズ／カメラ、時間帯、望むカラーパレットを列挙。
  • アイデンティティアンカーを使う：複数画像で同じ顔／小道具を維持したい場合は、継続的な記述（例：「同じ女性で、短い波打つ髪、緑のジャケット、左眉に傷」）を含め、1〜3枚の参照画像を提供する。Seedream 4.5の複数参照融合は改善されたが、アンカーは有効。
  • ネガティブプロンプト：避けたいことを明示的に記述（例：「テキストなし」「ウォーターマークなし」「余分な手足なし」）。
  • 短文＋長文のハイブリッド：短い基本指示を与え、その後に詳細と制約を数行追加する。

プロンプトテンプレート例

プロダクトのヒーローショット（フォトリアル）: "白いテーブルトップに置かれたマットブラックのワイヤレススピーカーのクリーンなヒーローショット、ソフトボックス照明、50mm、浅い被写界深度、スタジオ背景、フォトリアル、テキストなし"

ファンタジーイラスト（スタイライズ）: "壮大なファンタジー風景、断崖にそびえるガラスの城、ゴールデンアワー、ボリューメトリックフォグ、絵画風、非常に詳細、コンセプトアート"

画像編集（オブジェクト除去） : "左側の人物を削除し、背景を拡張して空間を埋める。ライティングは一貫させ、アーティファクトなし"

タイポグラフィ重視のモックアップ: "iPhone 14上のモバイルアプリのランディングスクリーンモックアップ。テキストは'Launch Now'をGotham Boldで。ボタンは緑にし、影はソフトに保つ"

キャラクターポートレート: "女性戦士の英雄的なポートレート、シネマティックなリムライティング、85mmポートレンズ、超高精細な肌の質感、自然なそばかす、レザーアーマー、ニュートラルな背景、フォトリアリスティック。"

マルチ画像と参照のプロンプト

マルチ画像編集を行う場合、どの参照画像がプロンプトのどの部分に対応するかを指定してください。Seedream 4.5は複数参照の中から主要被写体を識別する能力が向上しましたが、「image_1は顔、image_2は衣服のテクスチャに使用」といった明示があると結果が良くなります。

出力選択とポストプロセス

  • N個のバリエーションを生成し、客観的なフィルタをかける：顔類似度スコア、カラーヒストグラム比較、タイポグラフィのOCRによるテキスト正確性チェック。
  • QC閾値を自動化し、閾値未満の出力は手動レタッチにルーティング。
  • 最終的なタイポグラフィはレイアウトツールにオフロード：ピクセル単位で正確なテキストが必要な場合、モデルには背景やイメージ生成を任せ、正確なテキストは後工程で合成。これによりマーケティングアセットでモデルのテキスト忠実度に依存する必要が減ります。

画像編集、インペインティング、マルチ画像合成の実施方法

画像編集のワークフロー

  1. プロバイダーに参照画像をアップロードするか、リクエストにインラインで送信します。
  2. インペインティング用のマスク（2値画像）または対象編集のためのバウンディングアノテーションを提供します。
  3. 変更する領域と保持する領域を明確にした編集プロンプトを送信します。

多くのAPIは単一画像編集モードとマルチ画像合成モードの両方をサポートしています。4.5は被写体のアイデンティティ保持とマルチ画像の一貫性向上に明示的にチューニングされています。

例：インペインティングのペイロード（JSON疑似コード）

{
  "model": "seedream-4.5",
  "mode": "image_edit",
  "image_url": "https://.../original.png",
  "mask_url": "https://.../mask.png",
  "prompt": "Replace background with a sunset beach — keep subject untouched, maintain original lighting on subject",
  "guidance": 9,
  "steps": 40
}

一貫したマルチ画像編集のためのヒント

  • 関連するレンダリングには同じseedを使用してフレーム間の一貫性を保つ。
  • プロンプト内のカメラ記述（例：「85mm portrait, softbox, 3/4」）を一貫させ、視点の整合性を維持。
  • 顔の編集では、「顔の構造を保持し、髪色のみ変更」などの粒度の細かい保持条件をリクエストして、アイデンティティのドリフトを減らす。

Seedream 4.5利用時のベストプラクティス

よくある問題のトラブルシューティング方法

結果が意図と異なる場合の実用的な対処手順：

ぼやけた顔／誤ったディテール

顔の詳細（年齢、表情、ライティング）に関するプロンプトの具体性を高め、より高品質な参照画像を提供するか、「顔を保持」といった明示的な指示を追加し、編集のstrengthを下げて元画像の情報を多く残すようにします。Seedream 4.5は顔のリアリズムが強化されていますが、入力の品質は依然重要です。

テキストが読めない／文字が乱れる

ピクセル単位で正確なタイポグラフィが必要な場合は、テキストをベクターまたはラスターで別レイヤーとしてオーバーレイ提供してください。そうでない場合は、高解像度設定を使用し、「可読なテキストをレンダリング：はい」といったスタイル指示を明示します。4.5は過去のバージョンと比べて高密度テキストの扱いが改善されていますが、タイポグラフィの完全性が必要な場合は後工程での合成が有効です。

バッチ内のライティングや構図が不一致

ライティング／カメラに関する記述を固定したテンプレート化プロンプトを使うか、単一のバッチ呼び出し内で生成して一貫性を高めます。BytePlusやCometAPIはそのためのバッチ推論パターンを提供しています。

最後の注意点と次のステップ

Seedream 4.5は成熟したプロダクション志向の画像モデルであり、実際のクリエイティブワークフローを明確に意識した改善（より良い一貫性、テキストと顔のレンダリングの向上、複数参照サポート）を備えています。迅速な実験やマルチモデルの柔軟性が必要な場合は、CometAPIなどのアグリゲーターを利用してください。

開発者は、CometAPIを通じてSeedream 4.5 API等へアクセスできます。最新モデルバージョンは常に公式ウェブサイトに合わせて更新されています。開始にあたっては、Playgroundでモデルの機能を試し、詳細な手順はAPI guideを参照してください。アクセス前に、CometAPIへログインしてAPIキーを取得していることを確認してください。CometAPIは、公式価格よりはるかに低価格で統合を支援します。

準備はできましたか？→ Seedream 4.5の無料トライアル

より多くのヒント、ガイド、ニュースは、VK、X、Discordをフォローしてください。

もっと読む

1つのAPIで500以上のモデル

最大20%オフ