Class: OpenAI::Models::Responses::Tool::ImageGeneration

Inherits:
Internal::Type::BaseModel show all
Defined in:
lib/openai/models/responses/tool.rb

Defined Under Namespace

Modules: Background, InputFidelity, Model, Moderation, OutputFormat, Quality, Size Classes: InputImageMask

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Internal::Type::BaseModel

==, #==, #[], coerce, #deconstruct_keys, #deep_to_h, dump, fields, hash, #hash, inherited, inspect, #inspect, known_fields, optional, recursively_to_h, required, #to_h, #to_json, #to_s, to_sorbet_type, #to_yaml

Methods included from Internal::Type::Converter

#coerce, coerce, #dump, dump, inspect, #inspect, meta_info, new_coerce_state, type_info

Methods included from Internal::Util::SorbetRuntimeSupport

#const_missing, #define_sorbet_constant!, #sorbet_constant_defined?, #to_sorbet_type, to_sorbet_type

Constructor Details

#initialize(file_id: nil, image_url: nil) ⇒ Object

Some parameter documentations has been truncated, see InputImageMask for more details.

Optional mask for inpainting. Contains ‘image_url` (string, optional) and `file_id` (string, optional).

Parameters:

  • file_id (String) (defaults to: nil) —

    File ID for the mask image.

  • image_url (String) (defaults to: nil) —

    Base64-encoded mask image.




# File 'lib/openai/models/responses/tool.rb', line 519

Instance Attribute Details

#background ⇒ Symbol, ...

Background type for the generated image. One of ‘transparent`, `opaque`, or `auto`. Default: `auto`.

Returns:



451
 
# File 'lib/openai/models/responses/tool.rb', line 451

optional :background, enum: -> { OpenAI::Responses::Tool::ImageGeneration::Background }

#input_fidelity ⇒ Symbol, ...

Control how much effort the model will exert to match the style and features, especially facial features, of input images. This parameter is only supported for ‘gpt-image-1`. Unsupported for `gpt-image-1-mini`. Supports `high` and `low`. Defaults to `low`.

Returns:



460
461
462
463
464
 
# File 'lib/openai/models/responses/tool.rb', line 460

optional :input_fidelity,
enum: -> {
  OpenAI::Responses::Tool::ImageGeneration::InputFidelity
},
nil?: true

#input_image_mask ⇒ OpenAI::Models::Responses::Tool::ImageGeneration::InputImageMask?

Optional mask for inpainting. Contains ‘image_url` (string, optional) and `file_id` (string, optional).

Returns:



471
 
# File 'lib/openai/models/responses/tool.rb', line 471

optional :input_image_mask, -> { OpenAI::Responses::Tool::ImageGeneration::InputImageMask }

#model ⇒ String, ...

The image generation model to use. Default: ‘gpt-image-1`.

Returns:



477
 
# File 'lib/openai/models/responses/tool.rb', line 477

optional :model, union: -> { OpenAI::Responses::Tool::ImageGeneration::Model }

#moderation ⇒ Symbol, ...

Moderation level for the generated image. Default: ‘auto`.

Returns:



483
 
# File 'lib/openai/models/responses/tool.rb', line 483

optional :moderation, enum: -> { OpenAI::Responses::Tool::ImageGeneration::Moderation }

#output_compression ⇒ Integer?

Compression level for the output image. Default: 100.

Returns:

  • (Integer, nil) 


489
 
# File 'lib/openai/models/responses/tool.rb', line 489

optional :output_compression, Integer

#output_format ⇒ Symbol, ...

The output format of the generated image. One of ‘png`, `webp`, or `jpeg`. Default: `png`.

Returns:



496
 
# File 'lib/openai/models/responses/tool.rb', line 496

optional :output_format, enum: -> { OpenAI::Responses::Tool::ImageGeneration::OutputFormat }

#partial_images ⇒ Integer?

Number of partial images to generate in streaming mode, from 0 (default value) to 3.

Returns:

  • (Integer, nil) 


503
 
# File 'lib/openai/models/responses/tool.rb', line 503

optional :partial_images, Integer

#quality ⇒ Symbol, ...

The quality of the generated image. One of ‘low`, `medium`, `high`, or `auto`. Default: `auto`.

Returns:



510
 
# File 'lib/openai/models/responses/tool.rb', line 510

optional :quality, enum: -> { OpenAI::Responses::Tool::ImageGeneration::Quality }

#size ⇒ Symbol, ...

The size of the generated image. One of ‘1024x1024`, `1024x1536`, `1536x1024`, or `auto`. Default: `auto`.

Returns:



517
 
# File 'lib/openai/models/responses/tool.rb', line 517

optional :size, enum: -> { OpenAI::Responses::Tool::ImageGeneration::Size }

#type ⇒ Symbol, :image_generation

The type of the image generation tool. Always ‘image_generation`.

Returns:

  • (Symbol, :image_generation) 


444
 
# File 'lib/openai/models/responses/tool.rb', line 444

required :type, const: :image_generation

Class Method Details

.values ⇒ Array<Symbol>

Returns:

  • (Array<Symbol>) 



# File 'lib/openai/models/responses/tool.rb', line 558