Revision history for OpenAPI-Client-OpenAI

0.24    2025-08-22

        - Model Updates: Added support for new `gpt-5` series models, including
        `gpt-5`, `gpt-5-mini`, and `gpt-5-nano`, across various API endpoints like
        Assistants and Chat Completions.
        - Conversations API Introduction: A new top-level `/conversations` endpoint has
        been added to create, retrieve, update, and delete conversations and their
        items. This provides a new way to manage and persist conversation state. The
        previous `/embeddings` endpoint has been removed to accommodate this new
        feature.
        - Images API Streaming: The Images API now supports streaming for both image
        generation (`/images/generations`) and editing (`/images/edits`). New
        parameters such as `input_fidelity` and `partial_images` have also been
        introduced for more control over image results.
        - Documentation and Code Examples: Replaced all Kotlin code examples with Java
        examples across the entire API specification. Endpoint summaries have been
        standardized for conciseness, with longer explanations moved into the
        `description` field. Additionally, internal documentation links have been
        updated to absolute URLs.
        - File API Enhancements: The organizational file storage limit has been
        increased to 1 TB. A new `expires_after` parameter allows setting an expiration
        policy upon file creation.
        - Responses API Updates: A new `conversation` parameter has been added to
        manage conversation state more effectively. The `user` parameter is now
        deprecated in favor of `safety_identifier` and `prompt_cache_key` for better
        user identification and caching. A `verbosity` parameter has also been added to
        control response conciseness.
        - Other API Updates: The Batch API now includes an `output_expires_after`
        parameter to manage the lifecycle of output files. Many schema definitions have
        been updated from `oneOf` to the more flexible `anyOf`.

0.23    2025-07-03
        - Version number bump to replace bad PAUSE upload. No functional change.

0.22    2025-07-03
        - Added new `git-release` script to automate the release process.
        - Audio API Updates: The audio text-to-speech model is updated to
          gpt-4o-mini-tts, and the audio transcription model is updated to
          gpt-4o-transcribe, with the addition of a streaming option for the
          transcription api.
        - Chat Completions Enhancements: Introduces new features for the Chat
          Completions API, including the ability to list, retrieve, update, and delete
          chat completions.  Support for metadata filtering is added, and the
          documentation clarifies parameter support across different models. 
        - Realtime API Expansion: Adds a new endpoint for creating realtime
          transcription sessions and incorporates C# examples for both audio generation
          and transcription.
        - Responses API Improvements:  Significant updates to the Responses
          API, with a focus on enhanced tool usage, including web search and file search,
          and the ability to stream responses. The API now also supports including image
          URLs in the input and provides detailed usage information.
        - Fine-tuning API Updates: Introduces new endpoints for managing
          fine-tuning checkpoints and their permissions, enabling organization owners to
          share and control access to fine-tuned models. Metadata is now supported for
          fine-tuning jobs. 
        - Other Updates:  Minor documentation improvements and clarifications
          across various API endpoints and parameters, including updates to model
          descriptions and available tools. 

0.21    2025-04-11
        - Added examples to the docs, along with allowed models for each path.

0.20    2025-04-06
        - Complete revamped documentation. Much easier to read than the
          near-useless Schema.pod that we used to have.

0.16    2025-04-06
        - Audio API Updates: The audio text-to-speech model is updated to
          gpt-4o-mini-tts, and the audio transcription model is updated to
          gpt-4o-transcribe, with the addition of a streaming option for the
          transcription api.
        - Chat Completions Enhancements: Introduces new features for the Chat
          Completions API, including the ability to list, retrieve, update, and delete
          chat completions. Support for metadata filtering is added, and the
          documentation clarifies parameter support across different models.
        - Realtime API Expansion: Adds a new endpoint for creating realtime
          transcription sessions and incorporates C# examples for both audio generation
          and transcription.
        - Responses API Improvements:  Significant updates to the Responses
          API, with a focus on enhanced tool usage, including web search and file search,
          and the ability to stream responses. The API now also supports including image
          URLs in the input and provides detailed usage information.
        - Fine-tuning API Updates: Introduces new endpoints for managing
          fine-tuning checkpoints and their permissions, enabling organization owners to
          share and control access to fine-tuned models. Metadata is now supported for
          fine-tuning jobs.
        - Other Updates:  Minor documentation improvements and clarifications
          across various API endpoints and parameters, including updates to model
          descriptions and available tools.

0.15    2025-02-28
        - Update to latest version of OpenAI API spec.
          Even though the 4.5-preview has been released
          (https://platform.openai.com/docs/models#gpt-4-5), it's not listed
          in their openapi.yaml document. The changes are largely around the
          documentation in the API spec.

0.14    2025-02-05
        - Update to latest version of OpenAI API spec. Amongst many changes,
          this includes the new o3-mini model.

0.13    2025-01-02
        - Happy New Year!
        - Update assistance header to v2 https://platform.openai.com/docs/assistants/migration
        - Update to latest version of OpenAI API spec
        - Cleaned up main class imports

0.12    2024-11-18
        - Added examples/get-embeddings.pl to the MANIFEST

0.11    2024-11-18
        - Update to the latest OpenAPI spec
        - Add example of fetching embeddings from the API

0.10    2024-10-05
        - Update MANIFEST to include missing example files

0.09    2024-10-05
        - Update OpenAI spec
        - Include examples/describe_image.pl

0.08    2024-09-19 12:24 (CEST)
        - Bump OpenAI spec to version 2.3.0

0.07    2024-07-07 00:00 (CEST)
        - Added a missing dependencies in Makefile.PL
        - Add documentation to explain the deprecated methods.

0.06    2024-05-29 08:22 (CEST)
        - Build bugfix: File::ShareDir::Install needed to be in
          CONFIGURE_REQUIRES in the Makefile.PL. Thanks to Slaven Rezić
          for the bug report
        - POD now assumes UTF-8

0.05    2024-05-29 07:16 (CEST)
        - Added `devel/rebuild` script to make it easier to rebuild the
          project.
        - Common test behavior abstracted into t/lib/OpenAITests.pm
        - Bugfix: rebuilding docs should only list Perl files for examples.

0.04    2024-05-27 16:06 (CEST)
        - Indent HEREDOCS so metacpan doesn't think they're POD
        - Fix bad link in the POD
        - Update POD to show where to find examples

0.03    2024-05-27
        - Update manifest to ensure files are properly uploaded

0.02    2024-05-15
        - Updated to version 2.0.0 of openapi.yaml

0.01    2023-04-11
        First version, released on an unsuspecting world.