AGENT SKILL

runapi-cli

Generate AI images, videos, and music/audio from agents using the RunAPI CLI.

License 许可
Apache-2.0
最近更新
2026-10-22
Stars
★ 1
Forks
0

01 前言 Front Matter

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

03 SKILL.md 正文

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 --token -.

Discover Services, Commands, and Fields

The CLI is JSON-first. Every service exposes typed commands, and each command documents its request fields through --help. Inspect command help before composing a request.

runapi --help
runapi suno --help
runapi suno text-to-music --help

Run a Model

Pass the request body as JSON through --input-file, --input, or stdin. The default flow is synchronous and polls until the task completes.

runapi suno text-to-music --input-file request.json

runapi suno text-to-music --async --input-file request.json
runapi wait <task-id> --service suno --action text-to-music

runapi get <task-id> --service suno --action text-to-music

JSON responses go to stdout; progress lines go to stderr. Pipe to jq for downstream parsing.

Account

runapi account info
runapi account balance

Install the Skill Into Another Agent Runtime

runapi agent install-skill --target claude
runapi agent install-skill --target codex
runapi agent install-skill --target gemini
runapi agent install-skill --target openclaw
runapi agent list-targets
runapi agent install-skill --target-dir <path>

Limitations

  • RunAPI model calls require a valid RunAPI account or API key.
  • Some model tasks are long-running and should use --async plus runapi wait.
  • Browser login is interactive and should not be the default path for agents.
  • This skill does not replace model-specific parameter validation; inspect command help before building request JSON.

Security & Safety Notes

  • Never paste API keys into example commands or PR text.
  • Prefer RUNAPI_API_KEY or stdin token import instead of command-line secrets.
  • Do not run interactive runapi login by default from an agent.
  • Check the CLI exit code before assuming a task succeeded.

References

04 同仓库更多 Skills

Hazek-dc
Hazek-dc/PresensiGuru_FaceNet_EMAR

testing-best-practices

Laravel test design and review. Use when selecting coverage, naming or structuring tests, choosing assertions or test data, isolating dependencies, testing HTTP or security boundaries, improving suite performance, or reviewing test value. Use framework guidance or search-docs for Pest and PHPUnit syntax.

★ 1
Hazek-dc
Hazek-dc/PresensiGuru_FaceNet_EMAR

tailwindcss-development

Always invoke when the user's message includes 'tailwind' in any form. Also invoke for: building responsive grid layouts (multi-column card grids, product grids), flex/grid page structures (dashboards with sidebars, fixed topbars, mobile-toggle navs), styling UI components (cards, tables, navbars, pricing sections, forms, inputs, badges), adding dark mode variants, fixing spacing or typography, and Tailwind v3/v4 work. The core use case: writing or fixing Tailwind utility classes in HTML templates (Blade, JSX, Vue). Skip for backend PHP logic, database queries, API routes, JavaScript with no HTML/CSS component, CSS file audits, build tool configuration, and vanilla CSS.

★ 1
Hazek-dc
Hazek-dc/PresensiGuru_FaceNet_EMAR

laravel-best-practices

Apply this skill whenever writing, reviewing, or refactoring Laravel PHP code. This includes creating or modifying controllers, models, migrations, form requests, policies, jobs, scheduled commands, service classes, and Eloquent queries. Triggers for N+1 and query performance issues, caching strategies, authorization and security patterns, validation, error handling, queue and job configuration, route definitions, and architectural decisions. Also use for Laravel code reviews and refactoring existing Laravel code to follow best practices. Covers any task involving Laravel backend PHP code patterns.

★ 1
Hazek-dc
Hazek-dc/PresensiGuru_FaceNet_EMAR

infer-conventions

Use this skill to analyze how a Laravel application is actually written and record its conventions as shared rules. Trigger when the user wants to detect, infer, document, or standardize project conventions or coding style, set up or grow `.ai/rules`, resolve mixed or conflicting patterns (e.g. "are we using Form Requests or inline validation?"), or onboard agents and teammates to "how we do things here". Covers: a systematic sweep of ~49 Laravel convention dimensions (validation, models, architecture, testing, frontend, database, console), open-ended house-pattern discovery, conflict reporting, and recording rules scoped to the right paths via the Boost `record-rule` MCP tool. Only run this skill when the user explicitly asks for it; never start a sweep as part of another task. Do not use for one-off code review, enforcing formatting a linter already handles, or editing `.ai/rules` files by hand.

★ 1
Hazek-dc
Hazek-dc/PresensiGuru_FaceNet_EMAR

inertia-react-development

Develops Inertia.js v2 React client-side applications. Activates when creating React pages, forms, or navigation; using <Link>, <Form>, useForm, or router; working with deferred props, prefetching, or polling; or when user mentions React with Inertia, React pages, React forms, or React navigation.

★ 1
Hazek-dc
Hazek-dc/PresensiGuru_FaceNet_EMAR

deploying-to-cloud

Deploys and manages Laravel applications on Laravel Cloud using the `cloud` CLI. Use when the user wants to deploy an app, ship to Cloud, create or manage applications, environments, databases, caches, object storage, queues, domains, instances, background processes, secrets, compute, scheduled tasks, or Laravel Cloud infrastructure; or check billing, usage, or spend. Triggers on deployment, shipping, Cloud management, environment setup, database provisioning, billing or usage queries, the `cloud` CLI, and Laravel Cloud deployment troubleshooting.

★ 1