Gemini Nano Banana 2.1 画像生成
Gemini Nano Banana 2.1 で画像の生成と編集を行えます. 最大 14 枚の参照画像と 1K, 2K, 4K の解像度に対応します.
中国本土のユーザー向け: Base URL として https://toapis.cn を使用してください. 以下の例の https://toapis.com を https://toapis.cn に置き換えてください.
モデルの選択
| バージョン | Model ID |
|---|---|
| 通常版 | gemini-nano-banana-2.1 |
テキストからの画像生成と画像編集に対応します. リクエストは非同期タスクとして処理されます. 送信が成功したら, 返されたタスク ID で結果を取得してください.
image_urls は公開アクセス可能な画像 URL のみを受け付けます. base64 データは使用できません. ローカル画像は先に 画像アップロード API でアップロードして URL を取得してください.
認証
Authorizationstringヘッダー必須すべてのリクエストに Bearer Token が必要です. API Key 管理ページ から API Key を取得してください.
Authorization: Bearer YOUR_API_KEYリクエストパラメータ
modelstringボディ必須デフォルト: gemini-nano-banana-2.1gemini-nano-banana-2.1 を指定してください.
promptstringボディ必須画像生成または編集のためのテキスト説明.
sizestringボディ出力画像のアスペクト比. 対応する値:
1:13:2,2:34:3,3:416:9,9:165:4,4:521:91:4,4:11:8,8:1
nintegerボディデフォルト: 1出力枚数は数値の 1 に固定されています. 文字列の "1" は使用しないでください.
image_urlsstring[]ボディ画像生成や編集に使用する参照画像 URL の文字列配列. 最大 14 枚. 各 URL は公開アクセス可能である必要があります. 参照画像の枚数は出力画像の枚数ではありません.
画像 1 枚につき最大 10MB. 対応形式: .jpeg, .jpg, .png, .webp.
["https://example.com/photo.jpg"]metadataobjectボディ追加の設定パラメータ.
metadata
resolutionstringボディデフォルト: 1K出力画像の解像度. 対応する値: 1K, 2K, 4K. デフォルトは 1K. 大文字の K を使用してください.
レスポンスフィールド
idstring状態と結果の取得に使用するタスク ID.
objectstring常に generation.task.
modelstringリクエストで使用したモデル ID.
statusstringタスクの状態: queued, in_progress, completed, failed.
progressintegerタスクの進捗率. 0-100 の範囲.
created_atintegerタスク作成時刻. 秒単位の Unix タイムスタンプ.
metadataobjectタスクのメタデータ.
リクエスト例
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-nano-banana-2.1",
"prompt": "ネオンが輝くサイバーパンク風の都市の夜景",
"size": "16:9",
"n": 1,
"metadata": {
"resolution": "2K"
}
}'curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-nano-banana-2.1",
"prompt": "この写真を水彩画のスタイルに変換してください",
"size": "1:1",
"n": 1,
"image_urls": [
"https://example.com/photo.jpg"
],
"metadata": {
"resolution": "2K"
}
}'import requests
response = requests.post(
"https://toapis.com/v1/images/generations",
headers={
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
json={
"model": "gemini-nano-banana-2.1",
"prompt": "ネオンが輝くサイバーパンク風の都市の夜景",
"size": "16:9",
"n": 1,
"metadata": {
"resolution": "2K"
}
}
)
response.raise_for_status()
task = response.json()
print(task["id"])const response = await fetch('https://toapis.com/v1/images/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"model": "gemini-nano-banana-2.1",
"prompt": "ネオンが輝くサイバーパンク風の都市の夜景",
"size": "16:9",
"n": 1,
"metadata": {
"resolution": "2K"
}
})
});
if (!response.ok) {
throw new Error(await response.text());
}
const task = await response.json();
console.log(task.id);レスポンス例
{
"id": "task_img_abc123def456",
"object": "generation.task",
"model": "gemini-nano-banana-2.1",
"status": "queued",
"progress": 0,
"created_at": 1703884800,
"metadata": {}
}結果の取得
送信レスポンスの id がタスク ID です. 画像タスク状態 API で状態と最終画像を取得してください. 非同期通知については タスク Webhook を参照してください.