The project is in a healthy, maintained state
Use `runapi-minimax-h3` for MiniMax H3 video tasks in Ruby.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Runtime

~> 0.3.3
 Project Readme

RunAPI

MiniMax H3 API SDKs for JavaScript, Python, Ruby, Go, Java, and PHP on RunAPI.

npm PyPI RubyGems Go Reference Maven Central License


Typed SDKs for MiniMax H3 video generation through RunAPI. The public minimax-h3-sdk repository groups the JavaScript, Python, Ruby, Go, and Java packages. PHP is released from the split minimax-h3-php Composer repository.

MiniMax H3 exposes two resources:

  • textToVideo / text_to_video for prompt-only requests and requests with reference images, videos, or audio.
  • imageToVideo / image_to_video for first-frame, last-frame, or first-and-last-frame requests.

Packages

Language Package
JavaScript / TypeScript @runapi.ai/minimax-h3
Python runapi-minimax-h3
Ruby runapi-minimax-h3
Go github.com/runapi-ai/minimax-h3-sdk/go
Java ai.runapi:runapi-minimax-h3

For PHP, use runapi-ai/minimax-h3 from the split Composer repository.

JavaScript Quick Start

import { MiniMaxH3Client } from '@runapi.ai/minimax-h3';

const client = new MiniMaxH3Client();

const result = await client.textToVideo.run({
  model: 'minimax-h3',
  prompt: 'A cinematic tracking shot through a rain-soaked city',
  aspect_ratio: '16:9',
});

console.log(result.videos[0].url);

Reference media uses the same textToVideo resource:

const task = await client.textToVideo.create({
  model: 'minimax-h3',
  prompt: 'Keep the character and voice consistent in a new scene',
  reference_image_urls: ['https://cdn.runapi.ai/public/samples/image.jpg'],
  reference_audio_urls: ['https://cdn.runapi.ai/public/samples/voice.mp3'],
  aspect_ratio: 'adaptive',
});

Use create to submit and return a task id, get to read current status, or run to submit and poll to completion. In request handlers, prefer create with a callback or later polling.

Returned file URLs are temporary. Download generated files into durable storage within the retention window.

Links

License

Licensed under the Apache License, Version 2.0.