Nano Banana 2 API 技術ガイド

高度な人工知能機能を活用した Nano Banana 2 ビジュアル制作サービスの詳細技術文書

料金を確認Nano Banana 2 の購読オプションを探す

Nano Banana 2 API紹介

Nano Banana 2ビジュアル制作APIは、テキスト記述とサンプル画像から高品質なビジュアルを作成する高度なAIシステムとの統合を可能にします。Nano Banana 2プラットフォームは、包括的なジョブ調整と通知機能を備えたシンプルなRESTアーキテクチャを提供します。

Nano Banana 2コア機能

• 最先端AIシステムによるNano Banana 2テキストからビジュアルへの変換
• サンプル画像対応のNano Banana 2（最大4枚まで）
• 進捗監視機能付きNano Banana 2ノンブロッキングジョブ実行
• リアルタイム状態更新のためのNano Banana 2ウェブフック統合
• JSON形式レスポンス提供のNano Banana 2 RESTアーキテクチャ
• Nano Banana 2ベアラートークン認証システム

overview.base_url

https://api.defapi.org

overview.api_version

v1.0.0

Nano Banana 2実装ガイド

1. メインプラットフォームからNano Banana 2 API認証情報を登録
2. 認証パラメータにNano Banana 2アクセストークンを埋め込み
3. Nano Banana 2ビジュアル作成エンドポイントにPOST送信
4. 提供されたNano Banana 2ジョブIDを使用して状態確認
5. タスク完了後、Nano Banana 2で作成されたビジュアルを取得

本人確認

すべてのAPI送信には、Bearerトークン認証による本人確認が必要です。各送信時にAuthorizationパラメータにアクセス認証情報を含めてください。

認証方法

Authorizationパラメータにアクセス認証情報を埋め込んで、HTTP Bearerトークン認証を実装します：

Authorization: Bearer <your-api-key>

アクセスキーの構造例

Authorization: Bearer dk-1234567890abcdef

送信例

curl -X POST "https://api.defapi.org/api/image/gen" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key-here" \
  -d '{
    "model": "google/gempix2",
    "prompt": "A beautiful landscape"
  }'

認証成功

✅ アクセス認証情報が有効である
✅ クライアント登録がアクティブ状態を維持している
✅ 十分なサービスクレジットが残っている

よくある問題

❌ アクセス認証情報が不足している
❌ アクセスキーの設定が間違っている
❌ 登録が無効化または停止されている

Nano Banana 2 画像生成API

高度なAIシステムと柔軟なテキスト指示及びサンプル画像を使用して、Nano Banana 2で画像を生成します。

接続エンドポイント

POST /api/image/gen

送信パラメータ

Parameter	Type	Required	Description
model	string	Yes	Model identifier (e.g., "google/gempix2")
prompt	string	Yes	Text prompt describing the image
images	array	No	Reference image URLs (max 4)
callback_url	string	No	Webhook URL for completion notifications

実装例

基本的なNano Banana 2画像作成

{
  "model": "google/gempix2",
  "prompt": "A beautiful girl dancing in a garden"
}

サンプル画像を使用したNano Banana 2参照ベース生成

{
  "model": "google/gempix2",
  "prompt": "Put them in a basket",
  "images": [
    "https://cdn.openai.com/API/docs/images/body-lotion.png",
    "https://cdn.openai.com/API/docs/images/soap.png"
  ],
  "callback_url": "https://example.com/webhook/image-callback"
}

出力構造

{
  "code": 0,
  "message": "ok",
  "data": {
    "task_id": "ta12345678-1234-1234-1234-123456789abc"
  }
}

エラー処理

400 - Bad Request

{"code": 1, "message": "failed", "detail": "prompt is required"}

401 - Unauthorized

{"code": 1, "message": "Invalid API key"}

Nano Banana 2 ジョブステータスAPI

Nano Banana 2 ビジュアル作成ターミナルから提供されたタスク識別子を使用して、Nano Banana 2 ビジュアル制作ジョブの進捗と結果を調査します。

接続ターミナル

GET /api/task/query?task_id=<task_id>

調査変数

Parameter	Type	Required	Description
task_id	string	Yes	Unique task identifier returned from generation endpoint

送信例

curl -X GET "https://api.defapi.org/api/task/query?task_id=ta823dfb-eaac-44fd-aec2-3e2c7ba8e071" \
  -H "Authorization: Bearer your-api-key-here"

Nano Banana 2 ジョブステータスカテゴリ

pending - Nano Banana 2 ジョブの初期化が完了し、処理開始を待機中

submitted - Nano Banana 2 ジョブが制作シーケンスに投入されました

in_progress - Nano Banana 2 ジョブが現在アクティブに処理中

success - Nano Banana 2 ジョブが正常に完了し、ビジュアルが作成されました

failed - 技術的な問題によりNano Banana 2 ジョブが中断されました

問題の応答

404 - Task Not Found

{"code": 1, "message": "task not found"}

401 - Unauthorized

{"code": 401, "message": "Invalid API key"}

Nano Banana 2 情報構造

API通信と送信で使用されるすべてのNano Banana 2 情報設定とテンプレートの包括的なドキュメント。

ImageGenResult

Represents a generated image result.

{
  "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
}

Field	Type	Description
image	string	Image URL or base64 data URI

CallbackPayload

Payload sent to the callback_url when task status changes to final states.

{
  "result": [
    {
      "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
    }
  ],
  "status": "success",
  "task_id": "ta5c9705-b8ae-4cb9-aa6f-97c4fee88c8d",
  "consumed": "0.500000",
  "status_reason": {
    "message": null
  }
}

Field	Type	Description
result	array	Array of ImageGenResult objects (null if failed)
status	string	Final task status (success/failed)
task_id	string	Unique task identifier
consumed	string	Credits consumed by the task
status_reason	object	Status details including error message if failed

Nano Banana 2 サポート対象設定

google/gempix2Nano Banana image generation model

google/gemini-2.5-flash-imageGemini 2.5 Flash image model

問題管理

複雑な問題の管理とAPIレスポンス指標の解釈のための詳細なハンドブック。すべての問題通知は標準化された形式に従い、効率的な解決方法を可能にします。

HTTPレスポンス指標

200

OK

Request was successful

400

Bad Request

Invalid request parameters or malformed JSON

401

Unauthorized

Invalid, missing, or expired API key

404

Not Found

Task not found or endpoint doesn't exist

500

Internal Server Error

Server-side error occurred

問題解決の推奨アプローチ

出力内容を分析する前に、常にHTTPレスポンス指標を確認する
500エラー時の再試行メカニズムには段階的な遅延アルゴリズムを使用する
トラブルシューティングのために、詳細な情報と共に問題通知を記録する
400エラーを防ぐため、リクエスト送信前に入力の有効性を確認する
クライアントにAPI認証情報の更新を求めることで認証問題に対処する
過度なステータス確認ではなく、適切な間隔でジョブの進行状況を追跡する
継続的な完了監視を避けるため、可能な限りWebhook統合を使用する

問題管理の例（JavaScript）

async function generateImage(prompt, apiKey) {
  try {
    const response = await fetch('https://api.defapi.org/api/image/gen', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${apiKey}`
      },
      body: JSON.stringify({
        model: 'google/gempix2',
        prompt: prompt
      })
    });

    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(`API Error ${response.status}: ${errorData.message}`);
    }

    const data = await response.json();
    return data.data.task_id;

  } catch (error) {
    console.error('Image generation failed:', error.message);
    throw error;
  }
}