feat(api): deprecate Sora video APIs (#3610)

## Summary

Deprecate Sora video APIs before their September shutdown

Co-authored-by: apcha-oai <228803254+apcha-oai@users.noreply.github.com>

Author: apcha-oai

.castiron.stats.yml

@@ -1,6 +1,6 @@
 schema_version: 1
-generation_id: ec060161-a32a-42d7-99f3-6dd062ed3fea
-openapi_spec_hash: 971c659b020aa37865787aa082cc4159
-openapi_transformed_spec_hash: 75836bac7e1a2e2632c2709238aa355c
-config_hash: 4617b0962f16d328804312ac81aac630
-codegen_sha: a019f44ece72b97bd941243068cb5ccb2a926f8a
+generation_id: 625cc75a-e869-4197-b1a1-0ab0f2dd58bf
+openapi_spec_hash: 9b793011794d783fd6a2d71d8a6f6972
+openapi_transformed_spec_hash: 89ade65e8a3170ca977f145feda2a689
+config_hash: fcda4ecfe265daddba6fad25a8504a3f
+codegen_sha: 25f5de7c38e1809ac8576f80aba10db4a6c01df0

api_reference/openapi.transformed.yml

@@ -22529,6 +22529,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/VideoResource'
+      deprecated: true
       x-oaiMeta:
         name: Create video
         group: videos
@@ -22651,6 +22652,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/VideoListResource'
+      deprecated: true
       x-oaiMeta:
         name: List videos
         group: videos
@@ -22753,6 +22755,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/VideoCharacterResource'
+      deprecated: true
       description: Create a character from an uploaded video.
   /videos/characters/{character_id}:
     get:
@@ -22775,6 +22778,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/VideoCharacterResource'
+      deprecated: true
       description: Fetch a character.
   /videos/edits:
     post:
@@ -22795,6 +22799,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/VideoResource'
+      deprecated: true
       description: Create a new video generation job by editing a source video or existing generated video.
   /videos/extensions:
     post:
@@ -22815,6 +22820,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/VideoResource'
+      deprecated: true
       description: Create an extension of a completed video.
   /videos/{video_id}:
     get:
@@ -22837,6 +22843,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/VideoResource'
+      deprecated: true
       x-oaiMeta:
         name: Retrieve video
         group: videos
@@ -22924,6 +22931,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/DeletedVideoResource'
+      deprecated: true
       x-oaiMeta:
         name: Delete video
         group: videos
@@ -23026,6 +23034,7 @@ paths:
             application/json:
               schema:
                 type: string
+      deprecated: true
       x-oaiMeta:
         name: Retrieve video content
         group: videos
@@ -23136,6 +23145,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/VideoResource'
+      deprecated: true
       x-oaiMeta:
         name: Remix video
         group: videos

examples/video.py

@@ -8,7 +8,7 @@
 
 
 async def main() -> None:
-    video = await client.videos.create_and_poll(
+    video = await client.videos.create_and_poll(  # pyright: ignore[reportDeprecated]
         model="sora-2",
         prompt="A video of the words 'Thank you' in sparkling letters",
     )