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.