Seedream 5.0 Lite API 2026の使い方：EvoLink（非同期ワークフロー）での段階的な統合ガイド

概要

• Seedream 5.0 Liteは深い思考 + リアルタイム検索強化を重視しています（検索機能は製品実装に応じてオン/オフの切り替えが可能）。
• EvoLink経由で統合する場合、基本パターンは以下の通りです：
  • POST https://api.evolink.ai/v1/images/generations
  • 次に GET https://api.evolink.ai/v1/tasks/{task_id} でポーリング
  • 結果を速やかに保存（生成されたリンクには有効期限がある場合があります）。
• Seedream 5.0はEvoLinkで本日夜にロールアウト予定です（段階的なロールアウトは一般的です。ダッシュボードのモデル一覧をご確認ください）。

1. Seedream 5.0 Liteとは（過大な主張を避けるために）

安全に主張できること

Seedream 5.0 Liteは、よりスマートな画像モデルとして位置づけられています：

• より強力なクロスモーダル理解と推論、
• 改善された被写体の一貫性と画像・テキストの整合性、
• 時間に敏感な生成に対応するリアルタイム検索強化（特にリアルタイム情報を含むポスターに有用）。

公式APIの証拠なしに主張すべきでないこと

以下のような未文書化のAPIフィールドや仕組みについての断定は避けてください：

• conversation_id、enable_conversation、「マルチターン会話型編集セッション」
• 固定のレイテンシオーバーヘッド数値（例：「2〜5秒追加」）
• 現実世界の事実に対する正確性の保証

代わりに：「反復的な編集ワークフロー」として説明し、正確なリクエストスキーマについてはドキュメントを参照してください。

2. アクセスオプション（統合パスの選択）

オプションA — BytePlus ModelArk（公式、直接接続）

公式への直接アクセスに適しています。ModelArkのベースURL + APIキー認証を使用し、Image Generation APIを直接呼び出します。

オプションB — EvoLink（統合ゲートウェイ、マルチモデルワークフローに推奨）

複数の画像モデルにわたって単一のAPIインターフェースを使用したい場合に適しています。

3. EvoLink統合（EvoLink非同期ワークフローでのSeedream 5.0 Lite）

このセクションでは、EvoLinkのSeedream画像生成パターン：送信 → ポーリング → 保存に従います。

3.1 認証

すべてのEvoLink APIはBearerトークン認証を使用します：

Authorization: Bearer YOUR_API_KEY

APIキーはEvoLinkダッシュボード（APIキー管理）から取得できます。

3.2 ステップバイステップ：送信 → ポーリング → 保存

ステップ1 — 画像生成タスクを送信

• size：比率（例：16:9）またはピクセル（例：2048x2048）
• quality：2K または 4K（比率形式のsizeと組み合わせて使用）

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedream-5.0-lite",
    "prompt": "A clean product poster of a solar street light, studio lighting, white background, crisp typography, realistic materials.",
    "size": "16:9",
    "quality": "2K"
  }'

非同期タスクオブジェクトが返されます（例）：

{
  "created": 1757165031,
  "id": "task-unified-1757165031-seedream5d",
  "model": "doubao-seedream-5.0-lite",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 3.0,
    "user_group": "default"
  }
}

Seedream 5.0 Liteに関する注意：正しいモデル名は、EvoLink公式ドキュメントに示されているように doubao-seedream-5.0-lite です。

ステップ2 — タスクステータスをポーリング

curl --request GET \
  --url "https://api.evolink.ai/v1/tasks/task-unified-1757165031-seedream5d" \
  --header 'Authorization: Bearer YOUR_API_KEY'

{
  "created": 1756817821,
  "id": "task-unified-1756817821-4x3rx6ny",
  "model": "gpt-4o-image",
  "object": "image.generation.task",
  "progress": 100,
  "results": ["http://example.com/image.jpg"],
  "status": "completed",
  "task_info": { "can_cancel": false },
  "type": "image"
}

ステップ3 — 結果を速やかに保存

3.3 EvoLinkリクエストパラメータ（実用リファレンス）

以下は、EvoLinkのSeedream 5.0ドキュメントに基づいた統合パラメータガイドです。

必須

• model（string）— 例："doubao-seedream-5.0-lite"
• prompt（string）— 生成したい画像の説明、または入力画像の編集方法。上限：2000トークン。

一般的なオプション

• n（integer、1〜15）— 生成する画像の最大数。
  • 複数の画像を生成するには、プロンプトに「generate 2 different images」と記述することもできます。
  • 参照画像数 + 最終生成画像数 ≤ 15。
  • 事前課金は n に基づく場合がありますが、最終的な課金は実際の生成数に基づく場合があります。
• size（string）— 2つのモード：
  • 比率形式：auto、1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9 — quality と組み合わせて自動的に解像度を選択します。
  • ピクセル形式：幅x高さ（例：2048x2048、2560x1440、4096x4096）— デフォルト：2048x2048。ピクセル範囲：2560x1440〜4096x4096。アスペクト比範囲：1/16〜16。
• quality（string enum）— 2K または 4K。比率形式のsizeと組み合わせて使用します。
• prompt_priority（enum）— standard（より高品質な出力、処理時間は長くなります）。
• image_urls（画像URLの配列）— 画像から画像への変換 / 画像編集ワークフロー用。制限：
  • リクエストあたり最大14枚の入力画像
  • 各画像 ≤ 10MB
  • 対応形式：.jpeg、.jpg、.png、.webp、.bmp、.tiff、.gif
  • アスペクト比（幅/高さ）範囲：1/16〜16
  • 総ピクセル数 ≤ 6000×6000
• callback_url（string、HTTPSのみ）— タスクの完了/失敗/キャンセル時に呼び出されるWebhook（課金確認後）。
  • HTTPSのみ
  • 内部IPへのコールバックは禁止
  • タイムアウト10秒、最大3回リトライ（1秒 / 2秒 / 4秒）
  • コールバックのボディはタスク照会APIのレスポンス形式と同一

4. プロンプトのベストプラクティス（Seedreamスタイル）

Seedreamは「デザイナーのような制約」を提供すると最も効果的に応答します：

4.1 レイアウトと構図

• "Poster layout, headline at top, safe margins, centered hero product, empty lower-third for copy"
• "Front-facing, balanced symmetry, minimal background"

4.2 タイポグラフィ（テキストは短く）

• 階層を指定："1 large headline + 1 short subhead + 2 bullet lines"
• 明瞭さを指定："sharp readable sans-serif, high contrast, no stylized distorted text"

4.3 参照画像（ブランドの一貫性）

• ブランドスタイルガイドの参照
• 製品写真の参照
• キャラクター参照（一貫したキャラクターが必要な場合）

注意：参照画像 + 生成画像 ≤ 15。

5. 本番環境の信頼性チェックリスト（EvoLink非同期）

• 429：指数バックオフ + ジッター
• 5xx：最大3回リトライ（2秒 → 4秒 → 8秒）

• 最初の20秒間は2〜3秒間隔で開始
• その後5〜10秒間隔に変更
• 合理的なタイムアウト後に停止し、適切に失敗として処理

• task_id
• 最終的な results[] のURL
• プロンプトとパラメータ（デバッグの再現性のため）

6. コスト管理戦略（実用的、モデル非依存）

• デフォルトでは 2K を使用し、4K は最終アセット用に温存。
• n は小さく保ち、ブルートフォースではなくプロンプトを反復的に改善。
• (model + prompt + size + quality + image_urls) のハッシュでキャッシュし、重複を回避。
• 大量ジョブの場合は callback_url を使用して、過度なポーリングを回避。

まとめ

Seedream 5.0 Liteは、推論重視の画像モデルとして位置づけるのが最適であり、時間に敏感な生成にはオプションのリアルタイム検索強化機能を備えています。開発者にとって最もクリーンな本番パターンは以下の通りです：

1. アクセスパスを選択（ModelArk直接接続 vs EvoLink統合ゲートウェイ）、
2. 安定した非同期ワークフローを実装（送信 → ポーリング/コールバック → 保存）、
3. 高度な機能は、公式APIスキーマが明示的に文書化されていない限り「機能レベル」として扱う。

EvoLinkでSeedream 5.0 Liteを始める準備はできましたか？

• 🚀 即時アクセス — 1つのキー、1つのエンドポイント
• 🔧 統一API — モデル間で一貫したスキーマ
• 📊 タスク + 使用量の可視化 — 予測可能な非同期ワークフロー
• 🛡️ 本番環境対応 — コールバックサポートと安全な制約

1. evolink.ai でサインアップしてAPIキーを取得
2. ダッシュボードでModelsを開き、Seedream 5.0 Liteを見つける
3. 以下を呼び出す：

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "<SEEDREAM_5_0_LITE_MODEL_NAME_FROM_EVO_LINK_DASHBOARD>",
    "prompt": "A clean product poster of a solar street light, studio lighting, white background, crisp typography, realistic materials.",
    "size": "16:9",
    "quality": "2K"
  }'

次にクエリ：

curl --request GET \
  --url https://api.evolink.ai/v1/tasks/<task_id> \
  --header 'Authorization: Bearer YOUR_API_KEY'