release: 1.23.4

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.23.3"
+  ".": "1.23.4"
 }

CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 1.23.4 (2024-04-24)
+
+Full Changelog: [v1.23.3...v1.23.4](https://github.com/openai/openai-python/compare/v1.23.3...v1.23.4)
+
+### Bug Fixes
+
+* **api:** change timestamps to unix integers ([#1367](https://github.com/openai/openai-python/issues/1367)) ([fbc0e15](https://github.com/openai/openai-python/commit/fbc0e15f422971bd15499d4ea5f42a1c885c7004))
+* **docs:** doc improvements ([#1364](https://github.com/openai/openai-python/issues/1364)) ([8c3a005](https://github.com/openai/openai-python/commit/8c3a005247ea045b9a95e7459eba2a90067daf71))
+
+
+### Chores
+
+* **tests:** rename test file ([#1366](https://github.com/openai/openai-python/issues/1366)) ([4204e63](https://github.com/openai/openai-python/commit/4204e63e27584c68ad27825261225603d7a87008))
+
 ## 1.23.3 (2024-04-23)
 
 Full Changelog: [v1.23.2...v1.23.3](https://github.com/openai/openai-python/compare/v1.23.2...v1.23.3)

README.md

@@ -521,7 +521,7 @@ The context manager is required so that the response will reliably be closed.
 
 ### Making custom/undocumented requests
 
-This library is typed for convenient access the documented API.
+This library is typed for convenient access to the documented API.
 
 If you need to access undocumented endpoints, params, or response properties, the library can still be used.
 

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "openai"
-version = "1.23.3"
+version = "1.23.4"
 description = "The official Python library for the openai API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/openai/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "openai"
-__version__ = "1.23.3"  # x-release-please-version
+__version__ = "1.23.4"  # x-release-please-version

src/openai/resources/batches.py

@@ -65,8 +65,9 @@ def create(
               See [upload file](https://platform.openai.com/docs/api-reference/files/create)
               for how to upload a file.
 
-              Your input file must be formatted as a JSONL file, and must be uploaded with the
-              purpose `batch`.
+              Your input file must be formatted as a
+              [JSONL file](https://platform.openai.com/docs/api-reference/batch/requestInput),
+              and must be uploaded with the purpose `batch`.
 
           metadata: Optional custom metadata for the batch.
 
@@ -252,8 +253,9 @@ async def create(
               See [upload file](https://platform.openai.com/docs/api-reference/files/create)
               for how to upload a file.
 
-              Your input file must be formatted as a JSONL file, and must be uploaded with the
-              purpose `batch`.
+              Your input file must be formatted as a
+              [JSONL file](https://platform.openai.com/docs/api-reference/batch/requestInput),
+              and must be uploaded with the purpose `batch`.
 
           metadata: Optional custom metadata for the batch.
 

src/openai/types/batch.py

@@ -24,7 +24,7 @@ class Batch(BaseModel):
     completion_window: str
     """The time frame within which the batch should be processed."""
 
-    created_at: str
+    created_at: int
     """The Unix timestamp (in seconds) for when the batch was created."""
 
     endpoint: str
@@ -41,33 +41,33 @@ class Batch(BaseModel):
     ]
     """The current status of the batch."""
 
-    cancelled_at: Optional[str] = None
+    cancelled_at: Optional[int] = None
     """The Unix timestamp (in seconds) for when the batch was cancelled."""
 
-    cancelling_at: Optional[str] = None
+    cancelling_at: Optional[int] = None
     """The Unix timestamp (in seconds) for when the batch started cancelling."""
 
-    completed_at: Optional[str] = None
+    completed_at: Optional[int] = None
     """The Unix timestamp (in seconds) for when the batch was completed."""
 
     error_file_id: Optional[str] = None
     """The ID of the file containing the outputs of requests with errors."""
 
     errors: Optional[Errors] = None
 
-    expired_at: Optional[str] = None
+    expired_at: Optional[int] = None
     """The Unix timestamp (in seconds) for when the batch expired."""
 
-    expires_at: Optional[str] = None
+    expires_at: Optional[int] = None
     """The Unix timestamp (in seconds) for when the batch will expire."""
 
-    failed_at: Optional[str] = None
+    failed_at: Optional[int] = None
     """The Unix timestamp (in seconds) for when the batch failed."""
 
-    finalizing_at: Optional[str] = None
+    finalizing_at: Optional[int] = None
     """The Unix timestamp (in seconds) for when the batch started finalizing."""
 
-    in_progress_at: Optional[str] = None
+    in_progress_at: Optional[int] = None
     """The Unix timestamp (in seconds) for when the batch started processing."""
 
     metadata: Optional[builtins.object] = None

src/openai/types/batch_create_params.py

@@ -27,8 +27,9 @@ class BatchCreateParams(TypedDict, total=False):
     See [upload file](https://platform.openai.com/docs/api-reference/files/create)
     for how to upload a file.
 
-    Your input file must be formatted as a JSONL file, and must be uploaded with the
-    purpose `batch`.
+    Your input file must be formatted as a
+    [JSONL file](https://platform.openai.com/docs/api-reference/batch/requestInput),
+    and must be uploaded with the purpose `batch`.
     """
 
     metadata: Optional[Dict[str, str]]

src/openai/types/beta/vector_store.py

@@ -40,9 +40,6 @@ class VectorStore(BaseModel):
     id: str
     """The identifier, which can be referenced in API endpoints."""
 
-    bytes: int
-    """The byte size of the vector store."""
-
     created_at: int
     """The Unix timestamp (in seconds) for when the vector store was created."""
 
@@ -72,6 +69,9 @@ class VectorStore(BaseModel):
     for use.
     """
 
+    usage_bytes: int
+    """The total number of bytes used by the files in the vector store."""
+
     expires_after: Optional[ExpiresAfter] = None
     """The expiration policy for a vector store."""
 

src/openai/types/beta/vector_stores/vector_store_file.py

@@ -39,6 +39,12 @@ class VectorStoreFile(BaseModel):
     vector store file is ready for use.
     """
 
+    usage_bytes: int
+    """The total vector store usage in bytes.
+
+    Note that this may be different from the original file size.
+    """
+
     vector_store_id: str
     """
     The ID of the