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.
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
Authenticate with Modellix API and verify environment readiness using doctor checks
Submit text-to-image requests using default or specified models like Nano Banana
Generate videos from text or image inputs via models like Seedance with wait-and-poll
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
- Authenticate with
MODELLIX_API_KEYormodellix-cli auth login - Run
modellix-cli doctor --json - Use default models when unspecified (T2I:
google/nano-banana-2-lite, T2V:bytedance/seedance-2.0-mini-t2v) - Submit with
modellix-cli model run --wait --json - 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 --waitover 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 loginonly 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 describedocs_urlor 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.aiand 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.