runapi-flux-2 0.2.7 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d2f7af4be782a923b65df9f4f52418b1afa976271cca57a99931c313040b1ce
-  data.tar.gz: 9f2e464857535f906008da2404a43c5183cc1c5e56cecf174eaedbeb54fff064
+  metadata.gz: c634d010d5d4744ce8e2811c5705149c620778591a7969c06e2227f463376b3b
+  data.tar.gz: 434c41db48cd75e99215be821afd491ef413c82c99f0f3dd81fdd310f994388f
 SHA512:
-  metadata.gz: 3e4064be7f3a33af749e40c6ae7d0d3a0fadff165f50b97fa00e74f5122195a7f97fc8727a2f19896498c2502ab8ae9c8f3ce03ba23c381358c83f22f356a9c4
-  data.tar.gz: 2b0450f7cb1d201d8978a9bcc7f42e4ca3756a07f4e146c6cb563bc1d688e6e246b9ee1490c2843e8566135202ce7bffea63eccfb8f7b4bbe25504ef22352a20
+  metadata.gz: 190af50f6f040b2e9931eca396f5ec886878fea787980f8432b92eb08b5f6ee115b9b5ee26ab96cc6857c21544d66204e1de3c0386d584f1e525bc7c1d5308b8
+  data.tar.gz: 6bbf2e9ec1837adc9d271a1e30d486259dd1538c807b712e850d7e8b8a79dc1dfd0d0d7e1597716c235335b7d7513f5b57adb77d740b52c27c0931470dbf10ec

data/README.md

@@ -34,6 +34,10 @@ remix = client.remix_image.create(
 
 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.
 
+## Flux 2 Max
+
+Use `flux-2-max-text-to-image` or `flux-2-max-remix-image` for the highest-quality tier. Max requires a concrete `aspect_ratio`, supports `output_resolution: "1k"` and `output_count: 1` only, and accepts exactly one public HTTP(S) source image for remix.
+
 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

data/lib/runapi/flux_2/contract_gen.rb

@@ -4,64 +4,173 @@ module RunApi
   module Flux2
     CONTRACT = {
       "remix-image" => {
-        "models" => ["flux-2-flex-remix-image", "flux-2-pro-remix-image"],
+        "models" => ["flux-2-flex-remix-image", "flux-2-max-remix-image", "flux-2-pro-remix-image"],
         "fields_by_model" => {
           "flux-2-flex-remix-image" => {
             "aspect_ratio" => {
               "enum" => ["1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3", "auto"]
             },
+            "model" => {
+              "required" => true
+            },
             "output_resolution" => {
               "enum" => ["1k", "2k"]
             },
             "prompt" => {
-              "required" => true
+              "required" => true,
+              "min" => 3,
+              "max" => 5000,
+              "length" => true
             },
             "source_image_urls" => {
+              "required" => true,
+              "min_items" => 1,
+              "max_items" => 8
+            }
+          },
+          "flux-2-max-remix-image" => {
+            "aspect_ratio" => {
+              "enum" => ["1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3"],
+              "required" => true
+            },
+            "model" => {
               "required" => true
+            },
+            "output_count" => {
+              "enum" => [1],
+              "type" => "integer"
+            },
+            "output_resolution" => {
+              "enum" => ["1k"]
+            },
+            "prompt" => {
+              "required" => true,
+              "min" => 3,
+              "max" => 5000,
+              "length" => true
+            },
+            "source_image_urls" => {
+              "required" => true,
+              "min_items" => 1,
+              "max_items" => 1
             }
           },
           "flux-2-pro-remix-image" => {
             "aspect_ratio" => {
               "enum" => ["1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3", "auto"]
             },
+            "model" => {
+              "required" => true
+            },
             "output_resolution" => {
               "enum" => ["1k", "2k"]
             },
             "prompt" => {
-              "required" => true
+              "required" => true,
+              "min" => 3,
+              "max" => 5000,
+              "length" => true
             },
             "source_image_urls" => {
-              "required" => true
+              "required" => true,
+              "min_items" => 1,
+              "max_items" => 8
             }
           }
-        }
+        },
+        "rules" => [{
+          "when" => {
+            "model" => "flux-2-flex-remix-image"
+          },
+          "forbidden" => ["output_count"]
+        }, {
+          "when" => {
+            "model" => "flux-2-max-remix-image"
+          },
+          "forbidden" => ["enable_safety_checker"]
+        }, {
+          "when" => {
+            "model" => "flux-2-pro-remix-image"
+          },
+          "forbidden" => ["output_count"]
+        }]
       },
       "text-to-image" => {
-        "models" => ["flux-2-flex-text-to-image", "flux-2-pro-text-to-image"],
+        "models" => ["flux-2-flex-text-to-image", "flux-2-max-text-to-image", "flux-2-pro-text-to-image"],
         "fields_by_model" => {
           "flux-2-flex-text-to-image" => {
             "aspect_ratio" => {
               "enum" => ["1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3"]
             },
+            "model" => {
+              "required" => true
+            },
             "output_resolution" => {
               "enum" => ["1k", "2k"]
             },
             "prompt" => {
+              "required" => true,
+              "min" => 3,
+              "max" => 5000,
+              "length" => true
+            }
+          },
+          "flux-2-max-text-to-image" => {
+            "aspect_ratio" => {
+              "enum" => ["1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3"],
               "required" => true
+            },
+            "model" => {
+              "required" => true
+            },
+            "output_count" => {
+              "enum" => [1],
+              "type" => "integer"
+            },
+            "output_resolution" => {
+              "enum" => ["1k"]
+            },
+            "prompt" => {
+              "required" => true,
+              "min" => 3,
+              "max" => 5000,
+              "length" => true
             }
           },
           "flux-2-pro-text-to-image" => {
             "aspect_ratio" => {
               "enum" => ["1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3"]
             },
+            "model" => {
+              "required" => true
+            },
             "output_resolution" => {
               "enum" => ["1k", "2k"]
             },
             "prompt" => {
-              "required" => true
+              "required" => true,
+              "min" => 3,
+              "max" => 5000,
+              "length" => true
             }
           }
-        }
+        },
+        "rules" => [{
+          "when" => {
+            "model" => "flux-2-flex-text-to-image"
+          },
+          "forbidden" => ["output_count"]
+        }, {
+          "when" => {
+            "model" => "flux-2-max-text-to-image"
+          },
+          "forbidden" => ["enable_safety_checker"]
+        }, {
+          "when" => {
+            "model" => "flux-2-pro-text-to-image"
+          },
+          "forbidden" => ["output_count"]
+        }]
       }
     }.freeze
   end

data/lib/runapi/flux_2/resources/remix_image.rb

@@ -17,19 +17,19 @@ module RunApi
           @http = http
         end
 
-        def run(**params)
-          task = create(**params)
-          poll_until_complete { get(task.id) }
+        def run(options: nil, **params)
+          task = create(options: options, **params)
+          poll_until_complete { get(task.id, options: options) }
         end
 
-        def create(**params)
+        def create(options: nil, **params)
           params = compact_params(params)
           validate_contract!(CONTRACT["remix-image"], params)
-          request(:post, ENDPOINT, body: params)
+          request(:post, ENDPOINT, body: params, options: options)
         end
 
-        def get(id)
-          request(:get, "#{ENDPOINT}/#{id}")
+        def get(id, options: nil)
+          request(:get, "#{ENDPOINT}/#{id}", options: options)
         end
       end
     end

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

@@ -21,27 +21,27 @@ module RunApi
         #
         # @param params [Hash] text-to-image parameters
         # @return [RunApi::Flux2::Types::CompletedTextToImageResponse] completed text-to-image result
-        def run(**params)
-          task = create(**params)
-          poll_until_complete { get(task.id) }
+        def run(options: nil, **params)
+          task = create(options: options, **params)
+          poll_until_complete { get(task.id, options: options) }
         end
 
         # Create a text-to-image task.
         #
         # @param params [Hash] text-to-image parameters
         # @return [RunApi::Flux2::Types::TextToImageResponse] task creation result with id
-        def create(**params)
+        def create(options: nil, **params)
           params = compact_params(params)
           validate_contract!(CONTRACT["text-to-image"], params)
-          request(:post, ENDPOINT, body: params)
+          request(:post, ENDPOINT, body: params, options: options)
         end
 
         # Get text-to-image status by task ID.
         #
         # @param id [String] task ID
         # @return [RunApi::Flux2::Types::TextToImageResponse] current text-to-image status
-        def get(id)
-          request(:get, "#{ENDPOINT}/#{id}")
+        def get(id, options: nil)
+          request(:get, "#{ENDPOINT}/#{id}", options: options)
         end
       end
     end

data/lib/runapi/flux_2/types.rb

@@ -3,7 +3,8 @@
 module RunApi
   module Flux2
     # Type definitions for Flux 2.
-    # Each operation has pro (higher fidelity) and flex (faster, lower cost) tiers.
+    # Each operation has Pro, Flex, and Max tiers. Max requires a concrete
+    # aspect ratio, supports 1k output only, and produces one image.
     module Types
       # A single generated image with its CDN URL.
       class Image < RunApi::Core::BaseModel

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-flux-2
 version: !ruby/object:Gem::Version
-  version: 0.2.7
+  version: 0.3.0
 platform: ruby
 authors:
 - RunAPI
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.7
+        version: 0.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.7
+        version: 0.3.0
 description: The Flux 2 Ruby SDK is the language-specific package for Flux 2 on RunAPI.
   Use this package for image generation, image editing, and creative production workflows
   when your application needs request bodies, task status lookup, and consistent RunAPI
@@ -67,7 +67,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.17
 specification_version: 4
 summary: Flux 2 API Ruby SDK for RunAPI
 test_files: []