Specs

create_image_edit(bitstring(), String.t(),
  openai_organization_key: String.t(),
  openai_api_key: String.t(),
  user: String.t(),
  size: :"1024x1024" | :"512x512" | :"256x256",
  response_format: :b64_json | :url,
  n: integer(),
  mask: bitstring(),
  stream_to: pid()
) :: {:ok, ExOpenAI.Components.ImagesResponse.t()} | {:error, any()}

Creates an edited or extended image given an original image and a prompt.

Endpoint: https://api.openai.com/v1/images/edits

Method: POST

Docs: https://platform.openai.com/docs/api-reference/images

Required Arguments:

• image: The image to edit. Must be a valid PNG file, less than 4MB, and square. If mask is not provided, image must have transparency, which will be used as the mask.

• prompt: A text description of the desired image(s). The maximum length is 1000 characters.

Example: A cute baby sea otter wearing a beret

Optional Arguments:

• stream_to: PID of the process to stream content to

• mask: An additional image whose fully transparent areas (e.g. where alpha is zero) indicate where image should be edited. Must be a valid PNG file, less than 4MB, and have the same dimensions as image.

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

Example: 1

• response_format: The format in which the generated images are returned. Must be one of url or b64_json.

Example: "url"

• size: The size of the generated images. Must be one of 256x256, 512x512, or 1024x1024.

Example: "1024x1024"

• user: A unique identifier representing your end-user, which can help OpenAI to monitor and detect abuse. Learn more.

Example: "user-1234"

• openai_api_key: OpenAI API key to pass directly. If this is specified, it will override the api_key config value.

• openai_organization_key: OpenAI API key to pass directly. If this is specified, it will override the organization_key config value.