Ruby video SDK

# Averages the quality-of-experience score over the last 24 hours
res = s.metrics.list_overall_values(
  metric_id:   Models::Operations::MetricId::QUALITY_OF_EXPERIENCE_SCORE,
  timespan:    Models::Operations::Timespan::TWENTYFOUR_COLON_HOURS,
  filter_by:   'browser_name:Chrome',
  measurement: 'avg',
)

Which QoE metrics actually deserve an alert is covered in this working reference.

• How do I upload a video in Ruby?

  Two ways. Give s.input_video.create_media a URL of a file you already host, passed as keyword arguments, and FastPix fetches it. Or open a direct upload, which returns a signed URL your own code sends the file to. The first suits a backend job, the second a user-facing form. Both hand back a media ID.

• Do I need FFmpeg to handle video in Ruby?

  No. Most Ruby answers point at streamio-ffmpeg and a Sidekiq worker, which means the binary and the queue are both now yours. FastPix encodes on its side, so your Ruby code only makes API calls. You never install FFmpeg, size a worker box, or maintain a rendition ladder for every device you care about.

• How do I convert a video to HLS in Ruby?

  You do not convert it yourself. s.input_video.create_media creates the media entry, FastPix produces the HLS renditions, and s.playback.create_media_playback_id hands you the ID a player streams from. There is no ffmpeg command, no segmenting step and no manifest to write. Renditions are chosen per title rather than from a fixed preset, so a screen recording and an action scene do not get the same treatment.

• Does the SDK work with Rails and Sidekiq?

  Yes. Build the client once in an initializer and reuse it across Rails controllers, Sidekiq workers and Sinatra routes. Because calls block on Faraday, put anything slow in a background job. Each method accepts timeout_ms so one slow call cannot hold a worker open.

• How do I add live streaming to a Ruby app?

  Ask the live stream namespace for a stream key. Point OBS, vMix, a mobile app or hardware at it over RTMP, RTMPS or SRT. FastPix delivers low-latency HLS and records the broadcast. Provision streams from a background job, since the call blocks the worker while it waits.

• How do I play a video after uploading it?

  Creating the media entry gives you a media ID. Pass it to s.playback.create_media_playback_id to get a playback ID, then hand that to a player or an HLS URL. Public IDs play for anyone; signed IDs open only for a token your service mints, which is how you gate paid content.

• What happens when a FastPix request fails in Ruby?

  Failures raise FastpixClient::Models::Errors::APIError, carrying message, status_code, body and the raw Faraday response. Rescue it around the call itself. Note that the per-operation docs place the call outside the begin block, where the rescue can never fire, so follow the README form instead.

• Does the Ruby SDK verify webhook signatures?

  No. Only the Node SDK ships a verification helper. In Ruby you compute the digest with OpenSSL HMAC against your shared secret, then compare it to the signature header using a constant-time check before trusting the payload. The webhook reference documents the scheme.

• How do I get video analytics in Ruby?

  The metrics methods return overall values, breakdowns, timeseries and comparisons, with per-view records alongside. Metric and timespan are module constants rather than bare strings, so a typo fails early. Video Data captures 56 dimensions per session, ten of which you name yourself.

• Can I upload large video files from a browser?

  Yes, but not with this SDK. Your Rails app mints the signed upload URL and returns it to the browser, then a client-side upload SDK moves the bytes in resumable chunks with pause, resume and retry. The file never passes through your Ruby process at all.

• How do I stop people sharing my video link?

  Use a signed playback ID instead of a public one. Your Rails app decides who is entitled and signs a short-lived token, and FastPix refuses playback without it. You can also lock playback to named domains, apply browser rules, or add Widevine, FairPlay and PlayReady DRM.

• What is the best video API for Ruby?

  That depends on what you are building, and a fair comparison beats a claim. FastPix publishes benchmark timings against Cloudinary, api.video, Vimeo and Gumlet, including the workloads it loses. Compare the SDK surface, the pricing model and the numbers before choosing rather than after.

• How much does it cost to stream video?

  FastPix bills per minute rather than per stream or per seat, and the player carries no per-viewer licence. A free account covers ten videos, 100,000 streaming minutes and AI samples with no card. The pricing page breaks the rates down SKU by SKU.

• How do I install the FastPix Ruby SDK?

  Add the gem to your Gemfile and bundle, or install it directly. Pin the version while the SDK is in beta. It needs Ruby 3.2 or newer. The package is fastpixapi, currently 1.1.4 on RubyGems. Calls block, so reach for a background job in Rails.

• How do I authenticate with the FastPix API from Ruby?

  FastPix issues two values, not one key. The access token goes in the username field and the secret key in the password field, and the SDK sends both as HTTP Basic on every request. There is no bearer token. Read them through ENV at startup and keep them on your server, never in a browser.

• Does the FastPix Ruby SDK support async?

  No. Every operation blocks on Faraday until the response arrives, and there is no async variant. In Rails, put anything slow in a background job rather than a controller. Each method does accept timeout_ms, so a single slow call cannot hold a worker open indefinitely.

• Which other languages have a FastPix SDK?

  Seven official server SDKs: Python, Node.js, Java, PHP, Ruby, Go and C#. All authenticate the same way and cover the same API surface, so a polyglot team learns the model once. Client-side player, uploader and analytics SDKs ship separately for web, iOS, Android and Flutter.