Class: RunApi::NanoBanana::Resources::TextToImage

Inherits:
Object
  • Object
show all
Includes:
Core::ResourceHelpers
Defined in:
lib/runapi/nano_banana/resources/text_to_image.rb

Overview

NanoBanana image generation resource. Generate images from text prompts with various models and options.

Constant Summary collapse

ENDPOINT = 
"/api/v1/nano_banana/text_to_image"
RESPONSE_CLASS = 
Types::TextToImageResponse
COMPLETED_RESPONSE_CLASS = 
Types::CompletedTextToImageResponse

Instance Method Summary collapse

Constructor Details

#initialize(http) ⇒ TextToImage

Returns a new instance of TextToImage.



16
17
18
 
# File 'lib/runapi/nano_banana/resources/text_to_image.rb', line 16

def initialize(http)
  @http = http
end

Instance Method Details

#create(options: nil, **params) ⇒ RunApi::NanoBanana::Types::TextToImageResponse

Create an image generation task.

Parameters:

  • params (Hash) —

    generation parameters

Options Hash (**params):

  • :model (String) —

    model slug, e.g. "nano-banana", "nano-banana-pro", "nano-banana-2", "nano-banana-2-lite"

  • :prompt (String) —

    required; image description

  • :aspect_ratio (String) —

    optional; required for nano-banana-2-lite

  • :output_format (String) —

    optional; "png", "jpeg", or "jpg" (not supported by nano-banana-2-lite)

  • :output_resolution (String) —

    optional; "1k", "2k", or "4k" (nano-banana-pro / nano-banana-2)

  • :reference_image_urls (Array<String>) —

    optional; reference image URLs for visual guidance (nano-banana / nano-banana-pro up to 8, nano-banana-2 up to 14, nano-banana-2-lite up to 10; <=30MB each)

Returns:



40
41
42
43
44
 
# File 'lib/runapi/nano_banana/resources/text_to_image.rb', line 40

def create(options: nil, **params)
  params = compact_params(params)
  validate_params!(params)
  request(:post, ENDPOINT, body: params, options: options)
end

#get(id, options: nil) ⇒ RunApi::NanoBanana::Types::TextToImageResponse

Get generation status by task ID.

Parameters:

  • id (String) —

    task ID

Returns:



50
51
52
 
# File 'lib/runapi/nano_banana/resources/text_to_image.rb', line 50

def get(id, options: nil)
  request(:get, "#{ENDPOINT}/#{id}", options: options)
end

#run(options: nil, **params) ⇒ RunApi::NanoBanana::Types::CompletedTextToImageResponse

Generate an image and wait until complete.

Parameters:

  • params (Hash) —

    generation parameters (see #create for accepted keys)

Returns:



24
25
26
27
 
# File 'lib/runapi/nano_banana/resources/text_to_image.rb', line 24

def run(options: nil, **params)
  task = create(options: options, **params)
  poll_until_complete { get(task.id, options: options) }
end