Nano Banana Pro API 시작하기

Nano Banana Pro API는 최신 Gemini 기반 모델로 이미지를 생성하기 위한 실용적이고 프로덕션 준비가 된 인터페이스입니다. 이 Nano Banana Pro API 가이드는 프롬프트 작성 방법, 요청 구조화, 응답 해석, 제품이 신뢰할 수 있는 워크플로 구축 방법 등 실제 사용법에 중점을 둡니다.

공식적인 개요, 데모 및 Nano Banana 2 제품 맥락을 원하신다면 Nano Banana 2 허브에서 시작하세요.

Nano Banana Pro API란 무엇인가요?

Nano Banana Pro API는 고품질 이미지 생성을 위한 간단한 REST 인터페이스를 제공합니다. 프롬프트와 선택적 참조를 보내면 앱에 저장하고 제공할 수 있는 이미지 출력을 받습니다. 일관된 결과, 반복 가능한 워크플로, 예측 가능한 통합 패턴이 필요한 팀을 위해 설계되었습니다.

Nano Banana Pro API를 언제 사용해야 하나요?

사내 모델 파이프라인을 구축하지 않고 빠르고 온디맨드 비주얼을 원할 때 Nano Banana Pro API를 사용하세요:

• 광고 및 랜딩 페이지를 위한 마케팅 콘텐츠
• 카탈로그 및 전자상거래 목록을 위한 제품 이미지
• 초기 컨셉 및 무드 보드를 위한 크리에이티브 초안

핵심 기능

API는 프로덕션에서 중요한 몇 가지 핵심 강점을 중심으로 구축되었습니다:

• 자연어를 시각 자료로 변환하는 텍스트-이미지 생성
• 기존 샷을 리믹스하거나 구축하기 위한 이미지-이미지 생성
• 스타일과 주제를 일관되게 유지하기 위한 참조 인식 출력
• 배치 작업 및 자동화된 워크플로를 지원하는 확장 가능한 성능

Nano Banana Pro API 빠른 시작

1. 액세스 권한 얻기

EvoLink 대시보드에서 계정을 만든 다음 프로젝트용 API 키를 생성하세요. 키를 안전한 시크릿 저장소에 보관하고 클라이언트 측 코드에 절대 노출하지 마세요.

2. 첫 번째 요청 만들기

다음은 최소한의 cURL 예제입니다. 플레이스홀더를 실제 값으로 바꾸세요.

curl -X POST "API_BASE/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "prompt": "A beautiful sunset over mountains, digital art style",
    "size": "ASPECT_RATIO",
    "quality": "RESOLUTION_TIER"
  }'

3. 응답 처리

응답에는 일반적으로 메타데이터와 이미지 URL 또는 ID 목록이 포함됩니다. 결과를 신속하게 유지하고 장기 액세스를 위해 자체 스토리지 계층에 저장하세요.

{
  "created": 1737014400,
  "data": [
    {
      "url": "IMAGE_URL"
    }
  ]
}

알아야 할 핵심 파라미터

다음은 Nano Banana Pro API를 호출할 때 가장 자주 사용하는 파라미터입니다:

• model: 계정에 활성화된 모델을 사용하세요. 초안에는 비용 효율적인 계층을, 최종 자산에는 프리미엄 계층을 선택하세요.
• prompt: 지시 텍스트입니다. 주제, 스타일, 분위기에 대해 명확히 하세요.
• size: 배치에 맞는 종횡비 또는 크기 사전 설정(정사각형, 세로 또는 가로).
• quality: 최종 출력에 필요한 해상도 계층입니다.
• image_urls: 주제나 스타일을 일관되게 유지하려는 경우 선택적 참조 이미지입니다.

비동기 작업 및 이미지 URL

많은 팀이 API를 비동기적으로 실행합니다. 작업을 제출하고 완료될 때까지 작업을 폴링한 다음 이미지를 다운로드하여 저장합니다. URL은 시간 제한이 있을 수 있으므로 단기적인 것으로 취급하고 준비되는 대로 즉시 자체 스토리지로 이동하세요.

프롬프트 플레이북

결과를 개선하는 가장 빠른 방법은 명확한 프롬프트 구조를 사용하는 것입니다. 간단한 공식이 효과적입니다:

주제 + 컨텍스트 + 스타일 + 조명 + 구도 + 품질

더 실용적인 프롬프트 팁은 다음과 같습니다:

1. 구체적으로 - 주제의 이름을 지정하고 주요 세부 정보를 설명하세요.
2. 스타일 정의 - 사실적, 수채화, 영화적, 편집적.
3. 구도 제어 - 클로즈업, 와이드 샷, 탑다운 또는 중앙.

예제 프롬프트

품질 관리 및 반복

생성을 빠른 디자인 주기로 취급하세요. 광범위한 프롬프트로 시작한 다음 반복하세요:

• 첫 번째 출력을 기반으로 세부 정보를 추가하거나 제거합니다.
• 주제를 다듬기 전에 스타일을 고정하세요.
• 팀이 나중에 재사용할 수 있도록 최적의 프롬프트를 저장하세요.
• 시리즈 전체에서 일관성이 중요한 경우 참조 이미지를 사용하세요.

프로덕션 체크리스트

워크플로에서 Nano Banana Pro API를 배포하기 전에 이 체크리스트를 사용하세요:

• 안전한 서버 측 시크릿 저장소에 저장된 API 키
• 주요 사용 사례에 대해 문서화된 기본 프롬프트
• 영구 스토리지에 저장된 출력 이미지

요약

Nano Banana Pro API는 깔끔한 REST 인터페이스로 고품질 비주얼을 생성하는 신뢰할 수 있는 방법입니다. 명확한 프롬프트로 시작하고 빠르게 반복하며 최적의 결과를 문서화하세요. 빠르게 배포하는 팀의 경우 무거운 도구 없이도 창의적인 결과물을 계속 만들어낼 수 있습니다.