omnivideo-sdk (Ruby)

Ruby client for Omni Video — generate video and image content with the Gemini Omni Video series of models.

Omni Video hosts the Gemini Omni Video family (seedance-2 for text/image → video, gpt-image-2 and nano-banana-2 for text/image → image) behind one simple REST API.

Install

gem install omnivideo-sdk

Or in your Gemfile:

gem "omnivideo-sdk"

Get an API key

Sign in at https://omnivideo.net/, open the account page, then create a sk-… token.

export OMNIVIDEO_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Quick start

require "omnivideo_sdk"

client = OmnivideoSdk::Client.new  # reads ENV["OMNIVIDEO_API_KEY"]

task = client.run(
  model_id: "seedance-2",
  prompt: "a serene zen garden at sunrise, ultra detailed",
  aspect_ratio: "16:9"
)
puts task.output_url   # video_url or image_url

Lower level

task = client.create_task(
  model_id: "gpt-image-2",
  prompt: "cyberpunk corgi, neon rim light",
  aspect_ratio: "1:1"
)

until task.done?
  sleep 3
  task = client.get_task(task.task_id)
end
puts task.image_url

Models

model_id Modality Output
seedance-2 text/image → video video_url
gpt-image-2 text/image → image image_url
nano-banana-2 text/image → image image_url

See current models and pricing on omnivideo.net.

License

MIT