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 は複数画像ワークフローにおける被写体の一貫性向上、参照ディテールの厳格な保持、より高いタイポグラフィ忠実度(画像内テキスト)、そして「高品質」設定における 4K/超高精細までの出力品質改善に重点を置いています。これらの改善は、拡張されたアーキテクチャと更新されたプロンプト調整/エンジン側ヒューリスティクスの結果です。

なぜ重要か: 4.5 は、プロフェッショナルなクリエイティブ業務—バッチのプロダクトバリエーション、ブランド整合の取れた複数画像編集、高解像度の印刷資材—を想定して設計されており、参照画像や特化した編集操作によるきめ細かな制御を可能にします。

主要な機能

  • テキストから画像生成(単発・バッチ):1〜15 枚の画像を 1 回の API 呼び出しで生成。速度と解像度をトレードオフする品質モード(Basic と High)を選択可能。
  • 画像編集(i2i/インペインティング/アウトペインティング): 1 枚以上の参照画像を使用可能。複数参照間でのディテールと空間関係を保持。
  • 複数参照のブレンディング&要素コピー: 1 ジョブあたり約 10 枚までの参照画像で、要素を移植しつつ光源や遠近を整合。
  • 高いタイポグラフィ/高密度テキスト描画: テキストやサイネージを含む画像の扱いを改善(モックアップ、製品ラベル、UI スクリーンショットに有用)。
  • ストリーミング/プログレッシブ出力: 一部のデプロイ先はストリーミングに対応し、生成中の部分結果を受け取れます。

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

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

ハイレベルな手順

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

リクエスト種別とモード

Seedream 4.5 が一般的にサポートするもの:

  • テキスト → 画像(テキストプロンプト → 新規画像)
  • 画像 → 画像(参照画像+プロンプトによるスタイル変換)
  • 画像編集/インペインティング(マスク+編集指示でピンポイント変更)
    ホスト型 API は非同期タスクモード(ジョブ送信 → taskId でポーリング)にも対応しており、長時間レンダリングやバッチワークフローに適しています。生成リンクは時間制限付き(例:一部ゲートウェイでは 24 時間有効)であることが多いため、保存/エクスポート計画を立ててください。

curl example (text-to-image, single prompt)

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 example (text-to-image + saving results)

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. 二段階プロセスを実施:(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. インペインティング用のマスク(二値画像)または対象領域のバウンディング注釈を提供します。
  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 ポートレート、ソフトボックス、3/4」)を固定する。
  • 顔を編集する際は、「顔の構造は保持し、髪色のみ変更」のようなきめ細かな保持条件を付け、アイデンティティのドリフトを抑える。

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

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

期待どおりでない結果が出た場合の実践的な対処手順:

顔がぼやける/細部が誤っている

顔の詳細(年齢、表情、照明)をプロンプトでより具体化し、より高品質な参照画像を用意するか、「顔を保持」と明示し、編集の strength を下げて元画像の寄与を増やしてください。Seedream 4.5 は顔のリアリズムが改善していますが、入力品質は依然として重要です。

テキストが読めない/文字化けする

ピクセル単位のタイポグラフィ精度が必要な場合は、ベクターまたはラスタのテキストを別レイヤーでオーバーレイしてください。そうでなければ、より高い解像度設定と「可読テキストをレンダリング:はい」といった明示的なスタイル指示を使用します。4.5 は従来より高密度テキストの扱いが向上していますが、完全なタイポグラフィはポスト合成が望ましい場合があります。

バッチで照明や構図が不一致

照明/カメラ記述を固定したテンプレートプロンプトを使用するか、一回のバッチ呼び出し内で生成して一貫性を高めてください。BytePlus と CometAPI はそのためのバッチ推論パターンを提供しています。

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

Seedream 4.5 は、実運用を見据えた成熟した画像モデルであり、より良い一貫性、テキストと顔の描画改善、複数参照サポートなど、実際のクリエイティブワークフローに焦点を当てた改善が明確です。迅速な実験とマルチモデルの柔軟性が必要な場合は CometAPI などのアグリゲーターを利用してください。

開発者は CometAPI を通じて [Seedream 4.5](http://Seedream 4.5) API 等にアクセスできます。the latest model version は常に公式サイトに合わせて更新されています。まずは Playground でモデルの機能を試し、詳細は API guide を参照してください。アクセス前に、CometAPI にログインし API キーを取得していることを確認してください。CometAPI は公式価格よりもはるかに低い価格を提供し、統合を支援します。

Ready to Go?→ Free trial of Seedream 4.5 !

AI に関するヒント、ガイド、ニュースをさらに知りたい方は、VKXDiscord をフォローしてください。

SHARE THIS BLOG

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

最大20%オフ