商品・ライフスタイルコンセプト
プロンプトから商品関連シーンを作成するか、商品写真1枚を別のビジュアル表現に変更します。
Topview APIでNano Bananaの画像生成と編集をプロダクトに組み込めます。対応する5種類のアスペクト比で生成し、入力画像1枚を編集。解像度ティアの選択なしで、わかりやすい画像単価を利用できます。
Text to Image
ここでの設定はプレビューです。生成するとプロンプトがコピーされ、対応するPlatform Playgroundが開き、最終設定を確認できます。
実装前に設定を把握しましょう。
Topview API Platformドキュメントに掲載のNano Banana設定のクイックリファレンスです。モードごとに入力要件が異なります。
| パラメータ | 値 |
|---|---|
| プロバイダー / モデル | Google / Nano Banana |
| APIルート | google/nano-banana |
| 生成モード | Text to Image · Image Editing |
| 解像度 | Standard output (no resolution parameter) |
| アスペクト比 | 1:1 · 16:9 · 9:16 · 4:3 · 3:4 |
| Image Editingの入力 | 1 image |
| プロンプト長 | Up to 4,000 characters |
| タスク方式 | Async submission + polling + output retrieval |
| 料金 | Per generated image; settlement follows actual usage |
開発者クイックスタート
Platform APIキーで非同期予測を送信し、返却されたタスクIDをポーリングして出力を取得します。
# Set TOPVIEW_API_PLATFORM_KEY once. Preserve REQUEST_KEY and input for uncertain retries.
# For a NEW task only, unset REQUEST_KEY first. Save data.id to resume GET only.
: "${TOPVIEW_API_PLATFORM_KEY:?Set TOPVIEW_API_PLATFORM_KEY first}"
export REQUEST_KEY="${REQUEST_KEY:-$(uuidgen)}"
curl --fail-with-body 'https://platform-backend.topview.ai/api/v1/models/google/nano-banana/text-to-image/predictions' \
-H "Authorization: Bearer $TOPVIEW_API_PLATFORM_KEY" \
-H "Idempotency-Key: $REQUEST_KEY" \
-H 'Content-Type: application/json' \
--data '{
"prompt": "A blue ceramic cup on a wooden table",
"aspect_ratio": "1:1"
}'
# Poll data.id until completed or failed.
curl --fail-with-body 'https://platform-backend.topview.ai/api/v1/predictions/REQUEST_ID' \
-H "Authorization: Bearer $TOPVIEW_API_PLATFORM_KEY"サンプルはPlatformドキュメントのNano Banana text-to-imageリクエストに対応します。TOPVIEW_API_PLATFORM_KEYはサーバー側のみで保管してください。
ステップ 1
Topview API Platformにサインインし、必要なモデル権限付きのAPIキーを作成します。キーは安全に保管し、APIリクエストの認証に使用してください。
ステップ 2
テキストプロンプトを送信するか、編集用の参照画像をアップロードします。対応する画像設定を構成し、APIリクエストを送り、返却されたタスクIDを保存してください。
ステップ 3
生成が完了するまでタスク状態を確認します。画像URLを取得し、最終利用料金を確認して、生成画像を保存してください。
本番ワークフロー向け
オリジナルのNano Banana APIは、標準出力サイズ1種と、参照編集に特化したコントロールで、一般的な画像生成タスクを支えます。
プロンプトから商品関連シーンを作成するか、商品写真1枚を別のビジュアル表現に変更します。
4:3・3:4を含む対応5種類のアスペクト比で、正方形・横長・縦長のコンセプトを生成します。
編集入力1枚で、写真のスタイル変更、周囲の書き換え、新しい構図の探索をユーザーに提供できます。
クリエイターツール、社内フロー、小規模なマーケティングアプリに、基本的なtext-to-imageと1枚編集を追加します。
なぜ TOPVIEW API
新しいNano Bananaバリアントではなく、オリジナルモデルを求めるチーム向けに、Topviewはドキュメント化されたモードとフォーマットオプションを提供します。
未対応の2K・4K解像度セレクターを追加せずに、現在の画像単価を確認できます。
プロダクトの出力設定を設計する前に、1:1・16:9・9:16・4:3・3:4をテストできます。
専用の編集ルートとドキュメント化された入力要件で、ソース写真1枚のプロンプト編集を確認できます。
出力や編集の要件が変わるにつれ、同一のTopviewワークスペースでオリジナルモデルをLite・2・2.1と比較できます。
関連APIを見る
次の画像はここから
Playgroundで最初のプロンプトを試し、現在の料金を比較するか、ドキュメントに沿ってNano Bananaをアプリに統合してください。
明確な料金
Topview料金を公式のNano Banana料金およびfal.aiと比較できます。価格はTopview API Platformから取得し、毎日更新されます。
Text to Image
Text to Image · Standard output
Topview
$0.0190 /画像
公式: $0.0380/画像
fal.ai: $0.0398 /画像
公式比で50%お得 · fal.ai比で52%お得
Image Editing
Image Editing · Standard output
Topview
$0.0190 /画像
公式: $0.0380/画像
fal.ai: $0.0398 /画像
公式比で50%お得 · fal.ai比で52%お得
設定ごとの画像単価を、fal.aiと並べて表示します。Topviewと公式料金はTopview API Platformから取得します。
表示中:Text to Image · 1件の設定
| 設定 | Topview | 公式 | fal.ai | 節約 |
|---|---|---|---|---|
| Text to Image標準出力 · 生成画像 | $0.0190 /画像 | $0.0380 /画像 | $0.0398 /画像 | 公式より50%低価格fal.aiより52%低価格 |
料金は表示設定での生成画像1枚あたりで、出力画像ごとに課金されます。fal.ai料金はfalが公開する画像単価です。本番利用前にPlatformで最新見積もりを確認してください。