Skill

Generate AI images and videos via Modellix CLI

A skill for generating images and video through Modellix's CLI, with built-in cost-approval and safety guardrails.

Works with modellix

87
Spark score
out of 100
Updated 6 days ago
Version 15.0.0

Add to Favorites

Why it matters

Enable agents to generate professional images and videos from text prompts or source media by orchestrating the Modellix Model-as-a-Service platform through its official CLI workflow, handling authentication, model selection, submission, and output retrieval.

Outcomes

What it gets done

01

Authenticate with Modellix API and verify environment readiness using doctor checks

02

Submit text-to-image requests using default or specified models like Nano Banana

03

Generate videos from text or image inputs via models like Seedance with wait-and-poll

04

Download completed generation tasks to local storage with overwrite protection

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/ag-modellix | bash

Overview

Modellix

A skill for generating images and video through Modellix's CLI workflow - doctor check, model run with wait, and task download - with disclosed cost and explicit approval before paid submissions. Use it for text-to-image or text-to-video generation via Modellix - it requires disclosing cost and getting approval before any paid submission, and never retries blindly after an unknown outcome.

What it does

This skill teaches agents to use Modellix, a Model-as-a-Service platform for AI image and video generation, through its official modellix-cli workflow: authenticate, check environment health with doctor, submit a generation with model run --wait, then persist the result with task download. It covers text-to-image and text-to-video generation and calling Modellix models through a unified API/CLI, and applies when a user mentions Modellix or specific providers routed through it, like Seedream, Seedance, or Nano Banana.

The workflow runs in five steps: authenticate via MODELLIX_API_KEY or modellix-cli auth login, run modellix-cli doctor --json to check the environment, fall back to sensible default models when none is specified (text-to-image: google/nano-banana-2-lite; text-to-video: bytedance/seedance-2.0-mini-t2v), submit with modellix-cli model run --wait --json, and persist outputs with modellix-cli task download. A representative text-to-image call:

modellix-cli model run \
  --model-slug google/nano-banana-2-lite \
  --body '{"prompt":"A cinematic sunset over a futuristic city"}' \
  --wait --timeout 5m --json

When to use - and when NOT to

Use it for generating or editing images and video from text or existing images through Modellix's models. It builds in real cost and safety discipline rather than assuming it away: before any paid submission it discloses the provider, model, prompt or source media that will leave the machine, expected cost, and output path, and requires explicit user approval - it does not blindly retry a paid submission after an unknown outcome, instead checking task history first. It prefers session-scoped API key use, running auth login for persistent local credential storage only when the user has approved that. It also confirms the destination and overwrite policy before task download and never replaces an existing file without explicit approval.

Inputs and outputs

Input is a text prompt (and optionally source media) plus a model slug, with request schemas fetched from model describe's docs_url or Modellix's own llms.txt documentation. Output is the generated image or video, downloaded and persisted locally via task download.

Integrations

It integrates with the modellix-cli tool and Modellix's hosted API (api.modellix.ai) and CDN, which process prompts and any uploaded source media remotely - requiring a valid API key and never logging secrets.

Who it's for

Developers and agents generating AI images or video through Modellix who need a disclosed, approval-gated workflow rather than blind paid API calls - output still requires human review for quality, rights, privacy, and policy compliance before publication, since availability, pricing, quotas, and moderation are all controlled by Modellix and subject to change.

Source README

Modellix

Overview

Modellix is a Model-as-a-Service platform for AI image and video generation. This skill teaches agents to use the official modellix-cli workflow (doctor → model run --wait → task download).

Upstream package: https://github.com/Modellix/modellix-skill/tree/main/modellix-skill

When to Use This Skill

  • Generate images from text prompts
  • Generate or edit videos from text or images
  • Call Modellix models through a unified API/CLI
  • The user mentions Modellix, Seedream, Seedance, Nano Banana, or similar providers via Modellix

How It Works

  1. Authenticate with MODELLIX_API_KEY or modellix-cli auth login
  2. Run modellix-cli doctor --json
  3. Use default models when unspecified (T2I: google/nano-banana-2-lite, T2V: bytedance/seedance-2.0-mini-t2v)
  4. Submit with modellix-cli model run --wait --json
  5. Persist outputs with modellix-cli task download

Examples

Text-to-image

modellix-cli model run \
  --model-slug google/nano-banana-2-lite \
  --body '{"prompt":"A cinematic sunset over a futuristic city"}' \
  --wait --timeout 5m --json

Text-to-video

modellix-cli model run \
  --model-slug bytedance/seedance-2.0-mini-t2v \
  --body '{"prompt":"Ocean waves under a cloudy sunset"}' \
  --wait --timeout 10m --json

Best Practices

  • Prefer CLI model run --wait over hand-rolled polling
  • Before a paid submission, disclose the provider, model, prompt or source media that will leave the machine, expected cost, and output path; obtain explicit user approval
  • Prefer session-scoped API-key use; run modellix-cli auth login only when the user approves persistent local credential storage
  • Do not blindly retry paid submissions after unknown outcomes - check task history
  • Confirm the destination and overwrite policy before task download; never replace an existing file without explicit approval
  • Fetch request schemas from model describe docs_url or https://docs.modellix.ai/llms.txt

Security & Safety Notes

  • Requires a Modellix API key; never print secrets in logs
  • Prompts and uploaded source media leave the machine for api.modellix.ai and Modellix CDN processing
  • Paid generation consumes account balance and must not be submitted or retried without the approval described above

Limitations

  • Requires a Modellix account, network access, a valid API key, and sufficient account balance.
  • Model availability, request schemas, pricing, quotas, moderation, and generation time are controlled by Modellix and may change.
  • Generated outputs require human review for quality, rights, privacy, and policy compliance before publication.
  • This skill documents the CLI workflow only; it does not define a REST fallback or guarantee that a completed remote task downloads successfully.

Discussion

Questions & comments · 0

Sign In Sign in to leave a comment.