runapi-seedance 0.2.1 → 0.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a62ab3f8ec773b2d95c2cf868431bff5070499ac9c6f5a42e2dd857c451e714f
-  data.tar.gz: 8fb685bf5b79b3c365aa1393c1bc340506b5cde9a20455b200bd21b06fe746cc
+  metadata.gz: 4118e285fccee6a45c55c4a823d935bb75d7cca1cfe5dfc4e82973214575c183
+  data.tar.gz: 6ca91fe558e2a4e53890b21d573b4809dc2af0335cce7f35baabde7797c54fec
 SHA512:
-  metadata.gz: be49f1ab6768dc67ecc21aba313099c0bec5a4ec2f426a277adc838e6e59c334c72f0954da267e4c3b4a3bc55d8cc1f26c5ce328fc4c7a14ae375b39971f6680
-  data.tar.gz: '0258d37436ca3252f60004433252340182799f8f285d9d5f6ee6c251fa9f3cd2d24c56a2f3af959ddd41e44a7e32e64b7a9dd21019496221bb1ac3343aff7044'
+  metadata.gz: 0074a40fc6a32db226f372d2575aa2db218d3c0ec5b7abe2d3a6ffc1a9f962e5a137e7d03ab8ee714f80c6377180d88aed4899d513f84b008991452bc888c1b5
+  data.tar.gz: '06799aaa55a72f75efdef4e17311297e96c7a73b53bbfa1856157be770066adb09edc70128b9db546fe301359b8fd6eae7f84ec34d3251de19447568b340593d'

data/README.md

@@ -0,0 +1,43 @@
+# Seedance API Ruby SDK for RunAPI
+
+The seedance api Ruby SDK is the language-specific package for Seedance on RunAPI. Use this seedance api package for text-to-video, image-to-video, video editing, and animation flows when your application needs JSON request bodies, task status lookup, and consistent RunAPI errors in Ruby.
+
+This seedance api README is the Ruby package guide inside the public `seedance-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/seedance; for API reference, use https://runapi.ai/docs#seedance; for SDK docs, use https://runapi.ai/docs#sdk-seedance.
+
+## Install
+
+```bash
+gem install runapi-seedance
+```
+
+## Quick start
+
+```ruby
+require "runapi-seedance"
+
+client = RunApi::Seedance::Client.new
+task = client.generations.create(
+  # Pass the Seedance JSON request body from https://runapi.ai/docs#seedance.
+)
+status = client.generations.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::Seedance` error classes when building video jobs, Rails workers, or scripts. The available resources include generations. 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/seedance
+- SDK docs: https://runapi.ai/docs#sdk-seedance
+- Product docs: https://runapi.ai/docs#seedance
+- Pricing and rate limits: https://runapi.ai/models/seedance/v1-lite
+- Provider comparison: https://runapi.ai/providers/bytedance
+- Full catalog: https://runapi.ai/models
+- Repository: https://github.com/runapi-ai/seedance-sdk
+
+## License
+
+Licensed under the Apache License, Version 2.0.

data/lib/runapi/seedance/client.rb

@@ -7,7 +7,7 @@ module RunApi
     # @example
     #   client = RunApi::Seedance::Client.new(api_key: "your-api-key")
     #   result = client.text_to_video.run(
-    #     model: "seedance-2", prompt: "A cat walking through a garden"
+    #     model: "seedance-2.0", prompt: "A cat walking through a garden"
     #   )
     class Client
       # @return [Resources::TextToVideo] Video generation operations.

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

@@ -74,35 +74,29 @@ module RunApi
 
         def validate_v1!(params)
           model = param(params, :model)
-          has_image = field_present?(params, :input_urls)
+          has_image = field_present?(params, :first_frame_image_url)
 
           if model == "seedance-v1-pro-fast" && !has_image
-            raise Core::ValidationError, "seedance-v1-pro-fast requires input_urls (image-to-video only)"
-          end
-
-          if (value = param(params, :input_urls)).is_a?(Array) && value.size > 1
-            raise Core::ValidationError, "input_urls accepts at most 1 image for Seedance V1"
+            raise Core::ValidationError, "seedance-v1-pro-fast requires first_frame_image_url"
           end
 
           if has_image && field_present?(params, :aspect_ratio)
             raise Core::ValidationError, "aspect_ratio is not accepted in image-to-video mode; it is derived from the image"
           end
 
-          if field_present?(params, :last_frame_url) && !(model == "seedance-v1-lite" && has_image)
-            raise Core::ValidationError, "last_frame_url is only supported by seedance-v1-lite in image-to-video mode"
+          if field_present?(params, :last_frame_image_url) && !(model == "seedance-v1-lite" && has_image)
+            raise Core::ValidationError, "last_frame_image_url is only supported by seedance-v1-lite in image-to-video mode"
           end
 
-          unsupported = %i[first_frame_url reference_image_urls reference_video_urls reference_audio_urls web_search generate_audio]
+          unsupported = %i[source_image_urls reference_image_urls reference_video_urls reference_audio_urls web_search generate_audio]
           reject_unsupported!(params, unsupported, model)
 
-          if model == "seedance-v1-pro-fast"
-            reject_unsupported!(params, %i[lock_camera seed enable_safety_checker], model)
-          end
+          reject_unsupported!(params, %i[lock_camera seed], model) if model == "seedance-v1-pro-fast"
 
-          duration = param(params, :duration)
-          raise Core::ValidationError, "duration is required for Seedance V1; must be one of: #{Types::DURATIONS_V1.join(", ")}" unless duration
-          unless Types::DURATIONS_V1.include?(duration.to_s)
-            raise Core::ValidationError, "Invalid duration for #{model}: #{duration}. Must be one of: #{Types::DURATIONS_V1.join(", ")}"
+          duration_seconds = param(params, :duration_seconds)
+          raise Core::ValidationError, "duration_seconds is required for Seedance V1; must be one of: #{Types::DURATIONS_V1.join(", ")}" unless duration_seconds
+          unless Types::DURATIONS_V1.include?(duration_seconds)
+            raise Core::ValidationError, "Invalid duration_seconds for #{model}: #{duration_seconds}. Must be one of: #{Types::DURATIONS_V1.join(", ")}"
           end
 
           unless has_image
@@ -111,7 +105,7 @@ module RunApi
           end
 
           resolutions = (model == "seedance-v1-pro-fast") ? Types::RESOLUTIONS_V1_PRO_FAST : Types::RESOLUTIONS_V1
-          validate_optional!(params, :resolution, resolutions)
+          validate_optional!(params, :output_resolution, resolutions)
 
           seed = param(params, :seed)
           if seed
@@ -123,31 +117,39 @@ module RunApi
 
         def validate_1_5_pro!(params)
           validate_optional!(params, :aspect_ratio, Types::ASPECT_RATIOS_1_5)
-          validate_optional!(params, :resolution, Types::RESOLUTIONS_1_5)
+          validate_optional!(params, :output_resolution, Types::RESOLUTIONS_1_5)
+
+          duration_seconds = param(params, :duration_seconds)
+          unless duration_seconds
+            raise Core::ValidationError, "duration_seconds is required for seedance-1.5-pro; must be one of: #{Types::DURATIONS_1_5.join(", ")}"
+          end
+
+          if !Types::DURATIONS_1_5.include?(duration_seconds)
+            raise Core::ValidationError, "Invalid duration_seconds for seedance-1.5-pro: #{duration_seconds}. Must be one of: #{Types::DURATIONS_1_5.join(", ")}"
+          end
 
-          duration = param(params, :duration)
-          if duration && !Types::DURATIONS_1_5.include?(duration.to_s)
-            raise Core::ValidationError, "Invalid duration for seedance-1.5-pro: #{duration}. Must be one of: #{Types::DURATIONS_1_5.join(", ")}"
+          if (value = param(params, :source_image_urls)).is_a?(Array) && value.size > 2
+            raise Core::ValidationError, "source_image_urls accepts at most 2 images for seedance-1.5-pro"
           end
 
-          unsupported = %i[first_frame_url last_frame_url reference_image_urls reference_video_urls reference_audio_urls web_search]
+          unsupported = %i[first_frame_image_url last_frame_image_url reference_image_urls reference_video_urls reference_audio_urls web_search]
           reject_unsupported!(params, unsupported, "seedance-1.5-pro")
         end
 
         def validate_2!(params)
           validate_optional!(params, :aspect_ratio, Types::ASPECT_RATIOS_2)
-          resolutions = (param(params, :model) == "seedance-2") ? Types::RESOLUTIONS_SEEDANCE_2 : Types::RESOLUTIONS_SEEDANCE_2_FAST
-          validate_optional!(params, :resolution, resolutions)
+          resolutions = (param(params, :model) == "seedance-2.0") ? Types::RESOLUTIONS_SEEDANCE_2 : Types::RESOLUTIONS_SEEDANCE_2_FAST
+          validate_optional!(params, :output_resolution, resolutions)
 
-          duration = param(params, :duration)
-          if duration
-            dur_int = duration.to_i
+          duration_seconds = param(params, :duration_seconds)
+          if duration_seconds
+            dur_int = duration_seconds.to_i
             unless Types::DURATION_2_RANGE.cover?(dur_int)
-              raise Core::ValidationError, "Invalid duration for seedance-2: #{duration}. Must be an integer between 4 and 15"
+              raise Core::ValidationError, "Invalid duration_seconds for seedance-2.0: #{duration_seconds}. Must be an integer between 4 and 15"
             end
           end
 
-          unsupported = %i[input_urls lock_camera]
+          unsupported = %i[source_image_urls lock_camera]
           reject_unsupported!(params, unsupported, param(params, :model))
 
           validate_mode_conflicts!(params)
@@ -158,7 +160,7 @@ module RunApi
           has_reference = Types::REFERENCE_FIELDS.any? { |f| field_present?(params, f) }
 
           if has_frame && has_reference
-            raise Core::ValidationError, "Cannot use frame mode (first_frame_url/last_frame_url) and reference mode (reference_image_urls/reference_video_urls/reference_audio_urls) at the same time"
+            raise Core::ValidationError, "Cannot use frame mode and reference mode at the same time"
           end
         end
 

data/lib/runapi/seedance/types.rb

@@ -4,10 +4,10 @@ module RunApi
   module Seedance
     module Types
       V1_MODELS = %w[seedance-v1-lite seedance-v1-pro seedance-v1-pro-fast].freeze
-      MODELS = (%w[seedance-1.5-pro seedance-2 seedance-2-fast] + V1_MODELS).freeze
+      MODELS = (%w[seedance-1.5-pro seedance-2.0 seedance-2.0-fast] + V1_MODELS).freeze
 
       ASPECT_RATIOS_1_5 = %w[1:1 4:3 3:4 16:9 9:16 21:9].freeze
-      ASPECT_RATIOS_2 = [ *ASPECT_RATIOS_1_5, "auto" ].freeze
+      ASPECT_RATIOS_2 = [*ASPECT_RATIOS_1_5, "auto"].freeze
       ASPECT_RATIOS_V1_LITE = %w[1:1 4:3 3:4 16:9 9:16 9:21].freeze
       ASPECT_RATIOS_V1_PRO = %w[1:1 4:3 3:4 16:9 9:16 21:9].freeze
 
@@ -17,9 +17,9 @@ module RunApi
       RESOLUTIONS_V1 = %w[480p 720p 1080p].freeze
       RESOLUTIONS_V1_PRO_FAST = %w[720p 1080p].freeze
 
-      DURATIONS_1_5 = %w[4 8 12].freeze
+      DURATIONS_1_5 = [4, 8, 12].freeze
       DURATION_2_RANGE = (4..15)
-      DURATIONS_V1 = %w[5 10].freeze
+      DURATIONS_V1 = [5, 10].freeze
       SEED_RANGE = (-1..2_147_483_647)
 
       PROMPT_MIN_LENGTH = 3
@@ -27,7 +27,7 @@ module RunApi
       PROMPT_MAX_LENGTH_2 = 20000
       PROMPT_MAX_LENGTH_V1 = 10000
 
-      FRAME_FIELDS = %i[first_frame_url last_frame_url].freeze
+      FRAME_FIELDS = %i[first_frame_image_url last_frame_image_url].freeze
       REFERENCE_FIELDS = %i[reference_image_urls reference_video_urls reference_audio_urls].freeze
 
       class Video < RunApi::Core::BaseModel
@@ -40,17 +40,17 @@ module RunApi
       end
 
       class TextToVideoResponse < AsyncTaskResponse
-        optional :videos, [ -> { Video } ]
-        optional :last_frame_url, String
+        optional :videos, [-> { Video }]
+        optional :last_frame_image_url, String
         optional :error, String
       end
 
       # Narrowed response returned by `text_to_video.run()` once polling observes
       # `status: "completed"`. `videos` is required so consumers never have to
-      # null-check it on a successful task. `last_frame_url` stays optional
+      # null-check it on a successful task. `last_frame_image_url` stays optional
       # because it may be absent.
       class CompletedTextToVideoResponse < TextToVideoResponse
-        required :videos, [ -> { Video } ]
+        required :videos, [-> { Video }]
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-seedance
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.6
 platform: ruby
 authors:
 - RunAPI
@@ -15,22 +15,27 @@ 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 Seedance SDK for JavaScript, Ruby, and Go
+        version: 0.2.5
+description: The seedance api Ruby SDK is the language-specific package for Seedance
+  on RunAPI. Use this seedance api package for text-to-video, image-to-video, video
+  editing, and animation 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-seedance.rb
 - lib/runapi/seedance.rb
 - lib/runapi/seedance/client.rb
@@ -41,7 +46,7 @@ licenses:
 - Apache-2.0
 metadata:
   homepage_uri: https://runapi.ai/models/seedance
-  documentation_uri: https://runapi.ai/models/seedance
+  documentation_uri: https://github.com/runapi-ai/seedance-sdk/blob/main/ruby/README.md
   source_code_uri: https://github.com/runapi-ai/seedance-sdk
   changelog_uri: https://github.com/runapi-ai/seedance-sdk/blob/main/CHANGELOG.md
 rdoc_options: []
@@ -58,7 +63,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: Seedance API SDKs for JavaScript, Ruby, and Go on RunAPI.
+summary: Seedance API Ruby SDK for RunAPI
 test_files: []