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의 이미지 생성 API입니다. 최대 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은 공개적으로 접근 가능해야 합니다. 참조 이미지 수는 출력 이미지 수와 다릅니다.이미지당 최대 10MB. 지원 형식: .jpeg, .jpg, .png, .webp.
["https://example.com/photo.jpg"]
응답 필드
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을 참고하세요.