ToAPIsToAPIs
Gemini Nano Banana 2.1

Gemini Nano Banana 2.1 이미지 생성

Gemini Nano Banana 2.1로 이미지를 생성하고 편집합니다. 최대 14개의 참조 이미지와 1K, 2K, 4K 해상도를 지원합니다.

POST
/v1/images/generations

중국 본토 사용자 안내: 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.1

gemini-nano-banana-2.1로 설정하세요.

promptstring본문필수

이미지 생성 또는 편집을 위한 텍스트 설명.

sizestring본문

출력 이미지의 가로세로 비율. 지원하는 값:

  • 1:1
  • 3:2, 2:3
  • 4:3, 3:4
  • 16:9, 9:16
  • 5:4, 4:5
  • 21:9
  • 1:4, 4:1
  • 1: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을 참고하세요.