하나의 API key
모델과 제공사를 넘나들며 같은 인증 정보를 사용합니다.
curl -X POST https://runapi.ai/api/v1/nano_banana/text_to_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-edit",
"prompt": "볼드 세리프 폰트로 'Never Give Up' 텍스트와 배경에 석양빛 산이 있는 동기부여 포스터를 만들어 주세요."
}'import { NanoBananaClient } from "@runapi.ai/nano-banana";
const client = new NanoBananaClient();
const result = await client.textToImage.run({
model: "nano-banana-edit",
prompt: "볼드 세리프 폰트로 'Never Give Up' 텍스트와 배경에 석양빛 산이 있는 동기부여 포스터를 만들어 주세요.",
});<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\NanoBanana\NanoBananaClient;
$client = new NanoBananaClient();
$result = $client->textToImage->run([
'model' => 'nano-banana-edit',
'prompt' => '볼드 세리프 폰트로 \'Never Give Up\' 텍스트와 배경에 석양빛 산이 있는 동기부여 포스터를 만들어 주세요.',
]);require "runapi/nano_banana"
client = RunApi::NanoBanana::Client.new
result = client.text_to_image.run(
model: "nano-banana-edit",
prompt: "볼드 세리프 폰트로 'Never Give Up' 텍스트와 배경에 석양빛 산이 있는 동기부여 포스터를 만들어 주세요."
)npx skills add runapi-ai/nano-banana -g# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor개요
Nano Banana 소개
Nano Banana는 이미지 내 정확한 텍스트 렌더링과 일관된 다중 캐릭터 장면에 최적화된 Google의 빠른 이미지 생성 모델입니다. 프롬프트 충실도를 유지하면서 빠른 결과물을 제공합니다.
제공사
Google
모달리티
이미지
변형
요금
Nano Banana 요금
| endpoint | 해상도 | 길이 | 가격 | |
|---|---|---|---|---|
| text_to_image | — | — | $0.03 / 이미지 |
nano-banana 기준 요금입니다. 다른 변형은 각자의 endpoint 요금이 적용됩니다.
에이전트 통합
에이전트에서 Nano Banana 실행
작동 방식
Nano Banana 시작하기
-
모델 선택
출력 유형, 품질 기준, 지연 시간 목표에 맞는 모델과 변형을 고릅니다.
-
한 번 인증
모든 지원 모델에 RunAPI key를 사용합니다.
-
skill 설치
기능을 구현하기 전에 코딩 워크스페이스에 model skill을 추가합니다.
-
결과 받기
task ID로 조회하거나 생성 완료 시 callback을 처리합니다.
RunAPI로 Nano Banana을 쓰는 이유
Skill-ready
model skill에 schema, 설정 메모, 가격 컨텍스트, 모델 ID가 포함됩니다.
예측 가능한 과금
호출 전에 사용량 기반 가격을 확인할 수 있습니다.
Nano Banana FAQ
이미지 내 텍스트 렌더링 정확도는 어떻습니까?
Nano Banana는 텍스트 정확도에 최적화되어 있어 생성된 이미지 내 헤드라인, 레이블, 캡션과 같은 짧거나 중간 길이의 텍스트를 안정적으로 렌더링합니다.
다중 캐릭터 일관성이란 무엇인가요?
Nano Banana는 동일한 이미지 내 여러 피사체의 캐릭터 외형을 일관되게 유지합니다 — 얼굴, 의상, 비율이 일관성을 유지합니다.
생성 속도는 얼마나 빠른가요?
기본 변형은 빠르게 생성됩니다. pro 변형은 10~20초가 걸리지만 최대 4K 해상도로 출력됩니다.
Nano Banana와 Nano Banana Pro의 차이는 무엇인가요?
Pro는 Gemini 3 Pro를 기반으로 하며 최대 4K 해상도와 최상의 텍스트 렌더링을 제공합니다. 표준 변형은 더 빠른 1K 생성에 최적화되어 있습니다.
Nano Banana로 기존 이미지를 편집할 수 있나요?
네 — edit 변형은 기존 이미지를 받아 원본 구도를 유지하면서 프롬프트 기반 수정을 적용합니다.
이 모델은 어떻게 호출하나요?
model skill을 설치하고 RunAPI key와 함께 설정 메모를 따르세요.
유사 모델