release: 1.7.2

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.7.1"
+  ".": "1.7.2"
 }

.stats.yml

@@ -1 +1 @@
-configured_endpoints: 57
+configured_endpoints: 51

CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 1.7.2 (2024-01-12)
+
+Full Changelog: [v1.7.1...v1.7.2](https://github.com/openai/openai-python/compare/v1.7.1...v1.7.2)
+
+### Documentation
+
+* **readme:** improve api reference ([#1065](https://github.com/openai/openai-python/issues/1065)) ([745b9e0](https://github.com/openai/openai-python/commit/745b9e08ae0abb8bf4cd87ed40fa450d9ad81ede))
+
+
+### Refactors
+
+* **api:** remove deprecated endpoints ([#1067](https://github.com/openai/openai-python/issues/1067)) ([199ddcd](https://github.com/openai/openai-python/commit/199ddcdca00c136e4e0c3ff16521eff22acf2a1a))
+
 ## 1.7.1 (2024-01-10)
 
 Full Changelog: [v1.7.0...v1.7.1](https://github.com/openai/openai-python/compare/v1.7.0...v1.7.1)

README.md

@@ -10,7 +10,7 @@ It is generated from our [OpenAPI specification](https://github.com/openai/opena
 
 ## Documentation
 
-The API documentation can be found [here](https://platform.openai.com/docs).
+The REST API documentation can be found [on platform.openai.com](https://platform.openai.com/docs). The full API of this library can be found in [api.md](https://www.github.com/openai/openai-python/blob/main/api.md).
 
 ## Installation
 
@@ -296,8 +296,9 @@ from openai import OpenAI
 client = OpenAI()
 
 try:
-    client.fine_tunes.create(
-        training_file="file-XGinujblHPwGLSztz8cPS8XY",
+    client.fine_tuning.jobs.create(
+        model="gpt-3.5-turbo",
+        training_file="file-abc123",
     )
 except openai.APIConnectionError as e:
     print("The server could not be reached")

api.md

@@ -50,18 +50,6 @@ Methods:
 
 - <code title="post /chat/completions">client.chat.completions.<a href="./src/openai/resources/chat/completions.py">create</a>(\*\*<a href="src/openai/types/chat/completion_create_params.py">params</a>) -> <a href="./src/openai/types/chat/chat_completion.py">ChatCompletion</a></code>
 
-# Edits
-
-Types:
-
-```python
-from openai.types import Edit
-```
-
-Methods:
-
-- <code title="post /edits">client.edits.<a href="./src/openai/resources/edits.py">create</a>(\*\*<a href="src/openai/types/edit_create_params.py">params</a>) -> <a href="./src/openai/types/edit.py">Edit</a></code>
-
 # Embeddings
 
 Types:
@@ -182,22 +170,6 @@ Methods:
 - <code title="post /fine_tuning/jobs/{fine_tuning_job_id}/cancel">client.fine_tuning.jobs.<a href="./src/openai/resources/fine_tuning/jobs.py">cancel</a>(fine_tuning_job_id) -> <a href="./src/openai/types/fine_tuning/fine_tuning_job.py">FineTuningJob</a></code>
 - <code title="get /fine_tuning/jobs/{fine_tuning_job_id}/events">client.fine_tuning.jobs.<a href="./src/openai/resources/fine_tuning/jobs.py">list_events</a>(fine_tuning_job_id, \*\*<a href="src/openai/types/fine_tuning/job_list_events_params.py">params</a>) -> <a href="./src/openai/types/fine_tuning/fine_tuning_job_event.py">SyncCursorPage[FineTuningJobEvent]</a></code>
 
-# FineTunes
-
-Types:
-
-```python
-from openai.types import FineTune, FineTuneEvent, FineTuneEventsListResponse
-```
-
-Methods:
-
-- <code title="post /fine-tunes">client.fine_tunes.<a href="./src/openai/resources/fine_tunes.py">create</a>(\*\*<a href="src/openai/types/fine_tune_create_params.py">params</a>) -> <a href="./src/openai/types/fine_tune.py">FineTune</a></code>
-- <code title="get /fine-tunes/{fine_tune_id}">client.fine_tunes.<a href="./src/openai/resources/fine_tunes.py">retrieve</a>(fine_tune_id) -> <a href="./src/openai/types/fine_tune.py">FineTune</a></code>
-- <code title="get /fine-tunes">client.fine_tunes.<a href="./src/openai/resources/fine_tunes.py">list</a>() -> <a href="./src/openai/types/fine_tune.py">SyncPage[FineTune]</a></code>
-- <code title="post /fine-tunes/{fine_tune_id}/cancel">client.fine_tunes.<a href="./src/openai/resources/fine_tunes.py">cancel</a>(fine_tune_id) -> <a href="./src/openai/types/fine_tune.py">FineTune</a></code>
-- <code title="get /fine-tunes/{fine_tune_id}/events">client.fine_tunes.<a href="./src/openai/resources/fine_tunes.py">list_events</a>(fine_tune_id, \*\*<a href="src/openai/types/fine_tune_list_events_params.py">params</a>) -> <a href="./src/openai/types/fine_tune_events_list_response.py">FineTuneEventsListResponse</a></code>
-
 # Beta
 
 ## Assistants

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "openai"
-version = "1.7.1"
+version = "1.7.2"
 description = "The official Python library for the openai API"
 readme = "README.md"
 license = "Apache-2.0"

src/openai/__init__.py

@@ -316,12 +316,10 @@ def _reset_client() -> None:  # type: ignore[reportUnusedFunction]
     beta as beta,
     chat as chat,
     audio as audio,
-    edits as edits,
     files as files,
     images as images,
     models as models,
     embeddings as embeddings,
-    fine_tunes as fine_tunes,
     completions as completions,
     fine_tuning as fine_tuning,
     moderations as moderations,

src/openai/_client.py

@@ -49,15 +49,13 @@
 class OpenAI(SyncAPIClient):
     completions: resources.Completions
     chat: resources.Chat
-    edits: resources.Edits
     embeddings: resources.Embeddings
     files: resources.Files
     images: resources.Images
     audio: resources.Audio
     moderations: resources.Moderations
     models: resources.Models
     fine_tuning: resources.FineTuning
-    fine_tunes: resources.FineTunes
     beta: resources.Beta
     with_raw_response: OpenAIWithRawResponse
 
@@ -125,15 +123,13 @@ def __init__(
 
         self.completions = resources.Completions(self)
         self.chat = resources.Chat(self)
-        self.edits = resources.Edits(self)
         self.embeddings = resources.Embeddings(self)
         self.files = resources.Files(self)
         self.images = resources.Images(self)
         self.audio = resources.Audio(self)
         self.moderations = resources.Moderations(self)
         self.models = resources.Models(self)
         self.fine_tuning = resources.FineTuning(self)
-        self.fine_tunes = resources.FineTunes(self)
         self.beta = resources.Beta(self)
         self.with_raw_response = OpenAIWithRawResponse(self)
 
@@ -249,15 +245,13 @@ def _make_status_error(
 class AsyncOpenAI(AsyncAPIClient):
     completions: resources.AsyncCompletions
     chat: resources.AsyncChat
-    edits: resources.AsyncEdits
     embeddings: resources.AsyncEmbeddings
     files: resources.AsyncFiles
     images: resources.AsyncImages
     audio: resources.AsyncAudio
     moderations: resources.AsyncModerations
     models: resources.AsyncModels
     fine_tuning: resources.AsyncFineTuning
-    fine_tunes: resources.AsyncFineTunes
     beta: resources.AsyncBeta
     with_raw_response: AsyncOpenAIWithRawResponse
 
@@ -325,15 +319,13 @@ def __init__(
 
         self.completions = resources.AsyncCompletions(self)
         self.chat = resources.AsyncChat(self)
-        self.edits = resources.AsyncEdits(self)
         self.embeddings = resources.AsyncEmbeddings(self)
         self.files = resources.AsyncFiles(self)
         self.images = resources.AsyncImages(self)
         self.audio = resources.AsyncAudio(self)
         self.moderations = resources.AsyncModerations(self)
         self.models = resources.AsyncModels(self)
         self.fine_tuning = resources.AsyncFineTuning(self)
-        self.fine_tunes = resources.AsyncFineTunes(self)
         self.beta = resources.AsyncBeta(self)
         self.with_raw_response = AsyncOpenAIWithRawResponse(self)
 
@@ -450,31 +442,27 @@ class OpenAIWithRawResponse:
     def __init__(self, client: OpenAI) -> None:
         self.completions = resources.CompletionsWithRawResponse(client.completions)
         self.chat = resources.ChatWithRawResponse(client.chat)
-        self.edits = resources.EditsWithRawResponse(client.edits)
         self.embeddings = resources.EmbeddingsWithRawResponse(client.embeddings)
         self.files = resources.FilesWithRawResponse(client.files)
         self.images = resources.ImagesWithRawResponse(client.images)
         self.audio = resources.AudioWithRawResponse(client.audio)
         self.moderations = resources.ModerationsWithRawResponse(client.moderations)
         self.models = resources.ModelsWithRawResponse(client.models)
         self.fine_tuning = resources.FineTuningWithRawResponse(client.fine_tuning)
-        self.fine_tunes = resources.FineTunesWithRawResponse(client.fine_tunes)
         self.beta = resources.BetaWithRawResponse(client.beta)
 
 
 class AsyncOpenAIWithRawResponse:
     def __init__(self, client: AsyncOpenAI) -> None:
         self.completions = resources.AsyncCompletionsWithRawResponse(client.completions)
         self.chat = resources.AsyncChatWithRawResponse(client.chat)
-        self.edits = resources.AsyncEditsWithRawResponse(client.edits)
         self.embeddings = resources.AsyncEmbeddingsWithRawResponse(client.embeddings)
         self.files = resources.AsyncFilesWithRawResponse(client.files)
         self.images = resources.AsyncImagesWithRawResponse(client.images)
         self.audio = resources.AsyncAudioWithRawResponse(client.audio)
         self.moderations = resources.AsyncModerationsWithRawResponse(client.moderations)
         self.models = resources.AsyncModelsWithRawResponse(client.models)
         self.fine_tuning = resources.AsyncFineTuningWithRawResponse(client.fine_tuning)
-        self.fine_tunes = resources.AsyncFineTunesWithRawResponse(client.fine_tunes)
         self.beta = resources.AsyncBetaWithRawResponse(client.beta)
 
 

src/openai/_module_client.py

@@ -18,12 +18,6 @@ def __load__(self) -> resources.Beta:
         return _load_client().beta
 
 
-class EditsProxy(LazyProxy[resources.Edits]):
-    @override
-    def __load__(self) -> resources.Edits:
-        return _load_client().edits
-
-
 class FilesProxy(LazyProxy[resources.Files]):
     @override
     def __load__(self) -> resources.Files:
@@ -54,12 +48,6 @@ def __load__(self) -> resources.Embeddings:
         return _load_client().embeddings
 
 
-class FineTunesProxy(LazyProxy[resources.FineTunes]):
-    @override
-    def __load__(self) -> resources.FineTunes:
-        return _load_client().fine_tunes
-
-
 class CompletionsProxy(LazyProxy[resources.Completions]):
     @override
     def __load__(self) -> resources.Completions:
@@ -80,13 +68,11 @@ def __load__(self) -> resources.FineTuning:
 
 chat: resources.Chat = ChatProxy().__as_proxied__()
 beta: resources.Beta = BetaProxy().__as_proxied__()
-edits: resources.Edits = EditsProxy().__as_proxied__()
 files: resources.Files = FilesProxy().__as_proxied__()
 audio: resources.Audio = AudioProxy().__as_proxied__()
 images: resources.Images = ImagesProxy().__as_proxied__()
 models: resources.Models = ModelsProxy().__as_proxied__()
 embeddings: resources.Embeddings = EmbeddingsProxy().__as_proxied__()
-fine_tunes: resources.FineTunes = FineTunesProxy().__as_proxied__()
 completions: resources.Completions = CompletionsProxy().__as_proxied__()
 moderations: resources.Moderations = ModerationsProxy().__as_proxied__()
 fine_tuning: resources.FineTuning = FineTuningProxy().__as_proxied__()

src/openai/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless.
 
 __title__ = "openai"
-__version__ = "1.7.1"  # x-release-please-version
+__version__ = "1.7.2"  # x-release-please-version

src/openai/resources/__init__.py

@@ -3,12 +3,10 @@
 from .beta import Beta, AsyncBeta, BetaWithRawResponse, AsyncBetaWithRawResponse
 from .chat import Chat, AsyncChat, ChatWithRawResponse, AsyncChatWithRawResponse
 from .audio import Audio, AsyncAudio, AudioWithRawResponse, AsyncAudioWithRawResponse
-from .edits import Edits, AsyncEdits, EditsWithRawResponse, AsyncEditsWithRawResponse
 from .files import Files, AsyncFiles, FilesWithRawResponse, AsyncFilesWithRawResponse
 from .images import Images, AsyncImages, ImagesWithRawResponse, AsyncImagesWithRawResponse
 from .models import Models, AsyncModels, ModelsWithRawResponse, AsyncModelsWithRawResponse
 from .embeddings import Embeddings, AsyncEmbeddings, EmbeddingsWithRawResponse, AsyncEmbeddingsWithRawResponse
-from .fine_tunes import FineTunes, AsyncFineTunes, FineTunesWithRawResponse, AsyncFineTunesWithRawResponse
 from .completions import Completions, AsyncCompletions, CompletionsWithRawResponse, AsyncCompletionsWithRawResponse
 from .fine_tuning import FineTuning, AsyncFineTuning, FineTuningWithRawResponse, AsyncFineTuningWithRawResponse
 from .moderations import Moderations, AsyncModerations, ModerationsWithRawResponse, AsyncModerationsWithRawResponse
@@ -22,10 +20,6 @@
     "AsyncChat",
     "ChatWithRawResponse",
     "AsyncChatWithRawResponse",
-    "Edits",
-    "AsyncEdits",
-    "EditsWithRawResponse",
-    "AsyncEditsWithRawResponse",
     "Embeddings",
     "AsyncEmbeddings",
     "EmbeddingsWithRawResponse",
@@ -54,10 +48,6 @@
     "AsyncFineTuning",
     "FineTuningWithRawResponse",
     "AsyncFineTuningWithRawResponse",
-    "FineTunes",
-    "AsyncFineTunes",
-    "FineTunesWithRawResponse",
-    "AsyncFineTunesWithRawResponse",
     "Beta",
     "AsyncBeta",
     "BetaWithRawResponse",

src/openai/resources/chat/completions.py

@@ -185,7 +185,7 @@ def create(
               will not call a function and instead generates a message. `auto` means the model
               can pick between generating a message or calling a function. Specifying a
               particular function via
-              `{"type: "function", "function": {"name": "my_function"}}` forces the model to
+              `{"type": "function", "function": {"name": "my_function"}}` forces the model to
               call that function.
 
               `none` is the default when no functions are present. `auto` is the default if
@@ -371,7 +371,7 @@ def create(
               will not call a function and instead generates a message. `auto` means the model
               can pick between generating a message or calling a function. Specifying a
               particular function via
-              `{"type: "function", "function": {"name": "my_function"}}` forces the model to
+              `{"type": "function", "function": {"name": "my_function"}}` forces the model to
               call that function.
 
               `none` is the default when no functions are present. `auto` is the default if
@@ -557,7 +557,7 @@ def create(
               will not call a function and instead generates a message. `auto` means the model
               can pick between generating a message or calling a function. Specifying a
               particular function via
-              `{"type: "function", "function": {"name": "my_function"}}` forces the model to
+              `{"type": "function", "function": {"name": "my_function"}}` forces the model to
               call that function.
 
               `none` is the default when no functions are present. `auto` is the default if
@@ -833,7 +833,7 @@ async def create(
               will not call a function and instead generates a message. `auto` means the model
               can pick between generating a message or calling a function. Specifying a
               particular function via
-              `{"type: "function", "function": {"name": "my_function"}}` forces the model to
+              `{"type": "function", "function": {"name": "my_function"}}` forces the model to
               call that function.
 
               `none` is the default when no functions are present. `auto` is the default if
@@ -1019,7 +1019,7 @@ async def create(
               will not call a function and instead generates a message. `auto` means the model
               can pick between generating a message or calling a function. Specifying a
               particular function via
-              `{"type: "function", "function": {"name": "my_function"}}` forces the model to
+              `{"type": "function", "function": {"name": "my_function"}}` forces the model to
               call that function.
 
               `none` is the default when no functions are present. `auto` is the default if
@@ -1205,7 +1205,7 @@ async def create(
               will not call a function and instead generates a message. `auto` means the model
               can pick between generating a message or calling a function. Specifying a
               particular function via
-              `{"type: "function", "function": {"name": "my_function"}}` forces the model to
+              `{"type": "function", "function": {"name": "my_function"}}` forces the model to
               call that function.
 
               `none` is the default when no functions are present. `auto` is the default if