openrouter 0.1.2__py3-none-any.whl → 0.6.0__py3-none-any.whl

openrouter/components/developermessage.py

@@ -0,0 +1,41 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from .chatmessagecontentitemtext import (
+    ChatMessageContentItemText,
+    ChatMessageContentItemTextTypedDict,
+)
+from openrouter.types import BaseModel
+from openrouter.utils import validate_const
+import pydantic
+from pydantic.functional_validators import AfterValidator
+from typing import List, Literal, Optional, Union
+from typing_extensions import Annotated, NotRequired, TypeAliasType, TypedDict
+
+
+DeveloperMessageContentTypedDict = TypeAliasType(
+    "DeveloperMessageContentTypedDict",
+    Union[str, List[ChatMessageContentItemTextTypedDict]],
+)
+
+
+DeveloperMessageContent = TypeAliasType(
+    "DeveloperMessageContent", Union[str, List[ChatMessageContentItemText]]
+)
+
+
+class DeveloperMessageTypedDict(TypedDict):
+    content: DeveloperMessageContentTypedDict
+    role: Literal["developer"]
+    name: NotRequired[str]
+
+
+class DeveloperMessage(BaseModel):
+    content: DeveloperMessageContent
+
+    ROLE: Annotated[
+        Annotated[Literal["developer"], AfterValidator(validate_const("developer"))],
+        pydantic.Field(alias="role"),
+    ] = "developer"
+
+    name: Optional[str] = None

openrouter/components/message.py

@@ -2,47 +2,14 @@
 
 from __future__ import annotations
 from .assistantmessage import AssistantMessage, AssistantMessageTypedDict
-from .chatmessagecontentitemtext import (
-    ChatMessageContentItemText,
-    ChatMessageContentItemTextTypedDict,
-)
+from .developermessage import DeveloperMessage, DeveloperMessageTypedDict
 from .systemmessage import SystemMessage, SystemMessageTypedDict
 from .toolresponsemessage import ToolResponseMessage, ToolResponseMessageTypedDict
 from .usermessage import UserMessage, UserMessageTypedDict
-from openrouter.types import BaseModel
-from openrouter.utils import get_discriminator, validate_const
-import pydantic
+from openrouter.utils import get_discriminator
 from pydantic import Discriminator, Tag
-from pydantic.functional_validators import AfterValidator
-from typing import List, Literal, Optional, Union
-from typing_extensions import Annotated, NotRequired, TypeAliasType, TypedDict
-
-
-MessageContentTypedDict = TypeAliasType(
-    "MessageContentTypedDict", Union[str, List[ChatMessageContentItemTextTypedDict]]
-)
-
-
-MessageContent = TypeAliasType(
-    "MessageContent", Union[str, List[ChatMessageContentItemText]]
-)
-
-
-class MessageDeveloperTypedDict(TypedDict):
-    content: MessageContentTypedDict
-    role: Literal["developer"]
-    name: NotRequired[str]
-
-
-class MessageDeveloper(BaseModel):
-    content: MessageContent
-
-    ROLE: Annotated[
-        Annotated[Literal["developer"], AfterValidator(validate_const("developer"))],
-        pydantic.Field(alias="role"),
-    ] = "developer"
-
-    name: Optional[str] = None
+from typing import Union
+from typing_extensions import Annotated, TypeAliasType
 
 
 MessageTypedDict = TypeAliasType(
@@ -50,7 +17,7 @@ MessageTypedDict = TypeAliasType(
     Union[
         SystemMessageTypedDict,
         UserMessageTypedDict,
-        MessageDeveloperTypedDict,
+        DeveloperMessageTypedDict,
         ToolResponseMessageTypedDict,
         AssistantMessageTypedDict,
     ],
@@ -61,7 +28,7 @@ Message = Annotated[
     Union[
         Annotated[SystemMessage, Tag("system")],
         Annotated[UserMessage, Tag("user")],
-        Annotated[MessageDeveloper, Tag("developer")],
+        Annotated[DeveloperMessage, Tag("developer")],
         Annotated[AssistantMessage, Tag("assistant")],
         Annotated[ToolResponseMessage, Tag("tool")],
     ],

openrouter/components/model.py

@@ -50,6 +50,8 @@ class ModelTypedDict(TypedDict):
     r"""Hugging Face model identifier, if applicable"""
     description: NotRequired[str]
     r"""Description of the model"""
+    expiration_date: NotRequired[Nullable[str]]
+    r"""The date after which the model may be removed. ISO 8601 date string (YYYY-MM-DD) or null if no expiration."""
 
 
 class Model(BaseModel):
@@ -96,14 +98,18 @@ class Model(BaseModel):
     description: Optional[str] = None
     r"""Description of the model"""
 
+    expiration_date: OptionalNullable[str] = UNSET
+    r"""The date after which the model may be removed. ISO 8601 date string (YYYY-MM-DD) or null if no expiration."""
+
     @model_serializer(mode="wrap")
     def serialize_model(self, handler):
-        optional_fields = ["hugging_face_id", "description"]
+        optional_fields = ["hugging_face_id", "description", "expiration_date"]
         nullable_fields = [
             "hugging_face_id",
             "context_length",
             "per_request_limits",
             "default_parameters",
+            "expiration_date",
         ]
         null_default_fields = []
 

openrouter/components/openresponsesrequest.py

@@ -222,37 +222,29 @@ class OpenResponsesRequestMaxPriceTypedDict(TypedDict):
     r"""The object specifying the maximum price you want to pay for this request. USD price per million tokens, for prompt and completion."""
 
     prompt: NotRequired[str]
-    r"""A value in string format that is a large number"""
+    r"""Price per million prompt tokens"""
     completion: NotRequired[str]
-    r"""A value in string format that is a large number"""
     image: NotRequired[str]
-    r"""A value in string format that is a large number"""
     audio: NotRequired[str]
-    r"""A value in string format that is a large number"""
     request: NotRequired[str]
-    r"""A value in string format that is a large number"""
 
 
 class OpenResponsesRequestMaxPrice(BaseModel):
     r"""The object specifying the maximum price you want to pay for this request. USD price per million tokens, for prompt and completion."""
 
     prompt: Optional[str] = None
-    r"""A value in string format that is a large number"""
+    r"""Price per million prompt tokens"""
 
     completion: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     image: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     audio: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     request: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
 
-class OpenResponsesRequestProviderTypedDict(TypedDict):
+class ProviderTypedDict(TypedDict):
     r"""When multiple model providers are available, optionally indicate your routing preference."""
 
     allow_fallbacks: NotRequired[Nullable[bool]]
@@ -291,7 +283,7 @@ class OpenResponsesRequestProviderTypedDict(TypedDict):
     r"""Preferred maximum latency (in seconds). Can be a number (applies to p50) or an object with percentile-specific cutoffs. Endpoints above the threshold(s) may still be used, but are deprioritized in routing. When using fallback models, this may cause a fallback model to be used instead of the primary model if it meets the threshold."""
 
 
-class OpenResponsesRequestProvider(BaseModel):
+class Provider(BaseModel):
     r"""When multiple model providers are available, optionally indicate your routing preference."""
 
     allow_fallbacks: OptionalNullable[bool] = UNSET
@@ -406,13 +398,13 @@ class OpenResponsesRequestProvider(BaseModel):
 IDResponseHealing = Literal["response-healing",]
 
 
-class OpenResponsesRequestPluginResponseHealingTypedDict(TypedDict):
+class PluginResponseHealingTypedDict(TypedDict):
     id: IDResponseHealing
     enabled: NotRequired[bool]
     r"""Set to false to disable the response-healing plugin for this request. Defaults to true."""
 
 
-class OpenResponsesRequestPluginResponseHealing(BaseModel):
+class PluginResponseHealing(BaseModel):
     id: IDResponseHealing
 
     enabled: Optional[bool] = None
@@ -422,7 +414,7 @@ class OpenResponsesRequestPluginResponseHealing(BaseModel):
 IDFileParser = Literal["file-parser",]
 
 
-class OpenResponsesRequestPluginFileParserTypedDict(TypedDict):
+class PluginFileParserTypedDict(TypedDict):
     id: IDFileParser
     enabled: NotRequired[bool]
     r"""Set to false to disable the file-parser plugin for this request. Defaults to true."""
@@ -430,7 +422,7 @@ class OpenResponsesRequestPluginFileParserTypedDict(TypedDict):
     r"""Options for PDF parsing."""
 
 
-class OpenResponsesRequestPluginFileParser(BaseModel):
+class PluginFileParser(BaseModel):
     id: IDFileParser
 
     enabled: Optional[bool] = None
@@ -443,7 +435,7 @@ class OpenResponsesRequestPluginFileParser(BaseModel):
 IDWeb = Literal["web",]
 
 
-class OpenResponsesRequestPluginWebTypedDict(TypedDict):
+class PluginWebTypedDict(TypedDict):
     id: IDWeb
     enabled: NotRequired[bool]
     r"""Set to false to disable the web-search plugin for this request. Defaults to true."""
@@ -453,7 +445,7 @@ class OpenResponsesRequestPluginWebTypedDict(TypedDict):
     r"""The search engine to use for web search."""
 
 
-class OpenResponsesRequestPluginWeb(BaseModel):
+class PluginWeb(BaseModel):
     id: IDWeb
 
     enabled: Optional[bool] = None
@@ -472,18 +464,18 @@ class OpenResponsesRequestPluginWeb(BaseModel):
 IDModeration = Literal["moderation",]
 
 
-class OpenResponsesRequestPluginModerationTypedDict(TypedDict):
+class PluginModerationTypedDict(TypedDict):
     id: IDModeration
 
 
-class OpenResponsesRequestPluginModeration(BaseModel):
+class PluginModeration(BaseModel):
     id: IDModeration
 
 
 IDAutoRouter = Literal["auto-router",]
 
 
-class OpenResponsesRequestPluginAutoRouterTypedDict(TypedDict):
+class PluginAutoRouterTypedDict(TypedDict):
     id: IDAutoRouter
     enabled: NotRequired[bool]
     r"""Set to false to disable the auto-router plugin for this request. Defaults to true."""
@@ -491,7 +483,7 @@ class OpenResponsesRequestPluginAutoRouterTypedDict(TypedDict):
     r"""List of model patterns to filter which models the auto-router can route between. Supports wildcards (e.g., \"anthropic/*\" matches all Anthropic models). When not specified, uses the default supported models list."""
 
 
-class OpenResponsesRequestPluginAutoRouter(BaseModel):
+class PluginAutoRouter(BaseModel):
     id: IDAutoRouter
 
     enabled: Optional[bool] = None
@@ -501,25 +493,25 @@ class OpenResponsesRequestPluginAutoRouter(BaseModel):
     r"""List of model patterns to filter which models the auto-router can route between. Supports wildcards (e.g., \"anthropic/*\" matches all Anthropic models). When not specified, uses the default supported models list."""
 
 
-OpenResponsesRequestPluginUnionTypedDict = TypeAliasType(
-    "OpenResponsesRequestPluginUnionTypedDict",
+PluginTypedDict = TypeAliasType(
+    "PluginTypedDict",
     Union[
-        OpenResponsesRequestPluginModerationTypedDict,
-        OpenResponsesRequestPluginResponseHealingTypedDict,
-        OpenResponsesRequestPluginAutoRouterTypedDict,
-        OpenResponsesRequestPluginFileParserTypedDict,
-        OpenResponsesRequestPluginWebTypedDict,
+        PluginModerationTypedDict,
+        PluginResponseHealingTypedDict,
+        PluginAutoRouterTypedDict,
+        PluginFileParserTypedDict,
+        PluginWebTypedDict,
     ],
 )
 
 
-OpenResponsesRequestPluginUnion = Annotated[
+Plugin = Annotated[
     Union[
-        Annotated[OpenResponsesRequestPluginAutoRouter, Tag("auto-router")],
-        Annotated[OpenResponsesRequestPluginModeration, Tag("moderation")],
-        Annotated[OpenResponsesRequestPluginWeb, Tag("web")],
-        Annotated[OpenResponsesRequestPluginFileParser, Tag("file-parser")],
-        Annotated[OpenResponsesRequestPluginResponseHealing, Tag("response-healing")],
+        Annotated[PluginAutoRouter, Tag("auto-router")],
+        Annotated[PluginModeration, Tag("moderation")],
+        Annotated[PluginWeb, Tag("web")],
+        Annotated[PluginFileParser, Tag("file-parser")],
+        Annotated[PluginResponseHealing, Tag("response-healing")],
     ],
     Discriminator(lambda m: get_discriminator(m, "id", "id")),
 ]
@@ -564,9 +556,9 @@ class OpenResponsesRequestTypedDict(TypedDict):
     service_tier: NotRequired[ServiceTier]
     truncation: NotRequired[Nullable[Truncation]]
     stream: NotRequired[bool]
-    provider: NotRequired[Nullable[OpenResponsesRequestProviderTypedDict]]
+    provider: NotRequired[Nullable[ProviderTypedDict]]
     r"""When multiple model providers are available, optionally indicate your routing preference."""
-    plugins: NotRequired[List[OpenResponsesRequestPluginUnionTypedDict]]
+    plugins: NotRequired[List[PluginTypedDict]]
     r"""Plugins you want to enable for this request, including their settings."""
     user: NotRequired[str]
     r"""A unique identifier representing your end-user, which helps distinguish between different users of your app. This allows your app to identify specific users in case of abuse reports, preventing your entire app from being affected by the actions of individual users. Maximum of 128 characters."""
@@ -660,10 +652,10 @@ class OpenResponsesRequest(BaseModel):
 
     stream: Optional[bool] = False
 
-    provider: OptionalNullable[OpenResponsesRequestProvider] = UNSET
+    provider: OptionalNullable[Provider] = UNSET
     r"""When multiple model providers are available, optionally indicate your routing preference."""
 
-    plugins: Optional[List[OpenResponsesRequestPluginUnion]] = None
+    plugins: Optional[List[Plugin]] = None
     r"""Plugins you want to enable for this request, including their settings."""
 
     user: Optional[str] = None

openrouter/components/outputmodality.py

@@ -10,6 +10,7 @@ OutputModality = Union[
         "text",
         "image",
         "embeddings",
+        "audio",
     ],
     UnrecognizedStr,
 ]

openrouter/components/providername.py

@@ -10,6 +10,7 @@ ProviderName = Union[
         "AI21",
         "AionLabs",
         "Alibaba",
+        "Ambient",
         "Amazon Bedrock",
         "Amazon Nova",
         "Anthropic",
@@ -66,6 +67,7 @@ ProviderName = Union[
         "Seed",
         "SiliconFlow",
         "Sourceful",
+        "StepFun",
         "Stealth",
         "StreamLake",
         "Switchpoint",

openrouter/components/providerpreferences.py

@@ -176,34 +176,26 @@ class ProviderPreferencesMaxPriceTypedDict(TypedDict):
     r"""The object specifying the maximum price you want to pay for this request. USD price per million tokens, for prompt and completion."""
 
     prompt: NotRequired[str]
-    r"""A value in string format that is a large number"""
+    r"""Price per million prompt tokens"""
     completion: NotRequired[str]
-    r"""A value in string format that is a large number"""
     image: NotRequired[str]
-    r"""A value in string format that is a large number"""
     audio: NotRequired[str]
-    r"""A value in string format that is a large number"""
     request: NotRequired[str]
-    r"""A value in string format that is a large number"""
 
 
 class ProviderPreferencesMaxPrice(BaseModel):
     r"""The object specifying the maximum price you want to pay for this request. USD price per million tokens, for prompt and completion."""
 
     prompt: Optional[str] = None
-    r"""A value in string format that is a large number"""
+    r"""Price per million prompt tokens"""
 
     completion: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     image: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     audio: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     request: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
 
 class ProviderPreferencesTypedDict(TypedDict):

openrouter/components/publicendpoint.py

@@ -15,68 +15,47 @@ from typing_extensions import Annotated, NotRequired, TypedDict
 
 class PricingTypedDict(TypedDict):
     prompt: str
-    r"""A value in string format that is a large number"""
     completion: str
-    r"""A value in string format that is a large number"""
     request: NotRequired[str]
-    r"""A value in string format that is a large number"""
     image: NotRequired[str]
-    r"""A value in string format that is a large number"""
     image_token: NotRequired[str]
-    r"""A value in string format that is a large number"""
     image_output: NotRequired[str]
-    r"""A value in string format that is a large number"""
     audio: NotRequired[str]
-    r"""A value in string format that is a large number"""
+    audio_output: NotRequired[str]
     input_audio_cache: NotRequired[str]
-    r"""A value in string format that is a large number"""
     web_search: NotRequired[str]
-    r"""A value in string format that is a large number"""
     internal_reasoning: NotRequired[str]
-    r"""A value in string format that is a large number"""
     input_cache_read: NotRequired[str]
-    r"""A value in string format that is a large number"""
     input_cache_write: NotRequired[str]
-    r"""A value in string format that is a large number"""
     discount: NotRequired[float]
 
 
 class Pricing(BaseModel):
     prompt: str
-    r"""A value in string format that is a large number"""
 
     completion: str
-    r"""A value in string format that is a large number"""
 
     request: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     image: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     image_token: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     image_output: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     audio: Optional[str] = None
-    r"""A value in string format that is a large number"""
+
+    audio_output: Optional[str] = None
 
     input_audio_cache: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     web_search: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     internal_reasoning: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     input_cache_read: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     input_cache_write: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     discount: Optional[float] = None
 
@@ -101,6 +80,8 @@ class PublicEndpointTypedDict(TypedDict):
     r"""Information about a specific model endpoint"""
 
     name: str
+    model_id: str
+    r"""The unique identifier for the model (permaslug)"""
     model_name: str
     context_length: float
     pricing: PricingTypedDict
@@ -123,6 +104,9 @@ class PublicEndpoint(BaseModel):
 
     name: str
 
+    model_id: str
+    r"""The unique identifier for the model (permaslug)"""
+
     model_name: str
 
     context_length: float

openrouter/components/publicpricing.py

@@ -10,29 +10,18 @@ class PublicPricingTypedDict(TypedDict):
     r"""Pricing information for the model"""
 
     prompt: str
-    r"""A value in string format that is a large number"""
     completion: str
-    r"""A value in string format that is a large number"""
     request: NotRequired[str]
-    r"""A value in string format that is a large number"""
     image: NotRequired[str]
-    r"""A value in string format that is a large number"""
     image_token: NotRequired[str]
-    r"""A value in string format that is a large number"""
     image_output: NotRequired[str]
-    r"""A value in string format that is a large number"""
     audio: NotRequired[str]
-    r"""A value in string format that is a large number"""
+    audio_output: NotRequired[str]
     input_audio_cache: NotRequired[str]
-    r"""A value in string format that is a large number"""
     web_search: NotRequired[str]
-    r"""A value in string format that is a large number"""
     internal_reasoning: NotRequired[str]
-    r"""A value in string format that is a large number"""
     input_cache_read: NotRequired[str]
-    r"""A value in string format that is a large number"""
     input_cache_write: NotRequired[str]
-    r"""A value in string format that is a large number"""
     discount: NotRequired[float]
 
 
@@ -40,39 +29,29 @@ class PublicPricing(BaseModel):
     r"""Pricing information for the model"""
 
     prompt: str
-    r"""A value in string format that is a large number"""
 
     completion: str
-    r"""A value in string format that is a large number"""
 
     request: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     image: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     image_token: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     image_output: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     audio: Optional[str] = None
-    r"""A value in string format that is a large number"""
+
+    audio_output: Optional[str] = None
 
     input_audio_cache: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     web_search: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     internal_reasoning: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     input_cache_read: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     input_cache_write: Optional[str] = None
-    r"""A value in string format that is a large number"""
 
     discount: Optional[float] = None