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-vip",
"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": {}
}
Gemini Nano Banana 2.1
Gemini Nano Banana 2.1 画像生成
Gemini Nano Banana 2.1 の通常版と VIP で画像を生成します. 最大 14 枚の参照画像と 1K, 2K, 4K 解像度に対応します.
POST
/
v1
/
images
/
generations
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-vip",
"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": {}
}
中国本土のユーザー向け: Base URL として
https://toapis.cn を使用してください. 以下の例の https://toapis.com を https://toapis.cn に置き換えてください.モデルの選択
| バージョン | Model ID |
|---|---|
| 通常版 | gemini-nano-banana-2.1 |
| VIP | gemini-nano-banana-2.1-vip |
model フィールドで切り替えてください. テキストからの画像生成と画像編集に対応します. リクエストは非同期で実行され, 送信後に返されるタスク ID で結果を取得できます.
image_urls は公開アクセス可能な画像 URL のみを受け付けます. base64 データは使用できません. ローカル画像は先に 画像アップロード API でアップロードして URL を取得してください.認証
string
必須
すべてのリクエストに Bearer Token が必要です. API Key 管理ページ から API Key を取得してください.
Authorization: Bearer YOUR_API_KEY
リクエストパラメータ
string
デフォルト:"gemini-nano-banana-2.1"
必須
モデル名.
gemini-nano-banana-2.1 または gemini-nano-banana-2.1-vip を使用します.string
必須
画像生成または編集のためのテキスト説明.
string
出力画像のアスペクト比. 対応する値:
1:13:2,2:34:3,3:416:9,9:165:4,4:521:91:4,4:11:8,8:1
integer
デフォルト:1
出力枚数は数値の
1 に固定されています. 文字列の "1" は使用しないでください.string[]
画像生成や編集に使用する参照画像 URL の文字列配列. 最大 14 枚. 各 URL は公開アクセス可能である必要があります. 参照画像の枚数は出力画像の枚数ではありません.画像 1 枚につき最大 10MB. 対応形式: .jpeg, .jpg, .png, .webp.
["https://example.com/photo.jpg"]
object
追加の設定パラメータ.
表示 metadata
表示 metadata
string
デフォルト:"1K"
出力画像の解像度. 対応する値:
1K, 2K, 4K. デフォルトは 1K. 大文字の K を使用してください.レスポンスフィールド
string
状態と結果の取得に使用するタスク ID.
string
常に
generation.task.string
リクエストで使用したモデル ID.
string
タスクの状態:
queued, in_progress, completed, failed.integer
タスクの進捗率. 0-100 の範囲.
integer
タスク作成時刻. 秒単位の Unix タイムスタンプ.
object
タスクのメタデータ.
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-vip",
"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 を参照してください.