NAME

OpenAPI::Client::OpenAI::Path::images-variations - Documentation for the /images/variations path.

DESCRIPTION

This document describes the API endpoint at /images/variations.

PATHS

POST /images/variations

Create image variation

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

Operation ID

createImageVariation

$client->createImageVariation( ... );

Parameters

Request Body

Content Type: multipart/form-data

Models

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

• dall-e-2

Example:

{
   "n" : 1,
   "response_format" : "url",
   "size" : "1024x1024",
   "user" : "user-1234"
}


         

Responses

Status Code: 200

OK

Content Types:

• application/json

  Example (See the OpenAI spec for more detail):

  {
    "created": 1713833628,
    "data": [
      {
        "b64_json": "..."
      }
    ],
    "background": "transparent",
    "output_format": "png",
    "size": "1024x1024",
    "quality": "high",
    "usage": {
      "total_tokens": 100,
      "input_tokens": 50,
      "output_tokens": 50,
      "input_tokens_details": {
        "text_tokens": 10,
        "image_tokens": 40
      }
    }
  }

SEE ALSO

OpenAPI::Client::OpenAI::Path

COPYRIGHT AND LICENSE

Copyright (C) 2023-2025 by Nelson Ferraz

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.14.0 or, at your option, any later version of Perl 5 you may have available.