API 가이드
나노 바나나 API 사용법: 공식 문서·키 발급·현재 코드, 시작 모델은 2.1
나노바나나 API는 Gemini API의 이미지 모델입니다. AI 스튜디오 키로 gemini-nano-banana-2.1부터 호출하고, 지원 중단된 나노 바나나 2와 preview ID는 바꿉니다.
17 분
AI 모델·API 기술 가이드 · 11 / 23 페이지
AI 모델, API 통합, 개발 워크플로를 원문 출처와 재현 절차, 적용 경계로 정리해 빠르게 바뀌는 가격·할당량·기능·제한을 검증 가능한 판단으로 연결합니다.
AI 이미지 생성
Nano Banana 2 Lite·2·2.1·Pro 차이: 작업별 선택법, 새 프로젝트는 2.1
새 프로젝트는 Nano Banana 2.1, 대량 초안은 Lite, 정확한 문구와 브랜드 자산은 Pro가 기본입니다. 지원 중단된 Nano Banana 2는 512px 출력과 기존 흐름에만 씁니다.
12 분
문제 해결
OpenClaw API 키 오류 해결: 인증·429·Gateway 문제 구분하기
OpenClaw의 오류를 고치려면 먼저 실패한 연결을 찾으세요. 모델 제공업체의 인증은 실제 agent와 실행 환경에서, Gateway 접속 오류는 클라이언트의 토큰·기기 권한에서 확인합니다. 429나 입력 초과라면 키 교체보다 대기 조건과 요청 크기를 먼저 조정하고, 완료한 작업을 보존한 뒤 재개하세요.
11 분
개발 도구·에이전트
OpenClaw에 laozhang.ai 연결하기: API 설정과 도구 호출 확인
OpenClaw에서는 laozhang.ai를 커스텀 공급업체로 등록하고, 토큰에 허용된 모델을 기본 모델과 허용 목록에 지정합니다. Chat Completions 설정 예제로 시작해 현재 대화의 모델, 응답, 실제 도구 실행을 차례로 확인하세요. 신규 이용자는 먼저 기업 화이트리스트 승인이 필요합니다.
10 분
모델 비교
Qwen3-30B-A3B 로컬 실행: 원본·2507·Coder 선택과 메모리
같은 모델에서 사고 모드를 전환하려면 Qwen3-30B-A3B 원본이 유효합니다. Instruct-2507과 Thinking-2507은 모드가 고정되어 있고, Coder는 코딩용 별도 모델입니다. 로컬 실행에서는 이름뿐 아니라 양자화와 실제 컨텍스트 설정도 확인해야 합니다.
8 분
API 가이드
Vertex AI 나노 바나나 API: 현재 모델 ID·인증·비용
Vertex AI 나노 바나나는 GA 모델 ID와 location global로 호출합니다. 새로 쓴다면 2K 약 $0.05인 2.1이 낫고, 나노 바나나 2도 2027년 5월 이후까지 GA입니다.
16 분
문제 해결
시스템 지시를 깨지 않고 API 400 role 미지원 오류를 고치는 방법
role 미지원 오류는 실제 API가 받는 필드와 메시지 위치부터 맞춰야 합니다. Claude의 처음 지시는 최상위 system에, OpenAI의 지시는 해당 API가 지원하는 위치에 둡니다. 도구 호출 ID와 대화 기록을 보존한 뒤 지시 준수와 전체 작업까지 확인하세요.
9 분
Claude Code
Claude Code API 설정: 키, settings.json, 모델, 게이트웨이 확인 순서
직접 API 키를 쓰려면 Claude Code를 실행할 터미널에 ANTHROPIC_API_KEY를 전달하고 대화형 승인 여부를 확인합니다. 설정이 적용되지 않으면 인증 방식, settings.json의 범위, 모델, 실행한 앱을 차례로 확인하세요.
10 분
Claude Code
Claude Code MCP 추천: 용도별 첫 서버 선택과 설치 확인
PR과 이슈가 필요하면 GitHub, 버전별 문서가 필요하면 Context7, 브라우저 동작 확인은 Playwright, 운영 오류 조사는 Sentry가 첫 후보입니다. 이미 쓰는 도구로 충분한지 확인한 뒤, 필요한 서버 하나를 연결하고 실제 조회 결과까지 확인하세요.
10 분
Claude Code
Claude Code context, memory, MCP, Context7: 먼저 고장 난 레이어를 고치기
Claude Code가 규칙을 잊었을 때는 새 세션에서도 빠지는지 먼저 확인합니다. Context7 오류는 메모리를 늘리는 대신 설치 방식, 인증과 실제 문서 조회 결과를 차례로 점검해야 합니다.
8 분
Claude Code
Claude Code MCP 컨텍스트 과부하: 원인 찾기와 큰 출력 줄이기
MCP 서버 수를 줄이기 전에 컨텍스트가 언제 늘어나는지 확인하세요. 도구 검색은 정의 로딩을 늦추고, 필터링과 분할 조회는 큰 반환값을 줄입니다. 정리한 뒤에도 같은 기록에 접근하고 필요한 작업을 끝낼 수 있어야 합니다.
8 분
Claude Code
Claude Code에서 OpenRouter와 DeepSeek 쓰기: 경로, 설정, 첫 오류 해결
OpenRouter 경유는 OpenRouter 키와 deepseek/deepseek-v4.1-flash를, DeepSeek 직접 연결은 DeepSeek 키와 deepseek-flash를 사용합니다. 두 경로의 설정, 모델 역할과 첫 오류 복구를 확인하세요.
9 분
Claude Code
Claude Code에서 top_p deprecated? 먼저 Opus 4.7 request contract부터 확인하세요
Claude Code에서 Opus 4.7의 top_p deprecated 오류가 나면 실제 모델과 연결 경로부터 확인하세요. 최종 요청의 샘플링 항목만 제거하고 메시지·도구·출력 제한은 보존한 뒤, 같은 경로에서 원래 작업이 완료되는지 확인해야 합니다.
7 분
Claude·Anthropic
Claude MCP로 사내 API 연동하기: 경로 선택부터 도구 실행 확인까지
기존 앱이 사용자 인증과 내부 호출을 담당한다면 MCP 없이도 Claude를 사내 API에 연결할 수 있습니다. 도구는 업무별로 좁게 만들고, 인증된 사용자의 권한으로 실행한 결과를 정확한 호출 ID에 연결해 반환합니다.
11 분
문제 해결
Nano Banana Pro 503 오류 해결: Deadline 메시지 구분과 재시도 중단 기준
Nano Banana Pro의 503은 Deadline expired라는 메시지를 동반할 수 있습니다. 같은 요청을 다시 보낼 수 있는지 확인하고, 횟수와 시간을 제한해 재시도하세요. 응답이 없었다면 중복 생성 전에 원래 작업의 결과부터 확인해야 합니다.
9 분
API 가이드
Gemini 3.5 Transcribe API 가이드: 녹음 전사와 실시간 자막 구현
녹음 파일의 화자·단어 시각은 gemini-3.5-transcribe로, 말하는 동안 바뀌는 자막은 gemini-3.5-transcribe-live로 처리합니다. 자주 충돌하는 설정을 분리하고 확정 텍스트와 미완료 결과를 구별해 저장합니다.
8 분
API 가이드
Gemini 3 Pro Image Batch API: 반값 요금과 이미지 회수까지
Gemini 3 Pro Image의 Batch 요금은 같은 작업의 Standard 요금 대비 50%입니다. 다만 이미지 출력 단가가 최종 비용 전부는 아닙니다. 총비용 계산부터 JSONL 요청 작성, 이미지 저장, 실패 요청만 다시 처리하는 흐름까지 연결합니다.
7 분
API 가이드
LLM 에이전트 API 비용 킬 스위치: 공급자 호출 전에 지출을 멈추는 법
LLM 에이전트의 비용 상한은 다음 유료 요청 앞에서 검사해야 합니다. 이미 쓴 금액과 진행 중인 요청의 예약액을 함께 계산하고, 재시도와 하위 에이전트에도 같은 예산을 적용하는 구현을 설명합니다.
12 분
개발 도구·에이전트
소규모 팀의 멀티 에이전트 코딩: Worktree 분리부터 검토·병합까지
소규모 팀은 먼저 구현 하나와 검토 흐름을 정하고, 서로 기다리지 않아도 끝낼 수 있는 작업만 병렬로 나누는 편이 좋습니다. 작업자마다 폴더와 브랜치를 분리하고, 합친 코드의 동작을 확인한 뒤 한 번에 한 변경씩 병합하세요.
13 분
AI 이미지 생성
Nano Banana 2 503 ‘Model is Overloaded’ 오류 해결: 재시도와 중단 기준
503 과부하 오류가 확인되면 지수 백오프와 지터를 적용하되, 시도 횟수와 총 대기 예산을 제한해야 합니다. 현재 Nano Banana 2 모델로 이미지를 생성하거나 편집하고, 이미지가 실제로 반환됐는지 확인하는 Python 예제를 제공합니다.
8 분
API 가이드
나노 바나나 프로 API 사용법: 공식 JSON·YAML 설정과 이미지 저장
나노 바나나 프로는 gemini-3-pro-image로 호출합니다. 공식 요청 JSON과 앱 설정을 구분하고, 응답의 모든 이미지 블록을 실제 MIME에 맞춰 저장하는 흐름을 코드로 구현합니다.
9 분
AI 이미지 생성
Nano Banana Pro에 `RESTRICTED by System Instructions`가 뜬다면 먼저 경로부터 확인하세요
Gemini 앱에서는 첫 이미지의 더보기에서 Pro로 다시 실행을 선택해야 합니다. 제한 문구가 뜨거나 이미지 대신 텍스트만 나오면 이용 조건과 실제 응답을 확인하고, 같은 Pro 경로에서 허용된 요청을 비교해 원인을 좁힙니다.
8 분
AI 이미지 생성
나노바나나 프로 seed 고정: 같은 이미지와 캐릭터 일관성을 지키는 방법
같은 그림을 다시 써야 한다면 seed보다 승인 원본을 먼저 보관하세요. 새 장면의 얼굴과 스타일을 맞출 때는 기준 이미지가 출발점입니다. Google의 일반 seed 필드와 제공업체별 조건을 구분하고, 요청 준비·결과 저장·고정 후처리를 직접 적용할 수 있습니다.
8 분
문제 해결
Nano Banana Pro에서 'Unsupported file URI type'이 뜨나? 먼저 Gemini 파일 경로부터 바로잡기
Gemini generateContent는 조건에 맞는 공개·서명 HTTPS URL을 받을 수 있습니다. Nano Banana Pro에서 파일 URI 오류가 나면 먼저 실제로 전송된 문자열과 요청 주소를 확인하고, URL·원본 바이트·업로드 URI 중 맞는 방식으로 이미지 입력을 고칩니다.
9 분