runapi-wan 0.2.1 → 0.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 58ddd07b634957ee384f916a55109d078319e93f2da84890ade05c489385ef7d
-  data.tar.gz: df3040b71cbc5ad6772c6b4c1c943233574e00fb9e042220153ba049face8f78
+  metadata.gz: dbc05521adf750d4146cf35031cc55dad92fd762f83048f56cb5083e702e0d4f
+  data.tar.gz: b717b95a9b712d242de851922717953f0b6ef8dd7a77b70ccce17c169343287e
 SHA512:
-  metadata.gz: 49fcb5460b62be7ef89e08338d62d66cabe9d050a3f7c0a8295ffb8b9b81ca25231268959be608509493ee9af9fe8fcc804596651e6e60ca6278d6e4b8020c29
-  data.tar.gz: 232c68bef5d41e8d5274232aeaa5f252b1fb5f4b6abb690c9c2dc637d7cc3db94aab3002ca7dd88cf2080edfe54a632f19f50f6e1baa92a4d51cdf6d734b69d6
+  metadata.gz: c4b5da04973ec6bde472f9ea0fd9cb746b749855a6292e69edeb0b08b303d8a7056d058a019e4de209d3a56f60091e756b9e6d566ffc68ae942273acf4063c55
+  data.tar.gz: b94bac6024b1adb20f4c8500b1e0e14f15f09344bb55a81285cbca87d1cb8feef4c35c9e6653d1f58cd904a1662550b753732f166d7e54a47e0dc141b5d90e94

data/README.md

@@ -0,0 +1,43 @@
+# Wan Video API Ruby SDK for RunAPI
+
+The wan video api Ruby SDK is the language-specific package for Wan on RunAPI. Use this wan video api package for text-to-video, image-to-video, animation, and video editing flows when your application needs JSON request bodies, task status lookup, and consistent RunAPI errors in Ruby.
+
+This wan video api README is the Ruby package guide inside the public `wan-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/wan; for API reference, use https://runapi.ai/docs#wan; for SDK docs, use https://runapi.ai/docs#sdk-wan.
+
+## Install
+
+```bash
+gem install runapi-wan
+```
+
+## Quick start
+
+```ruby
+require "runapi-wan"
+
+client = RunApi::Wan::Client.new
+task = client.text_to_video.create(
+  # Pass the Wan JSON request body from https://runapi.ai/docs#wan.
+)
+status = client.text_to_video.get(task.id)
+```
+
+Use `create` when you want to submit a task and return quickly, `get` when you need the latest task state, and `run` when a script should create and poll until completion. In web request handlers, prefer `create` plus webhook or later `get` polling so a worker is not held open.
+
+## Language notes
+
+Use Ruby keyword arguments and the `RunApi::Wan` error classes when building video jobs, Rails workers, or scripts. The available resources include text to videos, image to videos, speech to videos, animations, images, and video edits. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.
+
+## Links
+
+- Model page: https://runapi.ai/models/wan
+- SDK docs: https://runapi.ai/docs#sdk-wan
+- Product docs: https://runapi.ai/docs#wan
+- Pricing and rate limits: https://runapi.ai/models/wan/2.2-a14b-text-to-video-turbo
+- Provider comparison: https://runapi.ai/providers/alibaba
+- Full catalog: https://runapi.ai/models
+- Repository: https://github.com/runapi-ai/wan-sdk
+
+## License
+
+Licensed under the Apache License, Version 2.0.

data/lib/runapi/wan/client.rb

@@ -3,8 +3,8 @@
 module RunApi
   module Wan
     class Client
-      attr_reader :text_to_video, :image_to_video, :video_to_video,
-        :speech_to_video, :animate, :text_to_image, :reference_to_video, :edit_video
+      attr_reader :text_to_video, :image_to_video,
+        :speech_to_video, :animate, :text_to_image, :edit_video
 
       def initialize(api_key: nil, **options)
         @api_key = Core::Auth.resolve_api_key(api_key)
@@ -14,11 +14,9 @@ module RunApi
 
         @text_to_video = Resources::TextToVideo.new(http)
         @image_to_video = Resources::ImageToVideo.new(http)
-        @video_to_video = Resources::VideoToVideo.new(http)
         @speech_to_video = Resources::SpeechToVideo.new(http)
         @animate = Resources::Animate.new(http)
         @text_to_image = Resources::TextToImage.new(http)
-        @reference_to_video = Resources::ReferenceToVideo.new(http)
         @edit_video = Resources::EditVideo.new(http)
       end
     end

data/lib/runapi/wan/resources/animate.rb

@@ -33,8 +33,8 @@ module RunApi
 
         def validate_params!(params)
           raise Core::ValidationError, "model is required" unless param(params, :model)
-          raise Core::ValidationError, "video_url is required" unless param(params, :video_url)
-          raise Core::ValidationError, "image_url is required" unless param(params, :image_url)
+          raise Core::ValidationError, "source_image_url is required" unless param(params, :source_image_url)
+          raise Core::ValidationError, "reference_video_url is required" unless param(params, :reference_video_url)
 
           model = param(params, :model)
           unless Types::ANIMATE_MODELS.include?(model)

data/lib/runapi/wan/resources/edit_video.rb

@@ -33,12 +33,19 @@ module RunApi
 
         def validate_params!(params)
           raise Core::ValidationError, "model is required" unless param(params, :model)
-          raise Core::ValidationError, "video_url is required" unless param(params, :video_url)
 
           model = param(params, :model)
           unless Types::EDIT_VIDEO_MODELS.include?(model)
             raise Core::ValidationError, "Invalid model: #{model}. Must be one of: #{Types::EDIT_VIDEO_MODELS.join(", ")}"
           end
+
+          if model.include?("2.6")
+            raise Core::ValidationError, "prompt is required" unless param(params, :prompt)
+            urls = param(params, :source_video_urls)
+            raise Core::ValidationError, "source_video_urls is required" if urls.nil? || urls.empty?
+          else
+            raise Core::ValidationError, "source_video_url is required" unless param(params, :source_video_url)
+          end
         end
       end
     end

data/lib/runapi/wan/resources/speech_to_video.rb

@@ -33,8 +33,8 @@ module RunApi
 
         def validate_params!(params)
           raise Core::ValidationError, "model is required" unless param(params, :model)
-          raise Core::ValidationError, "image_url is required" unless param(params, :image_url)
-          raise Core::ValidationError, "audio_url is required" unless param(params, :audio_url)
+          raise Core::ValidationError, "source_image_url is required" unless param(params, :source_image_url)
+          raise Core::ValidationError, "source_audio_url is required" unless param(params, :source_audio_url)
 
           model = param(params, :model)
           unless Types::SPEECH_TO_VIDEO_MODELS.include?(model)

data/lib/runapi/wan/types.rb

@@ -4,31 +4,30 @@ module RunApi
   module Wan
     module Types
       TEXT_TO_VIDEO_MODELS = %w[
-        wan-2-2-a14b-text-to-video-turbo
-        wan-2-5-text-to-video
-        wan-2-6-text-to-video
-        wan-2-7-text-to-video
+        wan-2.2-a14b-text-to-video-turbo
+        wan-2.5-text-to-video
+        wan-2.6-text-to-video
+        wan-2.7-text-to-video
+        wan-2.7-r2v
       ].freeze
 
       IMAGE_TO_VIDEO_MODELS = %w[
-        wan-2-2-a14b-image-to-video-turbo
-        wan-2-5-image-to-video
-        wan-2-6-image-to-video
-        wan-2-6-flash-image-to-video
-        wan-2-7-image-to-video
+        wan-2.2-a14b-image-to-video-turbo
+        wan-2.5-image-to-video
+        wan-2.6-image-to-video
+        wan-2.6-flash-image-to-video
+        wan-2.7-image-to-video
       ].freeze
 
-      VIDEO_TO_VIDEO_MODELS = %w[
-        wan-2-6-video-to-video
-        wan-2-6-flash-video-to-video
+      SPEECH_TO_VIDEO_MODELS = %w[wan-2.2-a14b-speech-to-video-turbo].freeze
+      ANIMATE_MODELS = %w[wan-2.2-animate-move wan-2.2-animate-replace].freeze
+      TEXT_TO_IMAGE_MODELS = %w[wan-2.7-image wan-2.7-image-pro].freeze
+      EDIT_VIDEO_MODELS = %w[
+        wan-2.6-edit-video
+        wan-2.6-flash-edit-video
+        wan-2.7-edit-video
       ].freeze
 
-      SPEECH_TO_VIDEO_MODELS = %w[wan-2-2-a14b-speech-to-video-turbo].freeze
-      ANIMATE_MODELS = %w[wan-2-2-animate-move wan-2-2-animate-replace].freeze
-      TEXT_TO_IMAGE_MODELS = %w[wan-2-7-image wan-2-7-image-pro].freeze
-      REFERENCE_TO_VIDEO_MODELS = %w[wan-2-7-r2v].freeze
-      EDIT_VIDEO_MODELS = %w[wan-2-7-videoedit].freeze
-
       class Video < RunApi::Core::BaseModel
         optional :url, String
       end
@@ -40,14 +39,14 @@ module RunApi
       class VideoTaskResponse < RunApi::Core::TaskResponse
         required :id, String
         optional :status, String, enum: -> { RunApi::Core::TaskResponse::Status::ALL }
-        optional :videos, [ -> { Video } ]
+        optional :videos, [-> { Video }]
         optional :error, String
       end
 
       class ImageTaskResponse < RunApi::Core::TaskResponse
         required :id, String
         optional :status, String, enum: -> { RunApi::Core::TaskResponse::Status::ALL }
-        optional :images, [ -> { Image } ]
+        optional :images, [-> { Image }]
         optional :error, String
       end
 
@@ -55,11 +54,11 @@ module RunApi
       # `status: "completed"`. Result arrays are required so consumers never
       # have to null-check them on a successful task.
       class CompletedVideoTaskResponse < VideoTaskResponse
-        required :videos, [ -> { Video } ]
+        required :videos, [-> { Video }]
       end
 
       class CompletedImageTaskResponse < ImageTaskResponse
-        required :images, [ -> { Image } ]
+        required :images, [-> { Image }]
       end
     end
   end

data/lib/runapi/wan.rb

@@ -4,11 +4,9 @@ require "runapi/core"
 require_relative "wan/types"
 require_relative "wan/resources/text_to_video"
 require_relative "wan/resources/image_to_video"
-require_relative "wan/resources/video_to_video"
 require_relative "wan/resources/speech_to_video"
 require_relative "wan/resources/animate"
 require_relative "wan/resources/text_to_image"
-require_relative "wan/resources/reference_to_video"
 require_relative "wan/resources/edit_video"
 require_relative "wan/client"
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-wan
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.6
 platform: ruby
 authors:
 - RunAPI
@@ -15,39 +15,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: 0.2.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
-description: RunAPI Wan SDK for JavaScript, Ruby, and Go
+        version: 0.2.5
+description: The wan video api Ruby SDK is the language-specific package for Wan on
+  RunAPI. Use this wan video api package for text-to-video, image-to-video, animation,
+  and video editing flows when your application needs JSON request bodies, task status
+  lookup, and consistent RunAPI errors in Ruby.
 email:
 - contact@runapi.ai
 executables: []
 extensions: []
-extra_rdoc_files: []
+extra_rdoc_files:
+- README.md
 files:
 - LICENSE
+- README.md
 - lib/runapi/wan.rb
 - lib/runapi/wan/client.rb
 - lib/runapi/wan/resources/animate.rb
 - lib/runapi/wan/resources/edit_video.rb
 - lib/runapi/wan/resources/image_to_video.rb
-- lib/runapi/wan/resources/reference_to_video.rb
 - lib/runapi/wan/resources/speech_to_video.rb
 - lib/runapi/wan/resources/text_to_image.rb
 - lib/runapi/wan/resources/text_to_video.rb
-- lib/runapi/wan/resources/video_to_video.rb
 - lib/runapi/wan/types.rb
 homepage: https://runapi.ai/models/wan
 licenses:
 - Apache-2.0
 metadata:
   homepage_uri: https://runapi.ai/models/wan
-  documentation_uri: https://runapi.ai/models/wan
+  documentation_uri: https://github.com/runapi-ai/wan-sdk/blob/main/ruby/README.md
   source_code_uri: https://github.com/runapi-ai/wan-sdk
   changelog_uri: https://github.com/runapi-ai/wan-sdk/blob/main/CHANGELOG.md
 rdoc_options: []
@@ -64,7 +67,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.10
 specification_version: 4
-summary: Wan API SDKs for JavaScript, Ruby, and Go on RunAPI.
+summary: Wan Video API Ruby SDK for RunAPI
 test_files: []

data/lib/runapi/wan/resources/reference_to_video.rb

@@ -1,46 +0,0 @@
-# frozen_string_literal: true
-
-module RunApi
-  module Wan
-    module Resources
-      class ReferenceToVideo
-        include RunApi::Core::ResourceHelpers
-
-        ENDPOINT = "/api/v1/wan/reference_to_video"
-        RESPONSE_CLASS = Types::VideoTaskResponse
-        COMPLETED_RESPONSE_CLASS = Types::CompletedVideoTaskResponse
-
-        def initialize(http)
-          @http = http
-        end
-
-        def run(**params)
-          task = create(**params)
-          poll_until_complete { get(task.id) }
-        end
-
-        def create(**params)
-          params = compact_params(params)
-          validate_params!(params)
-          request(:post, ENDPOINT, body: params)
-        end
-
-        def get(id)
-          request(:get, "#{ENDPOINT}/#{id}")
-        end
-
-        private
-
-        def validate_params!(params)
-          raise Core::ValidationError, "model is required" unless param(params, :model)
-          raise Core::ValidationError, "prompt is required" unless param(params, :prompt)
-
-          model = param(params, :model)
-          unless Types::REFERENCE_TO_VIDEO_MODELS.include?(model)
-            raise Core::ValidationError, "Invalid model: #{model}. Must be one of: #{Types::REFERENCE_TO_VIDEO_MODELS.join(", ")}"
-          end
-        end
-      end
-    end
-  end
-end

data/lib/runapi/wan/resources/video_to_video.rb

@@ -1,46 +0,0 @@
-# frozen_string_literal: true
-
-module RunApi
-  module Wan
-    module Resources
-      class VideoToVideo
-        include RunApi::Core::ResourceHelpers
-
-        ENDPOINT = "/api/v1/wan/video_to_video"
-        RESPONSE_CLASS = Types::VideoTaskResponse
-        COMPLETED_RESPONSE_CLASS = Types::CompletedVideoTaskResponse
-
-        def initialize(http)
-          @http = http
-        end
-
-        def run(**params)
-          task = create(**params)
-          poll_until_complete { get(task.id) }
-        end
-
-        def create(**params)
-          params = compact_params(params)
-          validate_params!(params)
-          request(:post, ENDPOINT, body: params)
-        end
-
-        def get(id)
-          request(:get, "#{ENDPOINT}/#{id}")
-        end
-
-        private
-
-        def validate_params!(params)
-          raise Core::ValidationError, "model is required" unless param(params, :model)
-          raise Core::ValidationError, "prompt is required" unless param(params, :prompt)
-
-          model = param(params, :model)
-          unless Types::VIDEO_TO_VIDEO_MODELS.include?(model)
-            raise Core::ValidationError, "Invalid model: #{model}. Must be one of: #{Types::VIDEO_TO_VIDEO_MODELS.join(", ")}"
-          end
-        end
-      end
-    end
-  end
-end