フラッグシップの出力品質
Seedream 5 Pro はフォトリアルなシーン、エディトリアルな商品写真、正確な画像内テキストを 1K/2K でレンダリング——GPT Image や NanoBanana と同等水準。
Seedream 5 Pro API ガイド
Seedream 5 Pro は ByteDance のフラッグシップ画像モデル——多言語テキスト描画、複数参照画像による編集、クリーンなフォトリアル出力に強みを持ちます。Seedance API では安定したエイリアスとして、シンプルな REST エンドポイントと非同期タスクポーリングで呼び出せます。
1K または 2K 出力
1:1、16:9、9:16、2:3、3:2 など
プロンプトまたは最大10枚の参照画像
HTTPS 上の JSON
スターターリクエスト
curl -X POST 'https://seedanceapi.org/v1/images/generations' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "seedream-5-pro",
"prompt": "Studio product shot of a matte black water bottle on wet stone, soft top light",
"aspect_ratio": "4:3",
"resolution": "2k",
"image_urls": []
}'POST /v1/images/generations が task_id を返します。GET /v1/images/generations/:task_id を status が SUCCESS になるまでポーリングし、images[].url を読み取ります。
プロバイダーの SDK や予期しないスキーマ変更なしに、フラッグシップ品質の画像モデルを予測可能な REST 層の後ろに置きたいチームが選びます。
Seedream 5 Pro はフォトリアルなシーン、エディトリアルな商品写真、正確な画像内テキストを 1K/2K でレンダリング——GPT Image や NanoBanana と同等水準。
model "seedream-5-pro" を呼ぶだけ。プロバイダーのルーティング、容量、フォールバックはこちら側で処理——上流の変更に統合が影響されません。
1K 画像は 9 クレジット、2K は 18、2枚目以降の参照画像は +0.8。estimated_credits が作成レスポンスに含まれます。
公開インターフェースはモデルの実際の能力をそのまま提供:テキストから画像生成と最大10枚の参照画像による編集。
最大3000文字のプロンプトにアスペクト比と解像度を付けて送信——構図・光・画像内タイポグラフィはモデルが処理します。
image_urls に公開 HTTPS 画像 URL を 1〜10 件渡すと、既存ビジュアルの編集・合成・リスタイルが可能——商品差し替え、背景変更、スタイル転送。
resolution を "2k" にすると印刷品質のレンダリングに。1K はプレビューやイテレーション向け。
モデルの最大の強みのひとつ——ポスターやサイン内の英語・中国語・日本語などの文字が読みやすく出力されます。
作成時に即座に task_id が返ります。自分のペースでステータスをポーリングし、UI の応答性を維持——長時間接続は不要。
上流のルーティングに関係なくレスポンス形式は安定——consumed_credits、status、画像 URL は正規化されて返ります。
API キーから完成画像 URL までの 3 ステップ。
ログインして API Keys ページを開き、サーバーサイド用のキーをコピー。バックエンドに保管——ブラウザコードには含めないでください。
POST /v1/images/generations を model "seedream-5-pro"、プロンプト、aspect_ratio、resolution、オプションの image_urls で呼び出し。task_id と estimated_credits が返ります。
GET /v1/images/generations/:task_id を呼び出し。status が SUCCESS になったら images[0].url を読み取り、表示または保存します。
作成とポーリング——2 つのエンドポイントでライフサイクル全体をカバー。
Seedream 5 Pro タスクを作成。空の image_urls はテキストから画像生成、1〜10 URL は参照編集。task_id と estimated_credits を含む 202 を返します。
IN_PROGRESS、images[].url を含む SUCCESS、またはエラーオブジェクト付きの FAILED を返却。完了後は consumed_credits も返します。
400 無効なパラメータ、401 無効なキー、402 クレジット不足、404 タスク不明、429 レート制限、503 上流不可。完全な表はドキュメントを参照。
| パラメータ | 値 |
|---|---|
| model | 必ず "seedream-5-pro"——このルートで唯一の公開モデル。 |
| prompt | テキストプロンプトまたは編集指示、1〜3000 文字。 |
| aspect_ratio | 1:1、4:3、3:4、16:9、9:16、2:3、3:2 のいずれか。デフォルト 1:1。 |
| resolution | "1k"(デフォルト、9 クレジット)または "2k"(18 クレジット)。 |
| image_urls | 公開 HTTPS URL を 0〜10 件。空配列 = 純粋なテキストから画像生成。 |
不明なパラメータは 400 UNKNOWN_PARAMETER で拒否——契約は明示的に保たれます。完全なスキーマは /docs/images を参照。
Seedance API クレジットによる画像あたり定額料金。作成レスポンスに estimated_credits、完了ステータスに consumed_credits が含まれます。
| モード | クレジット | 備考 |
|---|---|---|
| テキストから画像生成 · 1K | 9 クレジット / 画像 | デフォルト解像度——イテレーションやプレビュー向け。 |
| テキストから画像生成 · 2K | 18 クレジット / 画像 | 最終アセット向けの印刷品質出力。 |
| 参照画像による編集 | 追加画像ごとに +0.8 クレジット | 最初の参照画像は基本料金に含まれ、2〜10 枚目は各 +0.8。 |
Seedance API 上の Seedream 5 Pro API を検討する開発者向けの回答。
Seedance API は Seedream 5 Pro を安定した REST 層の後ろで提供——認証・課金・レスポンスが正規化された状態でモデルの全機能を利用でき、プロバイダー認証情報の管理は不要です。
image_urls を空配列にすればテキストから画像生成、公開 HTTPS 画像 URL を 1〜10 件渡せば参照編集・合成——同じエンドポイントで両モードを処理します。
1:1、4:3、3:4、16:9、9:16、2:3、3:2。配置に合う比率を選択——モデルは切り抜きではなくその比率でネイティブに構図します。
1K あたり 9 クレジット、2K あたり 18。参照編集は 2 枚目以降 +0.8 クレジット。estimated_credits はポーリング前に確認できます。
通常の 1K タスクは約 15〜25 秒。2K や複数参照編集はさらに時間がかかります。ステータスエンドポイントをポーリング——タスクは設計上非同期です。
いいえ——呼ぶべきでもありません。Bearer キーはバックエンドに置き、サーバーサイドから呼び出し、クライアントには自分の安全なルートのみを公開してください。
はい——多言語の画像内テキストは強みのひとつ。ポスター、値札、ローカライズされた広告クリエイティブで読みやすい文字が出ます。
完全なリクエストスキーマ、レスポンス例、エラー表、料金詳細は /docs/images に。このページは統合の概要です。
APIキーを取得し、最初の生成タスクを送信して、今日からフラッグシップ画像生成をプロダクトに組み込みましょう。