runapi-seedance 0.2.6 → 0.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4118e285fccee6a45c55c4a823d935bb75d7cca1cfe5dfc4e82973214575c183
-  data.tar.gz: 6ca91fe558e2a4e53890b21d573b4809dc2af0335cce7f35baabde7797c54fec
+  metadata.gz: 4a4129f28a6815e05d711bf3c21304a59cc6f9d5250ba3c4efec1126a72227b5
+  data.tar.gz: 997e90de2aa928d79bbfe267a05d267d842137056f5beb470b1d2646254bec70
 SHA512:
-  metadata.gz: 0074a40fc6a32db226f372d2575aa2db218d3c0ec5b7abe2d3a6ffc1a9f962e5a137e7d03ab8ee714f80c6377180d88aed4899d513f84b008991452bc888c1b5
-  data.tar.gz: '06799aaa55a72f75efdef4e17311297e96c7a73b53bbfa1856157be770066adb09edc70128b9db546fe301359b8fd6eae7f84ec34d3251de19447568b340593d'
+  metadata.gz: e2b7f49b273915dabdca3e14b02eac8ae58733f5f4cea8c53a2b6b2ce5dcbc58a3c3e961304eadbfb32dbe1d5358585c399ef0b029a1b47c062a35a7f06485e0
+  data.tar.gz: b7c7f737b22359c3808c02bda601abcb2c7bc7155acf05b769813ba281d26dd242f3428ddc6a228b5983358c9bc0e2b26168328f5d1de8af414512ff64f636e3

data/README.md

@@ -24,6 +24,8 @@ 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.
 
+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::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.

data/lib/runapi/seedance/client.rb

@@ -9,15 +9,12 @@ module RunApi
     #   result = client.text_to_video.run(
     #     model: "seedance-2.0", prompt: "A cat walking through a garden"
     #   )
-    class Client
+    class Client < RunApi::Core::Client
       # @return [Resources::TextToVideo] Video generation operations.
       attr_reader :text_to_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)
       end
     end

data/lib/runapi/seedance/types.rb

@@ -2,43 +2,72 @@
 
 module RunApi
   module Seedance
+    # Type definitions and constants for Seedance video generation.
+    #
+    # Constants are grouped by model generation: 1.5, 2.0/2.0-fast, and V1.
+    # Each generation has its own aspect ratio, resolution, and duration
+    # constraints reflecting different rendering capabilities.
     module Types
+      # V1-generation model identifiers: lite (low-cost), pro (high-quality), and pro-fast (speed-optimized).
       V1_MODELS = %w[seedance-v1-lite seedance-v1-pro seedance-v1-pro-fast].freeze
+      # All supported model variants spanning 1.5, 2.0, and V1 generations.
       MODELS = (%w[seedance-1.5-pro seedance-2.0 seedance-2.0-fast] + V1_MODELS).freeze
 
+      # Aspect ratios for seedance-1.5-pro; required with every request.
       ASPECT_RATIOS_1_5 = %w[1:1 4:3 3:4 16:9 9:16 21:9].freeze
+      # Aspect ratios for 2.0/2.0-fast; includes "auto" for automatic selection.
       ASPECT_RATIOS_2 = [*ASPECT_RATIOS_1_5, "auto"].freeze
+      # Aspect ratios for seedance-v1-lite; uses 9:21 (not 21:9) for tall portrait.
       ASPECT_RATIOS_V1_LITE = %w[1:1 4:3 3:4 16:9 9:16 9:21].freeze
+      # Aspect ratios for seedance-v1-pro and seedance-v1-pro-fast.
       ASPECT_RATIOS_V1_PRO = %w[1:1 4:3 3:4 16:9 9:16 21:9].freeze
 
+      # Output resolutions for seedance-1.5-pro.
       RESOLUTIONS_1_5 = %w[480p 720p 1080p].freeze
+      # Output resolutions for seedance-2.0.
       RESOLUTIONS_SEEDANCE_2 = %w[480p 720p 1080p].freeze
+      # Output resolutions for seedance-2.0-fast; capped at 720p for faster rendering.
       RESOLUTIONS_SEEDANCE_2_FAST = %w[480p 720p].freeze
+      # Output resolutions for seedance-v1-lite and seedance-v1-pro.
       RESOLUTIONS_V1 = %w[480p 720p 1080p].freeze
+      # Output resolutions for seedance-v1-pro-fast; minimum 720p.
       RESOLUTIONS_V1_PRO_FAST = %w[720p 1080p].freeze
 
+      # Allowed duration values (seconds) for seedance-1.5-pro; discrete choices only.
       DURATIONS_1_5 = [4, 8, 12].freeze
+      # Continuous duration range (seconds) for 2.0/2.0-fast; any integer 4-15 is accepted.
       DURATION_2_RANGE = (4..15)
+      # Allowed duration values (seconds) for V1 models; 5 or 10.
       DURATIONS_V1 = [5, 10].freeze
+      # Valid seed range; -1 requests a random seed.
       SEED_RANGE = (-1..2_147_483_647)
 
+      # Minimum prompt length in characters, enforced across all models.
       PROMPT_MIN_LENGTH = 3
+      # Maximum prompt length for seedance-1.5-pro.
       PROMPT_MAX_LENGTH_1_5 = 2500
+      # Maximum prompt length for 2.0/2.0-fast (up to 20 000 characters).
       PROMPT_MAX_LENGTH_2 = 20000
+      # Maximum prompt length for V1 models (up to 10 000 characters).
       PROMPT_MAX_LENGTH_V1 = 10000
 
+      # Fields that specify first/last frame images for frame-conditioned generation.
       FRAME_FIELDS = %i[first_frame_image_url last_frame_image_url].freeze
+      # Fields for reference-conditioned generation (images, videos, and audio).
       REFERENCE_FIELDS = %i[reference_image_urls reference_video_urls reference_audio_urls].freeze
 
+      # A single generated video with its download URL.
       class Video < RunApi::Core::BaseModel
         optional :url, String
       end
 
+      # Base async response returned immediately after task creation and during polling.
       class AsyncTaskResponse < RunApi::Core::TaskResponse
         required :id, String
         optional :status, String, enum: -> { RunApi::Core::TaskResponse::Status::ALL }
       end
 
+      # Full response for a text-to-video task, including generated videos on completion.
       class TextToVideoResponse < AsyncTaskResponse
         optional :videos, [-> { Video }]
         optional :last_frame_image_url, String

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-seedance
 version: !ruby/object:Gem::Version
-  version: 0.2.6
+  version: 0.2.7
 platform: ruby
 authors:
 - RunAPI
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.5
+        version: 0.2.6
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.5
+        version: 0.2.6
 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