# Fashio API > Fashio generates publish-ready e-commerce fashion photos and video with AI: upload a > garment or product photo, pick an AI model/venue/pose (or let Fashio choose), get back > on-model shots. The v1 API exposes the same generation pipeline the Fashio mobile app > and web dashboard use — 15 generation tools, one shared bearer API key, billed against > that account's diamond credit balance. No separate API pricing, no sandbox: every key > is live. Base URL: https://api.fashiolabs.com Authentication: `Authorization: Bearer fio_live_.` on every request. Keys are created at dash.fashiolabs.com → Profile → API Keys (self-serve, free, up to 5 active keys per account). Doc pages below link to their Markdown (`.md`) version; the same page for humans is at the same path with `.html` (e.g. https://docs.fashiolabs.com/quickstart.html). ## Getting Started - [Introduction](https://docs.fashiolabs.com/index.md): what the API is, how requests flow (auth → async generation → poll), which tool to use. - [Authentication](https://docs.fashiolabs.com/authentication.md): key format, how to get one, auth error responses. - [Quickstart](https://docs.fashiolabs.com/quickstart.md): upload a photo, start a generation, poll the result — four calls end to end. - [Pricing & Credits](https://docs.fashiolabs.com/pricing.md): credit cost per tool, subscription plans, top-up packs. - [Rate Limits & Errors](https://docs.fashiolabs.com/rate-limits.md): daily request cap (500/key by default) and the full error status code table. - [Core Endpoints](https://docs.fashiolabs.com/core-endpoints.md): catalogs (fashion models, venues, poses), image uploads, and job status polling. ## Account & Templates - [Account](https://docs.fashiolabs.com/account.md): `GET /v1/account` — email, plan, diamond balance, renewal date for the key's owner. - [Template Sets](https://docs.fashiolabs.com/template-sets.md): save a generation's styling (model/venue/pose) as a reusable preset (`POST /v1/template-sets`), then reuse it on a new garment via `POST /v1/generations { templateSetId }` — one saved look becomes a catalog. Works with `virtual_model`, `outfit_photo`, `pro_studio`, `jewelry_on_model`, `clothing_ecom_pack`, `jewelry_ecom_pack`. - [Ready Template Sets](https://docs.fashiolabs.com/ready-template-sets.md): browse Fashio's own curated "ready photoshoot" library (`GET /v1/ready-template-sets`) — a different, larger catalogue than the caller's own saved Template Sets above — and generate a full catalogue from one with `POST /v1/catalog-jobs` (one image per shot, poll with the usual `GET /v1/generations/{id}`). ## Generation Tools Each has its own page with the exact request body, a runnable example, and the response shape. `toolId` is the value to send in `POST /v1/generations`. - [Virtual Try-On, Single](https://docs.fashiolabs.com/tools/virtual_model.md) — `virtual_model`, 4 credits. One garment photo onto one AI fashion model. - [Virtual Try-On, Batch](https://docs.fashiolabs.com/tools/outfit_photo.md) — `outfit_photo`, 4 credits. Multiple garments composed into one outfit shot. - [Pro Studio](https://docs.fashiolabs.com/tools/pro_studio.md) — `pro_studio`, 4 credits. Try-on with explicit shot-type/style-preset controls. - [Jewelry on Model](https://docs.fashiolabs.com/tools/jewelry_on_model.md) — `jewelry_on_model`, 4 credits. Ring/necklace/earring/bracelet product photo onto a model. - [Clothing E-com Pack](https://docs.fashiolabs.com/tools/clothing_ecom_pack.md) — `clothing_ecom_pack`, 12 credits. One clothing photo in, multiple ready-to-publish formats out (fan-out — `resultUrls` returns several images). - [Jewelry E-com Pack](https://docs.fashiolabs.com/tools/jewelry_ecom_pack.md) — `jewelry_ecom_pack`, 12 credits. Same fan-out idea, for jewelry. - [Photo to Video](https://docs.fashiolabs.com/tools/ai_videos.md) — `ai_videos`, 15 credits. Animates a still on-model/product photo into a short video clip. - [Mannequin to Flat Lay](https://docs.fashiolabs.com/tools/model_to_flat_lay.md) — `model_to_flat_lay`, 4 credits. On-model/mannequin photo → clean flat-lay product shot. - [Amateur to Professional](https://docs.fashiolabs.com/tools/amateur_to_pro.md) — `amateur_to_pro`, 4 credits. Phone photo → studio-quality product photo. - [Pose Variation](https://docs.fashiolabs.com/tools/pose_angle_switch.md) — `pose_angle_switch`, 4 credits. Re-pose an existing on-model photo; outfit and accessories are preserved exactly. - [Model Swap](https://docs.fashiolabs.com/tools/model_swap.md) — `model_swap`, 4 credits. Replace the person in an existing on-model photo, keep outfit/pose/scene. - [Photo Edit, free-text](https://docs.fashiolabs.com/tools/photo_edit.md) — `photo_edit`, 4 credits. Plain-English edit instruction applied to an existing photo. - [Enhance / Upscale](https://docs.fashiolabs.com/tools/photo_enhance.md) — `photo_enhance`, 3 credits. Resolution/sharpness pass, no scene changes. - [Remove Background](https://docs.fashiolabs.com/tools/remove_background.md) — `remove_background`, 2 credits. Clean cutout, transparent background. - [Reframe](https://docs.fashiolabs.com/tools/photo_reframe.md) — `photo_reframe`, 2 credits. Re-crop to a new aspect ratio via `targetRatio` (not `ratio`). ## Reference - [OpenAPI spec](https://docs.fashiolabs.com/openapi.yaml): machine-readable — every endpoint, request/response schema, and error code. - [Full reference](https://docs.fashiolabs.com/llms-full.txt): the same content as this file, expanded to every endpoint and tool with example requests/responses, common errors, and end-to-end flows — written for an LLM or coding agent to read in one pass. - [Interactive API reference](https://docs.fashiolabs.com/api-reference.md): human-facing Redoc reference, generated from the same OpenAPI spec. - [Playground](https://docs.fashiolabs.com/playground.md): try every endpoint from the browser with your own key, no code required. ## Support - [FAQ](https://docs.fashiolabs.com/faq.md) - [Troubleshooting](https://docs.fashiolabs.com/troubleshooting.md) - [Support](https://docs.fashiolabs.com/support.md) - [Changelog](https://docs.fashiolabs.com/changelog.md) - [Roadmap — what we're working on](https://docs.fashiolabs.com/roadmap.md) ## MCP Fashio also ships an MCP (Model Context Protocol) server, so an AI agent (Claude, Cursor, etc.) can call these same endpoints as native tools instead of raw HTTP. - Remote, no install: add `https://mcp.fashiolabs.com/mcp` to your MCP client as a remote/HTTP server, with `Authorization: Bearer `. - Local package: [`fashio-mcp`](https://www.npmjs.com/package/fashio-mcp) on npm ([source](https://github.com/fashiolabs/fashio-mcp)) — same tools, runs on your own machine. - Details: [fashiolabs.com/mcp](https://fashiolabs.com/mcp). ## Official SDKs & CLI - [`fashio-client`](https://www.npmjs.com/package/fashio-client) ([source](https://github.com/fashiolabs/fashio-client)): official Node.js/TypeScript SDK — one typed method per endpoint, `npm install fashio-client`. - [`fashio-cli`](https://www.npmjs.com/package/fashio-cli) ([source](https://github.com/fashiolabs/fashio-cli)): command-line client for scripts and CI — `npx fashio-cli generate '{"toolId": "virtual_model", ...}'`. ## Optional - [Fashio on Postman](https://www.postman.com/fashio): public Postman workspace with the full API as a collection ([collection docs](https://documenter.getpostman.com/view/60043630/2sBYHYud6x)); fork it and set `apiKey`. - [Fashio](https://fashiolabs.com): product marketing site.