API連携

[!WARNING] 🚧 このページの内容は架空のAPI例です。実際のNanobanana Pro APIの仕様はGemini API Documentationをご確認ください。

Nanobanana Pro の機能は、REST API を通じて外部アプリケーションから利用可能です。

エンドポイント

POST https://api.nanobanana.ai/v1/generate

リクエスト例 (Node.js)

const axios = require('axios');

const generateImage = async () => {
  const response = await axios.post('https://api.nanobanana.ai/v1/generate', {
    prompt: "1girl, cyberpunk city, neon lights",
    negative_prompt: "low quality, bad anatomy",
    width: 1024,
    height: 1024,
    steps: 30,
    cfg_scale: 7.0,
    sampler: "DPM++ 2M Karras",
    seed: -1
  }, {
    headers: {
      'Authorization': `Bearer ${YOUR_API_KEY}`,
      'Content-Type': 'application/json'
    }
  });

  console.log(response.data.image_url);
};

レスポンス構造

{
  "status": "success",
  "generation_time": 2.5,
  "image_url": "https://cdn.nanobanana.ai/generations/abc-123.webp",
  "seed": 4829104,
  "parameters": {
    "width": 1024,
    "height": 1024,
    "steps": 30
    // ...
  }
}

エラーハンドリング

• 400 Bad Request: パラメータが不正（解像度が制限を超えているなど）。
• 401 Unauthorized: APIキーが無効。
• 429 Too Many Requests: レートリミット超過。
• 500 Internal Server Error: サーバー側の問題。

SDK

公式SDKも提供されています。

npm install nanobanana-sdk

import { Nanobanana } from 'nanobanana-sdk';

const client = new Nanobanana(process.env.API_KEY);
const image = await client.generate({ prompt: "cat" });