> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedream の過去バージョン

> Seedream 5.0 / 4.5 / 4.0 の仕様比較、料金の違い、移行ガイドです。3つのバージョンはいずれも引き続き呼び出し可能で、用途に応じて選択でき、破壊的変更はありません。

<Note>
  このページでは、APIYIで**引き続き呼び出し可能**なSeedreamの全バージョンを一覧表示しています。3つのバージョンは同時に有効で、**完全に互換性のあるパラメータ**を備えています。切り替えるには、`model`フィールドだけを変更してください。最新バージョンと一般的な紹介については、[Seedream 概要](/ja/api-capabilities/seedream-image/overview)をご覧ください。
</Note>

## 一覧で見るバージョン

| バージョンID                   | リリース日 (UTC+8) | APIYI価格          | ステータス       | 推奨用途                                 |
| ------------------------- | ------------- | ---------------- | ----------- | ------------------------------------ |
| `seedream-5-0-pro-260628` | 2026-06-28    | \$0.12 / request | 🆕 Pro tier | 最高の画像品質 / プロ向けの複雑な指示（画像1枚あたり約2分）     |
| `seedream-5-0-260128`     | 2026-01-28    | \$0.035 / image  | ✅ 推奨（最新版）   | 総合的な体験が最良、テキスト描画、png出力               |
| `seedream-4-5-251128`     | 2025-11-28    | \$0.04 / image   | ✅ 推奨        | 4K + 最も強力なテキスト描画（ポスター、広告）            |
| `seedream-4-0-250828`     | 2025-08-28    | \$0.03 / image   | 🟡 維持中      | 4K + 最安価格、prompt高速モードをサポートする唯一のバージョン |

<Tip>
  `seedream-5-0-260128` はエイリアス `seedream-5-0-lite-260128` でも呼び出せます — 公式ドキュメントでは両方の model\_id 文字列が受け入れられ、動作は同一です。
</Tip>

## バージョン別仕様

### `seedream-5-0-pro-260628` (5.0 Pro)

* **リリース日**: 2026-06-28 (UTC+8); APIYIでは 2026-07-19 から利用可能
* **APIYI価格**: **\$0.12 / request**（リクエストごとの固定価格、1 request あたり 1 画像、約 ¥0.84 の定価）。公式には、このモデルは 2 段階の出力ピクセル価格ティア（≤2.36M / >2.36M）と、1 枚目以降の参照画像に対する料金を採用していますが、APIYIではこれを入力画像費用込みの一律リクエスト単価に簡略化しています
* **解像度ティア**: プリセット `1K` / `2K`（**3K/4K プリセットはなし**）に加え、合計 **4.19M** までの正確なピクセル `WxH`（最大 2048×2048; 16:9 では長辺が `2720x1530` まで達し、約 2.7K、検証済み）
* **出力形式**: `png` / `jpeg`
* **prompt最適化**: 標準 / 高速
* **特長**:
  * ファミリー内で最も高い画像品質と指示追従性能を持ちます。対話的な編集にも対応します（座標、選択ボックス、矢印で編集箇所を指定）
  * 複数画像融合は公式に **最大 10 枚の参照画像** をサポート
* **既知の制限**:
  * **`sequential_image_generation` / `stream` は受け付けられません** — いずれの値（`"disabled"` を含む）でも 400 が返ります。両方のパラメータを完全に省略してください
  * 生成が遅く、1 画像あたり一貫して **約 2 分**（実測 110-130s）かかります。クライアントのタイムアウトは 240s 以上に設定してください
  * 5.0-lite の 3.4 倍の単価です。日常的な作業には 5.0-lite をご利用ください

### `seedream-5-0-260128` (5.0-lite)

* **リリース日**: 2026-01-28 (UTC+8)
* **APIYI価格**: \$0.035 / image（約 ¥0.245 の定価）
* **解像度ティア**: `2K` / `3K`（**4K なし**）
* **出力形式**: `png` / `jpeg`（png 出力に対応する唯一のバージョン）
* **prompt最適化**: 標準
* **特長**:
  * 総合的に最も使いやすく、複数画像融合 / 編集 / バッチシーケンスの実装が最も成熟しています
  * `png` 出力に対応する唯一のバージョンです（そのため透明背景にも対応）
  * 成熟したストリーミング出力（`stream: true`）
* **既知の制限**:
  * 解像度は 3K（約 3072×3072）までに制限されます。4K 素材には 4.5 / 4.0 をご利用ください
* **公式ドキュメント**: `docs.byteplus.com/en/docs/ModelArk/1824121`

### `seedream-4-5-251128`

* **リリース日**: 2025-11-28 (UTC+8)
* **APIYI価格**: \$0.04 / image（約 ¥0.28 の定価）
* **解像度ティア**: `2K` / `4K`
* **出力形式**: `jpeg`
* **prompt最適化**: 標準
* **特長**:
  * 12 億パラメータの統合生成・編集アーキテクチャ
  * **文字レンダリングのブレークスルー**: 小さな文字もくっきり表示され、ポスター、広告、UI スクリーンショットで業界トップクラスです
  * 複数画像融合は最大 10 枚の参照画像を明示的にサポート
  * 編集では照明、色調、自然な顔のディテールが維持されます
* **既知の制限**:
  * `jpeg` 出力のみ（`png` なし、透明化なし）
* **関連記事**: [Seedream 4.5 launch](/en/news/seedream-4-5-launch)

### `seedream-4-0-250828`

* **リリース日**: 2025-08-28 (UTC+8)
* **APIYI価格**: \$0.03 / image（約 ¥0.21 の定価）
* **解像度ティア**: `1K` / `2K` / `4K`（最も幅広い対応範囲）
* **出力形式**: `jpeg`
* **prompt最適化**: 標準 / **高速**
* **特長**:
  * 実戦で鍛えられた安定版
  * 強いビジュアル一貫性と、バランスの取れた 4K ディテール
  * **prompt fast モードに対応する唯一のバージョン** — コスト重視のシナリオでより高速に生成できます
* **既知の制限**:
  * 文字レンダリングは 4.5 より弱いです
  * `jpeg` 出力のみ

## 移行ガイダンス

<Steps>
  <Step title="違いを確認する">
    3つのバージョンは**パラメータレベルでは完全に互換**です。切り替えるには `model` フィールドだけを変更してください。次を再確認してください:

    * 新しいバージョンでご利用の `size` ティアがサポートされているか（5.0 には 1K / 4K がなく、4.5 には 1K がなく、4.0 にはすべてあります）
    * `output_format: "png"` に依存しているか（5.0 のみ）
    * `prompt_optimization: "fast"` を使っているか（4.0 のみ）
  </Step>

  <Step title="並行実行する">
    古いバージョンと新しいバージョンで同じ prompt バッチを実行し、品質とコストを比較してください。拡大する前に小さなバッチ（10〜20枚の画像）で検証してください。
  </Step>

  <Step title="段階的に展開する">
    トラフィックを段階的に切り替えます（10% / 50% / 100%）。各段階で、さらに拡大する前に品質、失敗率、コストを観察してください。
  </Step>

  <Step title="フォールバックを維持する">
    本番コードには古い `model` 設定と新しい `model` 設定の両方を残しておきます。新しいバージョンの挙動がおかしい場合は、すぐに元へ戻せます。3つのバージョンはすべて統一課金を共有しているため、両方を動かしても追加コストはかかりません。
  </Step>
</Steps>

## レガシーな呼び出し例

```python theme={null}
{/* Switching versions only changes the model field; other params are compatible */}
from openai import OpenAI

client = OpenAI(api_key="sk-your-api-key", base_url="https://api.apiyi.com/v1")

resp = client.images.generate(
    model="seedream-4-0-250828",   # change this line to switch to 4.5 / 5.0
    prompt="A serene mountain landscape at golden hour, snow-capped peaks, ultra detailed, 4K",
    size="4K",                      # NOTE: 5.0 does not support 4K — use 2K or 3K
    response_format="url",
    extra_body={
        "watermark": False,
    }
)

print(resp.data[0].url)
```

## コスト比較

一般的な利用量を基にした試算です（**チャージボーナス前**。ボーナス適用で実効価格は最大80%まで下がります）:

| バージョン                     | 単価             | 100枚  | 1,000枚 | 10,000枚 |
| ------------------------- | -------------- | ----- | ------ | ------- |
| `seedream-5-0-pro-260628` | \$0.12 / リクエスト | \$12  | \$120  | \$1200  |
| `seedream-5-0-260128`     | \$0.035        | \$3.5 | \$35   | \$350   |
| `seedream-4-5-251128`     | \$0.04         | \$4   | \$40   | \$400   |
| `seedream-4-0-250828`     | \$0.03         | \$3   | \$30   | \$300   |

<Info>
  **選び方**:

  * 4Kアセット + テキスト重視 → **4.5**
  * 4Kアセット + 最安 → **4.0**
  * 総合最良 / png出力 / 透過背景 → **5.0**
  * 長時間の安定したバッチ生成 → **4.0**（実績あり、最安、高速promptモード）
  * 最高品質 / 複雑な指示を要するプロ用途 → **5.0-pro**（\$0.12/リクエスト + 画像あたり約2分 — 必要な場合を除き、避けてください）
</Info>

## 互換性マトリクス

| 項目                             | 5.0-pro                | 5.0  | 4.5           | 4.0  | 移行メモ                                                   |
| ------------------------------ | ---------------------- | ---- | ------------- | ---- | ------------------------------------------------------ |
| `1K` 解像度ティア                    | ✅                      | ❌    | ❌             | ✅    | 4.0 から 5.0-lite へ移行する場合 → 1K を 2K に切り替えてください           |
| `4K` 解像度ティア                    | ❌                      | ❌    | ✅             | ✅    | 4.5/4.0 から 5.0 シリーズへ移行する場合 → ティアを変更してください              |
| `output_format: "png"`         | ✅                      | ✅    | ❌             | ❌    | 5.0 シリーズから 4.5/4.0 へ移行する場合 → **透過は失われます**              |
| `prompt_optimization: "fast"`  | ✅                      | ❌    | ❌             | ✅    | 5.0-lite / 4.5 は fast に対応していません — 切り替え時にパラメータを削除してください |
| `image` 配列（マルチ画像フュージョン）        | ✅（明示指定は最大10件）          | ✅    | ✅（明示指定は最大10件） | ✅    | プロトコルは同一です                                             |
| `sequential_image_generation`  | ❌（**どの値でも 400 を返します**） | ✅    | ✅             | ✅    | pro へ移行する場合: パラメータを完全に削除してください（`"disabled"`を含む）        |
| `stream` ストリーミング               | ❌（渡すと 400）             | ✅    | ✅             | ✅    | pro へ移行する場合: パラメータを削除してください                            |
| レスポンスフィールド（`url` / `b64_json`） | 同一                     | 同一   | 同一            | 同一   | —                                                      |
| 課金                             | **\$0.12 / リクエスト**     | 画像ごと | 画像ごと          | 画像ごと | —                                                      |

## 関連ドキュメント

* [Seedream 概要](/ja/api-capabilities/seedream-image/overview)
* [テキストから画像へのプレイグラウンド](/ja/api-capabilities/seedream-image/text-to-image)
* [画像編集プレイグラウンド](/ja/api-capabilities/seedream-image/image-edit)
* [Seedream 4.5 ローンチ](/en/news/seedream-4-5-launch)
* BytePlus 公式チュートリアル: `docs.byteplus.com/en/docs/ModelArk/1824121`
