Nano Banana API 키: 발급·설정·테스트

01OmniaKey API 키 만들기

로그인한 뒤 API 키 화면을 열고 애플리케이션용 키를 만드세요. 할당량, 만료일, 모델 제한을 확인하세요. 생성 요청을 실행하기 전에 잔액을 충전하세요.

02키와 API URL 설정

자신의 터미널에서 명령을 실행하고 플레이스홀더를 자신의 키로 바꾸세요. 키는 서버나 시크릿 매니저에 보관하세요. 브라우저 코드나 공개 저장소에 절대 넣지 마세요.

export OMNIAKEY_API_KEY="YOUR_OMNIAKEY_API_KEY"
export OMNIAKEY_BASE_URL="https://api.omniakey.com/v1"

03인증 확인

생성 작업을 시작하지 않고 모델 목록을 요청하세요. 성공 응답은 data 배열이 포함된 JSON입니다. 이는 키 액세스를 확인할 뿐이며 모든 모델이 계정에서 활성화되어 있음을 의미하지는 않습니다.

curl --fail-with-body "$OMNIAKEY_BASE_URL/models" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

04모델의 요청 형식 사용

패밀리 페이지에서 모델을 선택하고 API ID를 복사한 뒤 해당 API 문서를 따르세요. 인증만으로는 생성 파라미터가 올바른지 확인할 수 없습니다.

이미지와 동영상 생성에는 POST /v1/media/tasks를 사용합니다. 같은 제출을 재시도할 때는 동일한 Idempotency-Key를 유지하고, 반환된 작업 ID를 저장한 뒤 GET /v1/media/tasks/{id}로 결과를 폴링하세요.

생성 요청 예시(유료)

이 요청은 계정 잔액을 사용합니다. 먼저 선택한 모델의 가격을 확인하세요. 예시는 문서화된 요청 형식을 따르며, 계정에 해당 모델 액세스 권한이 있어야 합니다.

curl --fail-with-body 'https://api.omniakey.com/v1/media/tasks' \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: nano-banana-first-request-001" \
  -d '{
  "model": "gemini-nano-banana-2.1",
  "type": "image",
  "operation": "generate",
  "input": {
    "prompt": "A paper boat on a quiet lake at sunset."
  },
  "parameters": {
    "image_size": "1K",
    "aspect_ratio": "1:1"
  }
}'

미디어 작업 폴링

YOUR_TASK_ID를 생성 요청에서 반환된 id로 바꾸세요. 작업이 최종 상태에 도달할 때까지 폴링하세요. 성공한 작업은 assets의 URL이 만료되기 전에 다운로드하세요. 새 멱등 키는 새 작업에만 사용하세요.

curl --fail-with-body "https://api.omniakey.com/v1/media/tasks/YOUR_TASK_ID" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"