transcodely 0.3.1__tar.gz → 0.3.3__tar.gz

{transcodely-0.3.1 → transcodely-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: transcodely
-Version: 0.3.1
+Version: 0.3.3
 Summary: Official Python SDK for the Transcodely video transcoding API
 Project-URL: Homepage, https://transcodely.com
 Project-URL: Documentation, https://transcodely.com/docs
@@ -30,7 +30,7 @@ Provides-Extra: dev
 Requires-Dist: mypy>=1.10; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
 Requires-Dist: pytest>=8.0; extra == 'dev'
-Requires-Dist: ruff>=0.5; extra == 'dev'
+Requires-Dist: ruff>=0.16; extra == 'dev'
 Provides-Extra: fast
 Requires-Dist: orjson>=3.10; extra == 'fast'
 Description-Content-Type: text/markdown
@@ -52,6 +52,7 @@ from transcodely import Transcodely
 with Transcodely(api_key=os.environ["TRANSCODELY_API_KEY"]) as client:
     job = client.jobs.create(
         input_url="https://example.com/source.mp4",
+        managed=True,  # write outputs to Transcodely-managed storage
         outputs=[{
             "type": "hls",
             "video": [
@@ -59,6 +60,10 @@ with Transcodely(api_key=os.environ["TRANSCODELY_API_KEY"]) as client:
                 {"codec": "h264", "resolution": "720p"},
             ],
         }],
+        # Optional: encode only a sub-range of the input. Applies job-wide and
+        # reduces cost (billing keys off the produced output duration). Omit
+        # "end_seconds" (or leave 0) to encode through to the end of the input.
+        clip={"start_seconds": 2, "end_seconds": 7},
     )
     print(job.id)  # "job_a1b2c3d4e5f6"
 
@@ -70,6 +75,35 @@ with Transcodely(api_key=os.environ["TRANSCODELY_API_KEY"]) as client:
 
 The simplified-string form (`"hls"`, `"h264"`, `"1080p"`) is what the API actually emits over the wire — the SDK round-trips it transparently to and from the proto enum integers.
 
+## AI captions
+
+Add auto-generated captions to any output with a `generate` subtitle track. Leave `language` empty (or set `"auto"`) to auto-detect the spoken language, or pass an ISO 639-2 code to force one. A per-job fee is metered by source minute and surfaced on `job.fees`; produced captions appear on `job.subtitle_results` with `auto_generated=True`.
+
+```python
+# Generate captions while transcoding a new source.
+client.jobs.create(
+    input_url="https://example.com/source.mp4",
+    managed=True,
+    outputs=[{
+        "type": "hls",
+        "video": [{"codec": "h264", "resolution": "1080p"}],
+        "subtitle_tracks": [{"operation": "generate", "language": "auto"}],
+    }],
+)
+
+# Retro-caption a video you've already hosted: reference it by input_video_id and
+# request a single captions-only output (no video encode).
+job = client.jobs.create(
+    input_video_id="vid_a1b2c3d4e5f6g7",
+    outputs=[{"subtitle_tracks": [{"operation": "generate"}]}],
+)
+
+for result in job.subtitle_results:
+    print(result.language, result.auto_generated, result.url)
+for fee in job.fees:
+    print(fee.fee_type, fee.amount, fee.currency)  # "captions" 0.51 "eur"
+```
+
 ## Authentication
 
 ```python
@@ -82,7 +116,7 @@ API keys are opaque `ak_`-prefixed secrets — pass the full value shown once at
 
 ```python
 client.jobs            # create / get / list / cancel / confirm / watch
-client.videos          # upload helpers, multipart, get / list / update / delete / watch
+client.videos          # upload helpers, multipart, create_from_url, get / list / update / delete / watch, get_stats / list_top_videos
 client.presets         # create / get / get_by_slug / list / update / duplicate / archive
 client.origins         # create / get / list / update / validate / archive
 client.apps            # create / get / list / update / archive / enable_hosting
@@ -96,6 +130,55 @@ client.events          # retrieve / list / resend
 client.webhooks        # construct_event / verify_signature (signature-verification helpers)
 ```
 
+## Videos
+
+### One-call ingest from a URL
+
+`create_from_url` skips the upload dance entirely: give it a publicly-reachable
+`http(s)` URL and the worker fetches it at transcode time. Requires an app with
+managed hosting enabled (`client.apps.enable_hosting(...)`).
+
+```python
+video = client.videos.create_from_url(
+    app_id="app_default000",
+    url="https://example.com/source.mp4",
+    title="Product demo",
+)
+print(video.id, video.status)  # "processing" — no upload step
+
+for event in client.videos.watch(video.id):
+    if event.video.status == "ready":
+        print(event.video.playback_url, event.video.embed_url)
+        break
+```
+
+No `video.uploaded` event fires for URL ingest (no bytes are uploaded to the
+API) — subscribe to `video.ready` / `video.failed` instead to know when it's
+playable.
+
+### Playback analytics
+
+`get_stats` returns a single video's playback stats — plays, watch time, and
+unique viewers — aggregated per UTC day, plus range totals. `list_top_videos`
+ranks an app's videos by plays over a date range. Both accept optional
+`start_date` / `end_date` (`YYYY-MM-DD`, inclusive); stats are best-effort and
+roll up hourly, so recent activity can lag by up to an hour.
+
+```python
+stats = client.videos.get_stats(
+    video_id="vid_abc123def456",
+    start_date="2026-07-01",
+    end_date="2026-07-16",
+)
+for day in stats.daily:
+    print(day.date, day.plays, day.watch_seconds, day.unique_viewers)
+print("range totals:", stats.totals.plays, stats.totals.watch_seconds)
+
+top = client.videos.list_top_videos(app_id="app_default000", limit=10)
+for video in top.items:
+    print(video.video_id, video.title, video.plays, video.watch_seconds)
+```
+
 ## Origins
 
 An origin tells Transcodely where to read source media from and where to write outputs. Every origin belongs to a single provider; pass exactly one provider-config field (`s3`, `gcs`, `http`, or `r2`) on create.
@@ -314,7 +397,7 @@ for event in client.events.list(app_id="app_123").auto_paging_iter():
 client.events.resend("evt_123")   # re-queue delivery to all subscribed endpoints
 ```
 
-The 13 event types are `job.created`, `job.succeeded`, `job.failed`, `job.canceled`, `job.progress`, `output.created`, `output.ready`, `output.failed`, `output.progress`, `video.uploaded`, `video.deleted`, `app.created`, and `app.updated`. Subscribe to `"*"` to receive all of them (including ones added later). An unrecognized future type still verifies; its `event.data` is left as a plain `dict`.
+The 17 event types are `job.created`, `job.succeeded`, `job.failed`, `job.canceled`, `job.progress`, `output.created`, `output.ready`, `output.failed`, `output.progress`, `video.uploaded`, `video.ready`, `video.failed`, `video.deleted`, `app.created`, `app.updated`, `app.spend_limit_warning`, and `app.spend_limit_exceeded`. Subscribe to `"*"` to receive all of them (including ones added later). An unrecognized future type still verifies; its `event.data` is left as a plain `dict`. The two `app.spend_limit_*` events also carry a plain `dict` (`app_id`, `period_start`, `period_end`, `limit_eur`, `spent_eur`, `threshold_pct`, `currency`), not a resource snapshot.
 
 ## Configuration
 

{transcodely-0.3.1 → transcodely-0.3.3}/README.md

@@ -15,6 +15,7 @@ from transcodely import Transcodely
 with Transcodely(api_key=os.environ["TRANSCODELY_API_KEY"]) as client:
     job = client.jobs.create(
         input_url="https://example.com/source.mp4",
+        managed=True,  # write outputs to Transcodely-managed storage
         outputs=[{
             "type": "hls",
             "video": [
@@ -22,6 +23,10 @@ with Transcodely(api_key=os.environ["TRANSCODELY_API_KEY"]) as client:
                 {"codec": "h264", "resolution": "720p"},
             ],
         }],
+        # Optional: encode only a sub-range of the input. Applies job-wide and
+        # reduces cost (billing keys off the produced output duration). Omit
+        # "end_seconds" (or leave 0) to encode through to the end of the input.
+        clip={"start_seconds": 2, "end_seconds": 7},
     )
     print(job.id)  # "job_a1b2c3d4e5f6"
 
@@ -33,6 +38,35 @@ with Transcodely(api_key=os.environ["TRANSCODELY_API_KEY"]) as client:
 
 The simplified-string form (`"hls"`, `"h264"`, `"1080p"`) is what the API actually emits over the wire — the SDK round-trips it transparently to and from the proto enum integers.
 
+## AI captions
+
+Add auto-generated captions to any output with a `generate` subtitle track. Leave `language` empty (or set `"auto"`) to auto-detect the spoken language, or pass an ISO 639-2 code to force one. A per-job fee is metered by source minute and surfaced on `job.fees`; produced captions appear on `job.subtitle_results` with `auto_generated=True`.
+
+```python
+# Generate captions while transcoding a new source.
+client.jobs.create(
+    input_url="https://example.com/source.mp4",
+    managed=True,
+    outputs=[{
+        "type": "hls",
+        "video": [{"codec": "h264", "resolution": "1080p"}],
+        "subtitle_tracks": [{"operation": "generate", "language": "auto"}],
+    }],
+)
+
+# Retro-caption a video you've already hosted: reference it by input_video_id and
+# request a single captions-only output (no video encode).
+job = client.jobs.create(
+    input_video_id="vid_a1b2c3d4e5f6g7",
+    outputs=[{"subtitle_tracks": [{"operation": "generate"}]}],
+)
+
+for result in job.subtitle_results:
+    print(result.language, result.auto_generated, result.url)
+for fee in job.fees:
+    print(fee.fee_type, fee.amount, fee.currency)  # "captions" 0.51 "eur"
+```
+
 ## Authentication
 
 ```python
@@ -45,7 +79,7 @@ API keys are opaque `ak_`-prefixed secrets — pass the full value shown once at
 
 ```python
 client.jobs            # create / get / list / cancel / confirm / watch
-client.videos          # upload helpers, multipart, get / list / update / delete / watch
+client.videos          # upload helpers, multipart, create_from_url, get / list / update / delete / watch, get_stats / list_top_videos
 client.presets         # create / get / get_by_slug / list / update / duplicate / archive
 client.origins         # create / get / list / update / validate / archive
 client.apps            # create / get / list / update / archive / enable_hosting
@@ -59,6 +93,55 @@ client.events          # retrieve / list / resend
 client.webhooks        # construct_event / verify_signature (signature-verification helpers)
 ```
 
+## Videos
+
+### One-call ingest from a URL
+
+`create_from_url` skips the upload dance entirely: give it a publicly-reachable
+`http(s)` URL and the worker fetches it at transcode time. Requires an app with
+managed hosting enabled (`client.apps.enable_hosting(...)`).
+
+```python
+video = client.videos.create_from_url(
+    app_id="app_default000",
+    url="https://example.com/source.mp4",
+    title="Product demo",
+)
+print(video.id, video.status)  # "processing" — no upload step
+
+for event in client.videos.watch(video.id):
+    if event.video.status == "ready":
+        print(event.video.playback_url, event.video.embed_url)
+        break
+```
+
+No `video.uploaded` event fires for URL ingest (no bytes are uploaded to the
+API) — subscribe to `video.ready` / `video.failed` instead to know when it's
+playable.
+
+### Playback analytics
+
+`get_stats` returns a single video's playback stats — plays, watch time, and
+unique viewers — aggregated per UTC day, plus range totals. `list_top_videos`
+ranks an app's videos by plays over a date range. Both accept optional
+`start_date` / `end_date` (`YYYY-MM-DD`, inclusive); stats are best-effort and
+roll up hourly, so recent activity can lag by up to an hour.
+
+```python
+stats = client.videos.get_stats(
+    video_id="vid_abc123def456",
+    start_date="2026-07-01",
+    end_date="2026-07-16",
+)
+for day in stats.daily:
+    print(day.date, day.plays, day.watch_seconds, day.unique_viewers)
+print("range totals:", stats.totals.plays, stats.totals.watch_seconds)
+
+top = client.videos.list_top_videos(app_id="app_default000", limit=10)
+for video in top.items:
+    print(video.video_id, video.title, video.plays, video.watch_seconds)
+```
+
 ## Origins
 
 An origin tells Transcodely where to read source media from and where to write outputs. Every origin belongs to a single provider; pass exactly one provider-config field (`s3`, `gcs`, `http`, or `r2`) on create.
@@ -277,7 +360,7 @@ for event in client.events.list(app_id="app_123").auto_paging_iter():
 client.events.resend("evt_123")   # re-queue delivery to all subscribed endpoints
 ```
 
-The 13 event types are `job.created`, `job.succeeded`, `job.failed`, `job.canceled`, `job.progress`, `output.created`, `output.ready`, `output.failed`, `output.progress`, `video.uploaded`, `video.deleted`, `app.created`, and `app.updated`. Subscribe to `"*"` to receive all of them (including ones added later). An unrecognized future type still verifies; its `event.data` is left as a plain `dict`.
+The 17 event types are `job.created`, `job.succeeded`, `job.failed`, `job.canceled`, `job.progress`, `output.created`, `output.ready`, `output.failed`, `output.progress`, `video.uploaded`, `video.ready`, `video.failed`, `video.deleted`, `app.created`, `app.updated`, `app.spend_limit_warning`, and `app.spend_limit_exceeded`. Subscribe to `"*"` to receive all of them (including ones added later). An unrecognized future type still verifies; its `event.data` is left as a plain `dict`. The two `app.spend_limit_*` events also carry a plain `dict` (`app_id`, `period_start`, `period_end`, `limit_eur`, `spent_eur`, `threshold_pct`, `currency`), not a resource snapshot.
 
 ## Configuration
 

{transcodely-0.3.1 → transcodely-0.3.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "transcodely"
-version = "0.3.1"
+version = "0.3.3"
 description = "Official Python SDK for the Transcodely video transcoding API"
 readme = "README.md"
 license = "MIT"
@@ -37,7 +37,7 @@ fast = ["orjson>=3.10"]
 dev = [
     "pytest>=8.0",
     "pytest-asyncio>=0.23",
-    "ruff>=0.5",
+    "ruff>=0.16",
     "mypy>=1.10",
 ]
 

{transcodely-0.3.1 → transcodely-0.3.3}/src/transcodely/__init__.py

@@ -47,19 +47,6 @@ from .errors import (
     WebhookTimestampError,
 )
 from .pagination import Page, PageContents
-from .version import API_VERSION, DEFAULT_BASE_URL, SDK_VERSION
-from .webhooks import (
-    DEFAULT_TOLERANCE_SECONDS,
-    EVENT_ID_HEADER,
-    SIGNATURE_HEADER,
-    Event,
-    EventRequest,
-    EventType,
-    WebhookEvent,
-    Webhooks,
-    construct_event,
-    verify_signature,
-)
 
 # Headline message classes — most callers reach for these. Everything else lives
 # in :mod:`transcodely.types`.
@@ -68,11 +55,18 @@ from .types import (
     App,
     AudioTrackConfig,
     AutoABRConfig,
+    ChapterPoint,
+    ChapterResult,
+    ClipConfig,
     ContentAwareConfig,
     DASHConfig,
     DRMConfig,
     HDRConfig,
     HLSConfig,
+    Invoice,
+    InvoiceLineItem,
+    InvoiceLineType,
+    InvoiceStatus,
     Job,
     JobOutput,
     JobPriority,
@@ -87,6 +81,7 @@ from .types import (
     PresetVariant,
     Resolution,
     StreamingConfig,
+    SubtitleResult,
     SubtitleTrack,
     ThumbnailResult,
     ThumbnailSpec,
@@ -95,16 +90,36 @@ from .types import (
     Video,
     VideoCodec,
     VideoRendition,
+    VideoTextTrack,
     VideoVariant,
     WatchEventType,
     WatchJobResponse,
     WatchVideoResponse,
+    WatermarkConfig,
     WebhookDelivery,
     WebhookEndpoint,
 )
+from .version import API_VERSION, DEFAULT_BASE_URL, SDK_VERSION
+from .webhooks import (
+    DEFAULT_TOLERANCE_SECONDS,
+    EVENT_ID_HEADER,
+    SIGNATURE_HEADER,
+    Event,
+    EventRequest,
+    EventType,
+    WebhookEvent,
+    Webhooks,
+    construct_event,
+    verify_signature,
+)
 
 __all__ = [
     "API_VERSION",
+    "DEFAULT_BASE_URL",
+    "DEFAULT_TOLERANCE_SECONDS",
+    "EVENT_ID_HEADER",
+    "SDK_VERSION",
+    "SIGNATURE_HEADER",
     "APIConnectionError",
     "APIError",
     "APIKey",
@@ -112,21 +127,24 @@ __all__ = [
     "AudioTrackConfig",
     "AuthenticationError",
     "AutoABRConfig",
+    "ChapterPoint",
+    "ChapterResult",
+    "ClipConfig",
     "ConflictError",
-    "construct_event",
     "ContentAwareConfig",
     "DASHConfig",
-    "DEFAULT_BASE_URL",
-    "DEFAULT_TOLERANCE_SECONDS",
     "DRMConfig",
     "Event",
-    "EVENT_ID_HEADER",
     "EventRequest",
     "EventType",
     "FieldViolation",
     "HDRConfig",
     "HLSConfig",
     "InvalidRequestError",
+    "Invoice",
+    "InvoiceLineItem",
+    "InvoiceLineType",
+    "InvoiceStatus",
     "Job",
     "JobOutput",
     "JobPriority",
@@ -146,9 +164,8 @@ __all__ = [
     "PresetVariant",
     "RateLimitError",
     "Resolution",
-    "SDK_VERSION",
-    "SIGNATURE_HEADER",
     "StreamingConfig",
+    "SubtitleResult",
     "SubtitleTrack",
     "ThumbnailResult",
     "ThumbnailSpec",
@@ -156,20 +173,23 @@ __all__ = [
     "TranscodelyError",
     "User",
     "UserWithOrganizations",
-    "verify_signature",
     "Video",
     "VideoCodec",
     "VideoRendition",
+    "VideoTextTrack",
     "VideoVariant",
     "WatchEventType",
     "WatchJobResponse",
     "WatchVideoResponse",
+    "WatermarkConfig",
     "WebhookDelivery",
     "WebhookEndpoint",
     "WebhookError",
     "WebhookEvent",
     "WebhookPayloadError",
-    "Webhooks",
     "WebhookSignatureError",
     "WebhookTimestampError",
+    "Webhooks",
+    "construct_event",
+    "verify_signature",
 ]

{transcodely-0.3.1 → transcodely-0.3.3}/src/transcodely/_codec/json_codec.py

@@ -132,9 +132,8 @@ def _transform_field(
             parent[key] = _apply_enum(v, field.enum_type, mode)
         return
 
-    if field.type == FieldDescriptor.TYPE_MESSAGE:
-        if isinstance(v, dict):
-            transform_enums_in_dict(v, field.message_type, mode=mode)
+    if field.type == FieldDescriptor.TYPE_MESSAGE and isinstance(v, dict):
+        transform_enums_in_dict(v, field.message_type, mode=mode)
 
 
 def _apply_enum(value: str, enum_desc: EnumDescriptor, mode: str) -> str:

{transcodely-0.3.1 → transcodely-0.3.3}/src/transcodely/_transport/error_mapping.py

@@ -3,7 +3,8 @@
 from __future__ import annotations
 
 import json
-from typing import Any, Mapping, Optional
+from collections.abc import Mapping
+from typing import Any
 
 from ..errors import (
     APIConnectionError,
@@ -55,7 +56,7 @@ def map_http_error(*, status: int, body: Any, headers: Mapping[str, str]) -> Tra
         return InvalidRequestError(message, **kwargs)
     if status == 429:
         retry_after = _header(headers, "retry-after")
-        retry_after_ms: Optional[int] = None
+        retry_after_ms: int | None = None
         if retry_after:
             try:
                 retry_after_ms = max(0, int(retry_after) * 1000)
@@ -69,7 +70,7 @@ def map_http_error(*, status: int, body: Any, headers: Mapping[str, str]) -> Tra
     return APIError(message, **kwargs)
 
 
-def connection_error(cause: BaseException, message: Optional[str] = None) -> APIConnectionError:
+def connection_error(cause: BaseException, message: str | None = None) -> APIConnectionError:
     msg = message or str(cause) or "network request failed"
     err = APIConnectionError(msg)
     err.__cause__ = cause
@@ -82,21 +83,21 @@ def _parse_body(body: Any) -> dict[str, Any]:
     if isinstance(body, (bytes, bytearray)):
         try:
             return json.loads(body.decode("utf-8"))
-        except Exception:
+        except (UnicodeDecodeError, json.JSONDecodeError):
             return {"message": body.decode("utf-8", errors="replace")}
     if isinstance(body, str):
         try:
             return json.loads(body)
-        except Exception:
+        except json.JSONDecodeError:
             return {"message": body}
     return {}
 
 
-def _header(headers: Mapping[str, str], key: str) -> Optional[str]:
+def _header(headers: Mapping[str, str], key: str) -> str | None:
     # httpx headers are case-insensitive but expose .get with the lowercase form.
     if hasattr(headers, "get"):
         try:
             return headers.get(key) or headers.get(key.title())
-        except Exception:
+        except Exception:  # noqa: BLE001 — headers may be any duck-typed mapping
             return None
     return None

{transcodely-0.3.1 → transcodely-0.3.3}/src/transcodely/_transport/transport.py

@@ -19,11 +19,13 @@ from __future__ import annotations
 import random
 import struct
 import time
+from collections.abc import Callable, Generator, Iterable
 from dataclasses import dataclass, field
-from typing import Any, Callable, Generator, Iterable, Optional, TypeVar
+from typing import Any, TypeVar
 
 import httpx
 from google.protobuf.message import Message
+from typing_extensions import Self
 
 from .._codec import json_codec
 from ..errors import RateLimitError, TranscodelyError
@@ -39,10 +41,10 @@ TRes = TypeVar("TRes", bound=Message)
 class CallOptions:
     """Per-call overrides for timeout, retries, idempotency, headers."""
 
-    timeout: Optional[float] = None
-    max_retries: Optional[int] = None
-    idempotency_key: Optional[str] = None
-    api_version: Optional[str] = None
+    timeout: float | None = None
+    max_retries: int | None = None
+    idempotency_key: str | None = None
+    api_version: str | None = None
     headers: dict[str, str] = field(default_factory=dict)
 
 
@@ -52,9 +54,9 @@ class LogEvent:
     method: str
     duration_ms: int
     attempt: int
-    status: Optional[int] = None
-    request_id: Optional[str] = None
-    error: Optional[TranscodelyError] = None
+    status: int | None = None
+    request_id: str | None = None
+    error: TranscodelyError | None = None
 
 
 _WRITE_PREFIXES = ("Create", "Update", "Delete", "Cancel", "Confirm", "Revoke", "Archive", "Enable")
@@ -71,17 +73,19 @@ class Transport:
         self,
         api_key: str,
         *,
-        base_url: Optional[str] = None,
+        organization_id: str | None = None,
+        base_url: str | None = None,
         timeout: float = 30.0,
         max_retries: int = 3,
-        api_version: Optional[str] = None,
-        default_headers: Optional[dict[str, str]] = None,
-        http_client: Optional[httpx.Client] = None,
-        logger: Optional[Callable[[LogEvent], None]] = None,
+        api_version: str | None = None,
+        default_headers: dict[str, str] | None = None,
+        http_client: httpx.Client | None = None,
+        logger: Callable[[LogEvent], None] | None = None,
     ) -> None:
         if not api_key:
             raise ValueError("Transcodely: api_key is required")
         self.api_key = api_key
+        self.organization_id = organization_id
         self.base_url = (base_url or DEFAULT_BASE_URL).rstrip("/")
         self.timeout = timeout
         self.max_retries = max_retries
@@ -91,16 +95,16 @@ class Transport:
         self._owns_client = http_client is None
         self._logger = logger
         #: ID of the most recent successful or failed request, Stripe-style.
-        self.last_request_id: Optional[str] = None
+        self.last_request_id: str | None = None
 
     def close(self) -> None:
         if self._owns_client:
             self._client.close()
 
-    def __enter__(self) -> "Transport":
+    def __enter__(self) -> Self:
         return self
 
-    def __exit__(self, *args: Any) -> None:
+    def __exit__(self, *args: object) -> None:
         self.close()
 
     # ---------- unary ----------
@@ -111,7 +115,7 @@ class Transport:
         method_name: str,
         request: Message,
         response: TRes,
-        opts: Optional[CallOptions] = None,
+        opts: CallOptions | None = None,
     ) -> TRes:
         opts = opts or CallOptions()
         url = f"{self.base_url}/{service_name}/{method_name}"
@@ -161,7 +165,7 @@ class Transport:
         method_name: str,
         request: Message,
         response_factory: Callable[[], TRes],
-        opts: Optional[CallOptions] = None,
+        opts: CallOptions | None = None,
     ) -> Generator[TRes, None, None]:
         opts = opts or CallOptions()
         url = f"{self.base_url}/{service_name}/{method_name}"
@@ -207,7 +211,7 @@ class Transport:
         self,
         opts: CallOptions,
         content_type: str,
-        idempotency_key: Optional[str] = None,
+        idempotency_key: str | None = None,
     ) -> dict[str, str]:
         headers = {
             "content-type": content_type,
@@ -218,6 +222,8 @@ class Transport:
             "transcodely-version": opts.api_version or self.api_version,
             "accept": content_type,
         }
+        if self.organization_id:
+            headers["x-organization-id"] = self.organization_id
         if idempotency_key:
             headers["idempotency-key"] = idempotency_key
         headers.update(self.default_headers)
@@ -228,7 +234,7 @@ class Transport:
         if self._logger is not None:
             try:
                 self._logger(event)
-            except Exception:
+            except Exception:  # noqa: BLE001, S110 — a caller's logger must never break requests
                 pass
 
     def _with_retry(
@@ -239,7 +245,7 @@ class Transport:
         fn: Callable[[int], TRes],
     ) -> TRes:
         max_retries = opts.max_retries if opts.max_retries is not None else self.max_retries
-        last_error: Optional[BaseException] = None
+        last_error: BaseException | None = None
         for attempt in range(1, max_retries + 2):
             try:
                 return fn(attempt)
@@ -260,9 +266,7 @@ def _is_retryable(exc: BaseException) -> bool:
         return True
     if exc.__class__.__name__ == "APIConnectionError":
         return True
-    if exc.http_status is not None and exc.http_status >= 500:
-        return True
-    return False
+    return exc.http_status is not None and exc.http_status >= 500
 
 
 def _sleep_backoff(attempt: int, exc: BaseException) -> None:
@@ -308,5 +312,5 @@ def _try_json(data: bytes) -> Any:
         import json
 
         return json.loads(data.decode("utf-8"))
-    except Exception:
+    except (UnicodeDecodeError, json.JSONDecodeError):
         return data.decode("utf-8", errors="replace")