Nano Banana 로고Nano Banana
API 소개빠른 시작Nano Banana ProNano Banana 2Nano Banana 2 Lite

시작하기

빠른 시작

Bearer 토큰, JSON 요청 본문, 그리고 두 개의 프로덕션 엔드포인트 create와 check를 사용해 Nano Banana API를 빠르게 시작하세요.

필요한 항목

  • A사용 가능한 크레딧이 있는 Nano Banana 계정
  • API 키 대시보드에서 생성한 API 키

API 키 받기

로그인한 후 API 키 페이지를 열고 키 이름을 입력한 다음 생성을 클릭하세요. 키는 즉시 복사해야 하며 전체 키는 한 번만 표시됩니다.

HTTP 요청 헤더 구성

기본 URL

HTTPS
https://nanobanana.io
HTTP
Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

빠른 시작

JSON 페이로드를 제출하여 비동기 생성 작업을 만드세요. 반환된 task_id 를 저장한 뒤 작업 상태를 확인하는 데 사용하세요.

POST /api/v1/create
curl -X POST https://nanobanana.io/api/v1/create \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana-2",
  "input": {
    "prompt": "미래형 바나나 모양 카메라를 담은 시네마틱 제품 사진",
    "aspect_ratio": "1:1",
    "resolution": "1k"
  }
}'
응답
{
  "data": {
    "task_id": "d0a8d9f2-5e01-4c5d-9f40-38d197a1c617",
    "model": "nano-banana-2",
    "status": "processing",
    "credits": 20
  }
}

작업 생성

모델 ID와 입력 객체를 제출하여 비동기 생성 작업을 만듭니다. 이 엔드포인트는 작업이 대기열에 등록되었음을 확인하며 최종 미디어 결과가 완료될 때까지 기다리지 않습니다.

POST/api/v1/create

인증

필드
유형
필수
설명 및 제약사항
Authorizationstring필수
요청 헤더에 Bearer 토큰으로 전달되는 API 키입니다. 예시: Authorization: Bearer sk_live_your_api_key

요청 본문

application/json
필드
유형
필수
설명 및 제약사항
modelstring필수
공개 모델 ID입니다. API 섹션에 등록된 모델을 사용하세요. 예: nano-banana-2.
inputobject필수
생성 입력값입니다. 비어 있지 않은 prompt를 포함해야 합니다. 다른 입력 필드는 모델별로 다르므로 이미지, 화면비, 길이, 해상도, 생성 수 등의 필드를 보내기 전에 해당 모델 문서를 확인하세요.
JSON
{
  "model": "nano-banana-2",
  "input": {
    "prompt": "미래형 바나나 모양 카메라를 담은 시네마틱 제품 사진",
    "aspect_ratio": "1:1",
    "resolution": "1k"
  }
}

생성 응답

application/json

성공한 응답에는 작업 ID, 모델 ID, 대기열 상태, 해당 작업에 예약된 크레딧 수가 포함됩니다.

HTTP 201
{
  "data": {
    "task_id": "d0a8d9f2-5e01-4c5d-9f40-38d197a1c617",
    "model": "nano-banana-2",
    "status": "processing",
    "credits": 20
  }
}

작업 상태 가져오기

반환된 작업 ID를 사용해 작업이 완료되거나 실패할 때까지 이 엔드포인트를 폴링하세요. 최신 작업 상태를 확인하려면 5초마다 폴링하는 것을 권장합니다.

POST/api/v1/check

요청 본문

application/json
필드
유형
필수
설명 및 제약사항
task_idstring필수
POST /api/v1/create에서 반환된 작업 ID입니다. 이 ID를 사용해 작업 상태와 최종 결과 URL을 가져옵니다.
JSON
{
  "task_id": "d0a8d9f2-5e01-4c5d-9f40-38d197a1c617"
}

상태 응답

application/json

처리가 완료되면 응답에 최종 결과 URL과 시간 메타데이터가 포함됩니다. 작업이 아직 실행 중인 동안에는 data 가 null.

HTTP 200
{
  "id": "adc0e6ec-9c12-44fc-b45f-112187766c3",
  "created_at": 1788652800,
  "model": "nano-banana-2",
  "status": "completed",
  "data": {
    "results": [
      "https://cdn.nanobanana.io/api/predictions/example.mp4"
    ],
    "processing_time": 48
  }
}