codai-sdk 0.70.0__tar.gz → 0.71.0__tar.gz

{codai_sdk-0.70.0 → codai_sdk-0.71.0}/CHANGELOG.md

@@ -6,6 +6,12 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.71.0] - 2026-10-24
+
+- `productions.create(kind=..., duration_s=...)`: 8 production kinds (video, image, deck, doc, sheet, audio,
+  carousel, print) and a 15-60 s target length for video; non-video responses carry `kind`, `output_asset_id` and
+  `outputs`.
+
 ## [0.70.0] - 2026-10-24
 
 - `vault.resolve_challenge()` (`POST /v1/vault/resolve/challenge`) and a required `proof` on `vault.resolve()`: local

{codai_sdk-0.70.0 → codai_sdk-0.71.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: codai-sdk
-Version: 0.70.0
+Version: 0.71.0
 Summary: Official Python SDK for the codai AI gateway — chat, messages, responses, streaming, agents, sessions, hosts, tasks, account.
 Project-URL: Homepage, https://codai.ro
 Project-URL: Repository, https://github.com/codai-ro/codai-sdk-python

{codai_sdk-0.70.0 → codai_sdk-0.71.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "codai-sdk"
-version = "0.70.0"
+version = "0.71.0"
 description = "Official Python SDK for the codai AI gateway — chat, messages, responses, streaming, agents, sessions, hosts, tasks, account."
 readme = "README.md"
 

{codai_sdk-0.70.0 → codai_sdk-0.71.0}/src/codai/__init__.py

@@ -172,7 +172,7 @@ __all__ = [
     "vault_resolve_message",
     "vault_unlock_message",
 ]
-__version__ = "0.70.0"
+__version__ = "0.71.0"
 class _CallableGroup:
     """A resource group that is also callable — keeps ``client.chat(...)``,
     ``client.embeddings(...)``, ``client.models()`` and ``client.feedback(...)``

{codai_sdk-0.70.0 → codai_sdk-0.71.0}/src/codai/_types.py

@@ -2518,14 +2518,20 @@ class MediaOpJob(TypedDict):
     updated_at: str
 
 
+# What the production builds: `video` (MP4), `image` (PNG), `deck` (PPTX), `doc` (DOCX), `sheet` (XLSX), `audio`…
+StudioProductionKind = Literal['video', 'image', 'deck', 'doc', 'sheet', 'audio', 'carousel', 'print']
+
+
 class _StudioProductionCreateRequired(TypedDict):
     brief: str
 
 
 class StudioProductionCreate(_StudioProductionCreateRequired, total=False):
     """Studio production request"""
+    kind: StudioProductionKind
     language: Literal['en', 'ro']
     aspect_ratio: Literal['16:9', '9:16', '1:1']
+    duration_s: int
     starter: str
     voice: str
     narration: bool
@@ -2539,8 +2545,24 @@ class StudioProductionQa(TypedDict, total=False):
     skipped: str
 
 
-class StudioProduction(TypedDict):
-    """Studio production"""
+class StudioProductionOutput(TypedDict):
+    """A built output of a non-video production: the regular Studio asset plus its `role`. `url` is a 1 h signed GET,…"""
+    asset_id: str
+    kind: AssetKind
+    status: Literal['pending', 'ready', 'failed', 'deleted']
+    model: str
+    url: Optional[str]
+    mime_type: str
+    bytes: int
+    duration_seconds: Optional[float]
+    width: Optional[int]
+    height: Optional[int]
+    created_at: str
+    expires_at: Optional[str]
+    role: Literal['image', 'cover', 'document', 'pages', 'pdf', 'audio']
+
+
+class _StudioProductionRequired(TypedDict):
     id: str
     object: Literal['studio.production']
     status: Literal['running', 'succeeded', 'failed']
@@ -2562,6 +2584,14 @@ class StudioProduction(TypedDict):
     created_at: str
 
 
+class StudioProduction(_StudioProductionRequired, total=False):
+    """Studio production"""
+    duration_s: Optional[int]
+    kind: StudioProductionKind
+    output_asset_id: Optional[str]
+    outputs: List[StudioProductionOutput]
+
+
 class _MusicRoomCreateRequired(TypedDict):
     brief: str
 
@@ -5745,7 +5775,7 @@ class AccountPatchResponse(TypedDict):
     training_opt_out: bool
     consents: List[AccountConsent]
     username_error: Optional[Literal['invalid', 'taken', 'change_limit']]
-    referral_result: Optional[Literal['window_closed', 'none', 'invalid_code', 'self', 'already_referred', 'flagged', 'granted', 'cap_reached']]
+    referral_result: Optional[Literal['window_closed', 'none', 'invalid_code', 'self', 'already_referred', 'flagged', 'pending_payment', 'granted', 'cap_reached']]
 
 
 class BillingSubscription(TypedDict):
@@ -10832,6 +10862,8 @@ __all__ = [
     'StudioPostCopyRequest',
     'StudioProduction',
     'StudioProductionCreate',
+    'StudioProductionKind',
+    'StudioProductionOutput',
     'StudioProductionQa',
     'StudioPublicDecisionRequest',
     'StudioPublicNameRequest',

{codai_sdk-0.70.0 → codai_sdk-0.71.0}/src/codai/resources/productions.py

@@ -1,10 +1,16 @@
-"""``/v1/studio/productions`` — codai Studio brief → finished promo video (RC-20): one model turn storyboards the brief
-on a built-in video starter, every scene gets an image and a voice-over line, the result is saved as an editable
-creative and a draft render is queued; a vision review may fix text once.
+"""``/v1/studio/productions`` — codai Studio brief → finished output (RC-20), one of 8 kinds (``kind``, default
+``video``): ``video`` (MP4 render), ``image`` (PNG), ``deck`` (PPTX), ``doc`` (DOCX), ``sheet`` (XLSX), ``carousel``
+(ZIP of PNG slides + cover PNG), ``print`` (A4/A5 PDF) and ``audio`` (MP3 jingle or song).
 
-``create`` returns 202 ``{id, status: "running", phase}`` after the render is queued (about a minute), ``retrieve``
+``video``: one model turn storyboards the brief on a built-in video starter, every scene gets an image and a voice-over
+line, the result is saved as an editable creative and a draft render is queued; a vision review may fix text once.
+Other kinds: one plan turn, generated images or music, an editable creative and the output built by the Studio
+builders; the response adds ``kind``, ``output_asset_id`` and ``outputs`` (Studio assets with a ``role``).
+``starter``, ``voice``, ``narration`` and ``aspect_ratio`` apply to ``video`` only.
+
+``create`` returns 202 ``{id, status: "running", phase}`` after the output is queued (about a minute), ``retrieve``
 advances and reads it, ``wait`` polls until ``succeeded`` / ``failed`` and ``run`` does ``create`` + ``wait``. The
-storyboard and review turns are token-metered; images, voice-over and renders are billed at their usual prices;
+plan and review turns are token-metered; images, music, voice-over and renders are billed at their usual prices;
 ``budget_micro_usd`` (default 3,000,000 = $3) caps the whole production.
 """
 
@@ -45,12 +51,17 @@ class Productions(Resource):
         title: Optional[str] = None,
         idempotency_key: Optional[str] = None,
         ext: Optional[RequestExtensions] = None,
+        kind: Optional[str] = None,
+        duration_s: Optional[int] = None,
     ) -> Dict[str, Any]:
-        """``POST /v1/studio/productions`` — storyboard + images + voice-over + creative + queued draft render."""
+        """``POST /v1/studio/productions`` — plan + images / music + creative + the output being built
+        (``kind``: video | image | deck | doc | sheet | audio | carousel | print, default video)."""
         body: Dict[str, Any] = {"brief": brief}
         for k, v in (
+            ("kind", kind),
             ("language", language),
             ("aspect_ratio", aspect_ratio),
+            ("duration_s", duration_s),
             ("starter", starter),
             ("voice", voice),
             ("narration", narration),

{codai_sdk-0.70.0 → codai_sdk-0.71.0}/tests/test_resources.py

@@ -24,7 +24,7 @@ def _chat_response(content="PONG", tool_calls=None):
 
 
 def test_version():
-    assert codai.__version__ == "0.70.0"
+    assert codai.__version__ == "0.71.0"
 def test_chat_completions_create(client, stub):
     stub.reply(
         200,