runapi-cli

name	runapi-cli
description	Generate AI images, videos, and music/audio from agents using the RunAPI CLI.
category	development
risk	critical
source	official
source_repo	runapi-ai/cli-skill
source_type	official
date_added	2026-06-07
author	runapi-ai
tags	["runapi","cli","models","automation","codex","claude","gemini"]
tools	["claude","codex","gemini","cursor","antigravity"]
license	Apache-2.0
license_source	https://github.com/runapi-ai/cli-skill/blob/main/LICENSE

RunAPI CLI

Overview

The runapi CLI is the execution layer for RunAPI model tasks. Use it when an agent needs to generate AI images, videos, or music/audio, run a one-off model job, pass a JSON request body, wait for an async task, or script RunAPI from a terminal, server, or CI job.

Source repository: github.com/runapi-ai/cli-skill (Apache-2.0)

When to Use This Skill

• Use when the user asks to run a RunAPI model from an agent.
• Use when the user needs to inspect RunAPI CLI auth or account status.
• Use when the user wants to pass JSON request bodies to RunAPI services.
• Use when the user wants to submit async RunAPI tasks and wait for completion.
• Use when the user wants to install the RunAPI CLI on a local machine, server, or CI runner.

Install

macOS / Linux

brew install runapi-ai/tap/runapi

Server / CI

Download the installer, inspect it, then run it locally.

curl -fsSL https://runapi.ai/cli/install.sh -o runapi-install.sh
less runapi-install.sh
sh runapi-install.sh

To pin a specific version:

sh runapi-install.sh --version v0.1.0

The installer detects OS and architecture, verifies the SHA-256 checksum from https://runapi.ai/cli/latest.json, and refuses to write the binary if verification fails.

Authentication

Treat RunAPI authentication and generation as security-sensitive: commands can call remote services, consume credits, and expose account state. Review installer scripts before running them and keep API keys in environment variables or stdin, not shell history.

Check the current state first:

runapi auth status

Source	How
Environment	Read RUNAPI_API_KEY from the environment
Saved config	printf '%s' "$RUNAPI_API_KEY" | runapi auth import-token --token -
Browser login	runapi login only when the user explicitly wants browser auth

RUNAPI_BASE_URL overrides the default base URL.

Avoid passing secrets directly in command arguments. Prefer RUNAPI_API_KEY or stdin token import with .