Created by ViNano AI | ViNano AI
ViNano AI
Advanced 요금제 전용 API

ViNano AI API

강력한 AI 이미지 생성 REST API, 몇 줄의 코드로 앱에 통합

API 사용 요구사항

  • Advanced 요금제 구독 필요
  • 연간 요금제 사용자: 분당 200회 속도 제한
  • 월간 요금제 사용자: 분당 20회 속도 제한
✉️

더 고급 API 기능이 필요하신가요?

더 높은 속도 제한, 엔터프라이즈 지원 또는 맞춤형 기능이 필요한 경우 이메일로 문의하세요:

[email protected]

Skills 통합 가이드

API 통합 가이드, 코드 예제 및 ViNano AI API 모범 사례 탐색

GitHub에서 보기

기대하셔도 좋아요

대규모 이미지 처리가 필요한 개발자를 위해 설계되었습니다

⚡

번개처럼 빠른 속도

최적화된 API 인프라로 이미지를 밀리초 단위로 처리합니다

🔧

간편한 통합

풍부한 문서와 다국어 SDK를 갖춘 RESTful API

💰

유연한 가격

사용한 만큼만 지불하는 투명하고 개발자 친화적인 요금제

API 호출 지침

ViNano AI API를 사용하여 이미지를 생성하는 방법 알아보기

빠른 시작

몇 줄의 코드로 AI 이미지 생성 기능 통합

API 엔드포인트
POST https://vinano.ai/api/v2/images/generate
curl -X POST https://vinano.ai/api/v2/images/generate \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "prompt=a beautiful sunset over the ocean" \
  -F "model=gemini-2.5-flash-image-preview" \
  -F "aspectRatio=16:9" \
  -F "googleSearch=false" \
  -F "mode=txt2img"

요청 매개변수

매개변수유형필수개발자를 위한 강력한 이미지 편집 API. 자연어로 이미지를 밀리초 만에 변환하세요.
promptstringNo*이미지 생성 프롬프트 (최대 2000자)
imageFile / File[]No*업로드된 이미지 파일 (여러 개 지원)
imageUrlstring / string[]No*Existing image URL(s) (supports multiple URLs)
modelstringNoAI 모델, gemini-2.5-flash-image-preview, sora_image 지원
aspectRatiostringNo종횡비, 예: 1:1, 16:9, 9:16
modestringNo선택적 생성 모드. 예: photo_restoration(오래된 사진 복원), figure, meme 등 모든 모드 보기
hdProbooleanNoHD 모드 사용 여부 (30 크레딧 소비, 일반 모드 10 크레딧)
img_sizestringNo이미지 크기: 1k, 2k, 4k (gemini-3-pro-image-preview 모델만, 크레딧: 1k=30, 2k=50, 4k=80)
googleSearchbooleanNoGoogle 검색 향상 활성화 (gemini-3.1-pro-image-preview 모델만 지원, 기본값 false)

* prompt 또는 image 중 하나가 필요합니다

지원 모델

  • gemini-2.5-flash-image-preview- Nano Banana (기본)
  • gemini-3.1-pro-image-preview- Nano Banana 2 (확장 종횡비 4:1, 1:4, 8:1, 1:8 지원)
  • gemini-3-pro-image-preview- Nano Banana Pro
  • sora_image- GPT-Image 2
  • Seedance-5.0- Seedance 5.0 (2K/3K 전용, 텍스트→이미지 / 이미지→이미지, 웹 검색 지원)
  • Z-Image- ViNano Basic (Z-Image, 텍스트→이미지 전용)
전체 가격 보기 →

응답 형식

성공 응답 (200)

{
  "status": 200,
  "images": ["https://example.com/generated-image.jpg"],
  "imageDetails": [{
    "width": 1024,
    "height": 1024,
    "filesize": 524288
  }],
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "prompt": "a beautiful sunset",
  "model": "gemini-2.5-flash-image-preview",
  "credits": {
    "cost": 10
  }
}

⚡ 비동기 이미지 생성 API

작업을 제출하여 task_id를 받고, 생성이 완료될 때까지 상태 엔드포인트를 폴링합니다.
1단계 — 비동기 작업 제출
POST https://vinano.ai/api/v1/images/async
2단계 — 작업 상태 폴링
GET https://vinano.ai/api/v1/images/task-status?task_id={task_id}
# Step 1: Submit async task (same parameters as sync API)
curl -X POST "https://vinano.ai/api/v1/images/async" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "prompt=a beautiful sunset" \
  -F "model=gemini-2.5-flash-image-preview"

# Response (202):
# {
#   "status": 202,
#   "task_id": "550e8400-e29b-41d4-a716-446655440000",
#   "message": "Task submitted. Use GET /api/v1/images/task-status?task_id={task_id} to poll for results.",
#   "model": "gemini-2.5-flash-image-preview",
#   "credits": { "cost": 10 }
# }

# Step 2: Poll task status (repeat every 3-5s until status=200)
curl -X GET "https://vinano.ai/api/v1/images/task-status?task_id=550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Response when completed:
# {
#   "status": 200,
#   "images": ["https://example.com/generated-image.jpg"],
#   "imageDetails": [{
#     "width": 1024,
#     "height": 1024,
#     "filesize": 524288
#   }],
#   "uuid": "550e8400-e29b-41d4-a716-446655440000",
#   "prompt": "a beautiful sunset",
#   "model": "gemini-2.5-flash-image-preview",
#   "credits": {
#     "cost": 10
#   }
# }

오류 코드 설명

상태 코드개발자를 위한 강력한 이미지 편집 API. 자연어로 이미지를 밀리초 만에 변환하세요.
400필수 매개변수 누락 또는 매개변수 검증 실패
401API 토큰이 유효하지 않거나 누락되었거나 형식이 잘못됨
403계정이 비활성화되었거나 Advanced 요금제를 구독하지 않았거나 API 권한이 없음
413파일 크기가 제한을 초과함 (100MB)
429속도 제한 초과 (분당 제한 초과)
495크레딧 부족
500서버 내부 오류 또는 이미지 생성 실패

모범 사례

API 토큰을 안전하게 보관

API 토큰을 다른 사람과 공유하거나 코드 저장소에 노출하지 마세요

오류 처리 구현

모든 가능한 오류 코드를 처리하세요, 특히 429 (속도 제한) 및 495 (크레딧 부족)

속도 제한 헤더 모니터링

응답 헤더의 X-RateLimit-Remaining을 확인하여 남은 할당량 파악

재시도 메커니즘 구현

429 오류의 경우 Retry-After 헤더를 기반으로 지수 백오프 재시도 구현

프롬프트 최적화

명확하고 구체적인 프롬프트는 더 나은 생성 결과를 제공합니다

이미지 압축

업로드 전 이미지를 압축하면 전송 속도가 향상되고 대역폭이 절약됩니다

API 속도 제한

API 호출은 속도 제한으로 보호되며, 제한은 구독 요금제에 따라 다릅니다:

年
연간 Advanced 요금제
200 요청/분
月
월간 Advanced 요금제
20 요청/분

💡응답 헤더에는 X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset 정보가 포함됩니다

HomeAI ImageAI VideoAI ToolsMe