Nano Banana API
이미지 내 정확한 텍스트와 다중 캐릭터 일관성을 갖춘 빠른 텍스트-이미지 변환을 위한 Nano Banana API 액세스.
curl -X POST https://runapi.ai/api/v1/nano_banana/text_to_image \
-H "Authorization: Bearer $RUNAPI_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는 이미지 내 정확한 텍스트 렌더링과 일관된 다중 캐릭터 장면에 최적화된 Google의 빠른 이미지 생성 모델입니다. 프롬프트 충실도를 유지하면서 빠른 결과물을 제공합니다.
- 품질과 지연 시간 목표에 맞춘 모델 변형
- 통합 API key
- Model skill에 docs, schema, 설정 메모 포함
- 실패한 생성은 과금되지 않습니다
변형
앱 개발을 위해 Nano Banana skill 설치
모델 docs, schema, 가격 메모, 설정 단계를 코딩 워크스페이스로 불러옵니다.
# Install the model skill for app development workflows
npx skills add runapi-ai/nano-banana -g
Install the Nano Banana skill for this app: 1. Add runapi-ai/nano-banana with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
이 model skill로 구현하는 방법
모델 선택
출력 유형, 품질 기준, 지연 시간 목표에 맞는 모델과 변형을 고릅니다.
한 번 인증
모든 지원 모델에 RunAPI key를 사용합니다.
skill 설치
기능을 구현하기 전에 코딩 워크스페이스에 model skill을 추가합니다.
결과 받기
task ID로 조회하거나 생성 완료 시 callback을 처리합니다.
Nano Banana의 위치
Nano Banana는 Gemini에 내장된 Google의 이미지 모델로, 이미지 내 텍스트 정확도를 위한 빠른 생성에 특화되어 있습니다. RunAPI를 통해 모든 Nano Banana 변형이 단일 키를 공유합니다.
RunAPI로 Nano Banana을 쓰는 이유
하나의 API key
모델과 제공사를 넘나들며 같은 인증 정보를 사용합니다.
Skill-ready
model skill에 schema, 설정 메모, 가격 컨텍스트, 모델 ID가 포함됩니다.
예측 가능한 과금
호출 전에 사용량 기반 가격을 확인할 수 있습니다.
자주 묻는 질문
이미지 내 텍스트 렌더링 정확도는 어떻습니까?
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와 함께 설정 메모를 따르세요.
실패한 생성도 비용이 드나요?
실패한 생성은 과금되지 않습니다
애플리케이션에서 호출할 수 있나요?
네. 코딩 워크스페이스에 model skill을 설치하고 모델 기능을 추가할 때 사용하세요.