kie-ruby

gem "kie-ruby"

require "kie"

client = Kie::Client.new

require "kie"

client = Kie::Client.new(api_key: "your_api_key_here")

require "kie"

client = Kie::Client.new

# Create an image generation task
task = client.general.generate(
  model: "nano-banana-pro",
  input: { prompt: "A serene Japanese garden with cherry blossoms" },
  aspect_ratio: "16:9",
  resolution: "2K",
  output_format: "png"
)

# Wait for completion (polls automatically)
task.wait

# Get the generated image URLs
task.urls.each do |url|
  puts url
end

require "kie"

client = Kie::Client.new

# Create a music generation task
task = client.suno.generate(
  model: "V5",
  input: {
    prompt: "An upbeat electronic dance track with energetic synths",
    callback_url: "https://your-server.com/webhook"  # Optional webhook URL
  }
)

# Wait for completion with progress monitoring
task.wait(timeout: 600, interval: 5)

# Get the generated audio and cover image URLs
puts "Audio files:"
task.audio_urls.each { |url| puts "  #{url}" }

puts "Cover images:"
task.image_urls.each { |url| puts "  #{url}" }

task = client.suno.generate(
  model: "V5",
  input: {
    custom_mode: true,
    prompt: "[Verse]\nWalking through the city lights\n[Chorus]\nWe are alive tonight",
    style: "Pop, Electronic, Upbeat",
    title: "City Lights",
    callback_url: "https://your-server.com/webhook"
  }
)

task.wait(timeout: 600)

task.audio_urls.each { |url| puts url }

task = client.general.generate(model: "nano-banana-pro", input: { prompt: "A sunset" })

loop do
  task.refresh!

  case task.status
  when :processing
    puts "Still processing..."
  when :success
    puts "Done! URLs: #{task.urls}"
    break
  when :failed
    puts "Failed: #{task.error_message}"
    break
  end

  sleep 3
end

require "kie"

client = Kie::Client.new

begin
  task = client.general.generate(
    model: "nano-banana-pro",
    input: { prompt: "A beautiful landscape" }
  )
  task.wait

  puts task.urls
rescue Kie::AuthenticationError => e
  # Invalid or missing API key (HTTP 401)
  puts "Authentication failed: #{e.message}"

rescue Kie::InsufficientCreditsError => e
  # Not enough credits (HTTP 402)
  puts "Insufficient credits. Please top up your account."

rescue Kie::RateLimitError => e
  # Too many requests (HTTP 429)
  puts "Rate limited. Please wait and retry."
  sleep 10
  retry

rescue Kie::ContentPolicyError => e
  # Content violates policy (e.g., SENSITIVE_WORD_ERROR)
  puts "Content policy violation: #{e.message}"

rescue Kie::TimeoutError => e
  # Task did not complete within the timeout period
  puts "Task timed out"

rescue Kie::TaskFailedError => e
  # Task failed during processing
  puts "Task failed: #{e.message}"
  puts "Fail code: #{e.fail_code}"

rescue Kie::ApiError => e
  # Other API errors
  puts "API error (#{e.status_code}): #{e.message}"
end

task = client.suno.generate(
  model: "V5",
  input: { prompt: "A jazz song", callback_url: "https://your-server.com/webhook" }
)
task.wait(raise_on_failure: false)

if task.failed?
  puts "Task failed: #{task.error_message}"
else
  puts "Success! #{task.urls}"
end