Seedream 5 Pro API ガイド

AI画像生成のための Seedream 5 Pro API

Seedream 5 Pro は ByteDance のフラッグシップ画像モデル——多言語テキスト描画、複数参照画像による編集、クリーンなフォトリアル出力に強みを持ちます。Seedance API では安定したエイリアスとして、シンプルな REST エンドポイントと非同期タスクポーリングで呼び出せます。

解像度
1K / 2K

1K または 2K 出力

アスペクト比
7

1:1、16:9、9:16、2:3、3:2 など

入力
T2I + I2I

プロンプトまたは最大10枚の参照画像

インターフェース
REST

HTTPS 上の JSON

スターターリクエスト

Seedream 5 Pro の画像タスクを作成

seedream-5-pro
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 を読み取ります。

Seedream 5 Pro API を選ぶ理由

プロバイダーの SDK や予期しないスキーマ変更なしに、フラッグシップ品質の画像モデルを予測可能な REST 層の後ろに置きたいチームが選びます。

フラッグシップの出力品質

Seedream 5 Pro はフォトリアルなシーン、エディトリアルな商品写真、正確な画像内テキストを 1K/2K でレンダリング——GPT Image や NanoBanana と同等水準。

安定したモデルエイリアス

model "seedream-5-pro" を呼ぶだけ。プロバイダーのルーティング、容量、フォールバックはこちら側で処理——上流の変更に統合が影響されません。

予測可能なクレジット料金

1K 画像は 9 クレジット、2K は 18、2枚目以降の参照画像は +0.8。estimated_credits が作成レスポンスに含まれます。

Seedream 5 Pro API の機能

公開インターフェースはモデルの実際の能力をそのまま提供:テキストから画像生成と最大10枚の参照画像による編集。

テキストから画像生成

最大3000文字のプロンプトにアスペクト比と解像度を付けて送信——構図・光・画像内タイポグラフィはモデルが処理します。

複数参照による編集

image_urls に公開 HTTPS 画像 URL を 1〜10 件渡すと、既存ビジュアルの編集・合成・リスタイルが可能——商品差し替え、背景変更、スタイル転送。

2K 高解像度出力

resolution を "2k" にすると印刷品質のレンダリングに。1K はプレビューやイテレーション向け。

多言語の画像内テキスト

モデルの最大の強みのひとつ——ポスターやサイン内の英語・中国語・日本語などの文字が読みやすく出力されます。

非同期ジョブアーキテクチャ

作成時に即座に task_id が返ります。自分のペースでステータスをポーリングし、UI の応答性を維持——長時間接続は不要。

プロバイダー非依存のレスポンス

上流のルーティングに関係なくレスポンス形式は安定——consumed_credits、status、画像 URL は正規化されて返ります。

Seedream 5 Pro API の呼び出し方

API キーから完成画像 URL までの 3 ステップ。

1

APIキーを作成

ログインして API Keys ページを開き、サーバーサイド用のキーをコピー。バックエンドに保管——ブラウザコードには含めないでください。

2

生成タスクを送信

POST /v1/images/generations を model "seedream-5-pro"、プロンプト、aspect_ratio、resolution、オプションの image_urls で呼び出し。task_id と estimated_credits が返ります。

3

ポーリングして描画

GET /v1/images/generations/:task_id を呼び出し。status が SUCCESS になったら images[0].url を読み取り、表示または保存します。

エンドポイントリファレンス

作成とポーリング——2 つのエンドポイントでライフサイクル全体をカバー。

POST /v1/images/generations

Seedream 5 Pro タスクを作成。空の image_urls はテキストから画像生成、1〜10 URL は参照編集。task_id と estimated_credits を含む 202 を返します。

GET /v1/images/generations/:task_id

IN_PROGRESS、images[].url を含む SUCCESS、またはエラーオブジェクト付きの FAILED を返却。完了後は consumed_credits も返します。

エラーとレート制限

400 無効なパラメータ、401 無効なキー、402 クレジット不足、404 タスク不明、429 レート制限、503 上流不可。完全な表はドキュメントを参照。

リクエストパラメータ

パラメータ値
model必ず "seedream-5-pro"——このルートで唯一の公開モデル。
promptテキストプロンプトまたは編集指示、1〜3000 文字。
aspect_ratio1: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 が含まれます。

モードクレジット備考
テキストから画像生成 · 1K9 クレジット / 画像デフォルト解像度——イテレーションやプレビュー向け。
テキストから画像生成 · 2K18 クレジット / 画像最終アセット向けの印刷品質出力。
参照画像による編集追加画像ごとに +0.8 クレジット最初の参照画像は基本料金に含まれ、2〜10 枚目は各 +0.8。

Seedream 5 Pro API よくある質問

Seedance API 上の Seedream 5 Pro API を検討する開発者向けの回答。

これは ByteDance 公式の Seedream 5 Pro API ですか?

Seedance API は Seedream 5 Pro を安定した REST 層の後ろで提供——認証・課金・レスポンスが正規化された状態でモデルの全機能を利用でき、プロバイダー認証情報の管理は不要です。

テキストから画像生成と参照編集の違いは?

image_urls を空配列にすればテキストから画像生成、公開 HTTPS 画像 URL を 1〜10 件渡せば参照編集・合成——同じエンドポイントで両モードを処理します。

Seedream 5 Pro はどのアスペクト比に対応?

1:1、4:3、3:4、16:9、9:16、2:3、3:2。配置に合う比率を選択——モデルは切り抜きではなくその比率でネイティブに構図します。

Seedream 5 Pro の画像 1 枚の料金は?

1K あたり 9 クレジット、2K あたり 18。参照編集は 2 枚目以降 +0.8 クレジット。estimated_credits はポーリング前に確認できます。

生成にどのくらい時間がかかりますか?

通常の 1K タスクは約 15〜25 秒。2K や複数参照編集はさらに時間がかかります。ステータスエンドポイントをポーリング——タスクは設計上非同期です。

ブラウザからこの API を呼べますか?

いいえ——呼ぶべきでもありません。Bearer キーはバックエンドに置き、サーバーサイドから呼び出し、クライアントには自分の安全なルートのみを公開してください。

Seedream 5 Pro は画像内にテキストを描画できますか?

はい——多言語の画像内テキストは強みのひとつ。ポスター、値札、ローカライズされた広告クリエイティブで読みやすい文字が出ます。

完全な API ドキュメントはどこ?

完全なリクエストスキーマ、レスポンス例、エラー表、料金詳細は /docs/images に。このページは統合の概要です。

最初の Seedream 5 Pro 画像を作成

APIキーを取得し、最初の生成タスクを送信して、今日からフラッグシップ画像生成をプロダクトに組み込みましょう。