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은 공개적으로 접근 가능해야 합니다. 참조 이미지 수는 출력 이미지 수와 다릅니다.
이미지당 최대 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을 참고하세요.