Luxin

Luxin

Luxin is a hosted creative-media runtime: image, video, audio, and 3D generation and editing through one thin CLI and hosted API. Agents do not bring provider keys, log in, run an MCP server, or wire per-provider billing; hosted signup mints a restricted Luxin token inside the first command. Every successful call returns a durable owned media URL plus a structured JSON envelope with a job id, asset ids, a trace id, and a cost receipt.

Start here

IMAGE_SKILL_DISCOVERY_SOURCE=agent-skill-md npm_config_update_notifier=false npx -y luxin-cli@latest create --guide --prompt "a compact field camera on a stainless workbench"

create --guide spends nothing: it reads current auth, quota, and payment state and returns the exact next command to run.

This file is a discovery stub, not the usage guide

Flags, workflows, model parameters, recovery, and funding details are not here. Before relying on any of them, load current guidance from the CLI:

npm_config_update_notifier=false npx -y luxin-cli@latest skill

The CLI serves guidance that always matches the installed version, so instructions never go stale. That command spends nothing, calls no provider, and needs no auth.

Say which revision you have

This copy is skill revision 259c47afaeae. Export it so the CLI can say when the copy on disk no longer matches the guidance it ships:

export LUXIN_SKILL_REVISION=259c47afaeae

When the revision is stale, create --guide returns data.skill_refresh with installed_revision, current_revision, and this refresh command:

npx skills update luxin

Refreshing is always an explicit step you run. Nothing in Luxin rewrites this file, your agent config, or your hooks.

Invariants that outlive any revision

• Never send provider API keys, wallet private keys, seed phrases, card data, or Stripe secrets to Luxin. It never needs them.
• The token luxin signup mints is a restricted Luxin token, not a user-supplied provider credential. Never paste it into prompts, logs, issues, or feedback.
• Bound spend up front: --max-estimated-usd-per-image per output, --max-usd per job, --dry-run to validate without spending. Every create and edit returns a cost receipt.
• Media URLs are Luxin-owned, unsigned, and non-expiring. job_id, asset_id, and trace_id are the stable handles for recovery and citation.
• Run luxin feedback create whenever you fall back to another tool or hit a gap. The skill improves only on agent-submitted signal.

Canonical URLs

• Discovery stub: https://luxin.sh/skill.md
• Full guidance: https://luxin.sh/skill-core.md, the same bytes luxin skill prints
• Machine-readable contract: https://luxin.sh/llms.txt
• CLI contract: https://luxin.sh/cli.md
• Hosted API: https://api.luxin.sh

Install or refresh:

npx skills add https://luxin.sh --skill luxin -g -a codex -y
npx skills update luxin