Initial commit: OpenRouter Python SDK

Auto-generated Python SDK for OpenRouter API, providing comprehensive client library with:
- Chat completions and streaming support
- Embeddings API
- Model and provider information
- API key management
- Analytics and usage tracking
- OAuth authentication flows
- Full type hints and error handling

src/openrouter/models/getkeyop.py

@@ -0,0 +1,180 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from datetime import datetime
+from openrouter.types import (
+    BaseModel,
+    Nullable,
+    OptionalNullable,
+    UNSET,
+    UNSET_SENTINEL,
+)
+from openrouter.utils import FieldMetadata, PathParamMetadata
+from pydantic import model_serializer
+from typing_extensions import Annotated, NotRequired, TypedDict
+
+
+class GetKeyRequestTypedDict(TypedDict):
+    hash: str
+    r"""The hash identifier of the API key to retrieve"""
+
+
+class GetKeyRequest(BaseModel):
+    hash: Annotated[
+        str, FieldMetadata(path=PathParamMetadata(style="simple", explode=False))
+    ]
+    r"""The hash identifier of the API key to retrieve"""
+
+
+class GetKeyDataTypedDict(TypedDict):
+    r"""The API key information"""
+
+    hash: str
+    r"""Unique hash identifier for the API key"""
+    name: str
+    r"""Name of the API key"""
+    label: str
+    r"""Human-readable label for the API key"""
+    disabled: bool
+    r"""Whether the API key is disabled"""
+    limit: Nullable[float]
+    r"""Spending limit for the API key in USD"""
+    limit_remaining: Nullable[float]
+    r"""Remaining spending limit in USD"""
+    limit_reset: Nullable[str]
+    r"""Type of limit reset for the API key"""
+    include_byok_in_limit: bool
+    r"""Whether to include external BYOK usage in the credit limit"""
+    usage: float
+    r"""Total OpenRouter credit usage (in USD) for the API key"""
+    usage_daily: float
+    r"""OpenRouter credit usage (in USD) for the current UTC day"""
+    usage_weekly: float
+    r"""OpenRouter credit usage (in USD) for the current UTC week (Monday-Sunday)"""
+    usage_monthly: float
+    r"""OpenRouter credit usage (in USD) for the current UTC month"""
+    byok_usage: float
+    r"""Total external BYOK usage (in USD) for the API key"""
+    byok_usage_daily: float
+    r"""External BYOK usage (in USD) for the current UTC day"""
+    byok_usage_weekly: float
+    r"""External BYOK usage (in USD) for the current UTC week (Monday-Sunday)"""
+    byok_usage_monthly: float
+    r"""External BYOK usage (in USD) for current UTC month"""
+    created_at: str
+    r"""ISO 8601 timestamp of when the API key was created"""
+    updated_at: Nullable[str]
+    r"""ISO 8601 timestamp of when the API key was last updated"""
+    expires_at: NotRequired[Nullable[datetime]]
+    r"""ISO 8601 UTC timestamp when the API key expires, or null if no expiration"""
+
+
+class GetKeyData(BaseModel):
+    r"""The API key information"""
+
+    hash: str
+    r"""Unique hash identifier for the API key"""
+
+    name: str
+    r"""Name of the API key"""
+
+    label: str
+    r"""Human-readable label for the API key"""
+
+    disabled: bool
+    r"""Whether the API key is disabled"""
+
+    limit: Nullable[float]
+    r"""Spending limit for the API key in USD"""
+
+    limit_remaining: Nullable[float]
+    r"""Remaining spending limit in USD"""
+
+    limit_reset: Nullable[str]
+    r"""Type of limit reset for the API key"""
+
+    include_byok_in_limit: bool
+    r"""Whether to include external BYOK usage in the credit limit"""
+
+    usage: float
+    r"""Total OpenRouter credit usage (in USD) for the API key"""
+
+    usage_daily: float
+    r"""OpenRouter credit usage (in USD) for the current UTC day"""
+
+    usage_weekly: float
+    r"""OpenRouter credit usage (in USD) for the current UTC week (Monday-Sunday)"""
+
+    usage_monthly: float
+    r"""OpenRouter credit usage (in USD) for the current UTC month"""
+
+    byok_usage: float
+    r"""Total external BYOK usage (in USD) for the API key"""
+
+    byok_usage_daily: float
+    r"""External BYOK usage (in USD) for the current UTC day"""
+
+    byok_usage_weekly: float
+    r"""External BYOK usage (in USD) for the current UTC week (Monday-Sunday)"""
+
+    byok_usage_monthly: float
+    r"""External BYOK usage (in USD) for current UTC month"""
+
+    created_at: str
+    r"""ISO 8601 timestamp of when the API key was created"""
+
+    updated_at: Nullable[str]
+    r"""ISO 8601 timestamp of when the API key was last updated"""
+
+    expires_at: OptionalNullable[datetime] = UNSET
+    r"""ISO 8601 UTC timestamp when the API key expires, or null if no expiration"""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = ["expires_at"]
+        nullable_fields = [
+            "limit",
+            "limit_remaining",
+            "limit_reset",
+            "updated_at",
+            "expires_at",
+        ]
+        null_default_fields = []
+
+        serialized = handler(self)
+
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+            serialized.pop(k, None)
+
+            optional_nullable = k in optional_fields and k in nullable_fields
+            is_set = (
+                self.__pydantic_fields_set__.intersection({n})
+                or k in null_default_fields
+            )  # pylint: disable=no-member
+
+            if val is not None and val != UNSET_SENTINEL:
+                m[k] = val
+            elif val != UNSET_SENTINEL and (
+                not k in optional_fields or (optional_nullable and is_set)
+            ):
+                m[k] = val
+
+        return m
+
+
+class GetKeyResponseTypedDict(TypedDict):
+    r"""API key details"""
+
+    data: GetKeyDataTypedDict
+    r"""The API key information"""
+
+
+class GetKeyResponse(BaseModel):
+    r"""API key details"""
+
+    data: GetKeyData
+    r"""The API key information"""