FluxTokens Ruby SDK

gem 'fluxtokens'

require 'fluxtokens'

client = FluxTokens::Client.new(api_key: 'sk-flux-your-api-key')

response = client.chat.completions.create(
  model: 'gpt-4.1-mini',
  messages: [
    { role: 'system', content: 'You are a helpful assistant.' },
    { role: 'user', content: 'Hello!' }
  ]
)

puts response.choices[0].message.content

response = client.chat.completions.create(
  model: 'gpt-4.1-mini',
  messages: [{ role: 'user', content: 'What is the capital of France?' }],
  temperature: 0.7,
  max_tokens: 256
)

puts response.choices[0].message.content
# Output: "The capital of France is Paris."

stream = client.chat.completions.create(
  model: 'gemini-2.5-flash',
  messages: [{ role: 'user', content: 'Write a haiku about programming.' }],
  stream: true
)

stream.each do |chunk|
  content = chunk.choices[0].delta.content
  print content if content
end

response = client.chat.completions.create(
  model: 'gpt-4.1-mini',
  messages: [
    {
      role: 'user',
      content: [
        { type: 'text', text: 'What is in this image?' },
        {
          type: 'image_url',
          image_url: {
            url: 'https://example.com/image.jpg',
            detail: 'high'
          }
        }
      ]
    }
  ],
  max_tokens: 500
)

require 'base64'

audio_data = Base64.strict_encode64(File.read('audio.mp3'))

response = client.chat.completions.create(
  model: 'gemini-2.5-flash',
  messages: [
    {
      role: 'user',
      content: [
        { type: 'text', text: 'Transcribe this audio:' },
        {
          type: 'input_audio',
          input_audio: {
            data: audio_data,
            format: 'mp3'
          }
        }
      ]
    }
  ]
)

response = client.chat.completions.create(
  model: 'gpt-4.1-mini',
  messages: [
    { role: 'system', content: 'You are a pirate. Always respond in pirate speak.' },
    { role: 'user', content: 'How are you today?' }
  ]
)
# Output: "Ahoy, matey! I be doin' just fine, thank ye fer askin'!"

client.models.list.each do |model|
  puts "#{model.name} (#{model.provider})"
  puts "  Input: $#{model.input_price}/1M tokens"
  puts "  Output: $#{model.output_price}/1M tokens"
  puts "  Vision: #{model.supports_vision ? '✅' : '❌'}"
end

client = FluxTokens::Client.new(
  api_key: 'sk-flux-...',
  base_url: 'https://api.fluxtokens.io', # Custom base URL
  timeout: 60,                            # Request timeout in seconds
  max_retries: 3                          # Max retries on rate limit/server errors
)

begin
  response = client.chat.completions.create(
    model: 'gpt-4.1-mini',
    messages: [{ role: 'user', content: 'Hello' }]
  )
rescue FluxTokens::AuthenticationError
  puts "Invalid API key"
rescue FluxTokens::RateLimitError => e
  puts "Rate limit exceeded, retry after: #{e.retry_after}"
rescue FluxTokens::InsufficientBalanceError
  puts "Please add credits at https://fluxtokens.io/dashboard/billing"
rescue FluxTokens::BadRequestError => e
  puts "Invalid request: #{e.message}"
rescue FluxTokens::Error => e
  puts "Error: #{e.message}"
end