Package 'freeimagetovideo'

Title: Generate AI Videos with Sound via 'Free Image to Video'
Description: Free image to video AI with no daily cap: start with no sign-up, keep going on a free account. Every video comes with sound and no watermark. This is the official R SDK for 'Free Image to Video' <https://freeimagetovideo.ai>. Submit text-to-video and image-to-video runs on 'MiniMax H3', wait for the result URL, and check your remaining credits.
Authors: Free Image to Video [aut, cre]
Maintainer: Free Image to Video <[email protected]>
License: MIT + file LICENSE
Version: 0.1.0
Built: 2026-11-15 13:22:33 UTC
Source: https://github.com/hanshs474/fitv-r

Help Index


Generate a video with sound on Free Image to Video

Description

Submits one run on Free Image to Video (https://freeimagetovideo.ai), waits for it and returns the result URL. Failures signal a condition of class fitv_auth, fitv_quota, fitv_plan, fitv_busy, fitv_rejected, fitv_failed, fitv_timeout or fitv_api.

Usage

fitv_generate_video(prompt, image_url = NULL, model = "minimax-h3", options = NULL,
  api_key = NULL, poll_seconds = 10, timeout_seconds = 1800, post = fitv_post)

Arguments

prompt

What to generate. For image to video, the motion.

image_url

Optional public https image URL; when set, runs image-to-video with it as the first frame.

model

Model id, default "minimax-h3".

options

Optional named list, e.g. list(duration = 6, resolution = "480p", aspect_ratio = "16:9").

api_key

Key from https://freeimagetovideo.ai/settings/apikeys; defaults to FREEIMAGETOVIDEO_API_KEY.

poll_seconds

How often the run is polled (default 10).

timeout_seconds

Deadline for the whole call (default 1800).

post

The HTTP function; replaceable in tests.

Value

The URL of the finished video.

Examples

## Not run: 
fitv_generate_video("a paper lantern drifting over a night river")
fitv_generate_video("the camera slowly orbits the statue",
                    image_url = "https://example.com/statue.jpg")

## End(Not run)

Submit a run, look it up, or check remaining credits

Description

Lower-level calls for submitting now and collecting later.

Usage

fitv_submit(prompt, image_url = NULL, model = "minimax-h3", options = NULL,
  api_key = NULL, post = fitv_post)
fitv_status(id, api_key = NULL, post = fitv_post)
fitv_credits(api_key = NULL, post = fitv_post)

Arguments

prompt

What to generate.

image_url

Optional public https image URL for image-to-video.

model

Model id, default "minimax-h3".

options

Optional named list of generation options.

id

The task id returned by fitv_submit.

api_key

Key from https://freeimagetovideo.ai/settings/apikeys; defaults to FREEIMAGETOVIDEO_API_KEY.

post

The HTTP function; replaceable in tests.

Value

fitv_submit: the task id. fitv_status: a list with id, status, videos, and errorMessage. fitv_credits: remaining credits as an integer.

Examples

## Not run: 
id <- fitv_submit("a fox trotting through fresh snow")
fitv_status(id)$status
fitv_credits()

## End(Not run)