anthropic 0.56.0__tar.gz → 0.57.0__tar.gz

anthropic-0.57.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.57.0"
+}

{anthropic-0.56.0 → anthropic-0.57.0}/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 0.57.0 (2025-07-03)
+
+Full Changelog: [v0.56.0...v0.57.0](https://github.com/anthropics/anthropic-sdk-python/compare/v0.56.0...v0.57.0)
+
+### Features
+
+* **api:** add support for Search Result Content Blocks ([4896178](https://github.com/anthropics/anthropic-sdk-python/commit/4896178d23832e4c84775571e8919c690ff998a1))
+
+
+### Bug Fixes
+
+* improve timeout/network error message to be more helpful ([347fb57](https://github.com/anthropics/anthropic-sdk-python/commit/347fb57c49129ff1fdac19859eb4c80808ed0711))
+
+
+### Chores
+
+* **ci:** change upload type ([4dc4178](https://github.com/anthropics/anthropic-sdk-python/commit/4dc4178d0a1eaeafc248deac4e08cc782f778600))
+* **internal:** version bump ([363629c](https://github.com/anthropics/anthropic-sdk-python/commit/363629cbc85d1e81d1e503d224dc8c7a3d1fa113))
+* **stream:** improve get_final_text() error message ([#979](https://github.com/anthropics/anthropic-sdk-python/issues/979)) ([5ae0a33](https://github.com/anthropics/anthropic-sdk-python/commit/5ae0a3303f8369575d9ebefe5b2c45cc435facdb))
+
+
+### Documentation
+
+* fix vertex id ([f7392c7](https://github.com/anthropics/anthropic-sdk-python/commit/f7392c7789fc2d329ab63c4d2ed7ba0d1dc0c7c0))
+* fix vertex id ([92fe132](https://github.com/anthropics/anthropic-sdk-python/commit/92fe1329a9a8a31de2fe71b40c4fdd84fb033dae))
+* update model in readme ([1a4df78](https://github.com/anthropics/anthropic-sdk-python/commit/1a4df783a75589dce9826a5c0564692ed0d7d7fb))
+* update models and non-beta ([a54e65c](https://github.com/anthropics/anthropic-sdk-python/commit/a54e65c5bc9dd1ac188ea9c166943548cc6f7c08))
+* update more models ([9e3dd6a](https://github.com/anthropics/anthropic-sdk-python/commit/9e3dd6afc565a6777f96ab05a28dcf2b4b9591da))
+
 ## 0.56.0 (2025-07-01)
 
 Full Changelog: [v0.55.0...v0.56.0](https://github.com/anthropics/anthropic-sdk-python/compare/v0.55.0...v0.56.0)

{anthropic-0.56.0 → anthropic-0.57.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: anthropic
-Version: 0.56.0
+Version: 0.57.0
 Summary: The official Python library for the anthropic API
 Project-URL: Homepage, https://github.com/anthropics/anthropic-sdk-python
 Project-URL: Repository, https://github.com/anthropics/anthropic-sdk-python
@@ -77,7 +77,7 @@ message = client.messages.create(
             "content": "Hello, Claude",
         }
     ],
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
 )
 print(message.content)
 ```
@@ -110,7 +110,7 @@ async def main() -> None:
                 "content": "Hello, Claude",
             }
         ],
-        model="claude-3-5-sonnet-latest",
+        model="claude-sonnet-4-20250514",
     )
     print(message.content)
 
@@ -153,7 +153,7 @@ async def main() -> None:
                     "content": "Hello, Claude",
                 }
             ],
-            model="claude-3-5-sonnet-latest",
+            model="claude-sonnet-4-20250514",
         )
         print(message.content)
 
@@ -178,7 +178,7 @@ stream = client.messages.create(
             "content": "Hello, Claude",
         }
     ],
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
     stream=True,
 )
 for event in stream:
@@ -200,7 +200,7 @@ stream = await client.messages.create(
             "content": "Hello, Claude",
         }
     ],
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
     stream=True,
 )
 async for event in stream:
@@ -226,7 +226,7 @@ async def main() -> None:
                 "content": "Say hello there!",
             }
         ],
-        model="claude-3-5-sonnet-latest",
+        model="claude-sonnet-4-20250514",
     ) as stream:
         async for text in stream.text_stream:
             print(text, end="", flush=True)
@@ -244,11 +244,11 @@ Alternatively, you can use `client.messages.create(..., stream=True)` which only
 
 ## Token counting
 
-To get the token count for a message without creating it you can use the `client.beta.messages.count_tokens()` method. This takes the same `messages` list as the `.create()` method.
+To get the token count for a message without creating it you can use the `client.messages.count_tokens()` method. This takes the same `messages` list as the `.create()` method.
 
 ```py
-count = client.beta.messages.count_tokens(
-    model="claude-3-5-sonnet-20241022",
+count = client.messages.count_tokens(
+    model="claude-sonnet-4-20250514",
     messages=[
         {"role": "user", "content": "Hello, world"}
     ]
@@ -266,20 +266,19 @@ message.usage
 
 ## Message Batches
 
-This SDK provides beta support for the [Message Batches API](https://docs.anthropic.com/en/docs/build-with-claude/message-batches) under the `client.beta.messages.batches` namespace.
-
+This SDK provides support for the [Message Batches API](https://docs.anthropic.com/en/docs/build-with-claude/message-batches) under the `client.messages.batches` namespace.
 
 ### Creating a batch
 
 Message Batches take the exact same request params as the standard Messages API:
 
 ```python
-await client.beta.messages.batches.create(
+await client.messages.batches.create(
     requests=[
         {
             "custom_id": "my-first-request",
             "params": {
-                "model": "claude-3-5-sonnet-latest",
+                "model": "claude-sonnet-4-20250514",
                 "max_tokens": 1024,
                 "messages": [{"role": "user", "content": "Hello, world"}],
             },
@@ -287,7 +286,7 @@ await client.beta.messages.batches.create(
         {
             "custom_id": "my-second-request",
             "params": {
-                "model": "claude-3-5-sonnet-latest",
+                "model": "claude-sonnet-4-20250514",
                 "max_tokens": 1024,
                 "messages": [{"role": "user", "content": "Hi again, friend"}],
             },
@@ -296,13 +295,12 @@ await client.beta.messages.batches.create(
 )
 ```
 
-
 ### Getting results from a batch
 
 Once a Message Batch has been processed, indicated by `.processing_status === 'ended'`, you can access the results with `.batches.results()`
 
 ```python
-result_stream = await client.beta.messages.batches.results(batch_id)
+result_stream = await client.messages.batches.results(batch_id)
 async for entry in result_stream:
     if entry.result.type == "succeeded":
         print(entry.result.message.content)
@@ -331,7 +329,7 @@ message = client.messages.create(
             "content": "Hello!",
         }
     ],
-    model="anthropic.claude-3-5-sonnet-20241022-v2:0",
+    model="anthropic.claude-sonnet-4-20250514-v2:0",
 )
 print(message)
 ```
@@ -362,7 +360,7 @@ from anthropic import AnthropicVertex
 client = AnthropicVertex()
 
 message = client.messages.create(
-    model="claude-3-5-sonnet-v2@20241022",
+    model="claude-sonnet-4@20250514",
     max_tokens=100,
     messages=[
         {
@@ -398,7 +396,7 @@ client = Anthropic()
 
 all_batches = []
 # Automatically fetches more pages as needed.
-for batch in client.beta.messages.batches.list(
+for batch in client.messages.batches.list(
     limit=20,
 ):
     # Do something with batch here
@@ -418,7 +416,7 @@ client = AsyncAnthropic()
 async def main() -> None:
     all_batches = []
     # Iterate through items across all pages, issuing requests as needed.
-    async for batch in client.beta.messages.batches.list(
+    async for batch in client.messages.batches.list(
         limit=20,
     ):
         all_batches.append(batch)
@@ -431,7 +429,7 @@ asyncio.run(main())
 Alternatively, you can use the `.has_next_page()`, `.next_page_info()`, or `.get_next_page()` methods for more granular control working with pages:
 
 ```python
-first_page = await client.beta.messages.batches.list(
+first_page = await client.messages.batches.list(
     limit=20,
 )
 if first_page.has_next_page():
@@ -445,7 +443,7 @@ if first_page.has_next_page():
 Or just work directly with the returned data:
 
 ```python
-first_page = await client.beta.messages.batches.list(
+first_page = await client.messages.batches.list(
     limit=20,
 )
 
@@ -473,7 +471,7 @@ message = client.messages.create(
             "role": "user",
         }
     ],
-    model="claude-3-7-sonnet-20250219",
+    model="claude-sonnet-4-20250514",
     metadata={},
 )
 print(message.metadata)
@@ -520,7 +518,7 @@ try:
                 "content": "Hello, Claude",
             }
         ],
-        model="claude-3-5-sonnet-latest",
+        model="claude-sonnet-4-20250514",
     )
 except anthropic.APIConnectionError as e:
     print("The server could not be reached")
@@ -561,14 +559,14 @@ message = client.messages.create(
             "content": "Hello, Claude",
         }
     ],
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
 )
 print(message._request_id)  # req_018EeWyXxfu5pfWkrYcMdjWG
 ```
 
 Note that unlike other properties that use an `_` prefix, the `_request_id` property
-*is* public. Unless documented otherwise, *all* other `_` prefix properties,
-methods and modules are *private*.
+_is_ public. Unless documented otherwise, _all_ other `_` prefix properties,
+methods and modules are _private_.
 
 ### Retries
 
@@ -596,7 +594,7 @@ client.with_options(max_retries=5).messages.create(
             "content": "Hello, Claude",
         }
     ],
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
 )
 ```
 
@@ -628,7 +626,7 @@ client.with_options(timeout=5.0).messages.create(
             "content": "Hello, Claude",
         }
     ],
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
 )
 ```
 
@@ -711,7 +709,7 @@ response = client.messages.with_raw_response.create(
         "role": "user",
         "content": "Hello, Claude",
     }],
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
 )
 print(response.headers.get('X-My-Header'))
 
@@ -745,7 +743,7 @@ with client.messages.with_streaming_response.create(
             "content": "Hello, Claude",
         }
     ],
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
 ) as response:
     print(response.headers.get("X-My-Header"))
 

{anthropic-0.56.0 → anthropic-0.57.0}/README.md

@@ -37,7 +37,7 @@ message = client.messages.create(
             "content": "Hello, Claude",
         }
     ],
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
 )
 print(message.content)
 ```
@@ -70,7 +70,7 @@ async def main() -> None:
                 "content": "Hello, Claude",
             }
         ],
-        model="claude-3-5-sonnet-latest",
+        model="claude-sonnet-4-20250514",
     )
     print(message.content)
 
@@ -113,7 +113,7 @@ async def main() -> None:
                     "content": "Hello, Claude",
                 }
             ],
-            model="claude-3-5-sonnet-latest",
+            model="claude-sonnet-4-20250514",
         )
         print(message.content)
 
@@ -138,7 +138,7 @@ stream = client.messages.create(
             "content": "Hello, Claude",
         }
     ],
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
     stream=True,
 )
 for event in stream:
@@ -160,7 +160,7 @@ stream = await client.messages.create(
             "content": "Hello, Claude",
         }
     ],
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
     stream=True,
 )
 async for event in stream:
@@ -186,7 +186,7 @@ async def main() -> None:
                 "content": "Say hello there!",
             }
         ],
-        model="claude-3-5-sonnet-latest",
+        model="claude-sonnet-4-20250514",
     ) as stream:
         async for text in stream.text_stream:
             print(text, end="", flush=True)
@@ -204,11 +204,11 @@ Alternatively, you can use `client.messages.create(..., stream=True)` which only
 
 ## Token counting
 
-To get the token count for a message without creating it you can use the `client.beta.messages.count_tokens()` method. This takes the same `messages` list as the `.create()` method.
+To get the token count for a message without creating it you can use the `client.messages.count_tokens()` method. This takes the same `messages` list as the `.create()` method.
 
 ```py
-count = client.beta.messages.count_tokens(
-    model="claude-3-5-sonnet-20241022",
+count = client.messages.count_tokens(
+    model="claude-sonnet-4-20250514",
     messages=[
         {"role": "user", "content": "Hello, world"}
     ]
@@ -226,20 +226,19 @@ message.usage
 
 ## Message Batches
 
-This SDK provides beta support for the [Message Batches API](https://docs.anthropic.com/en/docs/build-with-claude/message-batches) under the `client.beta.messages.batches` namespace.
-
+This SDK provides support for the [Message Batches API](https://docs.anthropic.com/en/docs/build-with-claude/message-batches) under the `client.messages.batches` namespace.
 
 ### Creating a batch
 
 Message Batches take the exact same request params as the standard Messages API:
 
 ```python
-await client.beta.messages.batches.create(
+await client.messages.batches.create(
     requests=[
         {
             "custom_id": "my-first-request",
             "params": {
-                "model": "claude-3-5-sonnet-latest",
+                "model": "claude-sonnet-4-20250514",
                 "max_tokens": 1024,
                 "messages": [{"role": "user", "content": "Hello, world"}],
             },
@@ -247,7 +246,7 @@ await client.beta.messages.batches.create(
         {
             "custom_id": "my-second-request",
             "params": {
-                "model": "claude-3-5-sonnet-latest",
+                "model": "claude-sonnet-4-20250514",
                 "max_tokens": 1024,
                 "messages": [{"role": "user", "content": "Hi again, friend"}],
             },
@@ -256,13 +255,12 @@ await client.beta.messages.batches.create(
 )
 ```
 
-
 ### Getting results from a batch
 
 Once a Message Batch has been processed, indicated by `.processing_status === 'ended'`, you can access the results with `.batches.results()`
 
 ```python
-result_stream = await client.beta.messages.batches.results(batch_id)
+result_stream = await client.messages.batches.results(batch_id)
 async for entry in result_stream:
     if entry.result.type == "succeeded":
         print(entry.result.message.content)
@@ -291,7 +289,7 @@ message = client.messages.create(
             "content": "Hello!",
         }
     ],
-    model="anthropic.claude-3-5-sonnet-20241022-v2:0",
+    model="anthropic.claude-sonnet-4-20250514-v2:0",
 )
 print(message)
 ```
@@ -322,7 +320,7 @@ from anthropic import AnthropicVertex
 client = AnthropicVertex()
 
 message = client.messages.create(
-    model="claude-3-5-sonnet-v2@20241022",
+    model="claude-sonnet-4@20250514",
     max_tokens=100,
     messages=[
         {
@@ -358,7 +356,7 @@ client = Anthropic()
 
 all_batches = []
 # Automatically fetches more pages as needed.
-for batch in client.beta.messages.batches.list(
+for batch in client.messages.batches.list(
     limit=20,
 ):
     # Do something with batch here
@@ -378,7 +376,7 @@ client = AsyncAnthropic()
 async def main() -> None:
     all_batches = []
     # Iterate through items across all pages, issuing requests as needed.
-    async for batch in client.beta.messages.batches.list(
+    async for batch in client.messages.batches.list(
         limit=20,
     ):
         all_batches.append(batch)
@@ -391,7 +389,7 @@ asyncio.run(main())
 Alternatively, you can use the `.has_next_page()`, `.next_page_info()`, or `.get_next_page()` methods for more granular control working with pages:
 
 ```python
-first_page = await client.beta.messages.batches.list(
+first_page = await client.messages.batches.list(
     limit=20,
 )
 if first_page.has_next_page():
@@ -405,7 +403,7 @@ if first_page.has_next_page():
 Or just work directly with the returned data:
 
 ```python
-first_page = await client.beta.messages.batches.list(
+first_page = await client.messages.batches.list(
     limit=20,
 )
 
@@ -433,7 +431,7 @@ message = client.messages.create(
             "role": "user",
         }
     ],
-    model="claude-3-7-sonnet-20250219",
+    model="claude-sonnet-4-20250514",
     metadata={},
 )
 print(message.metadata)
@@ -480,7 +478,7 @@ try:
                 "content": "Hello, Claude",
             }
         ],
-        model="claude-3-5-sonnet-latest",
+        model="claude-sonnet-4-20250514",
     )
 except anthropic.APIConnectionError as e:
     print("The server could not be reached")
@@ -521,14 +519,14 @@ message = client.messages.create(
             "content": "Hello, Claude",
         }
     ],
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
 )
 print(message._request_id)  # req_018EeWyXxfu5pfWkrYcMdjWG
 ```
 
 Note that unlike other properties that use an `_` prefix, the `_request_id` property
-*is* public. Unless documented otherwise, *all* other `_` prefix properties,
-methods and modules are *private*.
+_is_ public. Unless documented otherwise, _all_ other `_` prefix properties,
+methods and modules are _private_.
 
 ### Retries
 
@@ -556,7 +554,7 @@ client.with_options(max_retries=5).messages.create(
             "content": "Hello, Claude",
         }
     ],
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
 )
 ```
 
@@ -588,7 +586,7 @@ client.with_options(timeout=5.0).messages.create(
             "content": "Hello, Claude",
         }
     ],
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
 )
 ```
 
@@ -671,7 +669,7 @@ response = client.messages.with_raw_response.create(
         "role": "user",
         "content": "Hello, Claude",
     }],
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
 )
 print(response.headers.get('X-My-Header'))
 
@@ -705,7 +703,7 @@ with client.messages.with_streaming_response.create(
             "content": "Hello, Claude",
         }
     ],
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
 ) as response:
     print(response.headers.get("X-My-Header"))
 

{anthropic-0.56.0 → anthropic-0.57.0}/api.md

@@ -256,6 +256,9 @@ from anthropic.types.beta import (
     BetaRequestMCPServerToolConfiguration,
     BetaRequestMCPServerURLDefinition,
     BetaRequestMCPToolResultBlockParam,
+    BetaSearchResultBlockParam,
+    BetaSearchResultLocationCitation,
+    BetaSearchResultLocationCitationParam,
     BetaServerToolUsage,
     BetaServerToolUseBlock,
     BetaServerToolUseBlockParam,

{anthropic-0.56.0 → anthropic-0.57.0}/examples/batch_results.py

@@ -14,6 +14,6 @@ except IndexError as exc:
 
 s = time.monotonic()
 
-result_stream = client.beta.messages.batches.results(batch_id)
+result_stream = client.messages.batches.results(batch_id)
 for result in result_stream:
     rich.print(result)

{anthropic-0.56.0 → anthropic-0.57.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "anthropic"
-version = "0.56.0"
+version = "0.57.0"
 description = "The official Python library for the anthropic API"
 dynamic = ["readme"]
 license = "MIT"

{anthropic-0.56.0 → anthropic-0.57.0}/src/anthropic/_exceptions.py

@@ -75,7 +75,10 @@ class APIConnectionError(APIError):
 
 class APITimeoutError(APIConnectionError):
     def __init__(self, request: httpx.Request) -> None:
-        super().__init__(message="Request timed out.", request=request)
+        super().__init__(
+            message="Request timed out or interrupted. This could be due to a network timeout, dropped connection, or request cancellation. See https://docs.anthropic.com/en/api/errors#long-requests for more details.",
+            request=request,
+        )
 
 
 class BadRequestError(APIStatusError):

{anthropic-0.56.0 → anthropic-0.57.0}/src/anthropic/_version.py

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

{anthropic-0.56.0 → anthropic-0.57.0}/src/anthropic/lib/streaming/_beta_messages.py

@@ -101,7 +101,9 @@ class BetaMessageStream:
                 text_blocks.append(block.text)
 
         if not text_blocks:
-            raise RuntimeError("Expected to have received at least 1 text block")
+            raise RuntimeError(
+                f".get_final_text() can only be called when the API returns a `text` content block.\nThe API returned {','.join([b.type for b in message.content])} content block type(s) that you can access by calling get_final_message().content"
+            )
 
         return "".join(text_blocks)
 
@@ -239,7 +241,10 @@ class BetaAsyncMessageStream:
                 text_blocks.append(block.text)
 
         if not text_blocks:
-            raise RuntimeError("Expected to have received at least 1 text block")
+            raise RuntimeError(
+                f".get_final_text() can only be called when the API returns a `text` content block.\nThe API returned {','.join([b.type for b in message.content])} content block type(s) that you can access by calling get_final_message().content"
+            )
+
 
         return "".join(text_blocks)
 

{anthropic-0.56.0 → anthropic-0.57.0}/src/anthropic/lib/streaming/_messages.py

@@ -100,7 +100,9 @@ class MessageStream:
                 text_blocks.append(block.text)
 
         if not text_blocks:
-            raise RuntimeError("Expected to have received at least 1 text block")
+            raise RuntimeError(
+                f".get_final_text() can only be called when the API returns a `text` content block.\nThe API returned {','.join([b.type for b in message.content])} content block type(s) that you can access by calling get_final_message().content"
+            )
 
         return "".join(text_blocks)
 
@@ -237,7 +239,9 @@ class AsyncMessageStream:
                 text_blocks.append(block.text)
 
         if not text_blocks:
-            raise RuntimeError("Expected to have received at least 1 text block")
+            raise RuntimeError(
+                f".get_final_text() can only be called when the API returns a `text` content block.\nThe API returned {','.join([b.type for b in message.content])} content block type(s) that you can access by calling get_final_message().content"
+            )
 
         return "".join(text_blocks)