Class: OpenAI::Resources::Images

Inherits:
Object
  • Object
show all
Defined in:
lib/openai/resources/images.rb

Instance Method Summary collapse

Constructor Details

#initialize(client:) ⇒ Images

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of Images.

Parameters:



280
281
282
 
# File 'lib/openai/resources/images.rb', line 280

def initialize(client:)
  @client = client
end

Instance Method Details

#create_variation(image: , model: nil, n: nil, response_format: nil, size: nil, user: nil, request_options: {}) ⇒ OpenAI::Models::ImagesResponse

Some parameter documentations has been truncated, see Models::ImageCreateVariationParams for more details.

Creates a variation of a given image. This endpoint only supports dall-e-2.

Parameters:

  • image (Pathname, StringIO, IO, String, OpenAI::FilePart) —

    The image to use as the basis for the variation(s). Must be a valid PNG file, le

  • model (String, Symbol, OpenAI::Models::ImageModel, nil) —

    The model to use for image generation. Only dall-e-2 is supported at this time

  • n (Integer, nil) —

    The number of images to generate. Must be between 1 and 10.

  • response_format (Symbol, OpenAI::Models::ImageCreateVariationParams::ResponseFormat, nil) —

    The format in which the generated images are returned. Must be one of url or `

  • size (Symbol, OpenAI::Models::ImageCreateVariationParams::Size, nil) —

    The size of the generated images. Must be one of 256x256, 512x512, or `1024x

  • user (String) —

    A unique identifier representing your end-user, which can help OpenAI to monitor

  • request_options (OpenAI::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



30
31
32
33
34
35
36
37
38
39
40
 
# File 'lib/openai/resources/images.rb', line 30

def create_variation(params)
  parsed, options = OpenAI::ImageCreateVariationParams.dump_request(params)
  @client.request(
    method: :post,
    path: "images/variations",
    headers: {"content-type" => "multipart/form-data"},
    body: parsed,
    model: OpenAI::ImagesResponse,
    options: options
  )
end

#edit(image: , prompt: , background: nil, input_fidelity: nil, mask: nil, model: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, size: nil, user: nil, request_options: {}) ⇒ OpenAI::Models::ImagesResponse

See #edit_stream_raw for streaming counterpart.

Some parameter documentations has been truncated, see Models::ImageEditParams for more details.

Creates an edited or extended image given one or more source images and a prompt. This endpoint only supports gpt-image-1 and dall-e-2.

Parameters:

  • image (Pathname, StringIO, IO, String, OpenAI::FilePart, Array<Pathname, StringIO, IO, String, OpenAI::FilePart>) —

    The image(s) to edit. Must be a supported image file or an array of images.

  • prompt (String) —

    A text description of the desired image(s). The maximum length is 1000 character

  • background (Symbol, OpenAI::Models::ImageEditParams::Background, nil) —

    Allows to set transparency for the background of the generated image(s).

  • input_fidelity (Symbol, OpenAI::Models::ImageEditParams::InputFidelity, nil) —

    Control how much effort the model will exert to match the style and features,

  • mask (Pathname, StringIO, IO, String, OpenAI::FilePart) —

    An additional image whose fully transparent areas (e.g. where alpha is zero) ind

  • model (String, Symbol, OpenAI::Models::ImageModel, nil) —

    The model to use for image generation. Only dall-e-2 and gpt-image-1 are sup

  • n (Integer, nil) —

    The number of images to generate. Must be between 1 and 10.

  • output_compression (Integer, nil) —

    The compression level (0-100%) for the generated images. This parameter

  • output_format (Symbol, OpenAI::Models::ImageEditParams::OutputFormat, nil) —

    The format in which the generated images are returned. This parameter is

  • partial_images (Integer, nil) —

    The number of partial images to generate. This parameter is used for

  • quality (Symbol, OpenAI::Models::ImageEditParams::Quality, nil) —

    The quality of the image that will be generated. high, medium and low are

  • response_format (Symbol, OpenAI::Models::ImageEditParams::ResponseFormat, nil) —

    The format in which the generated images are returned. Must be one of url or `

  • size (Symbol, OpenAI::Models::ImageEditParams::Size, nil) —

    The size of the generated images. Must be one of 1024x1024, 1536x1024 (lands

  • user (String) —

    A unique identifier representing your end-user, which can help OpenAI to monitor

  • request_options (OpenAI::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
 
# File 'lib/openai/resources/images.rb', line 85

def edit(params)
  parsed, options = OpenAI::ImageEditParams.dump_request(params)
  if parsed[:stream]
    message = "Please use `#edit_stream_raw` for the streaming use case."
    raise ArgumentError.new(message)
  end
  @client.request(
    method: :post,
    path: "images/edits",
    headers: {"content-type" => "multipart/form-data"},
    body: parsed,
    model: OpenAI::ImagesResponse,
    options: options
  )
end

#edit_stream_raw(image: , prompt: , background: nil, input_fidelity: nil, mask: nil, model: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, size: nil, user: nil, request_options: {}) ⇒ OpenAI::Internal::Stream<OpenAI::Models::ImageEditPartialImageEvent, OpenAI::Models::ImageEditCompletedEvent>

See #edit for non-streaming counterpart.

Some parameter documentations has been truncated, see Models::ImageEditParams for more details.

Creates an edited or extended image given one or more source images and a prompt. This endpoint only supports gpt-image-1 and dall-e-2.

Parameters:

  • image (Pathname, StringIO, IO, String, OpenAI::FilePart, Array<Pathname, StringIO, IO, String, OpenAI::FilePart>) —

    The image(s) to edit. Must be a supported image file or an array of images.

  • prompt (String) —

    A text description of the desired image(s). The maximum length is 1000 character

  • background (Symbol, OpenAI::Models::ImageEditParams::Background, nil) —

    Allows to set transparency for the background of the generated image(s).

  • input_fidelity (Symbol, OpenAI::Models::ImageEditParams::InputFidelity, nil) —

    Control how much effort the model will exert to match the style and features,

  • mask (Pathname, StringIO, IO, String, OpenAI::FilePart) —

    An additional image whose fully transparent areas (e.g. where alpha is zero) ind

  • model (String, Symbol, OpenAI::Models::ImageModel, nil) —

    The model to use for image generation. Only dall-e-2 and gpt-image-1 are sup

  • n (Integer, nil) —

    The number of images to generate. Must be between 1 and 10.

  • output_compression (Integer, nil) —

    The compression level (0-100%) for the generated images. This parameter

  • output_format (Symbol, OpenAI::Models::ImageEditParams::OutputFormat, nil) —

    The format in which the generated images are returned. This parameter is

  • partial_images (Integer, nil) —

    The number of partial images to generate. This parameter is used for

  • quality (Symbol, OpenAI::Models::ImageEditParams::Quality, nil) —

    The quality of the image that will be generated. high, medium and low are

  • response_format (Symbol, OpenAI::Models::ImageEditParams::ResponseFormat, nil) —

    The format in which the generated images are returned. Must be one of url or `

  • size (Symbol, OpenAI::Models::ImageEditParams::Size, nil) —

    The size of the generated images. Must be one of 1024x1024, 1536x1024 (lands

  • user (String) —

    A unique identifier representing your end-user, which can help OpenAI to monitor

  • request_options (OpenAI::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
 
# File 'lib/openai/resources/images.rb', line 144

def edit_stream_raw(params)
  parsed, options = OpenAI::ImageEditParams.dump_request(params)
  unless parsed.fetch(:stream, true)
    message = "Please use `#edit` for the non-streaming use case."
    raise ArgumentError.new(message)
  end
  parsed.store(:stream, true)
  @client.request(
    method: :post,
    path: "images/edits",
    headers: {"content-type" => "multipart/form-data", "accept" => "text/event-stream"},
    body: parsed,
    stream: OpenAI::Internal::Stream,
    model: OpenAI::ImageEditStreamEvent,
    options: options
  )
end

#generate(prompt: , background: nil, model: nil, moderation: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, size: nil, style: nil, user: nil, request_options: {}) ⇒ OpenAI::Models::ImagesResponse

See #generate_stream_raw for streaming counterpart.

Some parameter documentations has been truncated, see Models::ImageGenerateParams for more details.

Creates an image given a prompt. Learn more.

Parameters:

Returns:

See Also:



203
204
205
206
207
208
209
210
211
212
213
214
215
216
 
# File 'lib/openai/resources/images.rb', line 203

def generate(params)
  parsed, options = OpenAI::ImageGenerateParams.dump_request(params)
  if parsed[:stream]
    message = "Please use `#generate_stream_raw` for the streaming use case."
    raise ArgumentError.new(message)
  end
  @client.request(
    method: :post,
    path: "images/generations",
    body: parsed,
    model: OpenAI::ImagesResponse,
    options: options
  )
end

#generate_stream_raw(prompt: , background: nil, model: nil, moderation: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, size: nil, style: nil, user: nil, request_options: {}) ⇒ OpenAI::Internal::Stream<OpenAI::Models::ImageGenPartialImageEvent, OpenAI::Models::ImageGenCompletedEvent>

See #generate for non-streaming counterpart.

Some parameter documentations has been truncated, see Models::ImageGenerateParams for more details.

Creates an image given a prompt. Learn more.

Parameters:

Returns:

See Also:



259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
 
# File 'lib/openai/resources/images.rb', line 259

def generate_stream_raw(params)
  parsed, options = OpenAI::ImageGenerateParams.dump_request(params)
  unless parsed.fetch(:stream, true)
    message = "Please use `#generate` for the non-streaming use case."
    raise ArgumentError.new(message)
  end
  parsed.store(:stream, true)
  @client.request(
    method: :post,
    path: "images/generations",
    headers: {"accept" => "text/event-stream"},
    body: parsed,
    stream: OpenAI::Internal::Stream,
    model: OpenAI::ImageGenStreamEvent,
    options: options
  )
end