legnext-ruby-sdk 1.0.0

data/lib/openapi_client/api/image_api.rb

@@ -0,0 +1,821 @@
+=begin
+#Midjourney api-unofficial by Legnext.ai
+
+## **Legnext.ai Midjourney API: The Ultimate AI Image Generation Toolkit**  Unlock the full creative potential of Midjourney directly within your applications and development workflows using the **Legnext.ai Midjourney API (Unofficial)**. This comprehensive collection offers a ready-to-integrate solution for professional image and video creation, manipulation, and high-fidelity upscaling.  We provide developers with **stable, high-performance API access** to the Midjourney model. Crucially, integrating our service requires **no Midjourney account**, eliminating the hassle of managing official subscriptions or Discord interactions. Our toolkit simplifies the entire text-to-image process, supporting complex prompts, aspect ratio adjustments, and advanced style parameters.  Focus on innovation while we handle the AI infrastructure. Start building scalable, visually stunning applications today with reliable access to the world’s leading generative AI model.
+
+The version of the OpenAPI document: 1.0.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.18.0
+
+=end
+
+require 'cgi'
+
+module OpenapiClient
+  class ImageApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Blend
+    # ## Combine Multiple Images into Unified Creation  Seamlessly blend 2-5 images together to create a single unique image that combines elements, styles, and concepts from all source images.  ### How it Works  Upload 2-5 image URLs and specify an aspect ratio. The API analyzes all images and creates a cohesive blend that merges their visual elements, colors, styles, and concepts.  ### Required Parameters  - `imgUrls` - Array of 2-5 image URLs to blend      - `aspect_ratio` - Output aspect ratio: \"2:3\" (portrait), \"1:1\" (square), or \"3:2\" (landscape)       ### Authentication  Requires a valid API key passed in the `x-api-key` header.  ### Response  Returns a task object. The blended images (4 variations) will be sent to your callback URL when complete (typically 60-90 seconds).  ### Use Cases  - Combine style references for unique visual concepts      - Merge product photos with artistic styles      - Create hybrid concepts from multiple references      - Blend textures and patterns for design work      - Mix character designs or architectural styles       ### Tips  - Works best with 2-3 images; more images create more abstract results      - All source images should be publicly accessible URLs      - The blend is conceptual, not a simple overlay      - Consider the aspect ratio based on your intended use      - Experiment with different image composition, color palettes, or subject matter for varied results.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [String] :body 
+    # @return [TaskResponse]
+    def api_v1_blend_post(opts = {})
+      data, _status_code, _headers = api_v1_blend_post_with_http_info(opts)
+      data
+    end
+
+    # Blend
+    # ## Combine Multiple Images into Unified Creation  Seamlessly blend 2-5 images together to create a single unique image that combines elements, styles, and concepts from all source images.  ### How it Works  Upload 2-5 image URLs and specify an aspect ratio. The API analyzes all images and creates a cohesive blend that merges their visual elements, colors, styles, and concepts.  ### Required Parameters  - `imgUrls` - Array of 2-5 image URLs to blend      - `aspect_ratio` - Output aspect ratio: \"2:3\" (portrait), \"1:1\" (square), or \"3:2\" (landscape)       ### Authentication  Requires a valid API key passed in the `x-api-key` header.  ### Response  Returns a task object. The blended images (4 variations) will be sent to your callback URL when complete (typically 60-90 seconds).  ### Use Cases  - Combine style references for unique visual concepts      - Merge product photos with artistic styles      - Create hybrid concepts from multiple references      - Blend textures and patterns for design work      - Mix character designs or architectural styles       ### Tips  - Works best with 2-3 images; more images create more abstract results      - All source images should be publicly accessible URLs      - The blend is conceptual, not a simple overlay      - Consider the aspect ratio based on your intended use      - Experiment with different image composition, color palettes, or subject matter for varied results.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [String] :body 
+    # @return [Array<(TaskResponse, Integer, Hash)>] TaskResponse data, response status code and response headers
+    def api_v1_blend_post_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ImageApi.api_v1_blend_post ...'
+      end
+      # resource path
+      local_var_path = '/api/v1/blend'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      header_params[:'x-api-key'] = opts[:'x_api_key'] if !opts[:'x_api_key'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'body'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TaskResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"ImageApi.api_v1_blend_post",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ImageApi#api_v1_blend_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Describe
+    # ## Generate Detailed Text Descriptions from Images  Analyze an image and generate detailed text descriptions that can be used as prompts for image generation. Perfect for reverse-engineering images or creating prompt variations.  ### How it Works  Provide an image URL and the API analyzes the image using AI, generating 4 different text descriptions that capture the image's content, style, mood, and composition.  ### Required Parameters  - `imgUrl` - Public URL of the image to analyze and describe       ### Authentication  Requires a valid API key passed in the `x-api-key` header.  ### Response  Returns a task object. The generated descriptions (typically 4 variations) will be sent to your callback URL when complete (typically 30-60 seconds).  ### Use Cases  - Reverse-engineer successful images to understand prompt styles      - Generate prompt variations from reference images      - Create training data for prompt engineering      - Document image libraries with AI-generated descriptions      - Learn effective prompt writing by analyzing AI descriptions       ### Tips  - Image URL must be publicly accessible      - Descriptions can be used directly as prompts for diffusion endpoint      - Each description offers a different perspective/focus on the image      - Useful for building prompt libraries from visual references      - Combine with your own modifications for customized prompts
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [TaskResponse]
+    def api_v1_describe_post(opts = {})
+      data, _status_code, _headers = api_v1_describe_post_with_http_info(opts)
+      data
+    end
+
+    # Describe
+    # ## Generate Detailed Text Descriptions from Images  Analyze an image and generate detailed text descriptions that can be used as prompts for image generation. Perfect for reverse-engineering images or creating prompt variations.  ### How it Works  Provide an image URL and the API analyzes the image using AI, generating 4 different text descriptions that capture the image&#39;s content, style, mood, and composition.  ### Required Parameters  - &#x60;imgUrl&#x60; - Public URL of the image to analyze and describe       ### Authentication  Requires a valid API key passed in the &#x60;x-api-key&#x60; header.  ### Response  Returns a task object. The generated descriptions (typically 4 variations) will be sent to your callback URL when complete (typically 30-60 seconds).  ### Use Cases  - Reverse-engineer successful images to understand prompt styles      - Generate prompt variations from reference images      - Create training data for prompt engineering      - Document image libraries with AI-generated descriptions      - Learn effective prompt writing by analyzing AI descriptions       ### Tips  - Image URL must be publicly accessible      - Descriptions can be used directly as prompts for diffusion endpoint      - Each description offers a different perspective/focus on the image      - Useful for building prompt libraries from visual references      - Combine with your own modifications for customized prompts
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [Array<(TaskResponse, Integer, Hash)>] TaskResponse data, response status code and response headers
+    def api_v1_describe_post_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ImageApi.api_v1_describe_post ...'
+      end
+      # resource path
+      local_var_path = '/api/v1/describe'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'x-api-key'] = opts[:'x_api_key'] if !opts[:'x_api_key'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'body'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TaskResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"ImageApi.api_v1_describe_post",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ImageApi#api_v1_describe_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Diffusion
+    # ## Generate Image from Text Prompt (Diffusion)  Creates AI-generated images from text descriptions using Midjourney's diffusion model. This endpoint processes your prompt asynchronously and delivers the generated image to your specified callback URL.  ### How It Works  Submit a text prompt describing the image you want to create. The API processes your request using Midjourney's AI model and sends the generated image result to your callback URL when complete. Processing typically takes 30-90 seconds depending on complexity and queue length.  ### Required Parameters  - **`text`** (string, required) - Your image description prompt          - Example: `\"A beautiful sunset over the snow mountains\"`              - Supports Midjourney parameters like `--v 7` (model version), `--draft` (draft mode), `--ar 16:9` (aspect ratio)              - Be specific and descriptive for best results          - **`callback`** (string, required) - HTTPS webhook URL to receive the result          - Must be publicly accessible and accept POST requests              - Example: `\"https://your-domain.com/webhook/image-result\"`              - The API will send the generated image data to this URL when processing completes           ### Authentication  Requires a valid API key in the `x-api-key` header. Store your API key securely in environment variables and never expose it in client-side code.  ### Response  Returns immediately with a task ID and status. The actual generated image will be delivered to your callback URL asynchronously once processing completes.  ### Common Use Cases  - Generate marketing visuals and social media content      - Create concept art and design mockups      - Produce unique illustrations for articles and presentations      - Prototype visual ideas before commissioning custom artwork      - Build AI-powered image generation features into your applications       ### Tips for Success  - **Be specific:** Detailed prompts produce better results (e.g., \"photorealistic mountain landscape at golden hour\" vs \"mountains\")      - **Use Midjourney parameters:** Add `--v 7` for the latest model version, `--ar 16:9` for widescreen format      - **Test your callback:** Ensure your webhook endpoint is accessible and can handle POST requests before submitting jobs      - **Handle async responses:** Implement proper webhook handling to receive and process results      - **Monitor task status:** Use the \"Get task response\" endpoint if you need to check job status manually       ### Related Endpoints  - **Get task response** - Check the status of your generation task      - **Variation** - Create variations of a generated image      - **Upscale** - Enhance the resolution of generated images      - **Reroll** - Generate alternative versions with the same prompt
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [ApiV1DiffusionPost200Response]
+    def api_v1_diffusion_post(opts = {})
+      data, _status_code, _headers = api_v1_diffusion_post_with_http_info(opts)
+      data
+    end
+
+    # Diffusion
+    # ## Generate Image from Text Prompt (Diffusion)  Creates AI-generated images from text descriptions using Midjourney&#39;s diffusion model. This endpoint processes your prompt asynchronously and delivers the generated image to your specified callback URL.  ### How It Works  Submit a text prompt describing the image you want to create. The API processes your request using Midjourney&#39;s AI model and sends the generated image result to your callback URL when complete. Processing typically takes 30-90 seconds depending on complexity and queue length.  ### Required Parameters  - **&#x60;text&#x60;** (string, required) - Your image description prompt          - Example: &#x60;\&quot;A beautiful sunset over the snow mountains\&quot;&#x60;              - Supports Midjourney parameters like &#x60;--v 7&#x60; (model version), &#x60;--draft&#x60; (draft mode), &#x60;--ar 16:9&#x60; (aspect ratio)              - Be specific and descriptive for best results          - **&#x60;callback&#x60;** (string, required) - HTTPS webhook URL to receive the result          - Must be publicly accessible and accept POST requests              - Example: &#x60;\&quot;https://your-domain.com/webhook/image-result\&quot;&#x60;              - The API will send the generated image data to this URL when processing completes           ### Authentication  Requires a valid API key in the &#x60;x-api-key&#x60; header. Store your API key securely in environment variables and never expose it in client-side code.  ### Response  Returns immediately with a task ID and status. The actual generated image will be delivered to your callback URL asynchronously once processing completes.  ### Common Use Cases  - Generate marketing visuals and social media content      - Create concept art and design mockups      - Produce unique illustrations for articles and presentations      - Prototype visual ideas before commissioning custom artwork      - Build AI-powered image generation features into your applications       ### Tips for Success  - **Be specific:** Detailed prompts produce better results (e.g., \&quot;photorealistic mountain landscape at golden hour\&quot; vs \&quot;mountains\&quot;)      - **Use Midjourney parameters:** Add &#x60;--v 7&#x60; for the latest model version, &#x60;--ar 16:9&#x60; for widescreen format      - **Test your callback:** Ensure your webhook endpoint is accessible and can handle POST requests before submitting jobs      - **Handle async responses:** Implement proper webhook handling to receive and process results      - **Monitor task status:** Use the \&quot;Get task response\&quot; endpoint if you need to check job status manually       ### Related Endpoints  - **Get task response** - Check the status of your generation task      - **Variation** - Create variations of a generated image      - **Upscale** - Enhance the resolution of generated images      - **Reroll** - Generate alternative versions with the same prompt
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [Array<(ApiV1DiffusionPost200Response, Integer, Hash)>] ApiV1DiffusionPost200Response data, response status code and response headers
+    def api_v1_diffusion_post_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ImageApi.api_v1_diffusion_post ...'
+      end
+      # resource path
+      local_var_path = '/api/v1/diffusion'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'x-api-key'] = opts[:'x_api_key'] if !opts[:'x_api_key'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'body'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ApiV1DiffusionPost200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"ImageApi.api_v1_diffusion_post",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ImageApi#api_v1_diffusion_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Edit
+    # ## Edit Images with Custom Canvas and Positioning  Perform advanced image editing by placing an image on a custom canvas with precise positioning control. Enables complex edits, extensions, and compositions.  ### How it Works  Place a selected image on a custom-sized canvas at specified coordinates. The API fills empty canvas areas with generated content based on your prompt, allowing for flexible composition and extensions.  ### Required Parameters  - `jobId` - UUID of the original image generation task      - `imageNo` - Image number to edit (0, 1, 2, or 3)      - `canvas` - Target canvas dimensions:          - `width` - Canvas width in pixels              - `height` - Canvas height in pixels          - `imgPos` - Image position on canvas:          - `width` - Image width in pixels              - `height` - Image height in pixels              - `x` - Horizontal offset from canvas top-left              - `y` - Vertical offset from canvas top-left          - `remixPrompt` - Prompt for filling empty canvas areas (1-8192 characters)       ### Authentication  Requires a valid API key passed in the `x-api-key` header.  ### Response  Returns a task object. The edited images (4 variations) will be sent to your callback URL when complete (typically 90-120 seconds).  ### Use Cases  - Create complex compositions with custom layouts      - Extend images asymmetrically in specific directions      - Place subjects in entirely new contexts      - Generate custom aspect ratios with filled backgrounds      - Build complex scenes by positioning and extending images       ### Tips  - Canvas dimensions define the final output size      - imgPos coordinates place your image within the canvas      - Empty canvas areas are generated based on remixPrompt      - More flexible than pan/outpaint for asymmetric extensions      - Useful for precise aspect ratio and positioning control
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [ApiV1EditPost200Response]
+    def api_v1_edit_post(opts = {})
+      data, _status_code, _headers = api_v1_edit_post_with_http_info(opts)
+      data
+    end
+
+    # Edit
+    # ## Edit Images with Custom Canvas and Positioning  Perform advanced image editing by placing an image on a custom canvas with precise positioning control. Enables complex edits, extensions, and compositions.  ### How it Works  Place a selected image on a custom-sized canvas at specified coordinates. The API fills empty canvas areas with generated content based on your prompt, allowing for flexible composition and extensions.  ### Required Parameters  - &#x60;jobId&#x60; - UUID of the original image generation task      - &#x60;imageNo&#x60; - Image number to edit (0, 1, 2, or 3)      - &#x60;canvas&#x60; - Target canvas dimensions:          - &#x60;width&#x60; - Canvas width in pixels              - &#x60;height&#x60; - Canvas height in pixels          - &#x60;imgPos&#x60; - Image position on canvas:          - &#x60;width&#x60; - Image width in pixels              - &#x60;height&#x60; - Image height in pixels              - &#x60;x&#x60; - Horizontal offset from canvas top-left              - &#x60;y&#x60; - Vertical offset from canvas top-left          - &#x60;remixPrompt&#x60; - Prompt for filling empty canvas areas (1-8192 characters)       ### Authentication  Requires a valid API key passed in the &#x60;x-api-key&#x60; header.  ### Response  Returns a task object. The edited images (4 variations) will be sent to your callback URL when complete (typically 90-120 seconds).  ### Use Cases  - Create complex compositions with custom layouts      - Extend images asymmetrically in specific directions      - Place subjects in entirely new contexts      - Generate custom aspect ratios with filled backgrounds      - Build complex scenes by positioning and extending images       ### Tips  - Canvas dimensions define the final output size      - imgPos coordinates place your image within the canvas      - Empty canvas areas are generated based on remixPrompt      - More flexible than pan/outpaint for asymmetric extensions      - Useful for precise aspect ratio and positioning control
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [Array<(ApiV1EditPost200Response, Integer, Hash)>] ApiV1EditPost200Response data, response status code and response headers
+    def api_v1_edit_post_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ImageApi.api_v1_edit_post ...'
+      end
+      # resource path
+      local_var_path = '/api/v1/edit'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'x-api-key'] = opts[:'x_api_key'] if !opts[:'x_api_key'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'body'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ApiV1EditPost200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"ImageApi.api_v1_edit_post",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ImageApi#api_v1_edit_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Inpaint
+    # ## Selectively Modify Image Regions with Masks  Repaint or modify specific regions within an existing image using mask-based editing. Target precise areas for changes while preserving the rest of the image.  ### How it Works  Select an image and define regions to modify using either polygon coordinates or a mask image URL. Optionally provide a prompt to guide what should appear in those regions. The API regenerates only the masked areas.  ### Required Parameters  - `jobId` - UUID of the original image generation task      - `imageNo` - Image number to edit (0, 1, 2, or 3)      - `mask` - Regions to repaint (use either areas array or url):          - `areas` - Array of polygons with width, height, and points (XYXY coordinates)              - `url` - Black and white mask image URL (white areas will be repainted)          - `remixPrompt` - Optional prompt for the repaint area (1-8192 characters)       ### Authentication  Requires a valid API key passed in the `x-api-key` header.  ### Response  Returns a task object. The inpainted images (4 variations) will be sent to your callback URL when complete (typically 90-120 seconds).  ### Use Cases  - Remove unwanted objects from images      - Replace specific elements while keeping surroundings      - Modify facial expressions or poses      - Change colors or textures in targeted areas      - Fix specific issues without regenerating entire image       ### Tips  - Polygon points format: \\[x1,y1, x2,y2, x3,y3, x4,y4\\] in clockwise order      - Mask images: white = repaint, black = keep original      - Use remixPrompt to specify what should replace masked content      - Smaller masks give more precise control      - Can apply multiple polygon areas in a single request
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [TaskResponse]
+    def api_v1_inpaint_post(opts = {})
+      data, _status_code, _headers = api_v1_inpaint_post_with_http_info(opts)
+      data
+    end
+
+    # Inpaint
+    # ## Selectively Modify Image Regions with Masks  Repaint or modify specific regions within an existing image using mask-based editing. Target precise areas for changes while preserving the rest of the image.  ### How it Works  Select an image and define regions to modify using either polygon coordinates or a mask image URL. Optionally provide a prompt to guide what should appear in those regions. The API regenerates only the masked areas.  ### Required Parameters  - &#x60;jobId&#x60; - UUID of the original image generation task      - &#x60;imageNo&#x60; - Image number to edit (0, 1, 2, or 3)      - &#x60;mask&#x60; - Regions to repaint (use either areas array or url):          - &#x60;areas&#x60; - Array of polygons with width, height, and points (XYXY coordinates)              - &#x60;url&#x60; - Black and white mask image URL (white areas will be repainted)          - &#x60;remixPrompt&#x60; - Optional prompt for the repaint area (1-8192 characters)       ### Authentication  Requires a valid API key passed in the &#x60;x-api-key&#x60; header.  ### Response  Returns a task object. The inpainted images (4 variations) will be sent to your callback URL when complete (typically 90-120 seconds).  ### Use Cases  - Remove unwanted objects from images      - Replace specific elements while keeping surroundings      - Modify facial expressions or poses      - Change colors or textures in targeted areas      - Fix specific issues without regenerating entire image       ### Tips  - Polygon points format: \\[x1,y1, x2,y2, x3,y3, x4,y4\\] in clockwise order      - Mask images: white &#x3D; repaint, black &#x3D; keep original      - Use remixPrompt to specify what should replace masked content      - Smaller masks give more precise control      - Can apply multiple polygon areas in a single request
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [Array<(TaskResponse, Integer, Hash)>] TaskResponse data, response status code and response headers
+    def api_v1_inpaint_post_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ImageApi.api_v1_inpaint_post ...'
+      end
+      # resource path
+      local_var_path = '/api/v1/inpaint'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'x-api-key'] = opts[:'x_api_key'] if !opts[:'x_api_key'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'body'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TaskResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"ImageApi.api_v1_inpaint_post",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ImageApi#api_v1_inpaint_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Outpaint
+    # ## Expand Images in All Directions  Extend an image uniformly in all directions using intelligent outpainting. Creates a larger canvas while maintaining the original image at the center.  ### How it Works  Select an image and specify scale factor. The API expands the canvas uniformly in all directions and generates new content that naturally continues the scene on all sides.  ### Required Parameters  - `jobId` - UUID of the original image generation task      - `imageNo` - Image number to expand (0, 1, 2, or 3)      - `scale` - Extension scale ratio (1.1 to 2.0, e.g., 1.5 = 50% larger in all directions)      - `remixPrompt` - Optional prompt to guide the outpainted areas (1-8192 characters)       ### Authentication  Requires a valid API key passed in the `x-api-key` header.  ### Response  Returns a task object. The outpainted images (4 variations) will be sent to your callback URL when complete (typically 90-120 seconds).  ### Use Cases  - Add environmental context around subject-focused images      - Create wider scenes from cropped compositions      - Extend backgrounds for design flexibility      - Generate variations with different surrounding content      - Prepare images for different aspect ratios       ### Tips  - Scale range 1.1-2.0 (outpaint is more conservative than pan)      - Use remixPrompt to describe desired surrounding content      - Great for adding context without losing the original subject      - Original image remains intact at center      - Compare with pan for directional control vs. uniform expansion
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [TaskResponse]
+    def api_v1_outpaint_post(opts = {})
+      data, _status_code, _headers = api_v1_outpaint_post_with_http_info(opts)
+      data
+    end
+
+    # Outpaint
+    # ## Expand Images in All Directions  Extend an image uniformly in all directions using intelligent outpainting. Creates a larger canvas while maintaining the original image at the center.  ### How it Works  Select an image and specify scale factor. The API expands the canvas uniformly in all directions and generates new content that naturally continues the scene on all sides.  ### Required Parameters  - &#x60;jobId&#x60; - UUID of the original image generation task      - &#x60;imageNo&#x60; - Image number to expand (0, 1, 2, or 3)      - &#x60;scale&#x60; - Extension scale ratio (1.1 to 2.0, e.g., 1.5 &#x3D; 50% larger in all directions)      - &#x60;remixPrompt&#x60; - Optional prompt to guide the outpainted areas (1-8192 characters)       ### Authentication  Requires a valid API key passed in the &#x60;x-api-key&#x60; header.  ### Response  Returns a task object. The outpainted images (4 variations) will be sent to your callback URL when complete (typically 90-120 seconds).  ### Use Cases  - Add environmental context around subject-focused images      - Create wider scenes from cropped compositions      - Extend backgrounds for design flexibility      - Generate variations with different surrounding content      - Prepare images for different aspect ratios       ### Tips  - Scale range 1.1-2.0 (outpaint is more conservative than pan)      - Use remixPrompt to describe desired surrounding content      - Great for adding context without losing the original subject      - Original image remains intact at center      - Compare with pan for directional control vs. uniform expansion
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [Array<(TaskResponse, Integer, Hash)>] TaskResponse data, response status code and response headers
+    def api_v1_outpaint_post_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ImageApi.api_v1_outpaint_post ...'
+      end
+      # resource path
+      local_var_path = '/api/v1/outpaint'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'x-api-key'] = opts[:'x_api_key'] if !opts[:'x_api_key'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'body'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TaskResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"ImageApi.api_v1_outpaint_post",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ImageApi#api_v1_outpaint_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Pan
+    # ## Extend Images in Specific Direction  Expand an image in a single specified direction (up, down, left, or right) with precision scale control. Generates new content that seamlessly continues the original image.  ### How it Works  Select an image and specify direction and scale. The API extends the canvas in that direction and generates new content that naturally continues the scene, maintaining style and coherence.  ### Required Parameters  - `jobId` - UUID of the original image generation task      - `imageNo` - Image number to extend (0, 1, 2, or 3)      - `direction` - Extension direction: 0=Down, 1=Right, 2=Up, 3=Left      - `scale` - Extension scale ratio (1.1 to 3.0, e.g., 1.5 = 50% larger in that direction)      - `remixPrompt` - Optional prompt to guide the extended content (1-8192 characters)       ### Authentication  Requires a valid API key passed in the `x-api-key` header.  ### Response  Returns a task object. The extended images (4 variations) will be sent to your callback URL when complete (typically 90-120 seconds).  ### Use Cases  - Create wider landscape compositions from square images      - Extend portraits to include more environmental context      - Add vertical space for text overlays or additional content      - Build panoramic views from single images      - Adjust aspect ratios for different platform requirements       ### Tips  - Use remixPrompt to specify what should appear in the extended area      - Scale 1.5 is a good starting point (50% extension)      - Higher scales (2.0-3.0) create more new content but may lose coherence      - Works directionally - use outpaint for all-direction expansion      - Can be applied multiple times in different directions
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [ApiV1PanPost200Response]
+    def api_v1_pan_post(opts = {})
+      data, _status_code, _headers = api_v1_pan_post_with_http_info(opts)
+      data
+    end
+
+    # Pan
+    # ## Extend Images in Specific Direction  Expand an image in a single specified direction (up, down, left, or right) with precision scale control. Generates new content that seamlessly continues the original image.  ### How it Works  Select an image and specify direction and scale. The API extends the canvas in that direction and generates new content that naturally continues the scene, maintaining style and coherence.  ### Required Parameters  - &#x60;jobId&#x60; - UUID of the original image generation task      - &#x60;imageNo&#x60; - Image number to extend (0, 1, 2, or 3)      - &#x60;direction&#x60; - Extension direction: 0&#x3D;Down, 1&#x3D;Right, 2&#x3D;Up, 3&#x3D;Left      - &#x60;scale&#x60; - Extension scale ratio (1.1 to 3.0, e.g., 1.5 &#x3D; 50% larger in that direction)      - &#x60;remixPrompt&#x60; - Optional prompt to guide the extended content (1-8192 characters)       ### Authentication  Requires a valid API key passed in the &#x60;x-api-key&#x60; header.  ### Response  Returns a task object. The extended images (4 variations) will be sent to your callback URL when complete (typically 90-120 seconds).  ### Use Cases  - Create wider landscape compositions from square images      - Extend portraits to include more environmental context      - Add vertical space for text overlays or additional content      - Build panoramic views from single images      - Adjust aspect ratios for different platform requirements       ### Tips  - Use remixPrompt to specify what should appear in the extended area      - Scale 1.5 is a good starting point (50% extension)      - Higher scales (2.0-3.0) create more new content but may lose coherence      - Works directionally - use outpaint for all-direction expansion      - Can be applied multiple times in different directions
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [Array<(ApiV1PanPost200Response, Integer, Hash)>] ApiV1PanPost200Response data, response status code and response headers
+    def api_v1_pan_post_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ImageApi.api_v1_pan_post ...'
+      end
+      # resource path
+      local_var_path = '/api/v1/pan'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'x-api-key'] = opts[:'x_api_key'] if !opts[:'x_api_key'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'body'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ApiV1PanPost200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"ImageApi.api_v1_pan_post",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ImageApi#api_v1_pan_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Remix
+    # ## Transform Images with New Prompts  Apply a new text prompt to an existing image, transforming it while maintaining aspects of the original composition. Controllable intensity for subtle or dramatic changes.  ### How it Works  Select an image and provide a new prompt. The API applies the new description to the existing image, creating variations that blend the original structure with the new concept. Intensity mode controls how strongly the new prompt is applied.  ### Required Parameters  - `jobId` - UUID of the original image generation task      - `imageNo` - Image number to remix (0, 1, 2, or 3)      - `remixPrompt` - New prompt to apply to the image (1-8192 characters)      - `mode` - Remix intensity: 0=Strong (significant transformation), 1=Subtle (light transformation)       ### Authentication  Requires a valid API key passed in the `x-api-key` header.  ### Response  Returns a task object. The remixed images (4 variations) will be sent to your callback URL when complete (typically 90-120 seconds).  ### Use Cases  - Change the style or mood of an existing image      - Apply different artistic directions to the same composition      - Modify time of day, weather, or season in scenes      - Transform realistic images to artistic styles (or vice versa)      - Iterate on concepts by applying different prompts       ### Tips  - Mode 0 (Strong) makes dramatic changes while keeping some structure      - Mode 1 (Subtle) makes gentle modifications, preserving more of the original      - Remix prompt completely replaces the original prompt      - Great for style transfer and conceptual variations      - Experiment with both modes to find the right balance
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [TaskResponse]
+    def api_v1_remix_post(opts = {})
+      data, _status_code, _headers = api_v1_remix_post_with_http_info(opts)
+      data
+    end
+
+    # Remix
+    # ## Transform Images with New Prompts  Apply a new text prompt to an existing image, transforming it while maintaining aspects of the original composition. Controllable intensity for subtle or dramatic changes.  ### How it Works  Select an image and provide a new prompt. The API applies the new description to the existing image, creating variations that blend the original structure with the new concept. Intensity mode controls how strongly the new prompt is applied.  ### Required Parameters  - &#x60;jobId&#x60; - UUID of the original image generation task      - &#x60;imageNo&#x60; - Image number to remix (0, 1, 2, or 3)      - &#x60;remixPrompt&#x60; - New prompt to apply to the image (1-8192 characters)      - &#x60;mode&#x60; - Remix intensity: 0&#x3D;Strong (significant transformation), 1&#x3D;Subtle (light transformation)       ### Authentication  Requires a valid API key passed in the &#x60;x-api-key&#x60; header.  ### Response  Returns a task object. The remixed images (4 variations) will be sent to your callback URL when complete (typically 90-120 seconds).  ### Use Cases  - Change the style or mood of an existing image      - Apply different artistic directions to the same composition      - Modify time of day, weather, or season in scenes      - Transform realistic images to artistic styles (or vice versa)      - Iterate on concepts by applying different prompts       ### Tips  - Mode 0 (Strong) makes dramatic changes while keeping some structure      - Mode 1 (Subtle) makes gentle modifications, preserving more of the original      - Remix prompt completely replaces the original prompt      - Great for style transfer and conceptual variations      - Experiment with both modes to find the right balance
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [Array<(TaskResponse, Integer, Hash)>] TaskResponse data, response status code and response headers
+    def api_v1_remix_post_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ImageApi.api_v1_remix_post ...'
+      end
+      # resource path
+      local_var_path = '/api/v1/remix'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'x-api-key'] = opts[:'x_api_key'] if !opts[:'x_api_key'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'body'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TaskResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"ImageApi.api_v1_remix_post",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ImageApi#api_v1_remix_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Reroll
+    # ## Re-execute Task with Same Parameters  Regenerate a new set of images using the exact same parameters as a previous task. This is equivalent to running the original request again with identical settings.  ### How it Works  Provide a previous task's job ID and the API will execute the same generation with the same prompt and parameters, producing 4 completely new variations.  ### Required Parameters  - `jobId` - UUID of the task to reroll       ### Authentication  Requires a valid API key passed in the `x-api-key` header.  ### Response  Returns a new task object with different `job_id`. The rerolled images (4 new variations) will be sent to your callback URL when complete (typically 60-90 seconds).  ### Use Cases  - Try the same prompt again if initial results didn't meet expectations      - Generate additional variations without retyping prompts      - Explore different random seeds for the same concept      - Create more options from successful prompts       ### Tips  - Reroll uses the exact same parameters as the original task      - Results will be completely different due to different random seeds      - Consider using variation endpoint instead if you want to build on a specific result      - You can reroll any completed task, even from previous sessions
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [TaskResponse]
+    def api_v1_reroll_post(opts = {})
+      data, _status_code, _headers = api_v1_reroll_post_with_http_info(opts)
+      data
+    end
+
+    # Reroll
+    # ## Re-execute Task with Same Parameters  Regenerate a new set of images using the exact same parameters as a previous task. This is equivalent to running the original request again with identical settings.  ### How it Works  Provide a previous task&#39;s job ID and the API will execute the same generation with the same prompt and parameters, producing 4 completely new variations.  ### Required Parameters  - &#x60;jobId&#x60; - UUID of the task to reroll       ### Authentication  Requires a valid API key passed in the &#x60;x-api-key&#x60; header.  ### Response  Returns a new task object with different &#x60;job_id&#x60;. The rerolled images (4 new variations) will be sent to your callback URL when complete (typically 60-90 seconds).  ### Use Cases  - Try the same prompt again if initial results didn&#39;t meet expectations      - Generate additional variations without retyping prompts      - Explore different random seeds for the same concept      - Create more options from successful prompts       ### Tips  - Reroll uses the exact same parameters as the original task      - Results will be completely different due to different random seeds      - Consider using variation endpoint instead if you want to build on a specific result      - You can reroll any completed task, even from previous sessions
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [Array<(TaskResponse, Integer, Hash)>] TaskResponse data, response status code and response headers
+    def api_v1_reroll_post_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ImageApi.api_v1_reroll_post ...'
+      end
+      # resource path
+      local_var_path = '/api/v1/reroll'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'x-api-key'] = opts[:'x_api_key'] if !opts[:'x_api_key'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'body'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TaskResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"ImageApi.api_v1_reroll_post",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ImageApi#api_v1_reroll_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Shorten
+    # ## Simplify Prompts to Essential Elements  Analyze a long or complex prompt and reduce it to its most essential and impactful elements, maintaining effectiveness while improving clarity.  ### How it Works  Submit a lengthy prompt and the API analyzes it using AI, identifying the most important elements and removing redundancy. Returns multiple shortened variations.  ### Required Parameters  - `prompt` - The text prompt to simplify (1-8192 characters)       ### Authentication  Requires a valid API key passed in the `x-api-key` header.  ### Response  Returns a task object. The shortened prompt variations will be sent to your callback URL when complete (typically 20-40 seconds).  ### Use Cases  - Optimize overly verbose prompts for better results      - Learn which prompt elements are most impactful      - Reduce token usage in prompt-based workflows      - Clean up accumulated prompt modifications      - Simplify complex prompts for better model understanding       ### Tips  - Particularly useful for prompts over 100 words      - The AI preserves key descriptive elements while removing filler      - Multiple variations help you choose the best simplified version      - Test both original and shortened prompts to compare results      - Great for learning concise prompt writing techniques
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [TaskResponse]
+    def api_v1_shorten_post(opts = {})
+      data, _status_code, _headers = api_v1_shorten_post_with_http_info(opts)
+      data
+    end
+
+    # Shorten
+    # ## Simplify Prompts to Essential Elements  Analyze a long or complex prompt and reduce it to its most essential and impactful elements, maintaining effectiveness while improving clarity.  ### How it Works  Submit a lengthy prompt and the API analyzes it using AI, identifying the most important elements and removing redundancy. Returns multiple shortened variations.  ### Required Parameters  - &#x60;prompt&#x60; - The text prompt to simplify (1-8192 characters)       ### Authentication  Requires a valid API key passed in the &#x60;x-api-key&#x60; header.  ### Response  Returns a task object. The shortened prompt variations will be sent to your callback URL when complete (typically 20-40 seconds).  ### Use Cases  - Optimize overly verbose prompts for better results      - Learn which prompt elements are most impactful      - Reduce token usage in prompt-based workflows      - Clean up accumulated prompt modifications      - Simplify complex prompts for better model understanding       ### Tips  - Particularly useful for prompts over 100 words      - The AI preserves key descriptive elements while removing filler      - Multiple variations help you choose the best simplified version      - Test both original and shortened prompts to compare results      - Great for learning concise prompt writing techniques
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [Array<(TaskResponse, Integer, Hash)>] TaskResponse data, response status code and response headers
+    def api_v1_shorten_post_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ImageApi.api_v1_shorten_post ...'
+      end
+      # resource path
+      local_var_path = '/api/v1/shorten'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'x-api-key'] = opts[:'x_api_key'] if !opts[:'x_api_key'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'body'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TaskResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"ImageApi.api_v1_shorten_post",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ImageApi#api_v1_shorten_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Upscale
+    # ## Enhance Image Resolution and Quality  Upscale and enhance one of your generated images to higher resolution with AI-powered quality improvement. Produces a single high-resolution version of the selected image.  ### How it Works  Select one image from a generation task and choose upscaling type. The API processes the image to increase resolution while adding detail and clarity based on the selected upscaling mode.  ### Required Parameters  - `jobId` - UUID of the original image generation task      - `imageNo` - Image number to upscale (0, 1, 2, or 3)      - `type` - Upscaling type: 0=Subtle (conservative enhancement), 1=Creative (adds detail and interpretation)       ### Authentication  Requires a valid API key passed in the `x-api-key` header.  ### Response  Returns a task object. The upscaled image (single high-resolution output) will be sent to your callback URL when complete (typically 90-120 seconds).  ### Use Cases  - Prepare images for print or high-resolution displays      - Enhance selected variations for final delivery      - Create detailed versions for client presentations      - Generate production-ready assets from generations       ### Tips  - Type 0 (Subtle) is safer for preserving exact details      - Type 1 (Creative) works well for artistic images where added interpretation is acceptable      - Upscaling is typically the final step after selecting your preferred variation      - Output resolution is significantly higher than the original 4-image grid
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [TaskResponse]
+    def api_v1_upscale_post(opts = {})
+      data, _status_code, _headers = api_v1_upscale_post_with_http_info(opts)
+      data
+    end
+
+    # Upscale
+    # ## Enhance Image Resolution and Quality  Upscale and enhance one of your generated images to higher resolution with AI-powered quality improvement. Produces a single high-resolution version of the selected image.  ### How it Works  Select one image from a generation task and choose upscaling type. The API processes the image to increase resolution while adding detail and clarity based on the selected upscaling mode.  ### Required Parameters  - &#x60;jobId&#x60; - UUID of the original image generation task      - &#x60;imageNo&#x60; - Image number to upscale (0, 1, 2, or 3)      - &#x60;type&#x60; - Upscaling type: 0&#x3D;Subtle (conservative enhancement), 1&#x3D;Creative (adds detail and interpretation)       ### Authentication  Requires a valid API key passed in the &#x60;x-api-key&#x60; header.  ### Response  Returns a task object. The upscaled image (single high-resolution output) will be sent to your callback URL when complete (typically 90-120 seconds).  ### Use Cases  - Prepare images for print or high-resolution displays      - Enhance selected variations for final delivery      - Create detailed versions for client presentations      - Generate production-ready assets from generations       ### Tips  - Type 0 (Subtle) is safer for preserving exact details      - Type 1 (Creative) works well for artistic images where added interpretation is acceptable      - Upscaling is typically the final step after selecting your preferred variation      - Output resolution is significantly higher than the original 4-image grid
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [Array<(TaskResponse, Integer, Hash)>] TaskResponse data, response status code and response headers
+    def api_v1_upscale_post_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ImageApi.api_v1_upscale_post ...'
+      end
+      # resource path
+      local_var_path = '/api/v1/upscale'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'x-api-key'] = opts[:'x_api_key'] if !opts[:'x_api_key'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'body'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TaskResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"ImageApi.api_v1_upscale_post",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ImageApi#api_v1_upscale_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Variation
+    # ## Create Controlled Variations of Existing Images  Generate new variations of a specific image from a previous generation task with controllable transformation intensity. Perfect for exploring different interpretations while maintaining the core composition.  ### How it Works  Select one of the 4 generated images from a diffusion task and create variations with either subtle or strong intensity. The API generates 4 new variations based on your selected image and intensity setting.  ### Required Parameters  - `jobId` - UUID of the original image generation task      - `imageNo` - Image number to vary (0, 1, 2, or 3)      - `type` - Variation intensity: 0=Subtle (minor changes), 1=Strong (major changes)      - `remixPrompt` - Optional additional prompt for guided variation (1-8192 characters)       ### Authentication  Requires a valid API key passed in the `x-api-key` header.  ### Response  Returns a new task object with `job_id`. The 4 variation images will be sent to your callback URL when processing completes (typically 60-90 seconds).  ### Use Cases  - Explore different interpretations of a successful generation      - Fine-tune specific aspects of an image      - Create multiple versions for A/B testing      - Generate variations for client review      - Remix images with additional prompt guidance       ### Tips  - Use type=0 (subtle) for minor refinements, type=1 (strong) for significant changes      - Add remixPrompt to guide the variation in a specific direction      - The original composition and structure are generally preserved      - Can chain variations: create variations of variations for iterative refinement
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [TaskResponse]
+    def api_v1_variation_post(opts = {})
+      data, _status_code, _headers = api_v1_variation_post_with_http_info(opts)
+      data
+    end
+
+    # Variation
+    # ## Create Controlled Variations of Existing Images  Generate new variations of a specific image from a previous generation task with controllable transformation intensity. Perfect for exploring different interpretations while maintaining the core composition.  ### How it Works  Select one of the 4 generated images from a diffusion task and create variations with either subtle or strong intensity. The API generates 4 new variations based on your selected image and intensity setting.  ### Required Parameters  - &#x60;jobId&#x60; - UUID of the original image generation task      - &#x60;imageNo&#x60; - Image number to vary (0, 1, 2, or 3)      - &#x60;type&#x60; - Variation intensity: 0&#x3D;Subtle (minor changes), 1&#x3D;Strong (major changes)      - &#x60;remixPrompt&#x60; - Optional additional prompt for guided variation (1-8192 characters)       ### Authentication  Requires a valid API key passed in the &#x60;x-api-key&#x60; header.  ### Response  Returns a new task object with &#x60;job_id&#x60;. The 4 variation images will be sent to your callback URL when processing completes (typically 60-90 seconds).  ### Use Cases  - Explore different interpretations of a successful generation      - Fine-tune specific aspects of an image      - Create multiple versions for A/B testing      - Generate variations for client review      - Remix images with additional prompt guidance       ### Tips  - Use type&#x3D;0 (subtle) for minor refinements, type&#x3D;1 (strong) for significant changes      - Add remixPrompt to guide the variation in a specific direction      - The original composition and structure are generally preserved      - Can chain variations: create variations of variations for iterative refinement
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_api_key 
+    # @option opts [Object] :body 
+    # @return [Array<(TaskResponse, Integer, Hash)>] TaskResponse data, response status code and response headers
+    def api_v1_variation_post_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ImageApi.api_v1_variation_post ...'
+      end
+      # resource path
+      local_var_path = '/api/v1/variation'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'x-api-key'] = opts[:'x_api_key'] if !opts[:'x_api_key'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'body'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TaskResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"ImageApi.api_v1_variation_post",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ImageApi#api_v1_variation_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end