Start a Fashio generation job
create_generationStarts one generation job (photo, or a short video for ai_videos) and returns {id, status: 'processing'} at once; poll get_generation with that id until status is 'completed' or 'failed'. Pick toolId from list_models, or pass templateSetId (from list_template_sets) to replay a saved model/venue/pose on a new garment; use create_catalog_job instead for a multi-shot shoot from Fashio's curated library. Deducts the tool's diamond price from the key's account when the job starts: 400 (unknown toolId, missing required image, toolId not matching the template) and 402 (balance too low) charge nothing, 404 means templateSetId not found, and a 500 or a job that ends 'failed' is refunded automatically. Needs a valid Fashio API key (Bearer); every call counts toward the key's daily request cap (429 when reached, 401 for a missing or revoked key).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "create_generation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pose | No | Pose id from list_poses. Required for pose_angle_switch; optional for virtual_model, outfit_photo, jewelry_on_model. | |
| ratio | No | Output aspect ratio: 1:1 | 9:16 | 16:9 | 4:3 | 3:4 | 4:5 | auto. | |
| images | No | Input images keyed by field; required keys depend on toolId: virtual_model -> fashion_model + garment_photo; outfit_photo and pro_studio -> fashion_model + garment_photos[]; jewelry_on_model -> jewelry_image or jewelry_images[]; model_swap -> user_photo + fashion_model; every other tool -> user_photo. Values are URLs (upload_image or your own hosting); fashion_model and venue also accept a catalog id from list_fashion_models / list_venues. A missing required key is a 400 with no charge. | |
| toolId | No | Tool to run, e.g. virtual_model, outfit_photo, pro_studio, jewelry_on_model, remove_background, photo_edit (full list: list_models). Required unless templateSetId is given; then it is taken from the preset, and if you pass both they must match (400 otherwise). | |
| duration | No | ai_videos only: clip length in seconds (default 5). | |
| shotType | No | pro_studio only (required there). | |
| jewelryType | No | jewelry_on_model only (required there): ring | necklace | earring | bracelet. | |
| stylePreset | No | pro_studio only (required there). | |
| targetRatio | No | photo_reframe only (required there): the output aspect ratio, e.g. 4:5. | |
| customPrompt | No | Free-text instruction. Required for photo_edit (it is the edit instruction); optional note for virtual_model and model_swap. | |
| motionPrompt | No | ai_videos only (required there): describes the motion. | |
| templateSetId | No | id of one of YOUR saved presets (list_template_sets / create_template_set; not a list_ready_template_sets id). Fills in fashion_model/venue/pose/shotType/stylePreset/ratio, so only the new garment's images are still required; any field you also pass overrides the preset's value. | |
| backgroundColor | No | jewelry_on_model only, optional solid studio background color. |