Merge pull request #101 from apivideo/ai-summary-updates

Update Summary endpoints

Author: bot-api-video

.openapi-generator/oas_apivideo.yaml-defaut-cli.sha256

@@ -1 +1 @@
-589578120105165c9f58683fbe2fb917dabfaf9392187865f30956f8e4964d5a
+f2258a85e4233a4243aa1514697cbb72ab9568d8bc147a0ba046e979c1e7bcf9

ApiVideoClient.podspec

@@ -5,8 +5,8 @@ Pod::Spec.new do |s|
   s.tvos.deployment_target = '10.0'
   # Add back when CocoaPods/CocoaPods#11558 is released
   #s.watchos.deployment_target = '3.0'
-  s.version = '1.3.6'
-  s.source = { :git => 'https://github.com/apivideo/api.video-swift-client', :tag => 'v1.3.6' }
+  s.version = '1.3.7'
+  s.source = { :git => 'https://github.com/apivideo/api.video-swift-client', :tag => 'v1.3.7' }
   s.authors = { 'Ecosystem Team' => 'ecosystem@api.video' }
   s.license = { :type => 'MIT' }
   s.homepage = 'https://docs.api.video'

CHANGELOG.md

@@ -1,6 +1,9 @@
 # Changelog
 All changes to this project will be documented in this file.
 
+## [1.3.7] - 2024-11-06
+- AI summary updates
+
 ## [1.3.6] - 2024-11-04
 - Analytics updates (ccv, views, ...)
 

README.md

@@ -57,14 +57,14 @@ api.video's Swift API client for iOS, macOS and tvOS streamlines the coding proc
 Specify it in your `Cartfile`:
 
 ```
-github "apivideo/api.video-swift-client" ~> 1.3.6
+github "apivideo/api.video-swift-client" ~> 1.3.7
 ```
 
 Run `carthage update`
 
 #### CocoaPods
 
-Add `pod 'ApiVideoClient', '1.3.6'` in your `Podfile`
+Add `pod 'ApiVideoClient', '1.3.7'` in your `Podfile`
 
 Run `pod install`
 

Sources/APIs.swift

@@ -8,7 +8,7 @@ import Foundation
 public class ApiVideoClient {
     public static var apiKey: String? = nil
     public static var basePath = "https://ws.api.video"
-    internal static var customHeaders:[String: String] = ["AV-Origin-Client": "swift:1.3.6"]
+    internal static var customHeaders:[String: String] = ["AV-Origin-Client": "swift:1.3.7"]
     private static var chunkSize: Int = 50 * 1024 * 1024
     internal static var requestBuilderFactory: RequestBuilderFactory = AlamofireRequestBuilderFactory()
     internal static var credential = ApiVideoCredential()

Sources/APIs/SummariesAPI.swift

@@ -47,7 +47,7 @@ open class SummariesAPI {
     /**
      Generate video summary
      - POST /summaries
-     - Generate a title, abstract, and key takeaways for a video.
+     - Generate an abstract and key takeaways for a video.
      - responseHeaders: [X-RateLimit-Limit(Int), X-RateLimit-Remaining(Int), X-RateLimit-Retry-After(Int)]
      - parameter summaryCreationPayload: (body)  
      - returns: RequestBuilder<Summary> 
@@ -108,7 +108,7 @@ open class SummariesAPI {
     /**
      Update summary details
      - PATCH /summaries/{summaryId}/source
-     - Update details for a summary. Note that this operation is only allowed for summary objects where `sourceStatus` is `missing`.
+     - Update details for a summary.
      - responseHeaders: [X-RateLimit-Limit(Int), X-RateLimit-Remaining(Int), X-RateLimit-Retry-After(Int)]
      - parameter summaryId: (path) The unique identifier of the summary source you want to update. 
      - parameter summaryUpdatePayload: (body)  

Sources/Models/SummaryCreationPayload.swift

@@ -15,19 +15,27 @@ public struct SummaryCreationPayload: Codable, Hashable {
     public enum Origin: String, Codable, CaseIterable {
         case auto = "auto"
     }
+    public enum Attributes: String, Codable, CaseIterable {
+        case abstract = "abstract"
+        case takeaways = "takeaways"
+    }
     /** Create a summary of a video using the video ID. */
     public var videoId: String
     /** Use this parameter to define how the API generates the summary. The only allowed value is `auto`, which means that the API generates a summary automatically.  If you do not set this parameter, **the API will not generate a summary automatically**.  In this case, `sourceStatus` will return `missing`, and you have to manually add a summary using the `PATCH /summaries/{summaryId}/source` endpoint operation. */
     public var origin: Origin?
+    /** Use this parameter to define the elements of a summary that you want to generate. If you do not define this parameter, the API generates a full summary with all attributes. */
+    public var attributes: [Attributes]?
 
-    public init(videoId: String, origin: Origin? = nil) {
+    public init(videoId: String, origin: Origin? = nil, attributes: [Attributes]? = nil) {
         self.videoId = videoId
         self.origin = origin
+        self.attributes = attributes
     }
 
     public enum CodingKeys: String, CodingKey, CaseIterable {
         case videoId
         case origin
+        case attributes
     }
 
     // Encodable protocol methods
@@ -36,6 +44,7 @@ public struct SummaryCreationPayload: Codable, Hashable {
         var container = encoder.container(keyedBy: CodingKeys.self)
         try container.encode(videoId, forKey: .videoId)
         try container.encodeIfPresent(origin, forKey: .origin)
+        try container.encodeIfPresent(attributes, forKey: .attributes)
     }
 }
 

Sources/Models/SummarySource.swift

@@ -12,21 +12,17 @@ import AnyCodable
 
 public struct SummarySource: Codable, Hashable {
 
-    /** A video title, based on the contents of the video. */
-    public var title: String?
     /** A short outline of the contents of the video. The length of an `abstract` depends on the amount of content in a video that can be transcribed. The API condenses the contents into minimum 20, maximum 300 words. */
     public var abstract: String?
     /** A list of 3 key points from the video, in chronological order. */
     public var takeaways: [String]?
 
-    public init(title: String? = nil, abstract: String? = nil, takeaways: [String]? = nil) {
-        self.title = title
+    public init(abstract: String? = nil, takeaways: [String]? = nil) {
         self.abstract = abstract
         self.takeaways = takeaways
     }
 
     public enum CodingKeys: String, CodingKey, CaseIterable {
-        case title
         case abstract
         case takeaways
     }
@@ -35,7 +31,6 @@ public struct SummarySource: Codable, Hashable {
 
     public func encode(to encoder: Encoder) throws {
         var container = encoder.container(keyedBy: CodingKeys.self)
-        try container.encodeIfPresent(title, forKey: .title)
         try container.encodeIfPresent(abstract, forKey: .abstract)
         try container.encodeIfPresent(takeaways, forKey: .takeaways)
     }

Sources/Models/SummaryUpdatePayload.swift

@@ -12,21 +12,17 @@ import AnyCodable
 
 public struct SummaryUpdatePayload: Codable, Hashable {
 
-    /** A video title, based on the contents of the video. */
-    public var title: String?
     /** A short outline of the contents of the video. */
     public var abstract: String?
     /** A list of 3 key points from the video, in chronological order. */
     public var takeaways: [String]?
 
-    public init(title: String? = nil, abstract: String? = nil, takeaways: [String]? = nil) {
-        self.title = title
+    public init(abstract: String? = nil, takeaways: [String]? = nil) {
         self.abstract = abstract
         self.takeaways = takeaways
     }
 
     public enum CodingKeys: String, CodingKey, CaseIterable {
-        case title
         case abstract
         case takeaways
     }
@@ -35,7 +31,6 @@ public struct SummaryUpdatePayload: Codable, Hashable {
 
     public func encode(to encoder: Encoder) throws {
         var container = encoder.container(keyedBy: CodingKeys.self)
-        try container.encodeIfPresent(title, forKey: .title)
         try container.encodeIfPresent(abstract, forKey: .abstract)
         try container.encodeIfPresent(takeaways, forKey: .takeaways)
     }

Sources/Models/VideoCreationPayload.swift

@@ -47,6 +47,10 @@ public struct VideoCreationPayload: Codable, Hashable {
         case vi = "vi"
         case zh = "zh"
     }
+    public enum TranscriptSummaryAttributes: String, Codable, CaseIterable {
+        case abstract = "abstract"
+        case takeaways = "takeaways"
+    }
     /** The title of your new video. */
     public var title: String
     /** A brief description of your video. */
@@ -73,8 +77,10 @@ public struct VideoCreationPayload: Codable, Hashable {
     public var transcript: Bool?
     /** Use this parameter to enable summarization. We recommend using this parameter together with `transcript: true`.  - When `true`, the API generates a summary for the video, based on the transcription. - The default value is `false`. - If you define a video language using the `language` parameter, the API uses that language to summarize the video. If you do not define a language, the API detects it based on the video. */
     public var transcriptSummary: Bool?
+    /** Use this parameter to define the elements of a summary that you want to generate. If you do not define this parameter, the API generates a full summary with all attributes. */
+    public var transcriptSummaryAttributes: [TranscriptSummaryAttributes]?
 
-    public init(title: String, description: String? = nil, source: String? = nil, _public: Bool? = true, panoramic: Bool? = false, mp4Support: Bool? = true, playerId: String? = nil, tags: [String]? = nil, metadata: [Metadata]? = nil, clip: VideoClip? = nil, watermark: VideoWatermark? = nil, language: Language? = nil, transcript: Bool? = nil, transcriptSummary: Bool? = nil) {
+    public init(title: String, description: String? = nil, source: String? = nil, _public: Bool? = true, panoramic: Bool? = false, mp4Support: Bool? = true, playerId: String? = nil, tags: [String]? = nil, metadata: [Metadata]? = nil, clip: VideoClip? = nil, watermark: VideoWatermark? = nil, language: Language? = nil, transcript: Bool? = nil, transcriptSummary: Bool? = nil, transcriptSummaryAttributes: [TranscriptSummaryAttributes]? = nil) {
         self.title = title
         self.description = description
         self.source = source
@@ -89,6 +95,7 @@ public struct VideoCreationPayload: Codable, Hashable {
         self.language = language
         self.transcript = transcript
         self.transcriptSummary = transcriptSummary
+        self.transcriptSummaryAttributes = transcriptSummaryAttributes
     }
 
     public enum CodingKeys: String, CodingKey, CaseIterable {
@@ -106,6 +113,7 @@ public struct VideoCreationPayload: Codable, Hashable {
         case language
         case transcript
         case transcriptSummary
+        case transcriptSummaryAttributes
     }
 
     // Encodable protocol methods
@@ -126,6 +134,7 @@ public struct VideoCreationPayload: Codable, Hashable {
         try container.encodeIfPresent(language, forKey: .language)
         try container.encodeIfPresent(transcript, forKey: .transcript)
         try container.encodeIfPresent(transcriptSummary, forKey: .transcriptSummary)
+        try container.encodeIfPresent(transcriptSummaryAttributes, forKey: .transcriptSummaryAttributes)
     }
 }