먼저 읽으세요: 이 API의 특징과 한계
여기에 도착하여 nano banana api를 사용하여 사진을 생성하는 방법을 궁금해하신다면, 정직한 답변은 이 서비스가 해당 작업을 수행할 수 없다는 것입니다. "Nano Banana"는 일반적으로 이미지 생성 모델에 붙여지는 이름이며, 이미지 생성은 여기서 제공되지 않습니다. nanobananaapis.com이 파는 것은 OpenAI 호환 엔드포인트를 통한 텍스트 언어 모델에 대한 접근 권한입니다.
이미지 도구는 제공되는 텍스트의 질에 따라 성능이 결정되므로, 이는 많은 이미지 워크플로우에 적합합니다. 텍스트 모델은 프롬프트를 작성하고, 변형을 주며, 스타일 시트와 비교하여 검증하고, 캡션 및 대체 텍스트를 생성하며, 파이프라인을 연결하는 스크립트를 작성할 수 있습니다. 이 페이지는 이러한 사용 사례를 안내합니다. 이미지만 필요하시다면 이미지 서비스를 사용하시고, 이 서비스와 함께 사용하실 수 있습니다.
이 모델은 독립적인 제공업체가 운영하는 단일 오픈 웨이트 모델로, 합법적인 성인 사용에 대한 콘텐츠 거부 없이 답변하도록 조정되었습니다. 주요 벤더의 공식 API가 아닙니다. 유일한 하드 제한은 미성년자를 포함한 성적인 콘텐츠가 없다는 것입니다.
1단계: 키 받기
Google 또는 이메일과 비밀번호로 로그인한 후 API 키 페이지를 여세요. $0.50 체험 크레딧을 청구하는 원클릭 버튼이 표시됩니다. 이 크레딧은 7일 동안 유효하며 카드가 필요 없고, 사람당 하나만 사용할 수 있습니다. 체험 키는 동시 요청 2개와 분당 60개의 요청을 허용하며, 테스트하기에 충분합니다.
키를 복사하여 저장소 외부에 보관하세요. 셸에서는 다음과 같이 저장할 수 있습니다:
export NANOBANANA_KEY="paste-your-key-here"
2단계: 첫 요청 보내기
세 가지 값이 중요합니다: 베이스 URL, 모델 ID 및 Authorization 헤더. 나머지는 모두 OpenAI chat-completions 형식을 따릅니다. curl을 사용한 첫 번째 호출 예시는 다음과 같습니다:
curl https://api.nanobananaapis.com/v1/chat/completions -H "Authorization: Bearer $NANOBANANA_KEY" -H "Content-Type: application/json" -d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Write one detailed image prompt for a foggy harbor at dawn."}
],
"max_tokens": 200
}'
공식 openai 패키지를 사용한 Python 코드:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.nanobananaapis.com/v1",
api_key=os.environ["NANOBANANA_KEY"],
)
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write one detailed image prompt for a foggy harbor at dawn."}],
)
print(r.choices[0].message.content)
Node에서는 다음과 같습니다:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.nanobananaapis.com/v1",
apiKey: process.env.NANOBANANA_KEY,
});
const r = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write one detailed image prompt for a foggy harbor at dawn." }],
});
console.log(r.choices[0].message.content);
응답 헤더를 한 번 확인하세요. X-Balance-USD는 남은 크레딧을 보여주며, X-Request-Id은 도움이 필요할 때 호출을 식별합니다. 문서 페이지에는 모든 지원 파라미터가 나열되어 있습니다.
단계 3: 아이디어를 구조화된 프롬프트로 변환
이미지 파이프라인에서 가장 유용한 트릭은 모델이 자유 텍스트 대신 구조화된 데이터를 반환하도록 하는 것입니다. JSON 모드가 이를 수행합니다. 시스템 메시지에 스키마를 설명하면 응답이 코드에서 직접 구문 분석되므로, 대략적인 아이디어 목록이 고정 필드가 있는 프롬프트 테이블로 변환됩니다.
import json, os
from openai import OpenAI
client = OpenAI(
base_url="https://api.nanobananaapis.com/v1",
api_key=os.environ["NANOBANANA_KEY"],
)
SYSTEM = (
"You write prompts for an image model. Reply with JSON only: "
'{"prompts": [{"subject": str, "style": str, "lighting": str, "negative": str, "full": str}]}'
)
def expand(idea: str, n: int = 3):
r = client.chat.completions.create(
model="uncensored",
response_format={"type": "json_object"},
temperature=0.9,
messages=[
{"role": "system", "content": SYSTEM},
{"role": "user", "content": f"Give {n} distinct prompts for: {idea}"},
],
)
return json.loads(r.choices[0].message.content)["prompts"]
for p in expand("a lighthouse keeper's kitchen in winter"):
print(p["full"])
다양성을 원할 때 온도를 높이고, 일관성을 원할 때 낮추세요. seed 파라미터는 전달되므로, 이전 배치와 동일한 결과를 얻어야 할 때 고정할 수 있습니다. 모든 언어 모델은 오류를 범할 수 있으므로, json.loads을 try 블록으로 감싸고 구문 분석이 실패할 경우 한 번 더 요청하세요.
사이트에는 이미지 관련 설명서도 있습니다: 프롬프트 생성 및 후처리. 텍스트 단계가 생성기와 어떻게 연결되는지 다룹니다.
이미지 워크플로우에서 텍스트 모델이 잘 수행하는 다른 작업
- 스타일 시트. 고정된 스타일 규칙이 포함된 시스템 메시지를 하나 유지하고, 각 새로운 주제를 통해 피드하여 전체 시리즈가 시각적으로 일관되도록 유지하세요.
- 캡션 및 대체 텍스트. 이미지가 생성된 후, 각 이미지에 대해 짧은 설명을 작성하세요. 이미지의 설명을 입력으로 제공하세요. API는 텍스트만 받기 때문에 모델은 이미지를 볼 수 없습니다.
- 샷 리스트 및 스크립트. 스토리보드나 단편 비디오의 경우, 장면 목록, 내레이션 및 화면상의 비트를 텍스트로 작성하세요.
- 프롬프트 비판. 나쁜 결과를 주는 프롬프트를 붙여넣고, 변경 사항을 설명하며 세 가지 재작성을 요청하세요.
- 성인용 픽션 및 캐릭터 작업. 이야기 및 보조 앱을 위한 캐릭터 시트, 배경 스토리 및 대화는 합법적인 성인 테마를 거부하지 않는 모델로 작성하세요.
긴 작업의 경우, stream: true를 사용하여 출력을 스트리밍하면 사용자 인터페이스가 텍스트가 도착하는 대로 표시할 수 있습니다. 함수 호출도 지원되므로, 모델이 자신의 함수를 호출할 시기를 결정할 수 있습니다. 예를 들어, 사용하는 이미지 서비스에 프롬프트를 제출하는 함수를 호출할 수 있습니다.
한계 및 실행 비용
배치를 빌드하기 전에 숫자를 확인하세요. 전체 키는 동시 요청 8개와 분당 300개의 요청을 허용합니다. 컨텍스트 창은 프롬프트와 완료를 포함하여 토큰 100,000개까지 지원하며, 최대 요청 본문 크기는 8 MB입니다. max_tokens은 선택 사항입니다. 속도 제한을 초과하면 HTTP 429 오류가 발생하며, 코드 rate_limited 또는 concurrency이 반환됩니다. 기다렸다가 다시 시도하세요.
가격은 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50입니다. 500개의 프롬프트 세트를 생성한다고 가정해 보겠습니다. 각 세트에는 400개의 입력 토큰과 600개의 출력 토큰이 있습니다:
- 입력: 500 x 400 = 200,000 토큰 x $0.15 / 1M = $0.03
- 출력: 500 x 600 = 300,000 토큰 x $0.50 / 1M = $0.15
- 총계: $0.18
따라서 $0.50의 무료 체험 크레딧은 해당 크기의 약 1,300개 세트를 커버할 수 있습니다. 일반 사용의 경우, 암호화폐(TRC20의 USDT, Base의 USDC)를 사용하여 $20에서 $500 사이의 전체 금액으로 선불 크레딧을 충전할 수 있습니다. 보너스는 $50부터 5%, $100부터 10%, $200부터 15%입니다. 표는 가격 페이지를 참조하세요. 크레딧은 만료되지 않습니다.
이미지 서비스와 연동하기
일반적인 설정은 두 단계로 구성됩니다. 텍스트 단계는 이 API를 사용하여 프롬프트를 생성합니다. 이미지 단계는 해당 프롬프트를 사용하는 이미지 생성기로 보내며, 해당 생성기는 자체 계정, 자체 가격 책정 및 자체 규칙을 가지며, 규칙은 해당 사이트에서 읽어야 합니다. 두 단계를 별도의 함수로 유지하여 한쪽을 변경할 때 다른 쪽을 다시 작성하지 않도록 하세요.
실용적인 팁: 생성에 사용한 프롬프트와 함께 seed 및 온도를 저장하세요. 이미지가 잘 나온 경우, 이를 생성한 정확한 텍스트를 추적할 수 있으며, 배치 결과가 기대에 미치지 못할 경우, 아이디어, 프롬프트 작성자 또는 이미지 모델 중 어디에 문제가 있었는지 확인할 수 있습니다. 또한 동일한 아이디어 목록에서 두 프롬프트 세트를 모두 실행하고 두 프롬프트 세트를 나란히 평가하여 두 프롬프트 세트를 비교하는 저렴한 방법을 제공합니다.
간단한 엔드투엔드 스크립트
조각들을 연결하기 위해, 대략적인 아이디어 파일에서 읽은 후 JSON 모드를 사용하여 각 아이디어를 프롬프트로 확장하고, 이미지 도구가 읽을 수 있는 파일로 결과를 작성하는 짧은 스크립트가 있습니다. 이 스크립트는 그렇지 않으면 문제를 일으킬 수 있는 하나의 실패 모드, 즉 유효하지 않은 JSON인 응답을 처리합니다.
import json, os
from openai import OpenAI
client = OpenAI(
base_url="https://api.nanobananaapis.com/v1",
api_key=os.environ["NANOBANANA_KEY"],
)
def one(idea: str):
for _ in range(2):
r = client.chat.completions.create(
model="uncensored",
response_format={"type": "json_object"},
messages=[
{"role": "system", "content": 'Reply with JSON only: {"prompt": str}'},
{"role": "user", "content": f"Write a vivid, specific image prompt for: {idea}"},
],
max_tokens=250,
)
try:
return json.loads(r.choices[0].message.content)["prompt"]
except (json.JSONDecodeError, KeyError):
continue
return None
ideas = [line.strip() for line in open("ideas.txt") if line.strip()]
out = {i: one(i) for i in ideas}
json.dump(out, open("prompts.json", "w"), indent=2)
먼저 다섯 가지 아이디어로 실행하고 결과를 눈으로 확인하세요. 원하는 스타일과 프롬프트가 일치할 때까지 시스템 메시지를 조정한 후 확장하세요. 각 요청이 작기 때문에 천 개의 아이디어는 빠르게 완료되며 비용은 몇 센트입니다.
초보자가 자주 하는 실수
- 이미지를 기대함. 응답은 항상 텍스트입니다. 코드가 응답에서 이진 이미지를 저장하려고 하면 실패합니다. 이미지가 없기 때문입니다.
- 다른 모델 이름을 찾음. 모델은 하나만 있으며, 그 ID는
uncensored입니다. 튜토리얼에서 벤더 모델 이름을 복사하면 not-found 오류가 발생합니다. - 시스템 메시지를 잊음. 시스템 메시지가 없으면 모델은 스타일 지침이 없으며 짧은 프롬프트와 긴 프롬프트 사이를 오갑니다. 규칙을 여기에 입력하세요.
- 프롬프트에 비밀 정보를 보냄. 프롬프트는 학습에 사용되지 않지만, 비밀번호나 개인 키를 어떤 모델 입력에도 붙여넣지 않는 것이 좋습니다.
- 동시에 100개의 요청을 실행합니다. 전체 키는 동시에 8개까지 허용합니다. 풀 또는 세마포어를 사용하고, 429 응답에 대해 재시도를 추가하세요.
무언가 이상하게 동작하면 지원 페이지에서 문의하세요. 응답 헤더의 요청 ID는 질문을 훨씬 쉽게 답변할 수 있게 해줍니다.
