Nano Banana 2.1 API

Nano Banana 2.1 텍스트 기반 이미지 생성 및 이미지 편집 모델의 전체 API 참조 문서입니다.

모델 종류

이 API는 두 가지 모델을 지원합니다.

빠른 비교

지원하는 종횡비

두 모델 모두 14가지 종횡비를 지원합니다.

• 16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9, 1:4, 4:1, 1:8, 8:1

비율은 숫자형 width와 height 값으로 각각 지정합니다. 예를 들어 width: 16과 height: 9는 16:9를 선택합니다. 이 값은 비율을 나타내며 출력 이미지의 픽셀 크기가 아닙니다.

Nano Banana 2.1(텍스트 기반 이미지 생성)

엔드포인트 {#}

POST /api/v1/image/task

인증

Authorization: Bearer YOUR_API_KEY

요청 매개변수

필수

참고: width:height 비율은 16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9, 1:4, 4:1, 1:8, 8:1 중 하나여야 합니다.

선택 사항

요청 예시

javascript복사
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'nano-banana-2.1',
    prompt: 'A serene mountain landscape at sunset',
    width: 16,
    height: 9,
    resolution: '2k',
    enable_web_search: true,
    enable_image_search: false
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Nano Banana 2.1 Edit(이미지 편집)

엔드포인트

POST /api/v1/image/task

요청 매개변수

필수

참고: width:height 비율은 위에 나열된 14가지 지원 비율 중 하나여야 합니다.

선택 사항

단일 이미지 편집 예시

javascript복사
{
  model_name: 'nano-banana-2.1-edit',
  prompt: 'Change the sky to sunset colors',
  width: 16,
  height: 9,
  resolution: '2k',
  image_url_list: ['https://example.com/image.jpg'],
  enable_web_search: false,
  enable_image_search: true
}

다중 이미지 합성 예시

javascript복사
{
  model_name: 'nano-banana-2.1-edit',
  prompt: 'Combine these images into a cohesive landscape',
  width: 16,
  height: 9,
  resolution: '2k',
  image_url_list: ['https://example.com/image1.jpg', 'https://example.com/image2.jpg', 'https://example.com/image3.jpg'],
  enable_web_search: false,
  enable_image_search: false
}

요금 안내: 참조 이미지는 첫 번째 이미지부터 장당 과금됩니다. 활성화한 각 검색 옵션에는 이미지 수와 관계없이 생성 건당 별도의 고정 요금이 추가됩니다. 요율은 현재 가격을 확인하세요.

응답 형식

초기 응답

json복사
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "submitted"
  }
}

폴링 응답

json복사
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "processing",
    "task_status_msg": null,
    "task_result": null
  }
}

성공 응답

json복사
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "credit": 0.074,
      "images": [
        {
          "url": "https://example.com/generated-image.png"
        }
      ]
    }
  }
}

상태 값

• submitted: 작업이 접수됨
• processing: 작업 실행 중
• succeed: 작업이 성공적으로 완료됨
• failed: 작업 실패

권장 사항

텍스트 기반 이미지 생성 팁

1. 이미지 설명: 프롬프트에 피사체, 조명, 구도를 포함하세요.
2. 해상도 선택: 모든 요청에 1k, 2k, 4k 중 하나를 전달하세요.
3. 종횡비 선택: 지원하는 14가지 비율 중 하나에 맞는 width와 height 값을 전달하세요.
4. 검색 옵션 선택: 각 검색 플래그를 생략하면 기본값인 false가 적용됩니다. 필요할 때 true로 설정하세요.

이미지 편집 팁

1. 참조 이미지 제공: image_url_list에 접근 가능한 이미지 URL을 1~14개 포함하세요.
2. 편집 내용 설명: 프롬프트에 변경하거나 유지할 내용을 명시하세요.
3. 출력 설정 선택: 필수 값인 resolution, width, height를 제공하세요.
4. 검색 옵션 선택: 웹 검색과 이미지 검색은 각각 활성화할 수 있습니다.