fashio-cli

Command-line client for the Fashio API — generate on-model e-commerce fashion photos and video from your terminal or a CI pipeline, no code required.

Built on fashio-client, the official SDK. Prefer to script it from Node/TS instead? Use that package directly. Prefer an AI agent to call it? See fashio-mcp.

Install

npm install -g fashio-cli
# or run without installing:
npx fashio-cli models

Setup

export FASHIO_API_KEY=fio_live_...   # from fashiolabs.com → Profile → API Keys

Usage

fashio models
fashio fashion-models --gender female --limit 10
fashio venues
fashio poses

fashio upload ./dress.jpg
# => { "success": true, "id": "...", "url": "https://..." }

fashio generate '{
  "toolId": "virtual_model",
  "images": {
    "fashion_model": "fm_south_asian_01",
    "garment_photo": "https://your-cdn.com/dress.jpg"
  }
}'
# => { "success": true, "id": "8b1e...", "status": "processing" }

fashio status 8b1e...
# => { "success": true, "status": "completed", "resultUrls": ["https://..."], ... }

fashio account
# => { "email": "...", "diamondBalance": 214, "plan": { ... } }

Reusable style presets

fashio templates create '{"label": "Studio white, model A", "sourceMediaId": "8b1e..."}'
fashio templates list
fashio generate '{"templateSetId": "tset_...", "images": {"garment_photo": "https://.../new.jpg"}}'

Fashio's curated photoshoot library → full catalogs

fashio ready-templates list --category editorial
fashio ready-templates get set_editorial_04
fashio catalog '{"readyTemplateSetId": "set_editorial_04", "images": {"garment_photo": "https://.../dress.jpg"}}'

Run fashio help for the full command list. Full request/response shapes, per-tool required fields, and error codes: docs.fashiolabs.com.

Scripting

Every command prints one JSON value to stdout — pipe it straight into jq:

fashio generate '{"toolId":"remove_background","images":{"user_photo":"'"$URL"'"}}' | jq -r .id

Non-2xx API responses exit with status 1 and print the error to stderr.

Links

• fashiolabs.com — product
• docs.fashiolabs.com — full API reference
• fashiolabs.com/pricing — plans & credit packs

License

MIT — see LICENSE.