KO ▾

파이프라인용 무검열 텍스트 API

Nanobanana API 연동: SillyTavern, LangChain, Cursor

여기서 Nanobanana API 연동: SillyTavern, LangChain, Cursor은 이미 사용하는 도구에 OpenAI 호환 텍스트 엔드포인트를 연결하는 것을 의미합니다. 모든 도구는 동일한 세 가지 값이 필요합니다: 베이스 URL, 키 및 모델 ID.

업데이트

채팅 패널, 코드 편집기 및 워크플로우 그래프에 케이블로 연결된 하나의 허브를 보여주는 아이소메트릭 일러스트레이션

주요 포인트

  • 세 가지 값은 베이스 URL https://api.nanobananaapis.com/v1, 키 및 모델 ID uncensored입니다.
  • 먼저 curl로 테스트한 후 SillyTavern, LangChain, Cursor 또는 기타 OpenAI SDK를 구성하세요.
  • API는 텍스트 전용이며 이미지, 오디오 또는 임베딩을 생성하지 않습니다.
  • 에이전트 및 확장 프로그램에서 429 오류를 피하려면 전체 키로 동시 요청 8개 이내를 유지하세요.

모든 연동에 필요한 세 가지 값

nanobanana API 연동에 대한 거의 모든 가이드는 서로 다른 위치에 동일한 세 필드를 채우는 것으로 귀결됩니다. 이 서비스는 OpenAI chat-completions 프로토콜을 사용하므로 OpenAI 엔드포인트를 재정의할 수 있는 도구를 통해 연결할 수 있습니다.

필드내용
기본 URLhttps://api.nanobananaapis.com/v1
API 키Authorization: Bearer <key>로 전송되는 키
모델 IDuncensored

시작하기 전 한 가지 참고 사항. 이는 텍스트 언어 모델이므로 이미지 생성, 음성 또는 임베딩이 필요한 곳에서는 작동하지 않습니다. 지원되는 메서드는 POST /v1/chat/completions 및 GET /v1/models입니다. 검색용 임베딩 모델을 요청하는 도구가 있다면 해당 부분을 다른 제공업체로 지정하세요.

API 키 페이지에서 키를 얻을 수 있습니다. 새 계정은 카드를 등록하지 않고 한 번의 클릭으로 7일 동안 유효한 $0.50의 무료 체험 크레딧을 청구할 수 있습니다.

어떤 도구를 건드리기 전에 엔드포인트를 테스트하세요

연동이 실패하면 사람들은 도구를 탓합니다. 대부분의 경우 키나 URL이 잘못되었습니다. 30초간의 curl 테스트로 그 의심을 없앨 수 있습니다. 먼저 모델 목록을 나열하세요:

curl https://api.nanobananaapis.com/v1/models   -H "Authorization: Bearer YOUR_API_KEY"

그런 다음 짧은 채팅 요청을 보내세요:

curl https://api.nanobananaapis.com/v1/chat/completions   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}],"max_tokens":10}'

두 호출이 모두 작동하면 엔드포인트와 키가 정상이며, 이후의 오류는 도구 구성 방식에서 비롯됩니다. 첫 번째 호출에서 401이 반환되면 키가 잘못되었거나 헤더에 Bearer 단어가 누락되었습니다. 404는 일반적으로 URL에 /v1이 누락되었거나 경로가 추가되었음을 의미합니다.

SillyTavern

SillyTavern은 역할극 및 캐릭터 채팅용 프론트엔드이며 OpenAI 호환 엔드포인트를 추가할 수 있습니다. 메뉴 레이블은 릴리스마다 변경되므로 단계를 정확한 문구보다는 지도로 간주하세요.

  1. API 연결 패널을 열고 API 유형으로 Chat Completion을(를) 선택하세요.
  2. Custom (OpenAI-compatible) 소스를 선택하세요.
  3. 엔드포인트 URL로 https://api.nanobananaapis.com/v1를 붙여넣으세요.
  4. 키 필드에 키를 붙여넣으세요.
  5. 모델 이름으로 uncensored를 입력하거나 연결 버튼을 눌러 GET /v1/models이(가) 반환하는 목록에서 선택하세요.
  6. 연결을 누르고 테스트 메시지를 보내세요.

두 가지 조정 팁입니다. SillyTavern은 캐릭터 카드와 함께 긴 이력을 보내므로 프롬프트와 응답이 공유되는 100,000토큰 컨텍스트 창에 주의하세요. 그리고 그룹 채팅을 사용하여 여러 요청을 동시에 실행하는 경우, 전체 키의 경우 동시 요청 8개 제한(체험 키의 경우 2개)을 기억하세요. 역할극 및 동반자 설정은 성인용이며, 모델은 어떤 프롬프트에서도 미성년자가 포함된 성적인 콘텐츠를 생성하지 않습니다.

LangChain

Python에서 langchain-openai 패키지는 커스텀 베이스 URL을 받는 ChatOpenAI을(를) 제공합니다. pip install langchain-openai로 설치하세요.

import os
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    base_url="https://api.nanobananaapis.com/v1",
    api_key=os.environ["NANOBANANA_KEY"],
    model="uncensored",
    temperature=0.7,
)

print(llm.invoke("Give me three names for a fictional smuggler ship.").content)

체인, 프롬프트 템플릿 및 출력 파서는 채팅 인터페이스에만 관심이 있으므로 동일한 방식으로 작동합니다. 도구 호출은 표준 경로를 통해 이루어지므로 llm.bind_tools([...])은 요청에 tools을(를) 보냅니다. 에이전트를 구축하기 전에 단일 도구 호출을 테스트하고 에이전트의 병렬성을 8로 제한하세요. 20개의 분기로 확장되는 그래프는 concurrency 오류에 부딪힐 것입니다.

JavaScript 패키지 @langchain/openai은 ChatOpenAI의 configuration: { baseURL } 옵션을 통해 동일한 개념을 적용합니다.

Cursor 및 기타 편집기

Cursor를 비롯한 여러 다른 코드 편집기에는 사용자 지정 OpenAI API 키를 제공하고 베이스 URL을 재정의할 수 있는 모델 설정 영역이 있습니다. 대략 다음과 같습니다: 모델 설정을 열고 사용자 지정 OpenAI 키 옵션을 활성화한 후, 재정의 베이스 URL을 https://api.nanobananaapis.com/v1로 설정하고, 키를 붙여넣은 다음 uncensored를 사용자 지정 모델 이름으로 추가하세요.

이것이 제공하는 것에 대해 현실적인 기대를 하세요. 편집기는 일부 기능(예: 인라인 완성)을 자체 백엔드 및 특정 모델 이름으로 구축하므로 사용자 지정 엔드포인트는 채팅 또는 명령의 하위 집합에만 적용될 수 있습니다. 정확한 옵션은 버전마다 변경되므로 편집기의 현재 문서를 확인하세요. 임베딩이나 이미지 입력과 같이 이 API가 제공하지 않는 기능이 필요한 경우 이 엔드포인트를 통해 작동하지 않습니다.

Open WebUI, Continue 및 기타 유사한 채팅 프론트엔드와 같은 기타 OpenAI 호환 클라이언트에도 동일한 패턴이 적용됩니다: 사용자 지정 OpenAI 엔드포인트 필드를 찾아 세 가지 값을 입력하고 테스트하세요.

일반 SDK 및 환경 변수

자체 코드를 작성하는 경우 공식 SDK는 표준 환경 변수를 읽으므로 소스 파일에 손대지 않고 엔드포인트를 전환할 수 있습니다. Python 및 Node SDK에서 OPENAI_BASE_URL 및 OPENAI_API_KEY을(를) 설정하면 충분합니다.

export OPENAI_BASE_URL="https://api.nanobananaapis.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
python app.py   # app.py calls client.chat.completions.create(model="uncensored", ...)

Node의 명시적 클라이언트는 다음과 같습니다:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.nanobananaapis.com/v1",
  apiKey: process.env.NANOBANANA_KEY,
});

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a short product description for a paper lantern." }],
  stream: true,
});

for await (const part of stream) {
  process.stdout.write(part.choices[0]?.delta?.content ?? "");
}

스트리밍은 SSE를 통해 제공되며 사용량은 마지막에 보고됩니다. 전체 매개변수 세부 정보는 문서 페이지에 있으며, 프롬프트 생성에 대한 기사은 텍스트 단계를 이미지 파이프라인에 연결하는 방법을 보여줍니다.

일반적인 실패 사례 해결

증상잠재적 원인해결 방법
401 Unauthorized잘못된 키 또는 Bearer 누락된 헤더키를 다시 복사하고 curl로 테스트
404 Not Found베이스 URL에 /v1이 없음 또는 중복 경로정확히 https://api.nanobananaapis.com/v1를 사용하세요
모델을 찾을 수 없음도구가 벤더 모델 이름으로 기본값 설정모델을 uncensored로 설정하세요
rate_limited과 함께 429분당 300개 이상의 요청 (체험 키 기준 60개)속도를 늦추고 재시도하세요.
concurrency 관련 429동시에 8개 이상의 요청 (시험판의 경우 2개)병렬성 감소
Retry-After: 5와 함께 429일시적 과부하5초간 대기 후 재시도
요청이 너무 큼본문이 8 MB 초과첨부 파일 또는 이력 축소

스트리밍 요청은 스트리밍이 끝날 때까지 동시 요청 슬롯을 점유하므로, 스트리밍을 포기하는 편집기는 실제로 바쁘지 않음에도 동시 요청 제한에 도달한 것처럼 보일 수 있습니다. 실패한 호출에서 X-Request-Id 헤더를 로그에 기록하세요. 지원팀이 가장 먼저 요청하는 정보입니다.

비용 측면에서, 입력 토큰 2,000개와 출력 토큰 500개의 일반적인 채팅 메시지는 토큰 100만 개당 $0.15와 $0.50 기준 $0.00055가 들며, 실패한 요청에는 요금이 부과되지 않습니다. 가격 책정 페이지에서는 $20부터 $500까지의 충전과 보너스 등급에 대해 다룹니다.

키, 안전성 및 데이터 접근 권한

각 통합 프로그램은 키를 어딘가에 저장하며, 그 방식에 차이가 있습니다. 데스크톱 프론트엔드에서는 키가 로컬 설정 파일에 저장됩니다. 브라우저 기반 도구에서는 브라우저에 저장될 수 있습니다. 편집기에서는 앱 구성 파일에 저장됩니다. 화면을 공유하거나 dotfile을 커밋하거나 노트북을 다른 사람에게 건네기 전에 어떤 방식인지 확인하세요.

이것을 관리하기 쉬운 상태로 유지하는 몇 가지 규칙이 있습니다. 가능한 한 도구마다 키를 하나씩 사용해, 하나의 키만 교체해도 나머지는 손상되지 않도록 하세요. 도움을 요청할 때 공개 이슈 트래커에 키를 붙여넣지 마세요. 대신 요청 ID를 공유하세요. 키가 유출된 경우 키 페이지에서 교체하고 도구를 업데이트하세요. API를 통해 전송된 프롬프트는 학습에 사용되지 않으며, 개인정보 처리 페이지에 나머지 데이터 처리 방식이 설명되어 있습니다.

다른 사용자를 위한 프론트엔드를 호스팅한다면, 키를 브라우저로 전송하지 마세요. 사용자와 API 사이에 작은 서버를 두고, 해당 서버에 자체 제한을 추가한 후 키는 서버에 보관하세요. 그러면 사용자는 귀하의 8개 동시 요청을 공유하게 되므로, 동시에 채팅할 수 있는 사용자 수를 계획에 반영하세요.

어떤 도구가 어떤 작업에 적합한가

통합 방식이 어디나 동일하므로, 도구 선택은 무엇을 만들고 있는지에 달려 있습니다.

  • SillyTavern 또는 유사한 채팅 프론트엔드는 코드 작성 없이 정교한 인터페이스와 캐릭터 카드를 원하는 성인 대상 캐릭터 채팅, 소설, 역할극에 적합합니다.
  • LangChain은 로더, 프롬프트 템플릿, 파서 및 다단계 체인 등 코드 내 파이프라인에 적합합니다. 구조를 제공하지만 의존성이 하나 더 추가됩니다.
  • 일반 SDK 호출은 작은 스크립트와 서비스에 적합합니다. 작업이 하나의 프롬프트 입력과 하나의 답변 출력으로 구성된 경우, OpenAI 패키지가 프레임워크보다 유지보수 부담이 적습니다.
  • Cursor와 같은 편집기는 코드 관련 채팅에 적합합니다. 이를 의존하기 전에 어떤 기능이 사용자 정의 엔드포인트를 지원하는지 확인하세요.

먼저 일반 curl 테스트를 수행한 후 SDK를 사용하고, 필요할 때만 프레임워크를 추가하세요. 나중에 이동해도 세 값은 변하지 않으므로 이동이 쉽습니다. 첫 번째 요청과 전체 매개변수 목록을 보려면 문서을 읽으세요.

질문과 답변

nanobanana 통합에 사용할 기본 URL은 무엇입니까?

https://api.nanobananaapis.com/v1을(를) Bearer 토큰으로 사용하고, uncensored를 모델 ID로 사용하세요.

SillyTavern과 호환됩니까?

네. SillyTavern은 Chat Completion 하에 사용자 정의 OpenAI 호환 엔드포인트를 지원합니다. 기본 URL, 키 및 모델 ID를 입력한 후 연결하세요.

LangChain에서 임베딩이나 이미지 생성에 사용할 수 있습니까?

아니요. API는 채팅 완료와 모델 목록만 지원합니다. 임베딩이나 이미지는 다른 제공업체를 사용하세요.

에이전트가 429 오류를 받는 이유는 무엇입니까?

전체 키는 동시 요청 8개와 분당 300개를 허용합니다. 병렬 호출을 제한하고 짧은 대기 후 다시 시도하세요.

내 데이터가 모델 학습에 사용됩니까?

아니요. 프롬프트는 학습에 사용되지 않습니다.

키는 양식 하나만 작성하면 받을 수 있습니다

계정을 생성하고 키를 복사한 후 기본 URL을 변경하세요. 설정은 이것으로 끝입니다.

API 키 받기