runapi-wan 0.2.6 → 0.2.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dbc05521adf750d4146cf35031cc55dad92fd762f83048f56cb5083e702e0d4f
-  data.tar.gz: b717b95a9b712d242de851922717953f0b6ef8dd7a77b70ccce17c169343287e
+  metadata.gz: 3ac7d4f40ceba4493f0b3759807014b881b46d80993c6e0803f062b02e76365e
+  data.tar.gz: be804d111c08b94f2be6562370bb2be17d841ca671ffea88cf593e4717a85e76
 SHA512:
-  metadata.gz: c4b5da04973ec6bde472f9ea0fd9cb746b749855a6292e69edeb0b08b303d8a7056d058a019e4de209d3a56f60091e756b9e6d566ffc68ae942273acf4063c55
-  data.tar.gz: b94bac6024b1adb20f4c8500b1e0e14f15f09344bb55a81285cbca87d1cb8feef4c35c9e6653d1f58cd904a1662550b753732f166d7e54a47e0dc141b5d90e94
+  metadata.gz: 14b6dc707f14c258f3f286b9fbee0fcb43d73c0753511135d474e4b3bf3d2e3b25bfe5fdd9d9e876adc4b6e2716a6dc1b9aa1bdf0c2fda7d14ef44f42148b2dc
+  data.tar.gz: ad772becf04fa4abddb64c130bb9662eaeb574f828c9308c0ff5829d4a8517e886d13b60d29e4dce7acf35c44812b2466628d458ac9ee8e514e5a7c8259f3880

data/README.md

@@ -1,8 +1,8 @@
-# Wan Video API Ruby SDK for RunAPI
+# Wan 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.
+The Wan Ruby SDK is the language-specific package for Wan on RunAPI. Use this package for video generation, animation, and video editing workflows when your application needs 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.
+This 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
 
@@ -13,7 +13,7 @@ gem install runapi-wan
 ## Quick start
 
 ```ruby
-require "runapi-wan"
+require "runapi/wan"
 
 client = RunApi::Wan::Client.new
 task = client.text_to_video.create(
@@ -24,9 +24,11 @@ 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.
 
+RunAPI-generated file URLs are temporary. Download and store generated images, videos, audio, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.
+
 ## 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.
+Use Ruby keyword arguments and the `RunApi::Wan` error classes when building video jobs, Rails workers, or scripts. The available resources are `text_to_video`, `image_to_video`, `speech_to_video`, `animate`, `text_to_image`, and `edit_video`. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.
 
 ## Links
 

data/lib/runapi/wan/client.rb

@@ -2,15 +2,33 @@
 
 module RunApi
   module Wan
-    class Client
-      attr_reader :text_to_video, :image_to_video,
-        :speech_to_video, :animate, :text_to_image, :edit_video
+    # Wan video and image generation API client.
+    #
+    # Spans multiple generation families (2.2 through 2.7) with progressive
+    # capability upgrades. Feature availability varies by model variant.
+    #
+    # @example
+    #   client = RunApi::Wan::Client.new(api_key: "your-api-key")
+    #   result = client.text_to_video.run(
+    #     model: "wan-2.6-text-to-video",
+    #     prompt: "A scenic mountain landscape with flowing rivers"
+    #   )
+    class Client < RunApi::Core::Client
+      # @return [Resources::TextToVideo] Generate videos from text prompts. Supports turbo (2.2) through 2.7 with progressive features.
+      attr_reader :text_to_video
+      # @return [Resources::ImageToVideo] Generate videos driven by a source image. Flash variants trade fidelity for speed.
+      attr_reader :image_to_video
+      # @return [Resources::SpeechToVideo] Generate lip-synced talking-head videos from a portrait image and speech audio.
+      attr_reader :speech_to_video
+      # @return [Resources::Animate] Transfer motion from a reference video onto a subject image (move or replace).
+      attr_reader :animate
+      # @return [Resources::TextToImage] Generate images with optional color palette, bounding box, and thinking mode.
+      attr_reader :text_to_image
+      # @return [Resources::EditVideo] Modify existing videos guided by text prompts and optional reference images.
+      attr_reader :edit_video
 
       def initialize(api_key: nil, **options)
-        @api_key = Core::Auth.resolve_api_key(api_key)
-
-        client_options = Core::ClientOptions.new(api_key: @api_key, **options)
-        http = client_options.http_client || Core::HttpClient.new(client_options)
+        super
 
         @text_to_video = Resources::TextToVideo.new(http)
         @image_to_video = Resources::ImageToVideo.new(http)

data/lib/runapi/wan/contract_gen.rb

@@ -0,0 +1,310 @@
+# frozen_string_literal: true
+
+module RunApi
+  module Wan
+    CONTRACT = {
+      "animate" => {
+        "models" => ["wan-2.2-animate-move", "wan-2.2-animate-replace"],
+        "fields_by_model" => {
+          "wan-2.2-animate-move" => {
+            "output_resolution" => {
+              "enum" => ["480p", "580p", "720p"]
+            },
+            "reference_video_url" => {
+              "required" => true
+            },
+            "source_image_url" => {
+              "required" => true
+            }
+          },
+          "wan-2.2-animate-replace" => {
+            "output_resolution" => {
+              "enum" => ["480p", "580p", "720p"]
+            },
+            "reference_video_url" => {
+              "required" => true
+            },
+            "source_image_url" => {
+              "required" => true
+            }
+          }
+        }
+      },
+      "edit-video" => {
+        "models" => ["wan-2.6-edit-video", "wan-2.6-flash-edit-video", "wan-2.7-edit-video"],
+        "fields_by_model" => {
+          "wan-2.6-edit-video" => {
+            "duration_seconds" => {
+              "type" => "integer"
+            },
+            "output_resolution" => {
+              "enum" => ["720p", "1080p"]
+            },
+            "prompt" => {
+              "required" => true
+            },
+            "seed" => {
+              "type" => "integer"
+            },
+            "source_video_urls" => {
+              "required" => true
+            }
+          },
+          "wan-2.6-flash-edit-video" => {
+            "duration_seconds" => {
+              "type" => "integer"
+            },
+            "prompt" => {
+              "required" => true
+            },
+            "seed" => {
+              "type" => "integer"
+            },
+            "source_video_urls" => {
+              "required" => true
+            }
+          },
+          "wan-2.7-edit-video" => {
+            "aspect_ratio" => {
+              "enum" => ["16:9", "9:16", "1:1", "4:3", "3:4"]
+            },
+            "duration_seconds" => {
+              "type" => "integer"
+            },
+            "output_resolution" => {
+              "enum" => ["720p", "1080p"]
+            },
+            "seed" => {
+              "type" => "integer"
+            },
+            "source_video_url" => {
+              "required" => true
+            }
+          }
+        }
+      },
+      "image-to-video" => {
+        "models" => ["wan-2.2-a14b-image-to-video-turbo", "wan-2.5-image-to-video", "wan-2.6-flash-image-to-video", "wan-2.6-image-to-video", "wan-2.7-image-to-video"],
+        "fields_by_model" => {
+          "wan-2.2-a14b-image-to-video-turbo" => {
+            "duration_seconds" => {
+              "type" => "integer"
+            },
+            "first_frame_image_url" => {
+              "required" => true
+            },
+            "output_resolution" => {
+              "enum" => ["480p", "720p"]
+            },
+            "seed" => {
+              "type" => "integer"
+            }
+          },
+          "wan-2.5-image-to-video" => {
+            "duration_seconds" => {
+              "required" => true,
+              "type" => "integer"
+            },
+            "first_frame_image_url" => {
+              "required" => true
+            },
+            "output_resolution" => {
+              "enum" => ["720p", "1080p"]
+            },
+            "seed" => {
+              "type" => "integer"
+            }
+          },
+          "wan-2.6-flash-image-to-video" => {
+            "audio" => {
+              "required" => true
+            },
+            "duration_seconds" => {
+              "type" => "integer"
+            },
+            "first_frame_image_url" => {
+              "required" => true
+            },
+            "output_resolution" => {
+              "enum" => ["720p", "1080p"]
+            },
+            "prompt" => {
+              "required" => true
+            }
+          },
+          "wan-2.6-image-to-video" => {
+            "duration_seconds" => {
+              "type" => "integer"
+            },
+            "first_frame_image_url" => {
+              "required" => true
+            },
+            "output_resolution" => {
+              "enum" => ["720p", "1080p"]
+            },
+            "prompt" => {
+              "required" => true
+            }
+          },
+          "wan-2.7-image-to-video" => {
+            "duration_seconds" => {
+              "type" => "integer"
+            },
+            "output_resolution" => {
+              "enum" => ["720p", "1080p"]
+            },
+            "prompt" => {
+              "required" => true
+            },
+            "seed" => {
+              "type" => "integer"
+            }
+          }
+        },
+        "rules" => [{
+          "when" => {
+            "model" => "wan-2.6-flash-image-to-video"
+          },
+          "forbidden" => ["seed"]
+        }, {
+          "when" => {
+            "model" => "wan-2.6-image-to-video"
+          },
+          "forbidden" => ["seed"]
+        }]
+      },
+      "speech-to-video" => {
+        "models" => ["wan-2.2-a14b-speech-to-video-turbo"],
+        "fields_by_model" => {
+          "wan-2.2-a14b-speech-to-video-turbo" => {
+            "frames_per_second" => {
+              "type" => "integer"
+            },
+            "num_frames" => {
+              "type" => "integer"
+            },
+            "num_inference_steps" => {
+              "type" => "integer"
+            },
+            "output_resolution" => {
+              "enum" => ["480p", "580p", "720p"]
+            },
+            "prompt" => {
+              "required" => true
+            },
+            "seed" => {
+              "type" => "integer"
+            },
+            "source_audio_url" => {
+              "required" => true
+            },
+            "source_image_url" => {
+              "required" => true
+            }
+          }
+        }
+      },
+      "text-to-image" => {
+        "models" => ["wan-2.7-image", "wan-2.7-image-pro"],
+        "fields_by_model" => {
+          "wan-2.7-image" => {
+            "aspect_ratio" => {
+              "enum" => ["1:1", "16:9", "4:3", "21:9", "3:4", "9:16", "8:1", "1:8"]
+            },
+            "output_count" => {
+              "type" => "integer"
+            },
+            "output_resolution" => {
+              "enum" => ["1k", "2k", "4k"]
+            },
+            "seed" => {
+              "type" => "integer"
+            }
+          },
+          "wan-2.7-image-pro" => {
+            "aspect_ratio" => {
+              "enum" => ["1:1", "16:9", "4:3", "21:9", "3:4", "9:16", "8:1", "1:8"]
+            },
+            "output_count" => {
+              "type" => "integer"
+            },
+            "output_resolution" => {
+              "enum" => ["1k", "2k", "4k"]
+            },
+            "seed" => {
+              "type" => "integer"
+            }
+          }
+        }
+      },
+      "text-to-video" => {
+        "models" => ["wan-2.2-a14b-text-to-video-turbo", "wan-2.5-text-to-video", "wan-2.6-text-to-video", "wan-2.7-r2v", "wan-2.7-text-to-video"],
+        "fields_by_model" => {
+          "wan-2.2-a14b-text-to-video-turbo" => {
+            "duration_seconds" => {
+              "type" => "integer"
+            },
+            "output_resolution" => {
+              "enum" => ["480p", "580p", "720p"]
+            },
+            "seed" => {
+              "type" => "integer"
+            }
+          },
+          "wan-2.5-text-to-video" => {
+            "duration_seconds" => {
+              "type" => "integer"
+            },
+            "output_resolution" => {
+              "enum" => ["720p", "1080p"]
+            },
+            "seed" => {
+              "type" => "integer"
+            }
+          },
+          "wan-2.6-text-to-video" => {
+            "duration_seconds" => {
+              "type" => "integer"
+            },
+            "output_resolution" => {
+              "enum" => ["720p", "1080p"]
+            }
+          },
+          "wan-2.7-r2v" => {
+            "aspect_ratio" => {
+              "enum" => ["16:9", "9:16", "1:1", "4:3", "3:4"]
+            },
+            "duration_seconds" => {
+              "min" => 2,
+              "max" => 10,
+              "type" => "integer"
+            },
+            "output_resolution" => {
+              "enum" => ["720p", "1080p"]
+            },
+            "seed" => {
+              "type" => "integer"
+            }
+          },
+          "wan-2.7-text-to-video" => {
+            "duration_seconds" => {
+              "type" => "integer"
+            },
+            "output_resolution" => {
+              "enum" => ["720p", "1080p"]
+            },
+            "seed" => {
+              "type" => "integer"
+            }
+          }
+        },
+        "rules" => [{
+          "when" => {
+            "model" => "wan-2.6-text-to-video"
+          },
+          "forbidden" => ["seed"]
+        }]
+      }
+    }.freeze
+  end
+end

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

@@ -3,6 +3,9 @@
 module RunApi
   module Wan
     module Resources
+      # Transfers motion from a reference video onto a subject in the source image.
+      # Use wan-2.2-animate-move to preserve the subject and animate its motion,
+      # or wan-2.2-animate-replace to swap the subject with the reference video's subject.
       class Animate
         include RunApi::Core::ResourceHelpers
 
@@ -14,32 +17,37 @@ module RunApi
           @http = http
         end
 
-        def run(**params)
-          task = create(**params)
-          poll_until_complete { get(task.id) }
+        # Transfer motion and wait until complete.
+        #
+        # @param params [Hash] animation parameters
+        # @return [RunApi::Wan::Types::CompletedVideoTaskResponse] completed animation result
+        def run(options: nil, **params)
+          task = create(options: options, **params)
+          poll_until_complete { get(task.id, options: options) }
         end
 
-        def create(**params)
+        # Create an animation task.
+        #
+        # @param params [Hash] animation parameters
+        # @return [RunApi::Wan::Types::VideoTaskResponse] task creation result with id
+        def create(options: nil, **params)
           params = compact_params(params)
           validate_params!(params)
-          request(:post, ENDPOINT, body: params)
+          request(:post, ENDPOINT, body: params, options: options)
         end
 
-        def get(id)
-          request(:get, "#{ENDPOINT}/#{id}")
+        # Get animation status by task ID.
+        #
+        # @param id [String] task ID
+        # @return [RunApi::Wan::Types::VideoTaskResponse] current task status
+        def get(id, options: nil)
+          request(:get, "#{ENDPOINT}/#{id}", options: options)
         end
 
         private
 
         def validate_params!(params)
-          raise Core::ValidationError, "model is required" unless param(params, :model)
-          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)
-            raise Core::ValidationError, "Invalid model: #{model}. Must be one of: #{Types::ANIMATE_MODELS.join(", ")}"
-          end
+          validate_contract!(CONTRACT["animate"], params)
         end
       end
     end

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

@@ -3,6 +3,9 @@
 module RunApi
   module Wan
     module Resources
+      # Modifies existing videos guided by a text prompt and optional reference image.
+      # The 2.6 models use source_video_urls (plural, required) while 2.7 uses
+      # source_video_url (singular, required). Flash variants support audio and multi-shot.
       class EditVideo
         include RunApi::Core::ResourceHelpers
 
@@ -14,38 +17,37 @@ module RunApi
           @http = http
         end
 
-        def run(**params)
-          task = create(**params)
-          poll_until_complete { get(task.id) }
+        # Edit a video and wait until complete.
+        #
+        # @param params [Hash] video editing parameters
+        # @return [RunApi::Wan::Types::CompletedVideoTaskResponse] completed video edit
+        def run(options: nil, **params)
+          task = create(options: options, **params)
+          poll_until_complete { get(task.id, options: options) }
         end
 
-        def create(**params)
+        # Create a video editing task.
+        #
+        # @param params [Hash] video editing parameters
+        # @return [RunApi::Wan::Types::VideoTaskResponse] task creation result with id
+        def create(options: nil, **params)
           params = compact_params(params)
           validate_params!(params)
-          request(:post, ENDPOINT, body: params)
+          request(:post, ENDPOINT, body: params, options: options)
         end
 
-        def get(id)
-          request(:get, "#{ENDPOINT}/#{id}")
+        # Get video editing status by task ID.
+        #
+        # @param id [String] task ID
+        # @return [RunApi::Wan::Types::VideoTaskResponse] current task status
+        def get(id, options: nil)
+          request(:get, "#{ENDPOINT}/#{id}", options: options)
         end
 
         private
 
         def validate_params!(params)
-          raise Core::ValidationError, "model is required" unless param(params, :model)
-
-          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
+          validate_contract!(CONTRACT["edit-video"], params)
         end
       end
     end

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

@@ -3,6 +3,8 @@
 module RunApi
   module Wan
     module Resources
+      # Generates videos driven by a source image. Flash variants trade fidelity
+      # for speed; 2.7 adds last-frame control, video continuation, and audio features.
       class ImageToVideo
         include RunApi::Core::ResourceHelpers
 
@@ -14,30 +16,37 @@ module RunApi
           @http = http
         end
 
-        def run(**params)
-          task = create(**params)
-          poll_until_complete { get(task.id) }
+        # Generate a video from an image and wait until complete.
+        #
+        # @param params [Hash] image-to-video parameters
+        # @return [RunApi::Wan::Types::CompletedVideoTaskResponse] completed video generation
+        def run(options: nil, **params)
+          task = create(options: options, **params)
+          poll_until_complete { get(task.id, options: options) }
         end
 
-        def create(**params)
+        # Create an image-to-video generation task.
+        #
+        # @param params [Hash] image-to-video parameters
+        # @return [RunApi::Wan::Types::VideoTaskResponse] task creation result with id
+        def create(options: nil, **params)
           params = compact_params(params)
           validate_params!(params)
-          request(:post, ENDPOINT, body: params)
+          request(:post, ENDPOINT, body: params, options: options)
         end
 
-        def get(id)
-          request(:get, "#{ENDPOINT}/#{id}")
+        # Get image-to-video status by task ID.
+        #
+        # @param id [String] task ID
+        # @return [RunApi::Wan::Types::VideoTaskResponse] current task status
+        def get(id, options: nil)
+          request(:get, "#{ENDPOINT}/#{id}", options: options)
         end
 
         private
 
         def validate_params!(params)
-          raise Core::ValidationError, "model is required" unless param(params, :model)
-
-          model = param(params, :model)
-          unless Types::IMAGE_TO_VIDEO_MODELS.include?(model)
-            raise Core::ValidationError, "Invalid model: #{model}. Must be one of: #{Types::IMAGE_TO_VIDEO_MODELS.join(", ")}"
-          end
+          validate_contract!(CONTRACT["image-to-video"], params)
         end
       end
     end

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

@@ -3,6 +3,8 @@
 module RunApi
   module Wan
     module Resources
+      # Generates lip-synced talking-head videos from a portrait image and
+      # driving speech audio. Both source_image_url and source_audio_url are required.
       class SpeechToVideo
         include RunApi::Core::ResourceHelpers
 
@@ -14,32 +16,37 @@ module RunApi
           @http = http
         end
 
-        def run(**params)
-          task = create(**params)
-          poll_until_complete { get(task.id) }
+        # Generate a lip-synced video and wait until complete.
+        #
+        # @param params [Hash] speech-to-video parameters
+        # @return [RunApi::Wan::Types::CompletedVideoTaskResponse] completed video generation
+        def run(options: nil, **params)
+          task = create(options: options, **params)
+          poll_until_complete { get(task.id, options: options) }
         end
 
-        def create(**params)
+        # Create a speech-to-video generation task.
+        #
+        # @param params [Hash] speech-to-video parameters
+        # @return [RunApi::Wan::Types::VideoTaskResponse] task creation result with id
+        def create(options: nil, **params)
           params = compact_params(params)
           validate_params!(params)
-          request(:post, ENDPOINT, body: params)
+          request(:post, ENDPOINT, body: params, options: options)
         end
 
-        def get(id)
-          request(:get, "#{ENDPOINT}/#{id}")
+        # Get speech-to-video status by task ID.
+        #
+        # @param id [String] task ID
+        # @return [RunApi::Wan::Types::VideoTaskResponse] current task status
+        def get(id, options: nil)
+          request(:get, "#{ENDPOINT}/#{id}", options: options)
         end
 
         private
 
         def validate_params!(params)
-          raise Core::ValidationError, "model is required" unless param(params, :model)
-          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)
-            raise Core::ValidationError, "Invalid model: #{model}. Must be one of: #{Types::SPEECH_TO_VIDEO_MODELS.join(", ")}"
-          end
+          validate_contract!(CONTRACT["speech-to-video"], params)
         end
       end
     end

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

@@ -3,6 +3,9 @@
 module RunApi
   module Wan
     module Resources
+      # Generates images from text prompts with optional color palette and bounding
+      # box constraints. Supports batch generation via output_count. Pro model
+      # supports thinking_mode for enhanced prompt reasoning.
       class TextToImage
         include RunApi::Core::ResourceHelpers
 
@@ -14,31 +17,38 @@ module RunApi
           @http = http
         end
 
-        def run(**params)
-          task = create(**params)
-          poll_until_complete { get(task.id) }
+        # Generate an image and wait until complete.
+        #
+        # @param params [Hash] text-to-image parameters
+        # @return [RunApi::Wan::Types::CompletedImageTaskResponse] completed image generation
+        def run(options: nil, **params)
+          task = create(options: options, **params)
+          poll_until_complete { get(task.id, options: options) }
         end
 
-        def create(**params)
+        # Create a text-to-image generation task.
+        #
+        # @param params [Hash] text-to-image parameters
+        # @return [RunApi::Wan::Types::ImageTaskResponse] task creation result with id
+        def create(options: nil, **params)
           params = compact_params(params)
           validate_params!(params)
-          request(:post, ENDPOINT, body: params)
+          request(:post, ENDPOINT, body: params, options: options)
         end
 
-        def get(id)
-          request(:get, "#{ENDPOINT}/#{id}")
+        # Get text-to-image status by task ID.
+        #
+        # @param id [String] task ID
+        # @return [RunApi::Wan::Types::ImageTaskResponse] current task status
+        def get(id, options: nil)
+          request(:get, "#{ENDPOINT}/#{id}", options: options)
         end
 
         private
 
         def validate_params!(params)
-          raise Core::ValidationError, "model is required" unless param(params, :model)
+          validate_contract!(CONTRACT["text-to-image"], params)
           raise Core::ValidationError, "prompt is required" unless param(params, :prompt)
-
-          model = param(params, :model)
-          unless Types::TEXT_TO_IMAGE_MODELS.include?(model)
-            raise Core::ValidationError, "Invalid model: #{model}. Must be one of: #{Types::TEXT_TO_IMAGE_MODELS.join(", ")}"
-          end
         end
       end
     end

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

@@ -3,6 +3,9 @@
 module RunApi
   module Wan
     module Resources
+      # Generates videos from text prompts. Supports turbo (2.2) through 2.7
+      # with progressive feature upgrades including negative prompts, watermark
+      # control, background audio, and R2V multi-reference inputs.
       class TextToVideo
         include RunApi::Core::ResourceHelpers
 
@@ -14,31 +17,38 @@ module RunApi
           @http = http
         end
 
-        def run(**params)
-          task = create(**params)
-          poll_until_complete { get(task.id) }
+        # Generate a video and wait until complete.
+        #
+        # @param params [Hash] text-to-video parameters
+        # @return [RunApi::Wan::Types::CompletedVideoTaskResponse] completed video generation
+        def run(options: nil, **params)
+          task = create(options: options, **params)
+          poll_until_complete { get(task.id, options: options) }
         end
 
-        def create(**params)
+        # Create a text-to-video generation task.
+        #
+        # @param params [Hash] text-to-video parameters
+        # @return [RunApi::Wan::Types::VideoTaskResponse] task creation result with id
+        def create(options: nil, **params)
           params = compact_params(params)
           validate_params!(params)
-          request(:post, ENDPOINT, body: params)
+          request(:post, ENDPOINT, body: params, options: options)
         end
 
-        def get(id)
-          request(:get, "#{ENDPOINT}/#{id}")
+        # Get text-to-video status by task ID.
+        #
+        # @param id [String] task ID
+        # @return [RunApi::Wan::Types::VideoTaskResponse] current task status
+        def get(id, options: nil)
+          request(:get, "#{ENDPOINT}/#{id}", options: options)
         end
 
         private
 
         def validate_params!(params)
-          raise Core::ValidationError, "model is required" unless param(params, :model)
+          validate_contract!(CONTRACT["text-to-video"], params)
           raise Core::ValidationError, "prompt is required" unless param(params, :prompt)
-
-          model = param(params, :model)
-          unless Types::TEXT_TO_VIDEO_MODELS.include?(model)
-            raise Core::ValidationError, "Invalid model: #{model}. Must be one of: #{Types::TEXT_TO_VIDEO_MODELS.join(", ")}"
-          end
         end
       end
     end

data/lib/runapi/wan/types.rb

@@ -3,39 +3,17 @@
 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.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
-      ].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
-      EDIT_VIDEO_MODELS = %w[
-        wan-2.6-edit-video
-        wan-2.6-flash-edit-video
-        wan-2.7-edit-video
-      ].freeze
-
+      # A single generated video result.
       class Video < RunApi::Core::BaseModel
         optional :url, String
       end
 
+      # A single generated image result.
       class Image < RunApi::Core::BaseModel
         optional :url, String
       end
 
+      # Task result for video generation and editing operations.
       class VideoTaskResponse < RunApi::Core::TaskResponse
         required :id, String
         optional :status, String, enum: -> { RunApi::Core::TaskResponse::Status::ALL }
@@ -43,6 +21,7 @@ module RunApi
         optional :error, String
       end
 
+      # Task result for text-to-image operations.
       class ImageTaskResponse < RunApi::Core::TaskResponse
         required :id, String
         optional :status, String, enum: -> { RunApi::Core::TaskResponse::Status::ALL }

data/lib/runapi/wan.rb

@@ -2,6 +2,7 @@
 
 require "runapi/core"
 require_relative "wan/types"
+require_relative "wan/contract_gen"
 require_relative "wan/resources/text_to_video"
 require_relative "wan/resources/image_to_video"
 require_relative "wan/resources/speech_to_video"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-wan
 version: !ruby/object:Gem::Version
-  version: 0.2.6
+  version: 0.2.8
 platform: ruby
 authors:
 - RunAPI
@@ -15,18 +15,18 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.5
+        version: 0.2.13
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        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.
+        version: 0.2.13
+description: The Wan Ruby SDK is the language-specific package for Wan on RunAPI.
+  Use this package for video generation, animation, and video editing workflows when
+  your application needs request bodies, task status lookup, and consistent RunAPI
+  errors in Ruby.
 email:
 - contact@runapi.ai
 executables: []
@@ -38,6 +38,7 @@ files:
 - README.md
 - lib/runapi/wan.rb
 - lib/runapi/wan/client.rb
+- lib/runapi/wan/contract_gen.rb
 - lib/runapi/wan/resources/animate.rb
 - lib/runapi/wan/resources/edit_video.rb
 - lib/runapi/wan/resources/image_to_video.rb
@@ -49,9 +50,11 @@ homepage: https://runapi.ai/models/wan
 licenses:
 - Apache-2.0
 metadata:
+  runapi_slug: wan
   homepage_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
+  bug_tracker_uri: https://github.com/runapi-ai/wan-sdk/issues
   changelog_uri: https://github.com/runapi-ai/wan-sdk/blob/main/CHANGELOG.md
 rdoc_options: []
 require_paths:
@@ -69,5 +72,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.10
 specification_version: 4
-summary: Wan Video API Ruby SDK for RunAPI
+summary: Wan API Ruby SDK for RunAPI
 test_files: []