=encoding utf8

=head1 NAME

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

=head1 DESCRIPTION

This document describes the API endpoint at C</images/variations>.

=head1 PATHS


=head2 C<POST /images/variations>

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



=head3 Operation ID

C<createImageVariation>

    $client->createImageVariation( ... );

=head3 Parameters

=over 4

=back

=head3 Request Body
  
=head3 Content Type: C<multipart/form-data>

    
      

      

=head4 Models

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

=over 4
      
=item * C<dall-e-2>

=back
      
      
Example:

    {
       "model" : "dall-e-2",
       "n" : 1,
       "response_format" : "url",
       "size" : "1024x1024",
       "user" : "user-1234"
    }


             

=head3 Responses


=head4 Status Code: C<200>

OK


=head4 Content Types:

=over 4


=item * C<application/json>

Example (See the L<OpenAI spec for more detail|https://github.com/openai/openai-openapi/blob/master/openapi.yaml>):

    {
      "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
        }
      }
    }


=back

=head1 SEE ALSO

L<OpenAPI::Client::OpenAI::Path>

=head1 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.

=cut