Tencent Hunyuan3D v2 — high-quality image-to-3D model with detailed textures and accurate geometry from a single reference image.
Pricing: $0.48 untextured · $1.44 textured per generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringguidance_scalenumbernum_inference_stepsnumberoctree_resolutionnumbertextured_meshbooleanseedintegeraspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fhunyuan3d%2Fv2",
"title": "Hunyuan3D v2 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/hunyuan3d/v2.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/hunyuan3d/v2",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance scale for the model.",
"default": 7.5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"num_inference_steps": {
"title": "Inference Steps",
"description": "Number of inference steps to perform.",
"default": 50,
"type": "number",
"minimum": 1,
"maximum": 50
},
"octree_resolution": {
"title": "Octree Resolution",
"description": "Octree resolution for the model.",
"default": 256,
"type": "number",
"minimum": 1,
"maximum": 1024
},
"textured_mesh": {
"title": "Textured Mesh",
"description": "Generate a fully textured mesh (3× the white-mesh price). Turn off for a cheaper untextured geometry-only model.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same image every time.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Tencent Hunyuan3D v2 Mini — lightweight and affordable image-to-3D model for rapid 3D asset creation and prototyping.
Pricing: $0.10 untextured · $0.30 textured per generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringguidance_scalenumbernum_inference_stepsnumbertextured_meshbooleanoctree_resolutionnumberinput_image_urlstringseedintegeraspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fhunyuan3d%2Fv2%2Fmini",
"title": "Hunyuan3D v2 Mini generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/hunyuan3d/v2/mini.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/hunyuan3d/v2/mini",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance scale for the model.",
"default": 7.5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"num_inference_steps": {
"title": "Inference Steps",
"description": "Number of inference steps to perform.",
"default": 50,
"type": "number",
"minimum": 1,
"maximum": 50
},
"textured_mesh": {
"title": "Textured Mesh",
"description": "Generate a fully textured mesh (3× the white-mesh price). Turn off for a cheaper untextured geometry-only model.",
"default": true,
"type": "boolean"
},
"octree_resolution": {
"title": "Octree Resolution",
"description": "Octree resolution for the model.",
"default": 256,
"type": "number",
"minimum": 1,
"maximum": 1024
},
"input_image_url": {
"title": "Input Image URL",
"description": "Handled by the source image upload strip via buildFalInput.",
"type": "string"
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same image every time.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"input_image_url",
"reference_image_url"
],
"additionalProperties": false
}
Tencent Hunyuan3D v2 multi-view — reconstruct 3D models from up to 4 reference images (front, back, left views) for more accurate geometry and textures.
Pricing: $0.017 untextured · $0.051 textured per generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringtextured_meshbooleanguidance_scalenumbernum_inference_stepsnumberoctree_resolutionnumberseedintegeraspect_ratiostringresolutionstringreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fhunyuan3d%2Fv2%2Fmulti-view",
"title": "Hunyuan3D v2 Multi-View generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/hunyuan3d/v2/multi-view.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/hunyuan3d/v2/multi-view",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"textured_mesh": {
"title": "Textured Mesh",
"description": "Generate a fully textured mesh (3× the white-mesh price). Turn off for a cheaper untextured geometry-only model.",
"default": true,
"type": "boolean"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance scale for the model.",
"default": 7.5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"num_inference_steps": {
"title": "Inference Steps",
"description": "Number of inference steps to perform.",
"default": 50,
"type": "number",
"minimum": 1,
"maximum": 50
},
"octree_resolution": {
"title": "Octree Resolution",
"description": "Octree resolution for the model.",
"default": 256,
"type": "number",
"minimum": 1,
"maximum": 1024
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same image every time.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 3,
"maxItems": 3
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Tencent Hunyuan3D v2 Multi-View Turbo — faster multi-view 3D reconstruction from up to 4 reference images with slightly reduced cost.
Pricing: $0.015 untextured · $0.045 textured per generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringtextured_meshbooleanguidance_scalenumbernum_inference_stepsnumberoctree_resolutionnumberseedintegeraspect_ratiostringresolutionstringreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fhunyuan3d%2Fv2%2Fmulti-view%2Fturbo",
"title": "Hunyuan3D v2 MV Turbo generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/hunyuan3d/v2/multi-view/turbo.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/hunyuan3d/v2/multi-view/turbo",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"textured_mesh": {
"title": "Textured Mesh",
"description": "Generate a fully textured mesh (3× the white-mesh price). Turn off for a cheaper untextured geometry-only model.",
"default": true,
"type": "boolean"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance scale for the model.",
"default": 7.5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"num_inference_steps": {
"title": "Inference Steps",
"description": "Number of inference steps to perform.",
"default": 50,
"type": "number",
"minimum": 1,
"maximum": 50
},
"octree_resolution": {
"title": "Octree Resolution",
"description": "Octree resolution for the model.",
"default": 256,
"type": "number",
"minimum": 1,
"maximum": 1024
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same image every time.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 3,
"maxItems": 3
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Tencent Hunyuan3D v3 — latest-generation image-to-3D with optional multi-view inputs, PBR material generation, and fine polygon control.
Pricing: $0.375 per generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_typestringenable_pbrbooleanface_countnumberpolygon_typestringinput_image_urlstringleft_image_urlstringright_image_urlstringback_image_urlstringaspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fhunyuan3d-v3%2Fimage-to-3d",
"title": "Hunyuan3D v3 Image → 3D generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/hunyuan3d-v3/image-to-3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/hunyuan3d-v3/image-to-3d",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_type": {
"title": "Generate Type",
"description": "Generation type. Normal: textured model. LowPoly: polygon reduction. Geometry: white model without texture.",
"default": "Normal",
"type": "string",
"enum": [
"Normal",
"LowPoly",
"Geometry"
]
},
"enable_pbr": {
"title": "Enable PBR",
"description": "Whether to enable PBR material generation. Does not take effect when generate_type is Geometry.",
"default": false,
"type": "boolean"
},
"face_count": {
"title": "Face Count",
"description": "Target face count. Range: 40000–1500000.",
"default": 500000,
"type": "number",
"minimum": 40000,
"maximum": 1500000
},
"polygon_type": {
"title": "Polygon Type",
"description": "Polygon type. Only takes effect when Generate Type is LowPoly.",
"default": "triangle",
"type": "string",
"enum": [
"triangle",
"quadrilateral"
]
},
"input_image_url": {
"title": "Input Image URL",
"description": "URL of image to use while generating the 3D model. Handled by the source image upload strip.",
"type": "string"
},
"left_image_url": {
"title": "Left View",
"description": "Optional left view image for better 3D reconstruction.",
"type": "string"
},
"right_image_url": {
"title": "Right View",
"description": "Optional right view image for better 3D reconstruction.",
"type": "string"
},
"back_image_url": {
"title": "Back View",
"description": "Optional back view image for better 3D reconstruction.",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"input_image_url",
"reference_image_url"
],
"additionalProperties": false
}
Hyper3D Rodin v2.5 — the latest Rodin generation. Generate highly detailed 3D models from a text prompt or up to 5 reference images, with tiered quality levels, advanced texture controls, and optional HighPack 4K output.
Pricing: $0.40 / generation · Extreme-High tier = $0.80 (2×) · HighPack add-on +$0.80
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringtierstringquality_mesh_optionstringmaterialstringgeometry_file_formatstringtexture_modestringaddonsstringenable_creative_modebooleanTAPosebooleanhd_texturebooleantexture_delightbooleanuse_original_alphabooleanpreview_renderbooleanis_microbooleanseedintegerbbox_conditionarrayaspect_ratiostringresolutionstringreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fhyper3d%2Frodin%2Fv2.5",
"title": "Hyper3D Rodin v2.5 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/hyper3d/rodin/v2.5.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/hyper3d/rodin/v2.5",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"tier": {
"title": "Tier",
"description": "Generation tier. Higher tiers produce more detailed meshes. Extreme-High costs double and enables Micro Detail.",
"default": "Gen-2.5-High",
"type": "string",
"enum": [
"Gen-2.5-Minimum",
"Gen-2.5-Extreme-Low",
"Gen-2.5-Low",
"Gen-2.5-Medium",
"Gen-2.5-High",
"Gen-2.5-Extreme-High"
]
},
"quality_mesh_option": {
"title": "Mesh Quality",
"description": "Combined mesh quality and topology. Quad = smooth surfaces; Triangle = detailed geometry. Auto picks per tier.",
"default": "Auto",
"type": "string",
"enum": [
"Auto",
"4K Quad",
"8K Quad",
"18K Quad",
"50K Quad",
"100K Quad",
"200K Quad",
"2K Triangle",
"20K Triangle",
"50K Triangle",
"150K Triangle",
"500K Triangle",
"1M Triangle",
"2M Triangle"
]
},
"material": {
"title": "Material",
"description": "Material type. PBR: physically-based. Shaded: baked lighting. All: both. None: geometry only.",
"default": "All",
"type": "string",
"enum": [
"PBR",
"Shaded",
"All",
"None"
]
},
"geometry_file_format": {
"title": "File Format",
"description": "Output geometry file format.",
"default": "glb",
"type": "string",
"enum": [
"glb",
"usdz",
"fbx",
"obj",
"stl"
]
},
"texture_mode": {
"title": "Texture Mode",
"description": "Texture generation quality. When set to Auto, the API picks an appropriate default for the selected tier.",
"default": "",
"type": "string",
"enum": [
"",
"legacy",
"extreme-low",
"low",
"medium",
"high"
]
},
"addons": {
"title": "Addons",
"description": "HighPack provides 4K textures and high-poly geometry instead of default 2K. Addsto generation cost.",
"default": "",
"type": "string",
"enum": [
"",
"HighPack"
]
},
"enable_creative_mode": {
"title": "Creative Mode",
"description": "Enhanced generative robustness with output consistency — allows more creative interpretation of the input.",
"default": false,
"type": "boolean"
},
"TAPose": {
"title": "T/A Pose",
"description": "Generate characters in T-pose or A-pose format, making them easier to rig and animate in 3D software.",
"default": false,
"type": "boolean"
},
"hd_texture": {
"title": "HD Texture",
"description": "Enable enhanced texture post-processing for higher visual fidelity.",
"default": false,
"type": "boolean"
},
"texture_delight": {
"title": "Texture Delight",
"description": "Remove baked lighting and highlights from the generated textures for cleaner PBR workflow.",
"default": false,
"type": "boolean"
},
"use_original_alpha": {
"title": "Use Original Alpha",
"description": "Preserve the transparency channel from input images during 3D generation.",
"default": false,
"type": "boolean"
},
"preview_render": {
"title": "Preview Render",
"description": "Generate a preview render image of the 3D model along with the model files.",
"default": false,
"type": "boolean"
},
"is_micro": {
"title": "Micro Detail",
"description": "Generate finer micro-scale geometric detail. Only effective with Extreme-High tier.",
"default": false,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Seed value for randomization (0–65535).",
"type": "integer",
"minimum": 0,
"maximum": 65535
},
"bbox_condition": {
"title": "Bbox Condition",
"description": "Bounding box dimensions [width, height, length]. Array of 3 integers.",
"type": "array",
"items": {
"type": "string"
}
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 5
}
},
"required": [
"model_id"
],
"additionalProperties": false
}
Meshy 7 Retexture — apply sharp PBR materials to an existing 3D mesh using text, one style image, or up to four ordered reference views.
Pricing: 10 Meshy credits at 2K/4K; 15 at 8K.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringinput_task_idstringmodel_urlstringimage_style_urlstringmultiview_front_urlstringmultiview_left_urlstringmultiview_back_urlstringmultiview_right_urlstringai_modelstringenable_pbrbooleantexture_resolutionstringremove_lightingbooleanenable_original_uvbooleanalpha_thumbnailboolean
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fmeshy%2Fretexture",
"title": "Meshy 7 Retexture generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/meshy/retexture.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/meshy/retexture",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"input_task_id": {
"title": "Input Task ID",
"description": "Source Meshy task ID — auto-filled when retexturing a Meshy-generated model. Takes priority over Model URL.",
"type": "string"
},
"model_url": {
"title": "Model URL",
"description": "URL of the 3D mesh to retexture. Supports GLB, GLTF, OBJ, FBX, STL — must be a publicly accessible URL. Used when no Input Task ID is available.",
"type": "string"
},
"image_style_url": {
"title": "Single Style Image",
"description": "Use one JPG or PNG as the texture style. An image style takes priority over the text prompt.",
"type": "string"
},
"multiview_front_url": {
"title": "Multi-View Style — Front",
"description": "Primary front style view. Adding any multi-view image makes the multi-view set the exclusive style input.",
"type": "string"
},
"multiview_left_url": {
"title": "Multi-View Style — View 2",
"description": "Optional second view of the same object.",
"type": "string"
},
"multiview_back_url": {
"title": "Multi-View Style — View 3",
"description": "Optional third view of the same object.",
"type": "string"
},
"multiview_right_url": {
"title": "Multi-View Style — View 4",
"description": "Optional fourth view of the same object.",
"type": "string"
},
"ai_model": {
"title": "AI Model",
"description": "Meshy 7 is required for multi-view style images.",
"default": "meshy-7",
"type": "string",
"enum": [
"meshy-7",
"latest",
"meshy-6",
"meshy-5"
]
},
"enable_pbr": {
"title": "Enable PBR",
"description": "Generate metallic, roughness, and normal maps. Meshy 7 does not produce an emission map.",
"default": false,
"type": "boolean"
},
"texture_resolution": {
"title": "Texture Resolution",
"description": "Base-color texture resolution. 8K has a higher generation price.",
"default": "2k",
"type": "string",
"enum": [
"2k",
"4k",
"8k"
]
},
"remove_lighting": {
"title": "Remove Lighting",
"description": "Remove baked highlights and shadows. Meshy currently supports this option only with Meshy 6.",
"default": true,
"type": "boolean"
},
"enable_original_uv": {
"title": "Preserve Original UVs",
"description": "Use the existing UV map from the model instead of generating new UVs.",
"default": false,
"type": "boolean"
},
"alpha_thumbnail": {
"title": "Alpha Thumbnail",
"description": "Generate a thumbnail image with a transparent background.",
"default": false,
"type": "boolean"
}
},
"required": [
"model_id"
],
"additionalProperties": false
}
Meshy 7 text-to-3D with textured geometry, optional remeshing, PBR materials, rigging, animation, and Ultra detail.
Pricing: 100 API credits at default settings.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringsymmetry_modestringanimation_action_idintegertopologystringenable_animationbooleanis_a_t_posebooleanenable_prompt_expansionbooleantexture_image_urlstringultra_modebooleanpose_modestringtexture_promptstringmodel_typestringmodestringenable_safety_checkerbooleanshould_remeshbooleanenable_pbrbooleantarget_polycountintegerseedintegerenable_riggingbooleanrigging_height_metersnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=meshy%2Fv7%2Ftext-to-3d",
"title": "Meshy 7 Text → 3D generation request",
"description": "Request body accepted by POST /api/v1/generate for meshy/v7/text-to-3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "meshy/v7/text-to-3d",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"maxLength": 600
},
"symmetry_mode": {
"title": "Symmetry",
"default": "auto",
"type": "string",
"enum": [
"off",
"auto",
"on"
]
},
"animation_action_id": {
"title": "Animation",
"description": "Select an available motion from Meshy's live library. For generation models, enable Add Animation to apply it.",
"default": 92,
"type": "integer",
"minimum": 0,
"multipleOf": 1
},
"topology": {
"title": "Topology",
"default": "triangle",
"type": "string",
"enum": [
"quad",
"triangle"
]
},
"enable_animation": {
"title": "Add Animation",
"default": false,
"type": "boolean"
},
"is_a_t_pose": {
"title": "Force T-Pose",
"default": false,
"type": "boolean"
},
"enable_prompt_expansion": {
"title": "Prompt Expansion",
"default": false,
"type": "boolean"
},
"texture_image_url": {
"title": "Texture Guide",
"type": "string"
},
"ultra_mode": {
"title": "Ultra Detail",
"default": false,
"type": "boolean"
},
"pose_mode": {
"title": "Pose",
"default": "",
"type": "string",
"enum": [
"",
"a-pose",
"t-pose"
]
},
"texture_prompt": {
"title": "Texture Prompt",
"description": "Optional texture guidance, up to 600 characters.",
"type": "string",
"maxLength": 600
},
"model_type": {
"title": "Model Type",
"default": "standard",
"type": "string",
"enum": [
"standard",
"lowpoly",
"smart-topology"
]
},
"mode": {
"title": "Mode",
"default": "full",
"type": "string",
"enum": [
"preview",
"full"
]
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"should_remesh": {
"title": "Remesh",
"default": true,
"type": "boolean"
},
"enable_pbr": {
"title": "PBR Materials",
"default": false,
"type": "boolean"
},
"target_polycount": {
"title": "Target Polycount",
"default": 30000,
"type": "integer",
"minimum": 100,
"maximum": 300000,
"multipleOf": 1
},
"seed": {
"title": "Seed",
"type": "integer"
},
"enable_rigging": {
"title": "Rig Character",
"default": false,
"type": "boolean"
},
"rigging_height_meters": {
"title": "Rigging Height",
"default": 1.7,
"type": "number",
"minimum": 0.1,
"multipleOf": 0.1
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Meshy Animation — apply an available motion from Meshy's live animation library. Browse walks, dances, combat, daily actions, and more with GIF previews. Pick a completed Meshy Rigging generation, or upload an un-rigged GLB to rig and animate.
Pricing: $0.042/generation from a rigged source; $0.112 when rigging an uploaded model first (Pro plan pricing).
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringrig_task_idstringmodel_urlstringanimation_action_idinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fmeshy%2Fanimation",
"title": "Meshy Animation generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/meshy/animation.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/meshy/animation",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"rig_task_id": {
"title": "Rigged Model",
"description": "Pick a completed Meshy Rigging generation to animate, or upload a 3D model instead.",
"type": "string"
},
"model_url": {
"title": "3D Model",
"description": "Upload an un-rigged GLB to rig & animate in one run (adds the rigging cost). Already-rigged models must come from Meshy Rigging — pick them in the Rigged Model slot.",
"type": "string"
},
"animation_action_id": {
"title": "Animation",
"description": "Select an available motion from Meshy's live library. For generation models, enable Add Animation to apply it.",
"default": 0,
"type": "integer",
"minimum": 0,
"multipleOf": 1
}
},
"required": [
"model_id"
],
"additionalProperties": false
}
Convert a Meshy 3D model into GLB, FBX, OBJ, USDZ, STL, 3MF, or Blender format. 1 credit per conversion.
Pricing: 1 Meshy credit per conversion.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringinput_task_idstringmodel_urlstringformatstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=meshy%2Fconvert",
"title": "Meshy Format Convert generation request",
"description": "Request body accepted by POST /api/v1/generate for meshy/convert.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "meshy/convert",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"input_task_id": {
"title": "Input Task ID",
"description": "Source Meshy task ID — auto-filled when converting a Meshy-generated model. Takes priority over Model URL.",
"type": "string"
},
"model_url": {
"title": "Model URL",
"description": "URL of the 3D model to convert. Used when no Input Task ID is available.",
"type": "string"
},
"format": {
"title": "Output Format",
"description": "Target export format.",
"default": "GLB",
"type": "string",
"enum": [
"GLB",
"FBX",
"OBJ",
"USDZ",
"STL",
"3MF",
"BLEND"
]
}
},
"required": [
"model_id"
],
"additionalProperties": false
}
Meshy Multi-Color Print — export a Meshy 3D model as a multi-color 3MF file optimized for FDM 3D printing with multiple filaments. Compatible with Bambu Studio, Orca Slicer, and other AMS-capable slicers.
Pricing: $0.14/generation at Pro plan pricing.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringinput_task_idstringmodel_urlstringmax_colorsnumbermax_depthnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=meshy%2Fprint-multi-color",
"title": "Meshy Multi-Color Print generation request",
"description": "Request body accepted by POST /api/v1/generate for meshy/print-multi-color.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "meshy/print-multi-color",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"input_task_id": {
"title": "Input Task ID",
"description": "Meshy task ID from a completed model generation. Auto-filled. Takes priority over Model URL.",
"type": "string"
},
"model_url": {
"title": "Model URL",
"description": "URL of the GLB model. Auto-filled from the current Studio asset when no task ID is available.",
"type": "string"
},
"max_colors": {
"title": "Max Colors",
"description": "Maximum number of filament colors to assign (1–16). More colors produce richer detail.",
"default": 4,
"type": "number",
"minimum": 1,
"maximum": 16,
"multipleOf": 1
},
"max_depth": {
"title": "Max Depth",
"description": "Color segmentation depth. Higher values create finer color boundaries (3–6).",
"default": 4,
"type": "number",
"minimum": 3,
"maximum": 6,
"multipleOf": 1
}
},
"required": [
"model_id"
],
"additionalProperties": false
}
Meshy Printability Analysis — analyze a Meshy 3D model for common 3D printing issues such as non-manifold edges, holes, degenerate faces, and watertightness. Free to run.
Pricing: Free — no credits consumed.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringinput_task_idstringmodel_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=meshy%2Fprint-analyze",
"title": "Meshy Printability Analysis generation request",
"description": "Request body accepted by POST /api/v1/generate for meshy/print-analyze.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "meshy/print-analyze",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"input_task_id": {
"title": "Input Task ID",
"description": "Meshy task ID from a completed model generation. Auto-filled. Takes priority over Model URL.",
"type": "string"
},
"model_url": {
"title": "Model URL",
"description": "URL of the GLB model. Auto-filled from the current Studio asset when no task ID is available.",
"type": "string"
}
},
"required": [
"model_id"
],
"additionalProperties": false
}
Meshy Printability Repair — automatically fix mesh issues in a Meshy 3D model (non-manifold edges, holes, degenerate faces) to make it print-ready. Outputs a repaired GLB added as a new version.
Pricing: $0.14/generation at Pro plan pricing.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringinput_task_idstringmodel_urlstringalpha_thumbnailboolean
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=meshy%2Fprint-repair",
"title": "Meshy Printability Repair generation request",
"description": "Request body accepted by POST /api/v1/generate for meshy/print-repair.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "meshy/print-repair",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"input_task_id": {
"title": "Input Task ID",
"description": "Meshy task ID from a completed model generation. Auto-filled. Takes priority over Model URL.",
"type": "string"
},
"model_url": {
"title": "Model URL",
"description": "URL of the GLB model. Auto-filled from the current Studio asset when no task ID is available.",
"type": "string"
},
"alpha_thumbnail": {
"title": "Alpha Thumbnail",
"description": "Generate a thumbnail with a transparent background.",
"default": false,
"type": "boolean"
}
},
"required": [
"model_id"
],
"additionalProperties": false
}
Meshy Remesh — retopologize and decimate a 3D model to a target polycount. Reduce mesh density for real-time engines, or switch to a quad-dominant topology for clean editing. Outputs an optimized GLB added as a new version.
Pricing: 5 Meshy credits per remesh.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringinput_task_idstringmodel_urlstringtopologystringtarget_polycountnumberdecimation_modestringalpha_thumbnailboolean
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=meshy%2Fremesh",
"title": "Meshy Remesh (Optimize) generation request",
"description": "Request body accepted by POST /api/v1/generate for meshy/remesh.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "meshy/remesh",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"input_task_id": {
"title": "Input Task ID",
"description": "Source Meshy task ID — auto-filled when optimizing a Meshy-generated model. Takes priority over Model URL.",
"type": "string"
},
"model_url": {
"title": "Model URL",
"description": "URL of the model to remesh. Auto-filled from the current Studio asset when no task ID is available.",
"type": "string"
},
"topology": {
"title": "Topology",
"description": "Triangle = decimated render mesh; Quad = clean topology for editing.",
"default": "triangle",
"type": "string",
"enum": [
"triangle",
"quad"
]
},
"target_polycount": {
"title": "Target Polycount",
"description": "Approximate polygon count of the output (100–300,000). Ignored when an Adaptive level is set.",
"default": 30000,
"type": "number",
"minimum": 100,
"maximum": 300000,
"multipleOf": 1000
},
"decimation_mode": {
"title": "Adaptive Decimation",
"description": "When set, Meshy auto-picks the polycount and Target Polycount is ignored.",
"default": "",
"type": "string",
"enum": [
"",
"1",
"2",
"3",
"4"
]
},
"alpha_thumbnail": {
"title": "Alpha Thumbnail",
"description": "Also render a transparent-background preview.",
"default": false,
"type": "boolean"
}
},
"required": [
"model_id"
],
"additionalProperties": false
}
Meshy Rigging — automatically rig any existing 3D GLB model for humanoid animation, with optional animation preset support.
Pricing: $0.07/generation at Pro plan pricing.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringmodel_urlstringheight_metersnumbertexture_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fmeshy%2Frigging",
"title": "Meshy Rigging generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/meshy/rigging.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/meshy/rigging",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"model_url": {
"title": "Model URL",
"description": "URL of a 3D model in GLB format to rig. Can be any publicly accessible URL — works with models generated by Hunyuan, Trellis, Meshy, or any other 3D generator.",
"type": "string"
},
"height_meters": {
"title": "Height (m)",
"description": "Approximate height of the character in meters. 1.7 m = average adult.",
"default": 1.7,
"type": "number",
"minimum": 0.3,
"maximum": 3,
"multipleOf": 0.1
},
"texture_image_url": {
"title": "Texture Override",
"description": "Optional PNG image to override the texture on the rigged output model.",
"type": "string"
}
},
"required": [
"model_id",
"model_url"
],
"additionalProperties": false
}
Meshy UV Unwrap — automatically generate a clean, non-overlapping UV layout for a Meshy 3D model. Outputs a 'UV white model' (same geometry, fresh UVs, grey placeholder material) ready for texturing in Blender, Substance Painter, or Unreal. Supports meshes up to 40,000 faces.
Pricing: 5 Meshy credits per unwrap.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringinput_task_idstringmodel_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=meshy%2Fuv-unwrap",
"title": "Meshy UV Unwrap generation request",
"description": "Request body accepted by POST /api/v1/generate for meshy/uv-unwrap.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "meshy/uv-unwrap",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"input_task_id": {
"title": "Input Task ID",
"description": "Source Meshy task ID — auto-filled when unwrapping a Meshy-generated model. Takes priority over Model URL.",
"type": "string"
},
"model_url": {
"title": "Model URL",
"description": "URL of the GLB model to unwrap. Used when no Input Task ID is available.",
"type": "string"
}
},
"required": [
"model_id"
],
"additionalProperties": false
}
Meshy v5 multi-image-to-3D — previous-generation multi-view 3D reconstruction with PBR support from up to 4 reference images.
Pricing: $0.21/generation at Pro plan pricing.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenable_riggingbooleanpose_modestringshould_texturebooleantexture_promptstringshould_remeshbooleantopologystringenable_animationbooleantarget_polycountnumberrigging_height_metersnumbersymmetry_modestringanimation_action_idintegerenable_pbrbooleanenable_safety_checkerbooleantexture_image_urlstringaspect_ratiostringresolutionstringreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fmeshy%2Fv5%2Fmulti-image-to-3d",
"title": "Meshy-5 Multi-Image → 3D generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/meshy/v5/multi-image-to-3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/meshy/v5/multi-image-to-3d",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enable_rigging": {
"title": "Enable Rigging",
"description": "Automatically rig the generated model as a humanoid character.",
"default": false,
"type": "boolean"
},
"pose_mode": {
"title": "Pose Mode",
"description": "Pose mode for the generated model.",
"default": "",
"type": "string",
"enum": [
"a-pose",
"t-pose",
""
]
},
"should_texture": {
"title": "Texture",
"description": "Whether to generate textures. False provides mesh without textures for 5 credits, True adds texture generation for additional 10 credits.",
"default": true,
"type": "boolean"
},
"texture_prompt": {
"title": "Texture Prompt",
"description": "Text prompt to guide the texturing process. Requires should_texture to be true.",
"type": "string"
},
"should_remesh": {
"title": "Remesh",
"description": "Whether to enable the remesh phase.",
"default": true,
"type": "boolean"
},
"topology": {
"title": "Topology",
"description": "Mesh topology. Quad for smooth surfaces, Triangle for detailed geometry.",
"default": "triangle",
"type": "string",
"enum": [
"quad",
"triangle"
]
},
"enable_animation": {
"title": "Enable Animation",
"description": "Apply an animation preset to the rigged model. Requires enable_rigging to be true.",
"default": false,
"type": "boolean"
},
"target_polycount": {
"title": "Target Polycount",
"description": "Target number of polygons in the generated model.",
"default": 30000,
"type": "number",
"minimum": 100,
"maximum": 300000,
"multipleOf": 1
},
"rigging_height_meters": {
"title": "Rigging Height (m)",
"description": "Approximate height of the character in meters. Only used when enable_rigging is true.",
"default": 1.7,
"type": "number"
},
"symmetry_mode": {
"title": "Symmetry Mode",
"description": "Controls symmetry behavior during model generation.",
"default": "auto",
"type": "string",
"enum": [
"off",
"auto",
"on"
]
},
"animation_action_id": {
"title": "Animation",
"description": "Select an available motion from Meshy's live library. For generation models, enable Add Animation to apply it.",
"default": 92,
"type": "integer",
"minimum": 0,
"multipleOf": 1
},
"enable_pbr": {
"title": "Enable PBR",
"description": "Generate PBR maps (metallic, roughness, normal) in addition to base color. Requires should_texture to be true.",
"default": false,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the input safety checker before processing.",
"default": true,
"type": "boolean"
},
"texture_image_url": {
"title": "Texture Guide Image",
"description": "2D image to guide the texturing process. Requires should_texture to be true.",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 4
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Meshy v6 image-to-3D — high-quality textured mesh from a single photo with optional PBR maps and auto-rigging for humanoid characters.
Pricing: $0.42/generation at Pro plan pricing.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenable_riggingbooleanpose_modestringshould_texturebooleantexture_promptstringshould_remeshbooleantopologystringenable_animationbooleantarget_polycountnumberrigging_height_metersnumbersymmetry_modestringanimation_action_idintegerenable_pbrbooleanhd_texturebooleanenable_safety_checkerbooleantexture_image_urlstringaspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fmeshy%2Fv6%2Fimage-to-3d",
"title": "Meshy-6 Image → 3D generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/meshy/v6/image-to-3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/meshy/v6/image-to-3d",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enable_rigging": {
"title": "Enable Rigging",
"description": "Automatically rig the generated model as a humanoid character. Includes basic walking and running animations. Best results with humanoid characters.",
"default": false,
"type": "boolean"
},
"pose_mode": {
"title": "Pose Mode",
"description": "Pose mode for the generated model. 'a-pose' generates an A-pose, 't-pose' generates a T-pose, empty string for no specific pose.",
"default": "",
"type": "string",
"enum": [
"a-pose",
"t-pose",
""
]
},
"should_texture": {
"title": "Texture",
"description": "Whether to generate textures.",
"default": true,
"type": "boolean"
},
"texture_prompt": {
"title": "Texture Prompt",
"description": "Text prompt to guide the texturing process.",
"type": "string"
},
"should_remesh": {
"title": "Remesh",
"description": "Whether to enable the remesh phase.",
"default": true,
"type": "boolean"
},
"topology": {
"title": "Topology",
"description": "Mesh topology. Quad for smooth surfaces, Triangle for detailed geometry.",
"default": "triangle",
"type": "string",
"enum": [
"quad",
"triangle"
]
},
"enable_animation": {
"title": "Enable Animation",
"description": "Apply an animation preset to the rigged model. Requires enable_rigging to be true.",
"default": false,
"type": "boolean"
},
"target_polycount": {
"title": "Target Polycount",
"description": "Target number of polygons in the generated model.",
"default": 30000,
"type": "number",
"minimum": 100,
"maximum": 300000,
"multipleOf": 1
},
"rigging_height_meters": {
"title": "Rigging Height (m)",
"description": "Approximate height of the character in meters. Only used when enable_rigging is true.",
"default": 1.7,
"type": "number"
},
"symmetry_mode": {
"title": "Symmetry Mode",
"description": "Controls symmetry behavior during model generation.",
"default": "auto",
"type": "string",
"enum": [
"off",
"auto",
"on"
]
},
"animation_action_id": {
"title": "Animation",
"description": "Select an available motion from Meshy's live library. For generation models, enable Add Animation to apply it.",
"default": 92,
"type": "integer",
"minimum": 0,
"multipleOf": 1
},
"enable_pbr": {
"title": "Enable PBR",
"description": "Generate PBR maps (metallic, roughness, normal) in addition to base color.",
"default": false,
"type": "boolean"
},
"hd_texture": {
"title": "HD Texture (4K)",
"description": "Generate 4K base color texture instead of the default 1K.",
"default": false,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the input safety checker before processing.",
"default": true,
"type": "boolean"
},
"texture_image_url": {
"title": "Texture Guide Image",
"description": "2D image to guide the texturing process.",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Meshy v6 multi-image-to-3D — upload up to 4 reference views for more accurate 3D geometry, texturing, PBR maps, and optional rigging.
Pricing: $0.28 untextured · $0.42 textured at Pro plan pricing.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenable_riggingbooleanpose_modestringshould_texturebooleantexture_promptstringshould_remeshbooleantopologystringenable_animationbooleantarget_polycountnumberrigging_height_metersnumbersymmetry_modestringanimation_action_idintegerenable_pbrbooleanhd_texturebooleanenable_safety_checkerbooleantexture_image_urlstringaspect_ratiostringresolutionstringreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fmeshy%2Fv6%2Fmulti-image-to-3d",
"title": "Meshy-6 Multi-Image → 3D generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/meshy/v6/multi-image-to-3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/meshy/v6/multi-image-to-3d",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enable_rigging": {
"title": "Enable Rigging",
"description": "Automatically rig the generated model as a humanoid character. Best results with humanoid characters.",
"default": false,
"type": "boolean"
},
"pose_mode": {
"title": "Pose Mode",
"description": "Pose mode for the generated model.",
"default": "",
"type": "string",
"enum": [
"a-pose",
"t-pose",
""
]
},
"should_texture": {
"title": "Texture",
"description": "Whether to generate textures. False provides mesh without textures for 5 credits, True adds texture generation for additional 10 credits.",
"default": true,
"type": "boolean"
},
"texture_prompt": {
"title": "Texture Prompt",
"description": "Text prompt to guide the texturing process. Requires should_texture to be true.",
"type": "string"
},
"should_remesh": {
"title": "Remesh",
"description": "Whether to enable the remesh phase.",
"default": true,
"type": "boolean"
},
"topology": {
"title": "Topology",
"description": "Mesh topology. Quad for smooth surfaces, Triangle for detailed geometry.",
"default": "triangle",
"type": "string",
"enum": [
"quad",
"triangle"
]
},
"enable_animation": {
"title": "Enable Animation",
"description": "Apply an animation preset to the rigged model. Requires enable_rigging to be true.",
"default": false,
"type": "boolean"
},
"target_polycount": {
"title": "Target Polycount",
"description": "Target number of polygons in the generated model.",
"default": 30000,
"type": "number",
"minimum": 100,
"maximum": 300000,
"multipleOf": 1
},
"rigging_height_meters": {
"title": "Rigging Height (m)",
"description": "Approximate height of the character in meters. Only used when enable_rigging is true.",
"default": 1.7,
"type": "number"
},
"symmetry_mode": {
"title": "Symmetry Mode",
"description": "Controls symmetry behavior during model generation.",
"default": "auto",
"type": "string",
"enum": [
"off",
"auto",
"on"
]
},
"animation_action_id": {
"title": "Animation",
"description": "Select an available motion from Meshy's live library. For generation models, enable Add Animation to apply it.",
"default": 92,
"type": "integer",
"minimum": 0,
"multipleOf": 1
},
"enable_pbr": {
"title": "Enable PBR",
"description": "Generate PBR maps (metallic, roughness, normal) in addition to base color. Requires should_texture to be true.",
"default": false,
"type": "boolean"
},
"hd_texture": {
"title": "HD Texture (4K)",
"description": "Generate 4K base color texture instead of the default 1K. Requires should_texture to be true.",
"default": false,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the input safety checker before processing.",
"default": true,
"type": "boolean"
},
"texture_image_url": {
"title": "Texture Guide Image",
"description": "2D image to guide the texturing process. Requires should_texture to be true.",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 4
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Meshy v6 text-to-3D — generate fully textured 3D models from a text description with optional PBR maps, rigging, and animation.
Pricing: $0.42/generation at Pro plan pricing.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringmodestringenable_riggingbooleanseedintegerpose_modestringenable_pbrbooleanrigging_height_metersnumbertexture_promptstringshould_remeshbooleantopologystringenable_animationbooleantarget_polycountnumbersymmetry_modestringanimation_action_idintegerenable_safety_checkerbooleantexture_image_urlstringenable_prompt_expansionbooleanaspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fmeshy%2Fv6%2Ftext-to-3d",
"title": "Meshy-6 Text → 3D generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/meshy/v6/text-to-3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/meshy/v6/text-to-3d",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"mode": {
"title": "Mode",
"description": "Generation mode. 'preview' returns untextured geometry only, 'full' returns textured model.",
"default": "full",
"type": "string",
"enum": [
"preview",
"full"
]
},
"enable_rigging": {
"title": "Enable Rigging",
"description": "Automatically rig the generated model as a humanoid character. Best results with humanoid characters.",
"default": false,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Seed for reproducible results.",
"type": "integer"
},
"pose_mode": {
"title": "Pose Mode",
"description": "Pose mode for the generated model.",
"default": "",
"type": "string",
"enum": [
"a-pose",
"t-pose",
""
]
},
"enable_pbr": {
"title": "Enable PBR",
"description": "Generate PBR maps (metallic, roughness, normal) in addition to base color.",
"default": false,
"type": "boolean"
},
"rigging_height_meters": {
"title": "Rigging Height (m)",
"description": "Approximate height of the character in meters. Only used when enable_rigging is true.",
"default": 1.7,
"type": "number"
},
"texture_prompt": {
"title": "Texture Prompt",
"description": "Additional text prompt to guide the texturing process (only used in 'full' mode).",
"type": "string"
},
"should_remesh": {
"title": "Remesh",
"description": "Whether to enable the remesh phase. When false, returns unprocessed triangular mesh.",
"default": true,
"type": "boolean"
},
"topology": {
"title": "Topology",
"description": "Mesh topology. Quad for smooth surfaces, Triangle for detailed geometry.",
"default": "triangle",
"type": "string",
"enum": [
"quad",
"triangle"
]
},
"enable_animation": {
"title": "Enable Animation",
"description": "Apply an animation preset to the rigged model. Requires enable_rigging to be true.",
"default": false,
"type": "boolean"
},
"target_polycount": {
"title": "Target Polycount",
"description": "Target number of polygons in the generated model.",
"default": 30000,
"type": "number",
"minimum": 100,
"maximum": 300000,
"multipleOf": 1
},
"symmetry_mode": {
"title": "Symmetry Mode",
"description": "Controls symmetry behavior during model generation.",
"default": "auto",
"type": "string",
"enum": [
"off",
"auto",
"on"
]
},
"animation_action_id": {
"title": "Animation",
"description": "Select an available motion from Meshy's live library. For generation models, enable Add Animation to apply it.",
"default": 92,
"type": "integer",
"minimum": 0,
"multipleOf": 1
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the input safety checker before processing.",
"default": true,
"type": "boolean"
},
"texture_image_url": {
"title": "Texture Guide Image",
"description": "2D image to guide the texturing process (only used in 'full' mode).",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Prompt Expansion",
"description": "Use a large language model to expand the prompt with additional details while maintaining the original meaning.",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Meshy 7 image-to-3D with higher-fidelity geometry, optional Ultra detail, PBR texturing up to 8K, and production-ready GLB output.
Pricing: 20 Meshy credits without texture; 30 at 2K/4K, 35 at 8K, plus 5 for Ultra.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringultra_modebooleanshould_texturebooleantexture_resolutionstringenable_pbrbooleantexture_promptstringtexture_image_urlstringshould_remeshbooleantopologystringdecimation_modestringtarget_polycountnumberpose_modestringimage_enhancementbooleanauto_sizebooleanorigin_atstringaspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fmeshy%2Fv7%2Fimage-to-3d",
"title": "Meshy-7 Image → 3D generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/meshy/v7/image-to-3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/meshy/v7/image-to-3d",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"ultra_mode": {
"title": "Ultra Geometry",
"description": "Add Meshy 7 Ultra generation for finer surface detail and higher-fidelity geometry.",
"default": false,
"type": "boolean"
},
"should_texture": {
"title": "Texture",
"description": "Generate base-color textures. Turn off for a geometry-only result.",
"default": true,
"type": "boolean"
},
"texture_resolution": {
"title": "Texture Resolution",
"description": "Base-color texture resolution. 8K has a higher generation price.",
"default": "2k",
"type": "string",
"enum": [
"2k",
"4k",
"8k"
]
},
"enable_pbr": {
"title": "Enable PBR",
"description": "Generate metallic, roughness, and normal maps. Meshy 7 does not produce an emission map.",
"default": false,
"type": "boolean"
},
"texture_prompt": {
"title": "Texture Prompt",
"description": "Optional material or appearance guidance. Takes priority over a texture guide image.",
"type": "string"
},
"texture_image_url": {
"title": "Texture Guide Image",
"description": "Optional JPG or PNG image used to guide texturing.",
"type": "string"
},
"should_remesh": {
"title": "Remesh",
"description": "Remesh and decimate the result. Leave off for Meshy 7's highest-fidelity geometry.",
"default": false,
"type": "boolean"
},
"topology": {
"title": "Remesh Topology",
"description": "Topology used only when Remesh is enabled.",
"default": "triangle",
"type": "string",
"enum": [
"triangle",
"quad"
]
},
"decimation_mode": {
"title": "Adaptive Decimation",
"description": "Adaptive face-count level. When selected it overrides Target Face Count.",
"default": "",
"type": "string",
"enum": [
"",
"1",
"2",
"3",
"4"
]
},
"target_polycount": {
"title": "Target Face Count",
"description": "Approximate face count when Remesh is enabled and adaptive decimation is off.",
"default": 30000,
"type": "number",
"minimum": 100,
"maximum": 300000,
"multipleOf": 100
},
"pose_mode": {
"title": "Pose Mode",
"description": "Request an A-pose or T-pose for character inputs.",
"default": "",
"type": "string",
"enum": [
"",
"a-pose",
"t-pose"
]
},
"image_enhancement": {
"title": "Image Enhancement",
"description": "Optimize the input image for better reconstruction. Turn off to preserve its exact appearance.",
"default": true,
"type": "boolean"
},
"auto_size": {
"title": "Auto Size",
"description": "Estimate the object's real-world height and scale the model automatically.",
"default": false,
"type": "boolean"
},
"origin_at": {
"title": "Origin",
"description": "Origin position when Auto Size is enabled.",
"default": "bottom",
"type": "string",
"enum": [
"bottom",
"center"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Meshy 7 multi-view reconstruction from up to four images, with the first image used as the primary front view and PBR textures up to 8K.
Pricing: 20 Meshy credits without texture; 30 at 2K/4K and 35 at 8K.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringshould_texturebooleantexture_resolutionstringenable_pbrbooleantexture_promptstringtexture_image_urlstringshould_remeshbooleantopologystringdecimation_modestringtarget_polycountnumberpose_modestringimage_enhancementbooleanremove_lightingbooleanauto_sizebooleanorigin_atstringaspect_ratiostringresolutionstringreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fmeshy%2Fv7%2Fmulti-image-to-3d",
"title": "Meshy-7 Multi-Image → 3D generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/meshy/v7/multi-image-to-3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/meshy/v7/multi-image-to-3d",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"should_texture": {
"title": "Texture",
"description": "Generate base-color textures. Turn off for a geometry-only result.",
"default": true,
"type": "boolean"
},
"texture_resolution": {
"title": "Texture Resolution",
"description": "Base-color texture resolution. 8K has a higher generation price.",
"default": "2k",
"type": "string",
"enum": [
"2k",
"4k",
"8k"
]
},
"enable_pbr": {
"title": "Enable PBR",
"description": "Generate metallic, roughness, and normal maps. Meshy 7 does not produce an emission map.",
"default": false,
"type": "boolean"
},
"texture_prompt": {
"title": "Texture Prompt",
"description": "Optional material or appearance guidance. Takes priority over a texture guide image.",
"type": "string"
},
"texture_image_url": {
"title": "Texture Guide Image",
"description": "Optional JPG or PNG image used to guide texturing.",
"type": "string"
},
"should_remesh": {
"title": "Remesh",
"description": "Remesh and decimate the result. Leave off for the highest-fidelity geometry.",
"default": false,
"type": "boolean"
},
"topology": {
"title": "Remesh Topology",
"description": "Topology used only when Remesh is enabled.",
"default": "triangle",
"type": "string",
"enum": [
"triangle",
"quad"
]
},
"decimation_mode": {
"title": "Adaptive Decimation",
"description": "Adaptive face-count level. When selected it overrides Target Face Count.",
"default": "",
"type": "string",
"enum": [
"",
"1",
"2",
"3",
"4"
]
},
"target_polycount": {
"title": "Target Face Count",
"description": "Approximate face count when Remesh is enabled and adaptive decimation is off.",
"default": 30000,
"type": "number",
"minimum": 100,
"maximum": 300000,
"multipleOf": 100
},
"pose_mode": {
"title": "Pose Mode",
"description": "Request an A-pose or T-pose for character inputs.",
"default": "",
"type": "string",
"enum": [
"",
"a-pose",
"t-pose"
]
},
"image_enhancement": {
"title": "Image Enhancement",
"description": "Optimize input views for reconstruction. Turn off to preserve their exact appearance.",
"default": true,
"type": "boolean"
},
"remove_lighting": {
"title": "Remove Lighting",
"description": "Remove baked highlights and shadows for textures that can be relit cleanly.",
"default": true,
"type": "boolean"
},
"auto_size": {
"title": "Auto Size",
"description": "Estimate the object's real-world height and scale the model automatically.",
"default": false,
"type": "boolean"
},
"origin_at": {
"title": "Origin",
"description": "Origin position when Auto Size is enabled.",
"default": "bottom",
"type": "string",
"enum": [
"bottom",
"center"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 1,
"maxItems": 4
}
},
"required": [
"model_id",
"reference_image_urls"
],
"additionalProperties": false
}
Pixal3D by ByteDance — image-to-3D model with three-stage generation pipeline (structure, shape, texture) and fine-grained per-stage controls.
Pricing: ~$0.30 @ 1024 · ~$0.42 @ 1536
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringtexture_sizenumberss_sampling_stepsnumbershape_slat_sampling_stepsnumbertex_slat_sampling_stepsnumberss_guidance_strengthnumbershape_slat_guidance_strengthnumbertex_slat_guidance_strengthnumberss_rescale_tnumbershape_slat_rescale_tnumbertex_slat_rescale_tnumberss_guidance_rescalenumbershape_slat_guidance_rescalenumbertex_slat_guidance_rescalenumberdecimation_targetnumbermax_num_tokensnumbermesh_scalenumberremeshbooleanseedintegerresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fpixal3d",
"title": "Pixal3D generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/pixal3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/pixal3d",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"texture_size": {
"title": "Texture Size",
"description": "Resolution of the texture image baked onto the mesh. Higher values capture finer surface details but produce larger files.",
"default": 2048,
"type": "number",
"enum": [
1024,
2048,
4096
]
},
"ss_sampling_steps": {
"title": "Structure Steps",
"description": "Number of denoising steps for the initial structure.",
"default": 12,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"shape_slat_sampling_steps": {
"title": "Shape Steps",
"description": "Number of denoising steps for shape refinement.",
"default": 12,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"tex_slat_sampling_steps": {
"title": "Texture Steps",
"description": "Number of denoising steps for texture generation.",
"default": 12,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"ss_guidance_strength": {
"title": "Structure Guidance",
"description": "How closely the initial 3D structure follows the input image.",
"default": 7.5,
"type": "number",
"minimum": 0,
"maximum": 10
},
"shape_slat_guidance_strength": {
"title": "Shape Guidance",
"description": "How closely the detailed geometry follows the input image.",
"default": 7.5,
"type": "number",
"minimum": 0,
"maximum": 10
},
"tex_slat_guidance_strength": {
"title": "Texture Guidance",
"description": "How closely the texture follows the input image colors.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 10
},
"ss_rescale_t": {
"title": "Structure Rescale T",
"description": "Controls noise schedule sharpness for structure generation.",
"default": 5,
"type": "number",
"minimum": 1,
"maximum": 6
},
"shape_slat_rescale_t": {
"title": "Shape Rescale T",
"description": "Controls noise schedule sharpness for shape refinement.",
"default": 3,
"type": "number",
"minimum": 1,
"maximum": 6
},
"tex_slat_rescale_t": {
"title": "Texture Rescale T",
"description": "Controls noise schedule sharpness for texture generation.",
"default": 3,
"type": "number",
"minimum": 1,
"maximum": 6
},
"ss_guidance_rescale": {
"title": "Structure Guidance Rescale",
"description": "Dampens artifacts from high guidance in stage 1.",
"default": 0.7,
"type": "number",
"minimum": 0,
"maximum": 1
},
"shape_slat_guidance_rescale": {
"title": "Shape Guidance Rescale",
"description": "Dampens artifacts from high guidance in the shape stage.",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1
},
"tex_slat_guidance_rescale": {
"title": "Texture Guidance Rescale",
"description": "Dampens artifacts from high guidance in the texture stage.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 1
},
"decimation_target": {
"title": "Decimation Target",
"description": "Target number of vertices in the final mesh.",
"default": 200000,
"type": "number",
"minimum": 5000,
"maximum": 2000000,
"multipleOf": 1
},
"max_num_tokens": {
"title": "Max Tokens",
"description": "Maximum number of HR tokens used by the cascaded shape sampler. Higher values allow finer geometry.",
"default": 49152,
"type": "number",
"minimum": 4096,
"maximum": 131072,
"multipleOf": 1
},
"mesh_scale": {
"title": "Mesh Scale",
"description": "Scale factor applied to the inferred mesh. Affects camera distance estimation.",
"default": 1,
"type": "number",
"minimum": 0.1,
"maximum": 4
},
"remesh": {
"title": "Remesh",
"description": "Rebuild the mesh topology for cleaner triangles.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility.",
"type": "integer"
},
"resolution": {
"type": "string",
"enum": [
"1024",
"1536"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Rebuild an object from a single image as a clean triangle mesh with natively separated parts and a controlled face count.
Pricing: 5 Meshy credits without texture; 15 with texture.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringtarget_polycountnumbershould_texturebooleanenable_pbrbooleantexture_promptstringtexture_image_urlstringpose_modestringauto_sizebooleanorigin_atstringaspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=meshy%2Fsmart-topology%2Fimage-to-3d",
"title": "Smart Topology Image to 3D generation request",
"description": "Request body accepted by POST /api/v1/generate for meshy/smart-topology/image-to-3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "meshy/smart-topology/image-to-3d",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"target_polycount": {
"title": "Target Face Count",
"description": "Generate directly at this approximate face count (100-15,000). No separate remesh pass is used.",
"default": 4000,
"type": "number",
"minimum": 100,
"maximum": 15000,
"multipleOf": 100
},
"should_texture": {
"title": "Texture",
"description": "Generate base-color textures. Turning this off uses the lower untextured price.",
"default": true,
"type": "boolean"
},
"enable_pbr": {
"title": "Enable PBR",
"description": "Generate metallic, roughness, and normal maps in addition to base color. Requires Texture.",
"default": false,
"type": "boolean"
},
"texture_prompt": {
"title": "Texture Prompt",
"description": "Optional material or appearance guidance. Maximum 600 characters.",
"type": "string"
},
"texture_image_url": {
"title": "Texture Guide Image",
"description": "Optional JPG or PNG image to guide texturing. A texture prompt takes priority when both are provided.",
"type": "string"
},
"pose_mode": {
"title": "Pose Mode",
"description": "Request an A-pose or T-pose for character inputs.",
"default": "",
"type": "string",
"enum": [
"",
"a-pose",
"t-pose"
]
},
"auto_size": {
"title": "Auto Size",
"description": "Estimate the object's real-world height and scale the output automatically.",
"default": false,
"type": "boolean"
},
"origin_at": {
"title": "Origin",
"description": "Origin position when Auto Size is enabled.",
"default": "bottom",
"type": "string",
"enum": [
"bottom",
"center"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Advanced image-to-3D model with three-stage pipeline (structure, shape, texture), UV unwrapping, and full pipeline controls for high-quality GLB export.
Pricing: $0.30 per generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringss_sampling_stepsnumberss_guidance_strengthnumberss_guidance_rescalenumberss_rescale_tnumberss_guidance_interval_startnumberss_guidance_interval_endnumbershape_slat_sampling_stepsnumbershape_slat_guidance_strengthnumbershape_slat_guidance_rescalenumbershape_slat_rescale_tnumbershape_slat_guidance_interval_startnumbershape_slat_guidance_interval_endnumbertex_slat_sampling_stepsnumbertex_slat_guidance_strengthnumbertex_slat_guidance_rescalenumbertex_slat_rescale_tnumbertex_slat_guidance_interval_startnumbertex_slat_guidance_interval_endnumberresolutionstringtexture_sizenumberdecimation_targetnumberremeshbooleanremesh_bandnumberremesh_projectnumberuv_unwrap_angle_threshold_degnumberuv_unwrap_global_iterationsnumberuv_unwrap_refine_iterationsnumberuv_unwrap_smooth_strengthnumberseedintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Ftrellis-2",
"title": "Trellis 2 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/trellis-2.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/trellis-2",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"ss_sampling_steps": {
"title": "Structure Steps",
"description": "Number of denoising steps for the initial structure. More steps = slower but potentially higher quality.",
"default": 12,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"ss_guidance_strength": {
"title": "Structure Guidance",
"description": "How closely the initial 3D structure follows the input image.",
"default": 7.5,
"type": "number",
"minimum": 0,
"maximum": 10
},
"ss_guidance_rescale": {
"title": "Structure Guidance Rescale",
"description": "Dampens artifacts from high guidance in stage 1.",
"default": 0.7,
"type": "number",
"minimum": 0,
"maximum": 1
},
"ss_rescale_t": {
"title": "Structure Rescale T",
"description": "Controls noise schedule sharpness for structure generation.",
"default": 5,
"type": "number",
"minimum": 1,
"maximum": 6
},
"ss_guidance_interval_start": {
"title": "Structure Guidance Start",
"description": "Fraction of denoising at which guidance starts for stage 1.",
"default": 0.6,
"type": "number",
"minimum": 0,
"maximum": 1
},
"ss_guidance_interval_end": {
"title": "Structure Guidance End",
"description": "Fraction of denoising at which guidance ends for stage 1.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"shape_slat_sampling_steps": {
"title": "Shape Steps",
"description": "Number of denoising steps for shape refinement. More steps = slower but potentially smoother geometry.",
"default": 12,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"shape_slat_guidance_strength": {
"title": "Shape Guidance",
"description": "How closely the detailed geometry follows the input image.",
"default": 7.5,
"type": "number",
"minimum": 0,
"maximum": 10
},
"shape_slat_guidance_rescale": {
"title": "Shape Guidance Rescale",
"description": "Dampens artifacts from high guidance in the shape stage.",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1
},
"shape_slat_rescale_t": {
"title": "Shape Rescale T",
"description": "Controls noise schedule sharpness for shape refinement.",
"default": 3,
"type": "number",
"minimum": 1,
"maximum": 6
},
"shape_slat_guidance_interval_start": {
"title": "Shape Guidance Start",
"description": "Fraction of denoising at which guidance starts for stage 2.",
"default": 0.6,
"type": "number",
"minimum": 0,
"maximum": 1
},
"shape_slat_guidance_interval_end": {
"title": "Shape Guidance End",
"description": "Fraction of denoising at which guidance ends for stage 2.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"tex_slat_sampling_steps": {
"title": "Texture Steps",
"description": "Number of denoising steps for texture generation. More steps = slower but potentially cleaner textures.",
"default": 12,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"tex_slat_guidance_strength": {
"title": "Texture Guidance",
"description": "How closely the texture follows the input image colors.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 10
},
"tex_slat_guidance_rescale": {
"title": "Texture Guidance Rescale",
"description": "Dampens artifacts from high guidance in the texture stage.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 1
},
"tex_slat_rescale_t": {
"title": "Texture Rescale T",
"description": "Controls noise schedule sharpness for texture generation.",
"default": 3,
"type": "number",
"minimum": 1,
"maximum": 6
},
"tex_slat_guidance_interval_start": {
"title": "Texture Guidance Start",
"description": "Fraction of denoising at which guidance starts for stage 3.",
"default": 0.6,
"type": "number",
"minimum": 0,
"maximum": 1
},
"tex_slat_guidance_interval_end": {
"title": "Texture Guidance End",
"description": "Fraction of denoising at which guidance ends for stage 3.",
"default": 0.9,
"type": "number",
"minimum": 0,
"maximum": 1
},
"resolution": {
"title": "Resolution",
"description": "Output resolution; higher is slower but more detailed.",
"default": 1024,
"type": "string",
"enum": [
"512",
"1024",
"1536"
]
},
"texture_size": {
"title": "Texture Size",
"description": "Resolution of the texture image baked onto the mesh.",
"default": 2048,
"type": "number",
"enum": [
1024,
2048,
4096
]
},
"decimation_target": {
"title": "Decimation Target",
"description": "Target number of vertices in the final mesh. Lower = smaller files, less detail.",
"default": 500000,
"type": "number",
"minimum": 5000,
"maximum": 2000000,
"multipleOf": 1
},
"remesh": {
"title": "Remesh",
"description": "Rebuild the mesh topology for cleaner triangles.",
"default": true,
"type": "boolean"
},
"remesh_band": {
"title": "Remesh Band",
"description": "Controls how far remeshing can move vertices from the original surface.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4
},
"remesh_project": {
"title": "Remesh Project",
"description": "How much to project remeshed vertices back onto the original surface. 0 = smoother, 1 = preserves detail.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 1
},
"uv_unwrap_angle_threshold_deg": {
"title": "UV Angle Threshold",
"description": "Maximum angle between adjacent face normals within a single UV chart.",
"default": 90,
"type": "number",
"minimum": 0,
"maximum": 180
},
"uv_unwrap_global_iterations": {
"title": "UV Global Iterations",
"description": "Number of global clustering passes during UV chart computation.",
"default": 1,
"type": "number",
"minimum": 1,
"maximum": 10,
"multipleOf": 1
},
"uv_unwrap_refine_iterations": {
"title": "UV Refine Iterations",
"description": "Number of local refinement passes during UV chart computation.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 10,
"multipleOf": 1
},
"uv_unwrap_smooth_strength": {
"title": "UV Smooth Strength",
"description": "Smoothing strength applied to UV chart boundaries.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 10
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility.",
"type": "integer"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Apply a new texture to an existing 3D mesh using a reference image, powered by Trellis 2's texture pipeline.
Pricing: $0.10/generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringtex_slat_sampling_stepsnumbertex_slat_guidance_strengthnumbertex_slat_guidance_rescalenumbertex_slat_rescale_tnumbertex_slat_guidance_interval_startnumbertex_slat_guidance_interval_endnumberresolutionstringtexture_sizenumbermesh_urlstringseedintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Ftrellis-2%2Fretexture",
"title": "Trellis 2 Retexture generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/trellis-2/retexture.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/trellis-2/retexture",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"tex_slat_sampling_steps": {
"title": "Texture Steps",
"description": "Number of denoising steps for texture generation. More steps = slower but potentially cleaner textures.",
"default": 12,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"tex_slat_guidance_strength": {
"title": "Texture Guidance",
"description": "How closely the texture follows the input image colors.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 10
},
"tex_slat_guidance_rescale": {
"title": "Texture Guidance Rescale",
"description": "Dampens artifacts from high guidance in the texture stage.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 1
},
"tex_slat_rescale_t": {
"title": "Texture Rescale T",
"description": "Controls noise schedule sharpness for texture generation.",
"default": 3,
"type": "number",
"minimum": 1,
"maximum": 6
},
"tex_slat_guidance_interval_start": {
"title": "Texture Guidance Start",
"description": "Fraction of denoising at which guidance starts for the texture stage.",
"default": 0.6,
"type": "number",
"minimum": 0,
"maximum": 1
},
"tex_slat_guidance_interval_end": {
"title": "Texture Guidance End",
"description": "Fraction of denoising at which guidance ends for the texture stage.",
"default": 0.9,
"type": "number",
"minimum": 0,
"maximum": 1
},
"resolution": {
"title": "Resolution",
"description": "Internal resolution for texture generation. Higher produces finer details but is slower.",
"default": 1024,
"type": "string",
"enum": [
"512",
"1024"
]
},
"texture_size": {
"title": "Texture Size",
"description": "Resolution of the texture image baked onto the mesh.",
"default": 2048,
"type": "number",
"enum": [
1024,
2048,
4096
]
},
"mesh_url": {
"title": "Mesh URL",
"description": "URL of the untextured 3D mesh to retexture. Supports GLB, OBJ, PLY, and STL formats.",
"type": "string"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility.",
"type": "integer"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"mesh_url",
"reference_image_url"
],
"additionalProperties": false
}
Tripo AI animation — applies a preset motion to a Tripo-rigged model. Requires an Auto Rig version. Best results with humanoid characters (humans, robots, anime).
Pricing: $0.25/generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringoriginal_model_task_idstringanimationstringanimate_in_placeboolean
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=tripo3d%2Fanimate%2Fv1",
"title": "Tripo Animation generation request",
"description": "Request body accepted by POST /api/v1/generate for tripo3d/animate/v1.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "tripo3d/animate/v1",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"original_model_task_id": {
"title": "Rigged Model",
"description": "Pick a completed Tripo Auto Rig generation, or upload an already-rigged .glb — animation needs a rigged source model.",
"type": "string"
},
"animation": {
"title": "Animation Preset",
"description": "Motion preset to apply to the rigged character.",
"default": "preset:walk",
"type": "string",
"enum": [
"preset:idle",
"preset:walk",
"preset:run",
"preset:jump",
"preset:slash",
"preset:shoot",
"preset:climb",
"preset:dive",
"preset:hurt",
"preset:fall",
"preset:turn"
]
},
"animate_in_place": {
"title": "Animate in Place",
"description": "Keep the model stationary — no root motion translation.",
"default": false,
"type": "boolean"
}
},
"required": [
"model_id",
"original_model_task_id"
],
"additionalProperties": false
}
Export a Tripo 3D model to GLTF, FBX, OBJ, STL, USDZ, or 3MF format with optional animation baking, UV packing, and orientation control.
Pricing: $0.05/conversion.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringoriginal_model_task_idstringformatstringquadbooleanface_limitnumberbakebooleanwith_animationbooleanflatten_bottombooleantexture_sizenumberexport_orientationstringfbx_presetstringpack_uvbooleanpivot_to_center_bottomboolean
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=tripo3d%2Fconvert",
"title": "Tripo Format Convert generation request",
"description": "Request body accepted by POST /api/v1/generate for tripo3d/convert.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "tripo3d/convert",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"original_model_task_id": {
"title": "Source Model",
"description": "Pick a completed Tripo 3D generation to convert.",
"type": "string"
},
"format": {
"title": "Output Format",
"description": "Target export format.",
"default": "GLTF",
"type": "string",
"enum": [
"GLTF",
"FBX",
"OBJ",
"STL",
"USDZ",
"3MF"
]
},
"quad": {
"title": "Quad Mesh",
"description": "Convert triangular mesh to quad-dominant topology.",
"default": false,
"type": "boolean"
},
"face_limit": {
"title": "Face Limit",
"description": "Maximum polygon count. 0 = no limit.",
"default": 10000,
"type": "number",
"minimum": 500,
"maximum": 100000
},
"bake": {
"title": "Bake Textures",
"description": "Combine advanced material effects into the base textures.",
"default": true,
"type": "boolean"
},
"with_animation": {
"title": "Include Animation",
"description": "Include skeletal and animation data in the export.",
"default": true,
"type": "boolean"
},
"flatten_bottom": {
"title": "Flatten Bottom",
"description": "Flatten the underside of the model for stable placement.",
"default": false,
"type": "boolean"
},
"texture_size": {
"title": "Texture Size",
"description": "Texture resolution in pixels (128–4096).",
"default": 2048,
"type": "number",
"minimum": 128,
"maximum": 4096
},
"export_orientation": {
"title": "Export Orientation",
"description": "Forward axis orientation for the exported model.",
"default": "+x",
"type": "string",
"enum": [
"+x",
"-x",
"+y",
"-y"
]
},
"fbx_preset": {
"title": "FBX Target App",
"description": "FBX only — optimize for the target application.",
"default": "blender",
"type": "string",
"enum": [
"blender",
"3dsmax",
"mixamo"
]
},
"pack_uv": {
"title": "Pack UVs",
"description": "Pack UV islands into a single texture atlas.",
"default": false,
"type": "boolean"
},
"pivot_to_center_bottom": {
"title": "Pivot at Base",
"description": "Move the model pivot to the center bottom for easier placement.",
"default": false,
"type": "boolean"
}
},
"required": [
"model_id",
"original_model_task_id"
],
"additionalProperties": false
}
Tripo3D H3.1 — high-fidelity image-to-3D with detailed geometry, PBR materials, and quad mesh output.
Pricing: ~$0.30 base + surcharges: detailed texture +20 cr, extreme texture +30 cr, detailed geometry +20 cr, quad +5 cr, smart low poly +10 cr, generate parts +20 cr.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringtexture_qualitystringgeometry_qualitystringtexture_alignmentstringorientationstringpbrbooleantexturebooleanface_limitnumberquadbooleansmart_low_polybooleangenerate_partsbooleanauto_sizebooleanmodel_seedintegertexture_seednumberreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=tripo3d%2Fh3.1%2Fimage-to-3d",
"title": "Tripo H3.1 generation request",
"description": "Request body accepted by POST /api/v1/generate for tripo3d/h3.1/image-to-3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "tripo3d/h3.1/image-to-3d",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"texture_quality": {
"title": "Texture Quality",
"description": "detailed produces high-resolution textures; extreme is the highest tier.",
"default": "standard",
"type": "string",
"enum": [
"standard",
"detailed",
"extreme"
]
},
"geometry_quality": {
"title": "Geometry Quality",
"description": "detailed produces higher-polygon geometry.",
"default": "standard",
"type": "string",
"enum": [
"standard",
"detailed"
]
},
"texture_alignment": {
"title": "Texture Alignment",
"description": "How textures are aligned: to the input image or to the generated geometry.",
"default": "original_image",
"type": "string",
"enum": [
"original_image",
"geometry"
]
},
"orientation": {
"title": "Orientation",
"description": "Align Image auto-rotates the model to match the input image orientation.",
"default": "default",
"type": "string",
"enum": [
"default",
"align_image"
]
},
"pbr": {
"title": "PBR",
"description": "Generate physically-based rendering materials.",
"default": true,
"type": "boolean"
},
"texture": {
"title": "Texture",
"description": "Generate textures for the model. Disabling saves credits.",
"default": true,
"type": "boolean"
},
"face_limit": {
"title": "Face Limit",
"description": "Target polygon count. Leave unset for adaptive.",
"type": "number",
"minimum": 1000,
"maximum": 2000000,
"multipleOf": 1
},
"quad": {
"title": "Quad Mesh",
"description": "Output quad topology instead of triangles (+5 cr). Returns FBX.",
"default": false,
"type": "boolean"
},
"smart_low_poly": {
"title": "Smart Low Poly",
"description": "Generate hand-crafted low-poly topology (+10 cr).",
"default": false,
"type": "boolean"
},
"generate_parts": {
"title": "Generate Parts",
"description": "Create segmented, editable model parts (+20 cr). Requires Texture, PBR, and Quad Mesh to be off.",
"default": false,
"type": "boolean"
},
"auto_size": {
"title": "Auto Size",
"description": "Scale model to real-world dimensions (meters).",
"default": false,
"type": "boolean"
},
"model_seed": {
"title": "Seed",
"description": "Seed for geometry reproducibility.",
"type": "integer"
},
"texture_seed": {
"title": "Texture Seed",
"description": "Seed for texture generation reproducibility.",
"type": "number",
"multipleOf": 1
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Tripo3D H3.1 multiview — build a 3D model from 2–4 angles (front, left, back, right) for dramatically improved accuracy.
Pricing: ~$0.30 per generation (+extras for detailed quality/quad)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringtexture_qualitystringgeometry_qualitystringtexture_alignmentstringorientationstringpbrbooleantexturebooleanface_limitnumberquadbooleansmart_low_polybooleangenerate_partsbooleanauto_sizebooleanmodel_seedintegertexture_seednumberreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=tripo3d%2Fh3.1%2Fmultiview-to-3d",
"title": "Tripo H3.1 Multiview generation request",
"description": "Request body accepted by POST /api/v1/generate for tripo3d/h3.1/multiview-to-3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "tripo3d/h3.1/multiview-to-3d",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"texture_quality": {
"title": "Texture Quality",
"description": "detailed produces high-resolution textures; extreme is the highest tier.",
"default": "standard",
"type": "string",
"enum": [
"standard",
"detailed",
"extreme"
]
},
"geometry_quality": {
"title": "Geometry Quality",
"description": "detailed produces higher-polygon geometry.",
"default": "standard",
"type": "string",
"enum": [
"standard",
"detailed"
]
},
"texture_alignment": {
"title": "Texture Alignment",
"description": "How textures are aligned: to the input image or to the generated geometry.",
"default": "original_image",
"type": "string",
"enum": [
"original_image",
"geometry"
]
},
"orientation": {
"title": "Orientation",
"description": "Align Image auto-rotates the model to match the input image orientation.",
"default": "default",
"type": "string",
"enum": [
"default",
"align_image"
]
},
"pbr": {
"title": "PBR",
"description": "Generate physically-based rendering materials.",
"default": true,
"type": "boolean"
},
"texture": {
"title": "Texture",
"description": "Generate textures for the model. Disabling saves credits.",
"default": true,
"type": "boolean"
},
"face_limit": {
"title": "Face Limit",
"description": "Target polygon count. Leave unset for adaptive.",
"type": "number",
"minimum": 1000,
"maximum": 2000000,
"multipleOf": 1
},
"quad": {
"title": "Quad Mesh",
"description": "Output quad topology instead of triangles (+5 cr). Returns FBX.",
"default": false,
"type": "boolean"
},
"smart_low_poly": {
"title": "Smart Low Poly",
"description": "Generate hand-crafted low-poly topology (+10 cr).",
"default": false,
"type": "boolean"
},
"generate_parts": {
"title": "Generate Parts",
"description": "Create segmented, editable model parts (+20 cr). Requires Texture, PBR, and Quad Mesh to be off.",
"default": false,
"type": "boolean"
},
"auto_size": {
"title": "Auto Size",
"description": "Scale model to real-world dimensions (meters).",
"default": false,
"type": "boolean"
},
"model_seed": {
"title": "Seed",
"description": "Seed for geometry reproducibility.",
"type": "integer"
},
"texture_seed": {
"title": "Texture Seed",
"description": "Seed for texture generation reproducibility.",
"type": "number",
"multipleOf": 1
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 2,
"maxItems": 4
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Tripo3D H3.1 text-to-3D — generate a full 3D model directly from a text prompt with PBR materials and detailed geometry.
Pricing: ~$0.30 per generation (+extras for detailed quality/quad)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringtexture_qualitystringgeometry_qualitystringpbrbooleantexturebooleannegative_promptstringface_limitnumberquadbooleansmart_low_polybooleangenerate_partsbooleanauto_sizebooleanmodel_seedintegertexture_seednumberimage_seednumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=tripo3d%2Fh3.1%2Ftext-to-3d",
"title": "Tripo H3.1 Text generation request",
"description": "Request body accepted by POST /api/v1/generate for tripo3d/h3.1/text-to-3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "tripo3d/h3.1/text-to-3d",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"texture_quality": {
"title": "Texture Quality",
"description": "detailed produces high-resolution textures; extreme is the highest tier.",
"default": "standard",
"type": "string",
"enum": [
"standard",
"detailed",
"extreme"
]
},
"geometry_quality": {
"title": "Geometry Quality",
"description": "detailed produces higher-polygon geometry.",
"default": "standard",
"type": "string",
"enum": [
"standard",
"detailed"
]
},
"pbr": {
"title": "PBR",
"description": "Generate physically-based rendering materials.",
"default": true,
"type": "boolean"
},
"texture": {
"title": "Texture",
"description": "Generate textures for the model. Disabling saves credits.",
"default": true,
"type": "boolean"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Describe what you do not want in the model.",
"type": "string"
},
"face_limit": {
"title": "Face Limit",
"description": "Target polygon count. Leave unset for adaptive.",
"type": "number",
"minimum": 1000,
"maximum": 2000000,
"multipleOf": 1
},
"quad": {
"title": "Quad Mesh",
"description": "Output quad topology instead of triangles (+5 cr). Returns FBX.",
"default": false,
"type": "boolean"
},
"smart_low_poly": {
"title": "Smart Low Poly",
"description": "Generate hand-crafted low-poly topology (+10 cr).",
"default": false,
"type": "boolean"
},
"generate_parts": {
"title": "Generate Parts",
"description": "Create segmented, editable model parts (+20 cr). Requires Texture, PBR, and Quad Mesh to be off.",
"default": false,
"type": "boolean"
},
"auto_size": {
"title": "Auto Size",
"description": "Scale model to real-world dimensions (meters).",
"default": false,
"type": "boolean"
},
"model_seed": {
"title": "Seed",
"description": "Seed for geometry reproducibility.",
"type": "integer"
},
"texture_seed": {
"title": "Texture Seed",
"description": "Seed for texture generation reproducibility.",
"type": "number",
"multipleOf": 1
},
"image_seed": {
"title": "Image Seed",
"description": "Seed for the internal text-to-image step.",
"type": "number",
"multipleOf": 1
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Fill and complete mesh parts from a segmented Tripo model. Run Mesh Segmentation first, then use this to complete all parts or target specific ones by name.
Pricing: $0.25/generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringoriginal_model_task_idstringpart_namesstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=tripo3d%2Fmesh-completion%2Fv1",
"title": "Tripo Mesh Completion generation request",
"description": "Request body accepted by POST /api/v1/generate for tripo3d/mesh-completion/v1.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "tripo3d/mesh-completion/v1",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"original_model_task_id": {
"title": "Source Segmentation",
"description": "Auto-filled from the most recent Mesh Segmentation version.",
"type": "string"
},
"part_names": {
"title": "Part Names",
"description": "Comma-separated list of part names to complete (e.g. body,head). Leave empty to complete all parts.",
"type": "string"
}
},
"required": [
"model_id",
"original_model_task_id"
],
"additionalProperties": false
}
Separate a Tripo 3D model into named parts based on shape and type. Parts are named by component (body, head, limbs, etc.) and can be used as input for Mesh Completion or selective low-poly conversion.
Pricing: $0.20/generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringoriginal_model_task_idstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=tripo3d%2Fmesh-segmentation%2Fv1",
"title": "Tripo Mesh Segmentation generation request",
"description": "Request body accepted by POST /api/v1/generate for tripo3d/mesh-segmentation/v1.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "tripo3d/mesh-segmentation/v1",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"original_model_task_id": {
"title": "Source Model",
"description": "Pick a completed Tripo 3D generation to segment.",
"type": "string"
}
},
"required": [
"model_id",
"original_model_task_id"
],
"additionalProperties": false
}
Tripo P1 multiview — flagship multi-angle 3D reconstruction with best-in-class geometry accuracy. Provide 2–4 reference images from different angles for maximum fidelity and clean topology.
Pricing: $0.40 without textures · $0.50 with textures. +$0.20 detailed / +$0.30 extreme texture.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringtexturebooleanpbrbooleantexture_qualitystringtexture_alignmentstringorientationstringauto_sizebooleanface_limitnumbermodel_seednumbertexture_seednumberaspect_ratiostringresolutionstringreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=tripo3d%2Fp1%2Fmultiview-to-3d",
"title": "Tripo P1 Multiview → 3D generation request",
"description": "Request body accepted by POST /api/v1/generate for tripo3d/p1/multiview-to-3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "tripo3d/p1/multiview-to-3d",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"texture": {
"title": "Texture",
"description": "Whether to generate textures for the model.",
"default": true,
"type": "boolean"
},
"pbr": {
"title": "PBR Maps",
"description": "Generate PBR materials. When enabled, texture is treated as enabled.",
"default": true,
"type": "boolean"
},
"texture_quality": {
"title": "Texture Quality",
"description": "Texture resolution tier.",
"default": "standard",
"type": "string",
"enum": [
"standard",
"detailed",
"extreme"
]
},
"texture_alignment": {
"title": "Texture Alignment",
"description": "How textures are aligned to the model.",
"default": "original_image",
"type": "string",
"enum": [
"original_image",
"geometry"
]
},
"orientation": {
"title": "Orientation",
"description": "Auto-rotate the mesh to match the input images.",
"default": "default",
"type": "string",
"enum": [
"default",
"align_image"
]
},
"auto_size": {
"title": "Auto Size",
"description": "Automatically scale the model to real-world dimensions (meters).",
"default": false,
"type": "boolean"
},
"face_limit": {
"title": "Face Limit",
"description": "Target number of faces (48–20,000 for P1). Leave unset for adaptive.",
"type": "number",
"minimum": 48,
"maximum": 20000,
"multipleOf": 1
},
"model_seed": {
"title": "Model Seed",
"description": "Seed for geometry generation reproducibility.",
"type": "number",
"multipleOf": 1
},
"texture_seed": {
"title": "Texture Seed",
"description": "Seed for texture generation reproducibility.",
"type": "number",
"multipleOf": 1
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 4
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Tripo Retopology (Smart Low Poly) — convert a high-polygon Tripo model into a clean, game-ready low-poly mesh with hand-crafted topology. Optional quad output for DCC workflows.
Pricing: $0.30/generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringoriginal_model_task_idstringface_limitnumberquadbooleanbakebooleanpart_namesstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=tripo3d%2Fretopology",
"title": "Tripo Retopology generation request",
"description": "Request body accepted by POST /api/v1/generate for tripo3d/retopology.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "tripo3d/retopology",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"original_model_task_id": {
"title": "Source Model",
"description": "Pick a completed Tripo 3D generation to retopologize, or upload a .glb file.",
"type": "string"
},
"face_limit": {
"title": "Face Limit",
"description": "Target polygon count (500–20 000). When Quad Mesh is on, max is 10 000.",
"default": 4000,
"type": "number",
"minimum": 500,
"maximum": 20000,
"multipleOf": 1
},
"quad": {
"title": "Quad Mesh",
"description": "Output quad topology instead of triangles. Useful for DCC tools like Blender and Maya.",
"default": false,
"type": "boolean"
},
"bake": {
"title": "Bake Textures",
"description": "Bake textures from the original high-poly model onto the new low-poly mesh.",
"default": true,
"type": "boolean"
},
"part_names": {
"title": "Part Names",
"description": "Comma-separated part names from a Mesh Segmentation result (e.g. body,head). Leave empty to process the whole mesh.",
"type": "string"
}
},
"required": [
"model_id",
"original_model_task_id"
],
"additionalProperties": false
}
Tripo Rigging v2.5 — rig any Tripo 3D model including non-biped creatures (quadrupeds, animals, fantasy beings). Adds support for non-humanoid skeletons over v1.
Pricing: $0.25/generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringoriginal_model_task_idstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=tripo3d%2Frig%2Fv2.5",
"title": "Tripo Rigging v2.5 generation request",
"description": "Request body accepted by POST /api/v1/generate for tripo3d/rig/v2.5.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "tripo3d/rig/v2.5",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"original_model_task_id": {
"title": "Source Model",
"description": "Pick a completed Tripo 3D generation to rig.",
"type": "string"
}
},
"required": [
"model_id",
"original_model_task_id"
],
"additionalProperties": false
}
Tripo Stylization — transform any Tripo 3D model into LEGO, voxel, Voronoi, or Minecraft style. Requires a Tripo task ID from a completed generation job.
Pricing: $0.20/generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringoriginal_model_task_idstringstylestringblock_sizenumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=tripo3d%2Fstylize",
"title": "Tripo Stylization generation request",
"description": "Request body accepted by POST /api/v1/generate for tripo3d/stylize.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "tripo3d/stylize",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"original_model_task_id": {
"title": "Source Model",
"description": "Pick a completed Tripo 3D generation to stylize.",
"type": "string"
},
"style": {
"title": "Style",
"description": "Artistic style to apply to the model.",
"default": "lego",
"type": "string",
"enum": [
"lego",
"voxel",
"voronoi",
"minecraft"
]
},
"block_size": {
"title": "Block Size",
"description": "Size of the style blocks (LEGO bricks, voxels, etc.). Smaller = finer detail, larger = chunkier.",
"default": 80,
"type": "number",
"minimum": 10,
"maximum": 200,
"multipleOf": 1
}
},
"required": [
"model_id",
"original_model_task_id"
],
"additionalProperties": false
}
Tripo Texturing — apply new textures to an existing untextured (or white-mesh) 3D model using a text style prompt or reference image. Requires a Tripo task ID from a completed generation job.
Pricing: $0.20 standard · $0.40 detailed · $0.50 extreme texture.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringoriginal_model_task_idstringtexture_qualitystringpbrbooleantexture_alignmentstringimage_promptstringtexture_seednumbermodel_seednumberbakebooleanpart_namesstringmodel_versionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=tripo3d%2Ftexture",
"title": "Tripo Texturing generation request",
"description": "Request body accepted by POST /api/v1/generate for tripo3d/texture.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "tripo3d/texture",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"original_model_task_id": {
"title": "Source Model",
"description": "Pick a completed Tripo 3D generation to texture.",
"type": "string"
},
"texture_quality": {
"title": "Texture Quality",
"description": "Texture resolution tier.",
"default": "standard",
"type": "string",
"enum": [
"standard",
"detailed",
"extreme"
]
},
"pbr": {
"title": "PBR Maps",
"description": "Generate PBR (metallic/roughness/normal) maps in addition to base color.",
"default": true,
"type": "boolean"
},
"texture_alignment": {
"title": "Texture Alignment",
"description": "How textures are aligned to the mesh.",
"default": "original_image",
"type": "string",
"enum": [
"original_image",
"geometry"
]
},
"image_prompt": {
"title": "Style Image",
"description": "URL of a reference image to guide the texture style. Used alongside or instead of the text prompt.",
"type": "string"
},
"texture_seed": {
"title": "Texture Seed",
"description": "Seed for texture reproducibility.",
"type": "number",
"multipleOf": 1
},
"model_seed": {
"title": "Model Seed",
"description": "Seed for model reproducibility.",
"type": "number",
"multipleOf": 1
},
"bake": {
"title": "Bake Textures",
"description": "Combine advanced material effects into the base textures.",
"default": true,
"type": "boolean"
},
"part_names": {
"title": "Part Names",
"description": "Comma-separated part names from a Mesh Segmentation result. Leave empty to texture the whole mesh.",
"type": "string"
},
"model_version": {
"title": "Model Version",
"description": "v3.0 required for Detailed and Extreme texture quality.",
"default": "v2.5-20250123",
"type": "string",
"enum": [
"v2.5-20250123",
"v3.0-20250812"
]
}
},
"required": [
"model_id",
"prompt",
"original_model_task_id"
],
"additionalProperties": false
}
Tripo v3.0 — sculpture-level geometry with sharp edges and fine surface detail from a single image. Supports HD texturing, PBR maps, quad mesh, and smart low-poly output.
Pricing: $0.20 no tex · $0.30 standard · $0.50 detailed · $0.60 extreme. +$0.05 quad.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringtexturebooleantexture_qualitystringpbrbooleanorientationstringtexture_alignmentstringauto_sizebooleanquadbooleansmart_low_polybooleangenerate_partsbooleanface_limitnumbermodel_seedintegertexture_seednumberaspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=tripo3d%2Ftripo%2Fv3.0%2Fimage-to-3d",
"title": "Tripo v3.0 Image → 3D generation request",
"description": "Request body accepted by POST /api/v1/generate for tripo3d/tripo/v3.0/image-to-3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "tripo3d/tripo/v3.0/image-to-3d",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"texture": {
"title": "Texture",
"description": "Generate textures for the model. Disable to get a base mesh without textures.",
"default": true,
"type": "boolean"
},
"texture_quality": {
"title": "Texture Quality",
"description": "Texture resolution tier. Detailed and Extreme produce higher-resolution textures at extra cost.",
"default": "standard",
"type": "string",
"enum": [
"standard",
"detailed",
"extreme"
]
},
"pbr": {
"title": "PBR Maps",
"description": "Generate PBR (metallic/roughness) materials. When enabled, texture is treated as enabled.",
"default": true,
"type": "boolean"
},
"orientation": {
"title": "Orientation",
"description": "Auto-rotate the mesh to match the viewing angle of the input image. Only takes effect when texture is enabled.",
"default": "default",
"type": "string",
"enum": [
"default",
"align_image"
]
},
"texture_alignment": {
"title": "Texture Alignment",
"description": "How textures are aligned to the model.",
"default": "original_image",
"type": "string",
"enum": [
"original_image",
"geometry"
]
},
"auto_size": {
"title": "Auto Size",
"description": "Automatically scale the model to real-world dimensions (meters).",
"default": false,
"type": "boolean"
},
"quad": {
"title": "Quad Mesh",
"description": "Output quad topology instead of triangles. Forces FBX output.",
"default": false,
"type": "boolean"
},
"smart_low_poly": {
"title": "Smart Low Poly",
"description": "Generate low-poly meshes with hand-crafted topology.",
"default": false,
"type": "boolean"
},
"generate_parts": {
"title": "Generate Parts",
"description": "Generate segmented, editable model parts. Requires texture, PBR, and quad to be off.",
"default": false,
"type": "boolean"
},
"face_limit": {
"title": "Face Limit",
"description": "Target polygon count. Leave unset for adaptive.",
"type": "number",
"minimum": 1000,
"maximum": 500000,
"multipleOf": 1
},
"model_seed": {
"title": "Seed",
"description": "Seed for geometry reproducibility.",
"type": "integer"
},
"texture_seed": {
"title": "Texture Seed",
"description": "Seed for texture reproducibility.",
"type": "number",
"multipleOf": 1
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Tripo v3.0 multiview — sculpture-level geometry from 2–4 images of the same object from different angles. Dramatically reduces ambiguity artifacts vs single-image input.
Pricing: $0.20 no tex · $0.30 standard · $0.50 detailed · $0.60 extreme. +$0.05 quad.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringtexturebooleantexture_qualitystringpbrbooleantexture_alignmentstringorientationstringauto_sizebooleanquadbooleansmart_low_polybooleangenerate_partsbooleanface_limitnumbermodel_seedintegertexture_seednumberaspect_ratiostringresolutionstringreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=tripo3d%2Ftripo%2Fv3.0%2Fmultiview-to-3d",
"title": "Tripo v3.0 Multiview → 3D generation request",
"description": "Request body accepted by POST /api/v1/generate for tripo3d/tripo/v3.0/multiview-to-3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "tripo3d/tripo/v3.0/multiview-to-3d",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"texture": {
"title": "Texture",
"description": "Generate textures for the model.",
"default": true,
"type": "boolean"
},
"texture_quality": {
"title": "Texture Quality",
"description": "Texture resolution tier.",
"default": "standard",
"type": "string",
"enum": [
"standard",
"detailed",
"extreme"
]
},
"pbr": {
"title": "PBR Maps",
"description": "Generate PBR (metallic/roughness) materials.",
"default": true,
"type": "boolean"
},
"texture_alignment": {
"title": "Texture Alignment",
"description": "How textures are aligned to the model.",
"default": "original_image",
"type": "string",
"enum": [
"original_image",
"geometry"
]
},
"orientation": {
"title": "Orientation",
"description": "Auto-rotate the mesh to match the input images.",
"default": "default",
"type": "string",
"enum": [
"default",
"align_image"
]
},
"auto_size": {
"title": "Auto Size",
"description": "Automatically scale the model to real-world dimensions (meters).",
"default": false,
"type": "boolean"
},
"quad": {
"title": "Quad Mesh",
"description": "Output quad topology instead of triangles. Forces FBX output.",
"default": false,
"type": "boolean"
},
"smart_low_poly": {
"title": "Smart Low Poly",
"description": "Generate low-poly meshes with hand-crafted topology.",
"default": false,
"type": "boolean"
},
"generate_parts": {
"title": "Generate Parts",
"description": "Generate segmented, editable model parts. Requires texture, PBR, and quad to be off.",
"default": false,
"type": "boolean"
},
"face_limit": {
"title": "Face Limit",
"description": "Target polygon count. Leave unset for adaptive.",
"type": "number",
"minimum": 1000,
"maximum": 500000,
"multipleOf": 1
},
"model_seed": {
"title": "Seed",
"description": "Seed for geometry reproducibility.",
"type": "integer"
},
"texture_seed": {
"title": "Texture Seed",
"description": "Seed for texture reproducibility.",
"type": "number",
"multipleOf": 1
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 4
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Tripo3D P1 — flagship image-to-3D model with the highest quality output, texture generation, and fine control over polygon density.
Pricing: $0.40 without textures · $0.50 with textures. +$0.20 detailed / +$0.30 extreme texture.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringtexturebooleanpbrbooleantexture_qualitystringtexture_alignmentstringorientationstringauto_sizebooleanface_limitnumbermodel_seednumbertexture_seednumberaspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=tripo3d%2Fp1%2Fimage-to-3d",
"title": "Tripo3D P1 Image → 3D generation request",
"description": "Request body accepted by POST /api/v1/generate for tripo3d/p1/image-to-3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "tripo3d/p1/image-to-3d",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"texture": {
"title": "Texture",
"description": "Whether to generate textures for the model.",
"default": true,
"type": "boolean"
},
"pbr": {
"title": "PBR Maps",
"description": "Generate PBR materials. When enabled, texture is treated as enabled.",
"default": true,
"type": "boolean"
},
"texture_quality": {
"title": "Texture Quality",
"description": "Texture resolution tier. Detailed and Extreme produce higher-resolution textures at extra cost.",
"default": "standard",
"type": "string",
"enum": [
"standard",
"detailed",
"extreme"
]
},
"texture_alignment": {
"title": "Texture Alignment",
"description": "Determines the prioritization of texture alignment in the 3D model.",
"default": "original_image",
"type": "string",
"enum": [
"original_image",
"geometry"
]
},
"orientation": {
"title": "Orientation",
"description": "Auto-rotate the mesh to match the input image. Only takes effect when texture is enabled.",
"default": "default",
"type": "string",
"enum": [
"default",
"align_image"
]
},
"auto_size": {
"title": "Auto Size",
"description": "Automatically scale the model to real-world dimensions (meters).",
"default": false,
"type": "boolean"
},
"face_limit": {
"title": "Face Limit",
"description": "Target number of faces for the generated mesh (48-20,000 for P1). If not set, the model adaptively determines the count.",
"type": "number",
"minimum": 48,
"maximum": 20000,
"multipleOf": 1
},
"model_seed": {
"title": "Model Seed",
"description": "Seed for geometry generation reproducibility.",
"type": "number",
"multipleOf": 1
},
"texture_seed": {
"title": "Texture Seed",
"description": "Seed for texture generation reproducibility.",
"type": "number",
"multipleOf": 1
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Tripo3D v2.5 — professional image-to-3D with HD texturing, PBR maps, quad mesh, and style transfer options.
Pricing: $0.20 no tex · $0.30 standard · $0.50 detailed · $0.60 extreme texture. +$0.05 quad.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringtexturebooleantexture_qualitystringpbrbooleanorientationstringtexture_alignmentstringauto_sizebooleanquadbooleansmart_low_polybooleangenerate_partsbooleantexture_seednumberface_limitnumbermodel_seedintegeraspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=tripo3d%2Ftripo%2Fv2.5%2Fimage-to-3d",
"title": "Tripo3D v2.5 Image → 3D generation request",
"description": "Request body accepted by POST /api/v1/generate for tripo3d/tripo/v2.5/image-to-3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "tripo3d/tripo/v2.5/image-to-3d",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"texture": {
"title": "Texture",
"description": "Generate textures for the model. Disable to get a base model without any textures.",
"default": true,
"type": "boolean"
},
"texture_quality": {
"title": "Texture Quality",
"description": "Texture resolution tier. Detailed and Extreme produce higher-resolution textures at extra cost.",
"default": "standard",
"type": "string",
"enum": [
"standard",
"detailed",
"extreme"
]
},
"pbr": {
"title": "PBR Maps",
"description": "Generate PBR (metallic/roughness) materials. When enabled, texture is treated as enabled.",
"default": true,
"type": "boolean"
},
"orientation": {
"title": "Orientation",
"description": "Auto-rotate the mesh to match the viewing angle of the input image. Only takes effect when texture is enabled.",
"default": "default",
"type": "string",
"enum": [
"default",
"align_image"
]
},
"texture_alignment": {
"title": "Texture Alignment",
"description": "Determines the prioritization of texture alignment in the 3D model.",
"default": "original_image",
"type": "string",
"enum": [
"original_image",
"geometry"
]
},
"auto_size": {
"title": "Auto Size",
"description": "Automatically scale the model to real-world dimensions (meters).",
"default": false,
"type": "boolean"
},
"quad": {
"title": "Quad Mesh",
"description": "Enable quad mesh output. Forces FBX output. If face_limit is not set, defaults to 10000.",
"default": false,
"type": "boolean"
},
"smart_low_poly": {
"title": "Smart Low Poly",
"description": "Generate low-poly meshes with hand-crafted topology. Works best on simple inputs; face_limit should be 1000-20000.",
"default": false,
"type": "boolean"
},
"generate_parts": {
"title": "Generate Parts",
"description": "Generate segmented, editable model parts. Requires texture, PBR, and quad to be disabled.",
"default": false,
"type": "boolean"
},
"texture_seed": {
"title": "Texture Seed",
"description": "Random seed for texture generation. Using the same seed produces identical textures.",
"type": "number",
"multipleOf": 1
},
"face_limit": {
"title": "Face Limit",
"description": "Limits the number of faces on the output model (max 500,000 for v2.5). If not set, adaptively determined.",
"type": "number",
"minimum": 1,
"maximum": 500000,
"multipleOf": 1
},
"model_seed": {
"title": "Seed",
"description": "Random seed for model geometry generation.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Tripo3D v2.5 multiview-to-3D — upload front, back, left, and right reference views for the most accurate 3D reconstruction with PBR and HD textures.
Pricing: $0.20 no tex · $0.30 standard · $0.50 detailed · $0.60 extreme texture. +$0.05 quad.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringtexturebooleantexture_qualitystringpbrbooleantexture_alignmentstringauto_sizebooleanquadbooleansmart_low_polybooleangenerate_partsbooleanface_limitnumbertexture_seednumbermodel_seedintegerorientationstringaspect_ratiostringresolutionstringreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=tripo3d%2Ftripo%2Fv2.5%2Fmultiview-to-3d",
"title": "Tripo3D v2.5 Multiview → 3D generation request",
"description": "Request body accepted by POST /api/v1/generate for tripo3d/tripo/v2.5/multiview-to-3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "tripo3d/tripo/v2.5/multiview-to-3d",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"texture": {
"title": "Texture",
"description": "Generate textures for the model. Disable to get a base model without any textures.",
"default": true,
"type": "boolean"
},
"texture_quality": {
"title": "Texture Quality",
"description": "Texture resolution tier. Detailed and Extreme produce higher-resolution textures at extra cost.",
"default": "standard",
"type": "string",
"enum": [
"standard",
"detailed",
"extreme"
]
},
"pbr": {
"title": "PBR Maps",
"description": "Generate PBR (metallic/roughness) materials. When enabled, texture is treated as enabled.",
"default": true,
"type": "boolean"
},
"texture_alignment": {
"title": "Texture Alignment",
"description": "Determines the prioritization of texture alignment in the 3D model.",
"default": "original_image",
"type": "string",
"enum": [
"original_image",
"geometry"
]
},
"auto_size": {
"title": "Auto Size",
"description": "Automatically scale the model to real-world dimensions (meters).",
"default": false,
"type": "boolean"
},
"quad": {
"title": "Quad Mesh",
"description": "Enable quad mesh output. Forces FBX output. If face_limit is not set, defaults to 10000.",
"default": false,
"type": "boolean"
},
"smart_low_poly": {
"title": "Smart Low Poly",
"description": "Generate low-poly meshes with hand-crafted topology. Works best on simple inputs; face_limit should be 1000-20000.",
"default": false,
"type": "boolean"
},
"generate_parts": {
"title": "Generate Parts",
"description": "Generate segmented, editable model parts. Requires texture, PBR, and quad to be disabled.",
"default": false,
"type": "boolean"
},
"face_limit": {
"title": "Face Limit",
"description": "Limits the number of faces on the output model (max 500,000 for v2.5). If not set, adaptively determined.",
"type": "number",
"minimum": 1,
"maximum": 500000,
"multipleOf": 1
},
"texture_seed": {
"title": "Texture Seed",
"description": "Random seed for texture generation.",
"type": "number",
"multipleOf": 1
},
"model_seed": {
"title": "Seed",
"description": "Random seed for model geometry generation.",
"type": "integer"
},
"orientation": {
"title": "Orientation",
"description": "Auto-rotate the mesh to match the viewing angle of the input images. Only takes effect when texture is enabled.",
"default": "default",
"type": "string",
"enum": [
"default",
"align_image"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 2,
"maxItems": 4
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Fast and lightweight image-to-3D reconstruction from a single photo.
Pricing: $0.07 flat per generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringoutput_formatstringforeground_rationumbermc_resolutionnumberdo_remove_backgroundbooleanreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Ftriposr",
"title": "TripoSR generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/triposr.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/triposr",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"output_format": {
"title": "Output Format",
"description": "Output format for the 3D model.",
"default": "glb",
"type": "string",
"enum": [
"glb",
"obj"
]
},
"foreground_ratio": {
"title": "Foreground Ratio",
"description": "Ratio of the image occupied by the foreground object. Higher values zoom in on the subject.",
"default": 0.9,
"type": "number",
"minimum": 0.5,
"maximum": 1
},
"mc_resolution": {
"title": "MC Resolution",
"description": "Resolution of the marching cubes. Above 512 is not recommended.",
"default": 256,
"type": "number",
"minimum": 32,
"maximum": 1024,
"multipleOf": 1
},
"do_remove_background": {
"title": "Remove Background",
"description": "Whether to remove the background from the input image.",
"default": true,
"type": "boolean"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Generate professional-quality 44.1 kHz stereo music from a text prompt using CassetteAI — a 30-second sample in under 2 seconds.
Pricing: ~$0.02 / min
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=cassetteai%2Fmusic-generator",
"title": "CassetteAI Music Generator generation request",
"description": "Request body accepted by POST /api/v1/generate for cassetteai/music-generator.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "cassetteai/music-generator",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"duration": {
"title": "Duration (s)",
"description": "Duration of the generated music in seconds (10–180).",
"default": 30,
"type": "number",
"minimum": 10,
"maximum": 180,
"multipleOf": 1
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Cohere's transcription model with multi-language support and punctuation control.
Pricing: ~1 cr per 30s audio
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringlanguagestringpunctuationbooleanmax_new_tokensnumberaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fcohere-transcribe",
"title": "Cohere Transcribe generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/cohere-transcribe.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/cohere-transcribe",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"language": {
"title": "Language",
"description": "Language of the audio (ISO 639-1 code).",
"default": "en",
"type": "string",
"enum": [
"en",
"fr",
"de",
"it",
"es",
"pt",
"el",
"nl",
"pl",
"zh",
"ja",
"ko",
"vi",
"ar"
]
},
"punctuation": {
"title": "Punctuation",
"description": "Include punctuation and capitalization in the transcript.",
"default": true,
"type": "boolean"
},
"max_new_tokens": {
"title": "Max Tokens",
"description": "Maximum tokens to generate per audio chunk.",
"default": 256,
"type": "number",
"minimum": 1,
"maximum": 1014,
"multipleOf": 64
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"audio_url"
],
"additionalProperties": false
}
Separate vocals from background noise and music in any audio file using ElevenLabs' audio isolation model.
Pricing: ~$0.12 / min (30 s default)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=elevenlabs%2Faudio-isolation",
"title": "ElevenLabs Audio Isolation generation request",
"description": "Request body accepted by POST /api/v1/generate for elevenlabs/audio-isolation.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "elevenlabs/audio-isolation",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"audio_url"
],
"additionalProperties": false
}
Dub any video or audio into another language while preserving the original speaker voices using ElevenLabs.
Pricing: $0.33 / min (ElevenLabs direct)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringtarget_langstringsource_langstringhighest_resolutionbooleannum_speakersnumbervideo_urlstringaudio_urlstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Felevenlabs%2Fdubbing",
"title": "ElevenLabs Dubbing generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/elevenlabs/dubbing.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/elevenlabs/dubbing",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"target_lang": {
"title": "Target Language",
"description": "Language to dub into (29 supported).",
"type": "string",
"enum": [
"es",
"en",
"fr",
"de",
"pt",
"it",
"hi",
"zh",
"ja",
"ko",
"ar",
"ru",
"id",
"nl",
"tr",
"pl",
"sv",
"fil",
"ms",
"ro",
"uk",
"el",
"cs",
"da",
"fi",
"bg",
"hr",
"sk",
"ta"
]
},
"source_lang": {
"title": "Source Language",
"description": "Language of the source audio. Auto-detect works well for most clips.",
"default": "",
"type": "string",
"enum": [
"",
"en",
"es",
"fr",
"de",
"pt",
"it",
"hi",
"zh",
"ja",
"ko",
"ar",
"ru",
"id",
"nl",
"tr",
"pl",
"sv",
"fil",
"ms",
"ro",
"uk",
"el",
"cs",
"da",
"fi",
"bg",
"hr",
"sk",
"ta"
]
},
"highest_resolution": {
"title": "Highest Resolution",
"description": "Use the highest available resolution for the dubbed video output.",
"default": false,
"type": "boolean"
},
"num_speakers": {
"title": "Num Speakers",
"description": "Number of speakers in the audio. Auto-detected if not set.",
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"video_url": {
"type": "string",
"format": "uri"
},
"audio_url": {
"type": "string",
"format": "uri"
},
"duration": {
"type": "number",
"minimum": 1,
"maximum": 600,
"default": 60,
"description": "Estimate-only fallback when no media is supplied. Generation measures source bytes before reserving credits; client duration cannot lower the bill."
}
},
"required": [
"model_id",
"target_lang"
],
"anyOf": [
{
"required": [
"audio_url"
]
},
{
"required": [
"video_url"
]
}
],
"additionalProperties": false
}
Translate recorded audio or video while preserving the speaker's emotion, timing and voice with Dubbing v2. Returns dubbed audio. Supports 90+ languages; ArtEmotion accepts clips up to 10 minutes. Film, TV and comparable commercial entertainment uses require separate ElevenLabs authorization.
Pricing: $2.20 / source minute per target language. One language per ArtEmotion job; no watermark discount.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringtarget_languagestringsource_languagestringkeytermsarrayvideo_urlstringaudio_urlstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=elevenlabs%2Fdubbing%2Fv2",
"title": "ElevenLabs Dubbing v2 generation request",
"description": "Request body accepted by POST /api/v1/generate for elevenlabs/dubbing/v2.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "elevenlabs/dubbing/v2",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"target_language": {
"title": "Target language",
"description": "Supported BCP-47 language or dialect, such as es, en, fr-CA, or pt-BR. See the official supported-language list.",
"default": "es",
"type": "string"
},
"source_language": {
"title": "Source language",
"description": "Optional language code. Leave empty to detect automatically.",
"default": "",
"type": "string"
},
"keyterms": {
"title": "Keyterms",
"description": "Vocabulary hints; each term is at most 5 words. Adds a surcharge to transcription, included by /api/v1/estimate.",
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"maxItems": 1000
},
"video_url": {
"type": "string",
"format": "uri"
},
"audio_url": {
"type": "string",
"format": "uri"
},
"duration": {
"type": "number",
"minimum": 1,
"maximum": 600,
"default": 60,
"description": "Estimate-only fallback when no media is supplied. Generation measures source bytes before reserving credits; client duration cannot lower the bill."
}
},
"required": [
"model_id"
],
"anyOf": [
{
"required": [
"audio_url"
]
},
{
"required": [
"video_url"
]
}
],
"additionalProperties": false
}
ElevenLabs' most expressive TTS model with superior naturalness, emotion, and voice stability.
Pricing: ~$0.10 / 1k chars
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvoicestring / stringlanguage_codestringstabilitynumberuse_speaker_boostbooleanapply_text_normalizationstringseedinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=elevenlabs%2Ftts%2Feleven-v3",
"title": "ElevenLabs Eleven v3 generation request",
"description": "Request body accepted by POST /api/v1/generate for elevenlabs/tts/eleven-v3.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "elevenlabs/tts/eleven-v3",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"voice": {
"title": "Voice",
"default": "Rachel",
"description": "A listed premade voice or clone:<voice_id> owned by your account. Clone ownership is checked before submission.",
"anyOf": [
{
"title": "Voice",
"description": "Pre-made ElevenLabs voice.",
"default": "Rachel",
"type": "string",
"enum": [
"Rachel",
"Sarah",
"Laura",
"Alice",
"Matilda",
"Jessica",
"Bella",
"Lily",
"River",
"Roger",
"Charlie",
"George",
"Callum",
"Harry",
"Liam",
"Will",
"Eric",
"Chris",
"Brian",
"Daniel",
"Adam",
"Bill"
]
},
{
"type": "string",
"pattern": "^clone:[A-Za-z0-9_-]{8,128}$"
}
]
},
"language_code": {
"title": "Language",
"description": "Sets what language the model speaks. Any voice can speak any listed language — voices are not language-locked.",
"default": "",
"type": "string",
"enum": [
"",
"en",
"zh",
"es",
"hi",
"pt",
"fr",
"de",
"ja",
"ar",
"ko",
"id",
"it",
"nl",
"tr",
"pl",
"sv",
"fil",
"ms",
"ro",
"uk",
"el",
"cs",
"da",
"fi",
"bg",
"hr",
"sk",
"ta",
"ru"
]
},
"stability": {
"title": "Stability",
"description": "Voice stability (0–1). Higher values make the voice more consistent but less expressive.",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"use_speaker_boost": {
"title": "Speaker Boost",
"description": "Boosts similarity to the original speaker. On by default.",
"default": true,
"type": "boolean"
},
"apply_text_normalization": {
"title": "Text Normalization",
"description": "Whether to convert numbers, URLs, and symbols to spoken words. 'Auto' applies it selectively.",
"default": "auto",
"type": "string",
"enum": [
"auto",
"on",
"off"
]
},
"seed": {
"title": "Seed",
"description": "Seed for reproducibility. -1 for random.",
"type": "integer",
"minimum": -1
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Fast, affordable speech generation with Flash v2.5 across 32 languages. Generate narration and voiceovers with up to 40,000 characters per request.
Pricing: $0.05 / 1,000 characters.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvoicestring / stringlanguage_codestringstabilitynumbersimilarity_boostnumberspeednumberoutput_formatstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=elevenlabs%2Ftts%2Fflash-v2.5",
"title": "ElevenLabs Flash v2.5 generation request",
"description": "Request body accepted by POST /api/v1/generate for elevenlabs/tts/flash-v2.5.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "elevenlabs/tts/flash-v2.5",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"maxLength": 40000
},
"voice": {
"title": "Voice",
"default": "Sarah",
"description": "A listed premade voice or clone:<voice_id> owned by your account. Clone ownership is checked before submission.",
"anyOf": [
{
"title": "Voice",
"description": "Select a voice, including an authorized clone belonging to your account.",
"default": "Sarah",
"type": "string",
"enum": [
"Sarah",
"Laura",
"Alice",
"Matilda",
"Jessica",
"Bella",
"Lily",
"River",
"Roger",
"Charlie",
"George",
"Callum",
"Harry",
"Liam",
"Will",
"Eric",
"Chris",
"Brian",
"Daniel",
"Adam",
"Bill"
]
},
{
"type": "string",
"pattern": "^clone:[A-Za-z0-9_-]{8,128}$"
}
]
},
"language_code": {
"title": "Language",
"default": "",
"type": "string",
"enum": [
"",
"en",
"zh",
"es",
"hi",
"pt",
"fr",
"de",
"ja",
"ar",
"ko",
"id",
"it",
"nl",
"tr",
"pl",
"sv",
"fil",
"ms",
"ro",
"uk",
"el",
"cs",
"da",
"fi",
"bg",
"hr",
"sk",
"ta",
"ru",
"hu",
"no",
"vi"
]
},
"stability": {
"title": "Stability",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"similarity_boost": {
"title": "Voice similarity",
"default": 0.75,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"speed": {
"title": "Speed",
"default": 1,
"type": "number",
"minimum": 0.7,
"maximum": 1.2,
"multipleOf": 0.05
},
"output_format": {
"title": "Output format",
"description": "Browser-playable MP3 audio.",
"default": "mp3_44100_128",
"type": "string",
"enum": [
"mp3_44100_128"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Create a reusable ElevenLabs voice from a short, clean recording and hear it speak your preview text immediately.
Pricing: Clone creation plus a Multilingual v2 speech preview
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvoice_namestringdescriptionstringremove_background_noisebooleanconsent_confirmedbooleanlanguagestringaccentstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=elevenlabs%2Finstant-voice-clone",
"title": "ElevenLabs Instant Voice Clone generation request",
"description": "Request body accepted by POST /api/v1/generate for elevenlabs/instant-voice-clone.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "elevenlabs/instant-voice-clone",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"voice_name": {
"title": "Voice Name",
"description": "A private name for this voice in your ArtEmotion account.",
"default": "My Voice Clone",
"type": "string"
},
"description": {
"title": "Description",
"description": "Optional notes that make this voice easier to recognize later.",
"type": "string"
},
"remove_background_noise": {
"title": "Remove Background Noise",
"description": "Enable only when the sample contains background noise. It can reduce quality on an already-clean recording.",
"default": false,
"type": "boolean"
},
"consent_confirmed": {
"title": "Voice Ownership Confirmed",
"description": "You must own the voice or have explicit permission from its owner before cloning it.",
"default": false,
"type": "boolean"
},
"language": {
"title": "Sample Language",
"description": "Optional metadata describing the language spoken in the sample.",
"type": "string"
},
"accent": {
"title": "Accent",
"description": "Optional metadata describing the accent in the sample.",
"type": "string"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"voice_name",
"consent_confirmed",
"audio_url"
],
"additionalProperties": false
}
ElevenLabs' flagship multilingual TTS model with exceptional voice cloning and expressiveness across 29 languages.
Pricing: ~$0.10 / 1k chars
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvoicestring / stringstabilitynumbersimilarity_boostnumberstylenumberspeednumberuse_speaker_boostbooleanapply_text_normalizationstringprevious_textstringnext_textstringseedinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=elevenlabs%2Ftts%2Fmultilingual-v2",
"title": "ElevenLabs Multilingual v2 generation request",
"description": "Request body accepted by POST /api/v1/generate for elevenlabs/tts/multilingual-v2.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "elevenlabs/tts/multilingual-v2",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"voice": {
"title": "Voice",
"default": "Rachel",
"description": "A listed premade voice or clone:<voice_id> owned by your account. Clone ownership is checked before submission.",
"anyOf": [
{
"title": "Voice",
"description": "Pre-made ElevenLabs voice.",
"default": "Rachel",
"type": "string",
"enum": [
"Rachel",
"Sarah",
"Laura",
"Alice",
"Matilda",
"Jessica",
"Bella",
"Lily",
"River",
"Roger",
"Charlie",
"George",
"Callum",
"Harry",
"Liam",
"Will",
"Eric",
"Chris",
"Brian",
"Daniel",
"Adam",
"Bill"
]
},
{
"type": "string",
"pattern": "^clone:[A-Za-z0-9_-]{8,128}$"
}
]
},
"stability": {
"title": "Stability",
"description": "Voice stability (0–1). Higher values make the voice more consistent but less expressive.",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"similarity_boost": {
"title": "Similarity Boost",
"description": "How closely the output matches the selected voice (0–1).",
"default": 0.75,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"style": {
"title": "Style",
"description": "Style exaggeration (0–1). Higher values amplify the voice's natural style.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"speed": {
"title": "Speed",
"description": "Playback speed of the generated speech. Range: 0.7 (slower) to 1.2 (faster).",
"default": 1,
"type": "number",
"minimum": 0.7,
"maximum": 1.2,
"multipleOf": 0.05
},
"use_speaker_boost": {
"title": "Speaker Boost",
"description": "Boosts similarity to the original speaker. On by default.",
"default": true,
"type": "boolean"
},
"apply_text_normalization": {
"title": "Text Normalization",
"description": "Whether to convert numbers, URLs, and symbols to spoken words. 'Auto' applies it selectively.",
"default": "auto",
"type": "string",
"enum": [
"auto",
"on",
"off"
]
},
"previous_text": {
"title": "Previous Text",
"description": "Text that came before this request — helps the model produce smoother continuity when stitching multiple generations together.",
"type": "string"
},
"next_text": {
"title": "Next Text",
"description": "Text that follows this request — used for continuity when stitching multiple generations together.",
"type": "string"
},
"seed": {
"title": "Seed",
"description": "Seed for reproducibility. -1 for random.",
"type": "integer",
"minimum": -1
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Generate original music tracks from text descriptions using ElevenLabs' music generation model. Supports both vocal and instrumental output.
Pricing: ~$0.15 / min (60 s default)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringmusic_length_msnumberforce_instrumentalbooleanrespect_sections_durationsbooleancomposition_planobjectoutput_formatstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Felevenlabs%2Fmusic",
"title": "ElevenLabs Music v1 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/elevenlabs/music.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/elevenlabs/music",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"maxLength": 4100,
"minLength": 1,
"description": "Provide a prompt OR composition_plan, not both."
},
"music_length_ms": {
"title": "Length (ms)",
"description": "Track length in milliseconds (3 s–10 min). Default is 60 s.",
"default": 60000,
"type": "number",
"minimum": 3000,
"maximum": 600000,
"multipleOf": 1000
},
"force_instrumental": {
"title": "Force Instrumental",
"description": "When enabled, always produces a vocal-free instrumental track.",
"default": false,
"type": "boolean"
},
"respect_sections_durations": {
"title": "Respect Section Durations",
"description": "When enabled, section durations in a composition plan are strictly enforced.",
"default": true,
"type": "boolean"
},
"composition_plan": {
"type": "object",
"description": "A new composition only; provider song IDs/inpainting are not supported. Total duration_ms across all parts must be at most 600000 and determines billing.",
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"positive_global_styles",
"negative_global_styles",
"sections"
],
"properties": {
"positive_global_styles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000
}
},
"negative_global_styles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000
}
},
"sections": {
"type": "array",
"minItems": 1,
"maxItems": 200,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"section_name",
"positive_local_styles",
"negative_local_styles",
"duration_ms",
"lines"
],
"properties": {
"section_name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"positive_local_styles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000
}
},
"negative_local_styles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000
}
},
"duration_ms": {
"type": "integer",
"minimum": 3000,
"maximum": 120000
},
"lines": {
"type": "array",
"maxItems": 30,
"items": {
"type": "string",
"maxLength": 200
}
}
}
}
}
}
}
]
},
"output_format": {
"title": "Output Format",
"description": "Output audio format.",
"default": "mp3_44100_128",
"type": "string",
"enum": [
"mp3_44100_32",
"mp3_44100_64",
"mp3_44100_96",
"mp3_44100_128",
"mp3_44100_192",
"mp3_22050_32",
"pcm_8000",
"pcm_16000",
"pcm_22050",
"pcm_24000",
"pcm_44100",
"pcm_48000",
"ulaw_8000",
"alaw_8000",
"opus_48000_32",
"opus_48000_64",
"opus_48000_96",
"opus_48000_128",
"opus_48000_192"
]
}
},
"required": [
"model_id"
],
"oneOf": [
{
"required": [
"prompt"
],
"not": {
"anyOf": [
{
"required": [
"composition_plan"
]
},
{
"required": [
"extra"
],
"properties": {
"extra": {
"required": [
"composition_plan"
]
}
}
}
]
}
},
{
"not": {
"required": [
"prompt"
]
},
"anyOf": [
{
"required": [
"composition_plan"
]
},
{
"required": [
"extra"
],
"properties": {
"extra": {
"required": [
"composition_plan"
]
}
}
}
]
}
],
"additionalProperties": false
}
Generate music with vocals or instruments using Music v2.5, with richer arrangements and improved prompt adherence. Create a 3-second to 10-minute track from a prompt or a structured composition plan.
Pricing: $0.15 / generated minute; composition plans bill the sum of every section.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringmusic_length_msintegerforce_instrumentalbooleancomposition_planobjectoutput_formatstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=elevenlabs%2Fmusic%2Fv2.5",
"title": "ElevenLabs Music v2.5 generation request",
"description": "Request body accepted by POST /api/v1/generate for elevenlabs/music/v2.5.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "elevenlabs/music/v2.5",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"maxLength": 4100,
"minLength": 1,
"description": "Provide a prompt OR composition_plan, not both."
},
"music_length_ms": {
"title": "Length (ms)",
"description": "Used with a prompt. Composition plans determine their own length.",
"default": 60000,
"type": "integer",
"minimum": 3000,
"maximum": 600000,
"multipleOf": 1000
},
"force_instrumental": {
"title": "Instrumental only",
"description": "Used with a prompt; omit when supplying a composition plan.",
"default": false,
"type": "boolean"
},
"composition_plan": {
"type": "object",
"description": "A new composition only; provider song IDs/inpainting are not supported. Total duration_ms across all parts must be at most 600000 and determines billing.",
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"positive_global_styles",
"negative_global_styles",
"sections"
],
"properties": {
"positive_global_styles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000
}
},
"negative_global_styles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000
}
},
"sections": {
"type": "array",
"minItems": 1,
"maxItems": 200,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"section_name",
"positive_local_styles",
"negative_local_styles",
"duration_ms",
"lines"
],
"properties": {
"section_name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"positive_local_styles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000
}
},
"negative_local_styles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000
}
},
"duration_ms": {
"type": "integer",
"minimum": 3000,
"maximum": 120000
},
"lines": {
"type": "array",
"maxItems": 30,
"items": {
"type": "string",
"maxLength": 200
}
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"chunks"
],
"properties": {
"chunks": {
"type": "array",
"minItems": 1,
"maxItems": 200,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"text",
"positive_styles",
"duration_ms"
],
"properties": {
"text": {
"type": "string",
"maxLength": 6000
},
"positive_styles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000
}
},
"negative_styles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000
}
},
"duration_ms": {
"type": "integer",
"minimum": 3000,
"maximum": 120000
},
"context_adherence": {
"type": "string",
"enum": [
"low",
"medium",
"high"
]
}
}
}
}
}
}
]
},
"output_format": {
"title": "Output format",
"description": "Browser-playable MP3 audio.",
"default": "mp3_48000_192",
"type": "string",
"enum": [
"mp3_48000_192",
"mp3_44100_128"
]
}
},
"required": [
"model_id"
],
"oneOf": [
{
"required": [
"prompt"
],
"not": {
"anyOf": [
{
"required": [
"composition_plan"
]
},
{
"required": [
"extra"
],
"properties": {
"extra": {
"required": [
"composition_plan"
]
}
}
}
]
}
},
{
"not": {
"required": [
"prompt"
]
},
"anyOf": [
{
"required": [
"composition_plan"
]
},
{
"required": [
"extra"
],
"properties": {
"extra": {
"required": [
"composition_plan"
]
}
}
}
]
}
],
"additionalProperties": false
}
ElevenLabs' Scribe v2 transcription model with key term biasing for improved accuracy on domain-specific vocabulary.
Pricing: $0.22 / hour; keyterm prompting adds $0.05 / hour (ElevenLabs direct)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringlanguage_codestringdiarizebooleantag_audio_eventsbooleankeytermsarrayaudio_urlstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Felevenlabs%2Fspeech-to-text%2Fscribe-v2",
"title": "ElevenLabs Scribe v2 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/elevenlabs/speech-to-text/scribe-v2.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/elevenlabs/speech-to-text/scribe-v2",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"language_code": {
"title": "Language",
"description": "Language of the audio. Auto-detect works well for most clips.",
"default": "",
"type": "string",
"enum": [
"",
"eng",
"spa",
"fra",
"deu",
"por",
"ita",
"hin",
"zho",
"jpn",
"kor",
"ara",
"rus",
"ind",
"nld",
"tur",
"pol",
"swe",
"fil",
"msa",
"ron",
"ukr",
"ell",
"ces",
"dan",
"fin",
"bul",
"hrv",
"slk",
"tam",
"vie",
"tha",
"heb",
"hun",
"nor",
"cat"
]
},
"diarize": {
"title": "Diarize",
"description": "Annotate which speaker is talking at each point.",
"default": false,
"type": "boolean"
},
"tag_audio_events": {
"title": "Tag Audio Events",
"description": "Tag non-speech sounds like laughter, applause, or music.",
"default": true,
"type": "boolean"
},
"keyterms": {
"title": "Key Terms",
"description": "Vocabulary hints; each term is at most 5 words. Adds a surcharge to transcription, included by /api/v1/estimate.",
"type": "array",
"maxItems": 1000,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 50
}
},
"audio_url": {
"type": "string",
"format": "uri"
},
"duration": {
"type": "number",
"minimum": 1,
"maximum": 7200,
"default": 60,
"description": "Estimate-only fallback when no media is supplied. Generation measures source bytes before reserving credits; client duration cannot lower the bill."
}
},
"required": [
"model_id",
"audio_url"
],
"additionalProperties": false
}
Transcribe medical terminology and clinical dictation with Scribe v2 Medical in 90+ languages. Supports speaker diarization and vocabulary hints. Do not upload protected health information without an approved compliance arrangement; model availability alone does not make this app HIPAA-compliant.
Pricing: $0.22 / source hour; keyterms add $0.05 / hour.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringlanguage_codestringkeytermsarraydiarizebooleantag_audio_eventsbooleanaudio_urlstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=elevenlabs%2Fspeech-to-text%2Fscribe-v2-medical",
"title": "ElevenLabs Scribe v2 Medical generation request",
"description": "Request body accepted by POST /api/v1/generate for elevenlabs/speech-to-text/scribe-v2-medical.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "elevenlabs/speech-to-text/scribe-v2-medical",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"language_code": {
"title": "Language",
"description": "Optional ISO language code, such as en, es, eng, or spa. Leave empty to detect the language automatically.",
"default": "",
"type": "string",
"minLength": 2,
"maxLength": 3
},
"keyterms": {
"title": "Keyterms",
"description": "Vocabulary hints; each term is at most 5 words. Adds a surcharge to transcription, included by /api/v1/estimate.",
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"maxItems": 1000
},
"diarize": {
"title": "Identify speakers",
"description": "Include speaker labels in the transcript.",
"default": true,
"type": "boolean"
},
"tag_audio_events": {
"title": "Tag audio events",
"description": "Include non-speech sounds such as laughter.",
"default": true,
"type": "boolean"
},
"audio_url": {
"type": "string",
"format": "uri"
},
"duration": {
"type": "number",
"minimum": 1,
"maximum": 7200,
"default": 60,
"description": "Estimate-only fallback when no media is supplied. Generation measures source bytes before reserving credits; client duration cannot lower the bill."
}
},
"required": [
"model_id",
"audio_url"
],
"additionalProperties": false
}
Transcribe an uploaded audio clip through ElevenLabs' real-time Scribe WebSocket model. Supports 90+ languages and vocabulary hints. ArtEmotion returns the completed transcript; this is not a live microphone session. Maximum clip length: 10 minutes.
Pricing: $0.39 / source hour; keyterms add $0.05 / hour.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringlanguage_codestringkeytermsarrayaudio_urlstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=elevenlabs%2Fspeech-to-text%2Fscribe-v2-realtime",
"title": "ElevenLabs Scribe v2 Realtime generation request",
"description": "Request body accepted by POST /api/v1/generate for elevenlabs/speech-to-text/scribe-v2-realtime.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "elevenlabs/speech-to-text/scribe-v2-realtime",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"language_code": {
"title": "Language",
"description": "Optional ISO language code, such as en, es, eng, or spa. Leave empty to detect the language automatically.",
"default": "",
"type": "string",
"minLength": 2,
"maxLength": 3
},
"keyterms": {
"title": "Keyterms",
"description": "Vocabulary hints; each term is at most 5 words. Adds a surcharge to transcription, included by /api/v1/estimate.",
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"maxItems": 1000
},
"audio_url": {
"type": "string",
"format": "uri"
},
"duration": {
"type": "number",
"minimum": 2,
"maximum": 600,
"default": 60,
"description": "Estimate-only fallback when no media is supplied. Generation measures source bytes before reserving credits; client duration cannot lower the bill."
}
},
"required": [
"model_id",
"audio_url"
],
"additionalProperties": false
}
Generate high-quality sound effects from text descriptions using ElevenLabs' latest sound effects model.
Pricing: ~$0.12 / generation (flat)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringduration_secondsnumberprompt_influencenumberloopbooleanoutput_formatstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=elevenlabs%2Fsound-effects%2Fv2",
"title": "ElevenLabs Sound Effects v2 generation request",
"description": "Request body accepted by POST /api/v1/generate for elevenlabs/sound-effects/v2.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "elevenlabs/sound-effects/v2",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"duration_seconds": {
"title": "Duration (seconds)",
"description": "Duration in seconds (0.5–30). Leave blank and the model picks the optimal length.",
"type": "number",
"minimum": 0.5,
"maximum": 30
},
"prompt_influence": {
"title": "Prompt Influence",
"description": "How closely to follow the prompt (0–1). Higher values produce less variation.",
"default": 0.3,
"type": "number",
"minimum": 0,
"maximum": 1
},
"loop": {
"title": "Loop",
"description": "Create a sound effect that loops smoothly (v2 model feature).",
"default": false,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "Output audio format.",
"default": "mp3_44100_128",
"type": "string",
"enum": [
"mp3_44100_32",
"mp3_44100_64",
"mp3_44100_96",
"mp3_44100_128",
"mp3_44100_192",
"mp3_22050_32",
"pcm_8000",
"pcm_16000",
"pcm_22050",
"pcm_24000",
"pcm_44100",
"pcm_48000",
"ulaw_8000",
"alaw_8000",
"opus_48000_32",
"opus_48000_64",
"opus_48000_96",
"opus_48000_128",
"opus_48000_192"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Transcribe audio files with speaker diarization and audio event tagging using ElevenLabs' speech-to-text model.
Pricing: $0.22 / hour (ElevenLabs direct)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringlanguage_codestringdiarizebooleantag_audio_eventsbooleanaudio_urlstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Felevenlabs%2Fspeech-to-text",
"title": "ElevenLabs Speech to Text (Scribe v2) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/elevenlabs/speech-to-text.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/elevenlabs/speech-to-text",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"language_code": {
"title": "Language",
"description": "Language of the audio. Auto-detect works well for most clips.",
"default": "",
"type": "string",
"enum": [
"",
"eng",
"spa",
"fra",
"deu",
"por",
"ita",
"hin",
"zho",
"jpn",
"kor",
"ara",
"rus",
"ind",
"nld",
"tur",
"pol",
"swe",
"fil",
"msa",
"ron",
"ukr",
"ell",
"ces",
"dan",
"fin",
"bul",
"hrv",
"slk",
"tam",
"vie",
"tha",
"heb",
"hun",
"nor",
"cat"
]
},
"diarize": {
"title": "Diarize",
"description": "Annotate which speaker is talking at each point.",
"default": true,
"type": "boolean"
},
"tag_audio_events": {
"title": "Tag Audio Events",
"description": "Tag non-speech sounds like laughter, applause, or music.",
"default": true,
"type": "boolean"
},
"audio_url": {
"type": "string",
"format": "uri"
},
"duration": {
"type": "number",
"minimum": 1,
"maximum": 7200,
"default": 60,
"description": "Estimate-only fallback when no media is supplied. Generation measures source bytes before reserving credits; client duration cannot lower the bill."
}
},
"required": [
"model_id",
"audio_url"
],
"additionalProperties": false
}
Generate multi-speaker dialogue audio by assigning each line of dialogue to an ElevenLabs voice. Powered by Eleven v3.
Pricing: ~$0.10 / 1k chars of dialogue text
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringinputsstringstabilitynumberlanguage_codestringapply_text_normalizationstringseedintegerpronunciation_dictionary_locatorsobject
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=elevenlabs%2Ftext-to-dialogue%2Feleven-v3",
"title": "ElevenLabs Text to Dialogue generation request",
"description": "Request body accepted by POST /api/v1/generate for elevenlabs/text-to-dialogue/eleven-v3.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "elevenlabs/text-to-dialogue/eleven-v3",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"inputs": {
"title": "Dialogue Inputs",
"description": "Array of dialogue turns, each with a voice and a line of text. At least one turn is required.",
"type": "string"
},
"stability": {
"title": "Stability",
"description": "Voice stability (0–1). Higher = more consistent, lower = more expressive.",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"language_code": {
"title": "Language",
"description": "Language of the input text. Auto-detected if not set.",
"default": "",
"type": "string",
"enum": [
"",
"en",
"zh",
"es",
"hi",
"pt",
"fr",
"de",
"ja",
"ar",
"ko",
"id",
"it",
"nl",
"tr",
"pl",
"sv",
"fil",
"ms",
"ro",
"uk",
"el",
"cs",
"da",
"fi",
"bg",
"hr",
"sk",
"ta",
"ru"
]
},
"apply_text_normalization": {
"title": "Text Normalization",
"description": "Whether to convert numbers, URLs, and symbols to spoken words. 'Auto' applies it selectively.",
"default": "auto",
"type": "string",
"enum": [
"auto",
"on",
"off"
]
},
"seed": {
"title": "Seed",
"description": "Seed for reproducibility. -1 for random.",
"type": "integer",
"minimum": -1
},
"pronunciation_dictionary_locators": {
"title": "Pronunciation Dictionaries",
"description": "Array of pronunciation dictionary locators, each with pronunciation_dictionary_id and version_id. Up to 3 supported. Advanced use only.",
"type": "object",
"additionalProperties": true
}
},
"required": [
"model_id",
"inputs"
],
"additionalProperties": false
}
Expressive speech with Eleven v3 Conversational in 70+ languages. ArtEmotion generates one voice per job through the provider's Text to Dialogue WebSocket and saves a playable MP3. Use audio tags such as [laughs] and [whispers]. Maximum 5,000 characters per job.
Pricing: $0.05 / 1,000 characters.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvoicestring / stringoutput_formatstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=elevenlabs%2Ftts%2Feleven-v3-conversational",
"title": "ElevenLabs v3 Conversational generation request",
"description": "Request body accepted by POST /api/v1/generate for elevenlabs/tts/eleven-v3-conversational.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "elevenlabs/tts/eleven-v3-conversational",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"maxLength": 5000
},
"voice": {
"title": "Voice",
"default": "Sarah",
"description": "A listed premade voice or clone:<voice_id> owned by your account. Clone ownership is checked before submission.",
"anyOf": [
{
"title": "Voice",
"description": "Select a voice, including an authorized clone belonging to your account.",
"default": "Sarah",
"type": "string",
"enum": [
"Sarah",
"Laura",
"Alice",
"Matilda",
"Jessica",
"Bella",
"Lily",
"River",
"Roger",
"Charlie",
"George",
"Callum",
"Harry",
"Liam",
"Will",
"Eric",
"Chris",
"Brian",
"Daniel",
"Adam",
"Bill"
]
},
{
"type": "string",
"pattern": "^clone:[A-Za-z0-9_-]{8,128}$"
}
]
},
"output_format": {
"title": "Output format",
"description": "Browser-playable MP3 audio.",
"default": "mp3_44100_128",
"type": "string",
"enum": [
"mp3_44100_128"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Transform the voice in an audio file to any ElevenLabs pre-made voice while preserving the original speech rhythm and content.
Pricing: ~$0.12 / min (30 s default)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvoicestring / stringremove_background_noisebooleanoutput_formatstringseedintegeraudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Felevenlabs%2Fvoice-changer",
"title": "ElevenLabs Voice Changer generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/elevenlabs/voice-changer.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/elevenlabs/voice-changer",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"voice": {
"title": "Voice",
"default": "Sarah",
"description": "A listed premade voice or clone:<voice_id> owned by your account. Clone ownership is checked before submission.",
"anyOf": [
{
"title": "Voice",
"description": "Pre-made ElevenLabs voice. Upload reference audio in the input slot to use voice cloning instead.",
"default": "Sarah",
"type": "string",
"enum": [
"Sarah",
"Laura",
"Alice",
"Matilda",
"Jessica",
"Bella",
"Lily",
"River",
"Roger",
"Charlie",
"George",
"Callum",
"Harry",
"Liam",
"Will",
"Eric",
"Chris",
"Brian",
"Daniel",
"Adam",
"Bill"
]
},
{
"type": "string",
"pattern": "^clone:[A-Za-z0-9_-]{8,128}$"
}
]
},
"remove_background_noise": {
"title": "Remove Background Noise",
"description": "Strip background noise from the input audio before applying the voice change.",
"default": false,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "Output audio format. Formatted as codec_sample_rate_bitrate.",
"default": "mp3_44100_128",
"type": "string",
"enum": [
"mp3_44100_32",
"mp3_44100_64",
"mp3_44100_96",
"mp3_44100_128",
"mp3_44100_192",
"mp3_22050_32",
"pcm_8000",
"pcm_16000",
"pcm_22050",
"pcm_24000",
"pcm_44100",
"pcm_48000",
"ulaw_8000",
"alaw_8000",
"opus_48000_32",
"opus_48000_64",
"opus_48000_96",
"opus_48000_128",
"opus_48000_192"
]
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility.",
"type": "integer"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"audio_url"
],
"additionalProperties": false
}
Generate a brand-new voice from a text description using ElevenLabs Voice Design v3. The model produces an audio sample of the custom voice speaking your sample text. Ideal for prototyping unique narrator voices, character voices, or brand-specific voices.
Pricing: $0.10 / 1k chars of preview text (charged once for all 3 previews).
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringtextstringoutput_formatstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=elevenlabs%2Fvoice-design",
"title": "ElevenLabs Voice Design generation request",
"description": "Request body accepted by POST /api/v1/generate for elevenlabs/voice-design.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "elevenlabs/voice-design",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"text": {
"title": "Sample Text",
"description": "The text the generated voice will speak in the sample output. Must be 100-1000 characters.",
"default": "Hello there, this is a preview of my newly designed voice. I hope the tone, warmth, and clarity come through clearly in every word I speak.",
"type": "string"
},
"output_format": {
"title": "Output Format",
"description": "Audio format for the output sample.",
"default": "mp3_44100_128",
"type": "string",
"enum": [
"mp3_44100_32",
"mp3_44100_64",
"mp3_44100_96",
"mp3_44100_128",
"mp3_44100_192",
"mp3_22050_32",
"pcm_8000",
"pcm_16000",
"pcm_22050",
"pcm_24000",
"pcm_44100",
"pcm_48000",
"ulaw_8000",
"alaw_8000",
"opus_48000_32",
"opus_48000_64",
"opus_48000_96",
"opus_48000_128",
"opus_48000_192"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Google Gemini 3.1 Flash TTS with 30 expressive voices, granular audio tags, multi-speaker dialogue, and 90+ languages.
Pricing: ~$0.10 / 1k chars
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvoicestringlanguage_codestringspeakersstringstyle_instructionsstringtemperaturenumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fgemini-3.1-flash-tts",
"title": "Gemini 3.1 Flash TTS generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/gemini-3.1-flash-tts.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/gemini-3.1-flash-tts",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"voice": {
"title": "Voice",
"description": "Gemini TTS voice. Click to preview any voice.",
"default": "Kore",
"type": "string",
"enum": [
"Achernar",
"Achird",
"Algenib",
"Algieba",
"Alnilam",
"Aoede",
"Autonoe",
"Callirrhoe",
"Charon",
"Despina",
"Enceladus",
"Erinome",
"Fenrir",
"Gacrux",
"Iapetus",
"Kore",
"Laomedeia",
"Leda",
"Orus",
"Puck",
"Pulcherrima",
"Rasalgethi",
"Sadachbia",
"Sadaltager",
"Schedar",
"Sulafat",
"Umbriel",
"Vindemiatrix",
"Zephyr",
"Zubenelgenubi"
]
},
"language_code": {
"title": "Language",
"description": "Steers the model to speak in the specified language. Auto-detected from the text if not set.",
"type": "string",
"enum": [
"Arabic (Egypt)",
"Bangla (Bangladesh)",
"Dutch (Netherlands)",
"English (India)",
"English (US)",
"French (France)",
"German (Germany)",
"Hindi (India)",
"Indonesian (Indonesia)",
"Italian (Italy)",
"Japanese (Japan)",
"Korean (South Korea)",
"Marathi (India)",
"Polish (Poland)",
"Portuguese (Brazil)",
"Romanian (Romania)",
"Russian (Russia)",
"Spanish (Spain)",
"Tamil (India)",
"Telugu (India)",
"Thai (Thailand)",
"Turkish (Turkey)",
"Ukrainian (Ukraine)",
"Vietnamese (Vietnam)",
"Afrikaans (South Africa)",
"Albanian (Albania)",
"Amharic (Ethiopia)",
"Arabic (World)",
"Armenian (Armenia)",
"Azerbaijani (Azerbaijan)",
"Basque (Spain)",
"Belarusian (Belarus)",
"Bulgarian (Bulgaria)",
"Burmese (Myanmar)",
"Catalan (Spain)",
"Cebuano (Philippines)",
"Chinese Mandarin (China)",
"Chinese Mandarin (Taiwan)",
"Croatian (Croatia)",
"Czech (Czech Republic)",
"Danish (Denmark)",
"English (Australia)",
"English (UK)",
"Estonian (Estonia)",
"Filipino (Philippines)",
"Finnish (Finland)",
"French (Canada)",
"Galician (Spain)",
"Georgian (Georgia)",
"Greek (Greece)",
"Gujarati (India)",
"Haitian Creole (Haiti)",
"Hebrew (Israel)",
"Hungarian (Hungary)",
"Icelandic (Iceland)",
"Javanese (Java)",
"Kannada (India)",
"Konkani (India)",
"Lao (Laos)",
"Latin (Vatican City)",
"Latvian (Latvia)",
"Lithuanian (Lithuania)",
"Luxembourgish (Luxembourg)",
"Macedonian (North Macedonia)",
"Maithili (India)",
"Malagasy (Madagascar)",
"Malay (Malaysia)",
"Malayalam (India)",
"Mongolian (Mongolia)",
"Nepali (Nepal)",
"Norwegian Bokmal (Norway)",
"Norwegian Nynorsk (Norway)",
"Odia (India)",
"Pashto (Afghanistan)",
"Persian (Iran)",
"Portuguese (Portugal)",
"Punjabi (India)",
"Serbian (Serbia)",
"Sindhi (India)",
"Sinhala (Sri Lanka)",
"Slovak (Slovakia)",
"Slovenian (Slovenia)",
"Spanish (Latin America)",
"Spanish (Mexico)",
"Swahili (Kenya)",
"Swedish (Sweden)",
"Urdu (Pakistan)"
]
},
"speakers": {
"title": "Speakers",
"description": "Multi-speaker voice config. Each entry needs a voice and a speaker ID that matches a prefix in your prompt (e.g. 'Alice: Hello!'). Ignored when empty.",
"type": "string"
},
"style_instructions": {
"title": "Style Instructions",
"description": "Optional delivery instructions prepended to the prompt (tone, pace, accent, emotion). Example: 'Speak slowly and warmly.'",
"default": "",
"type": "string"
},
"temperature": {
"title": "Temperature",
"description": "Controls variability of the generated speech. Lower = more consistent, higher = more expressive.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 2,
"multipleOf": 0.05
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Inworld AI's multilingual TTS with a large library of expressive character voices across 14 languages.
Pricing: ~$0.01 / 1k chars
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvoicestringsample_rate_hertznumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Finworld-tts",
"title": "Inworld TTS 1.5 Max generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/inworld-tts.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/inworld-tts",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"voice": {
"title": "Voice",
"description": "Voice to use for synthesis. Language is determined by the voice — pick a non-English voice to speak in that language.",
"default": "Craig (en)",
"type": "string",
"enum": [
"Abby (en)",
"Alex (en)",
"Amina (en)",
"Anjali (en)",
"Arjun (en)",
"Ashley (en)",
"Blake (en)",
"Brian (en)",
"Callum (en)",
"Carter (en)",
"Celeste (en)",
"Chloe (en)",
"Claire (en)",
"Clive (en)",
"Craig (en)",
"Darlene (en)",
"Deborah (en)",
"Dennis (en)",
"Derek (en)",
"Dominus (en)",
"Edward (en)",
"Elizabeth (en)",
"Elliot (en)",
"Ethan (en)",
"Evan (en)",
"Evelyn (en)",
"Gareth (en)",
"Graham (en)",
"Grant (en)",
"Hades (en)",
"Hamish (en)",
"Hana (en)",
"Hank (en)",
"Jake (en)",
"James (en)",
"Jason (en)",
"Jessica (en)",
"Julia (en)",
"Kayla (en)",
"Kelsey (en)",
"Lauren (en)",
"Liam (en)",
"Loretta (en)",
"Luna (en)",
"Malcolm (en)",
"Mark (en)",
"Marlene (en)",
"Miranda (en)",
"Mortimer (en)",
"Nate (en)",
"Oliver (en)",
"Olivia (en)",
"Pippa (en)",
"Pixie (en)",
"Priya (en)",
"Ronald (en)",
"Rupert (en)",
"Saanvi (en)",
"Sarah (en)",
"Sebastian (en)",
"Serena (en)",
"Shaun (en)",
"Simon (en)",
"Snik (en)",
"Tessa (en)",
"Theodore (en)",
"Timothy (en)",
"Tyler (en)",
"Victor (en)",
"Victoria (en)",
"Veronica (en)",
"Vinny (en)",
"Wendy (en)",
"Nour (ar)",
"Omar (ar)",
"Jing (zh)",
"Xiaoyin (zh)",
"Xinyi (zh)",
"Yichen (zh)",
"Erik (nl)",
"Katrien (nl)",
"Lennart (nl)",
"Lore (nl)",
"Alain (fr)",
"Étienne (fr)",
"Hélène (fr)",
"Mathieu (fr)",
"Johanna (de)",
"Josef (de)",
"Oren (he)",
"Yael (he)",
"Manoj (hi)",
"Riya (hi)",
"Gianni (it)",
"Orietta (it)",
"Asuka (ja)",
"Satoshi (ja)",
"Hyunwoo (ko)",
"Minji (ko)",
"Seojun (ko)",
"Yoona (ko)",
"Szymon (pl)",
"Wojciech (pl)",
"Heitor (pt)",
"Maitê (pt)",
"Dmitry (ru)",
"Elena (ru)",
"Nikolai (ru)",
"Svetlana (ru)",
"Diego (es)",
"Lupita (es)",
"Miguel (es)",
"Rafael (es)"
]
},
"sample_rate_hertz": {
"title": "Sample Rate",
"description": "Audio sample rate of the output file.",
"default": "48000",
"type": "number",
"enum": [
48000,
40000,
32000,
24000,
16000,
8000
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Kokoro lightweight TTS — natural Brazilian Portuguese voices with fast inference.
Pricing: ~$0.02 / 1k chars
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvoicestringspeednumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fkokoro%2Fbrazilian-portuguese",
"title": "Kokoro (Brazilian Portuguese) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/kokoro/brazilian-portuguese.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/kokoro/brazilian-portuguese",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"voice": {
"title": "Voice",
"description": "Kokoro voice style.",
"default": "pf_dora",
"type": "string",
"enum": [
"pf_dora",
"pm_alex",
"pm_santa"
]
},
"speed": {
"title": "Speed",
"description": "Speed of the generated audio. Default is 1.0.",
"default": 1,
"type": "number",
"minimum": 0.1,
"maximum": 5
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Kokoro lightweight TTS — natural British English voices with fast inference.
Pricing: ~$0.02 / 1k chars
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvoicestringspeednumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fkokoro%2Fbritish-english",
"title": "Kokoro (British English) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/kokoro/british-english.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/kokoro/british-english",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"voice": {
"title": "Voice",
"description": "Kokoro voice style.",
"default": "bf_emma",
"type": "string",
"enum": [
"bf_alice",
"bf_emma",
"bf_isabella",
"bf_lily",
"bm_daniel",
"bm_fable",
"bm_george",
"bm_lewis"
]
},
"speed": {
"title": "Speed",
"description": "Speed of the generated audio. Default is 1.0.",
"default": 1,
"type": "number",
"minimum": 0.1,
"maximum": 5
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Kokoro lightweight TTS — natural French voices with fast inference.
Pricing: ~$0.02 / 1k chars
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvoicestringspeednumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fkokoro%2Ffrench",
"title": "Kokoro (French) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/kokoro/french.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/kokoro/french",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"voice": {
"title": "Voice",
"description": "Kokoro voice style.",
"default": "ff_siwis",
"type": "string",
"enum": [
"ff_siwis"
]
},
"speed": {
"title": "Speed",
"description": "Speed of the generated audio. Default is 1.0.",
"default": 1,
"type": "number",
"minimum": 0.1,
"maximum": 5
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Kokoro lightweight TTS — natural Hindi voices with fast inference.
Pricing: ~$0.02 / 1k chars
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvoicestringspeednumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fkokoro%2Fhindi",
"title": "Kokoro (Hindi) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/kokoro/hindi.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/kokoro/hindi",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"voice": {
"title": "Voice",
"description": "Kokoro voice style.",
"default": "hf_alpha",
"type": "string",
"enum": [
"hf_alpha",
"hf_beta",
"hm_omega",
"hm_psi"
]
},
"speed": {
"title": "Speed",
"description": "Speed of the generated audio. Default is 1.0.",
"default": 1,
"type": "number",
"minimum": 0.1,
"maximum": 5
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Kokoro lightweight TTS — natural Italian voices with fast inference.
Pricing: ~$0.02 / 1k chars
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvoicestringspeednumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fkokoro%2Fitalian",
"title": "Kokoro (Italian) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/kokoro/italian.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/kokoro/italian",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"voice": {
"title": "Voice",
"description": "Kokoro voice style.",
"default": "if_sara",
"type": "string",
"enum": [
"if_sara",
"im_nicola"
]
},
"speed": {
"title": "Speed",
"description": "Speed of the generated audio. Default is 1.0.",
"default": 1,
"type": "number",
"minimum": 0.1,
"maximum": 5
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Kokoro lightweight TTS — natural Japanese voices with fast inference.
Pricing: ~$0.02 / 1k chars
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvoicestringspeednumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fkokoro%2Fjapanese",
"title": "Kokoro (Japanese) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/kokoro/japanese.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/kokoro/japanese",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"voice": {
"title": "Voice",
"description": "Kokoro voice style.",
"default": "jf_alpha",
"type": "string",
"enum": [
"jf_alpha",
"jf_gongitsune",
"jf_nezumi",
"jf_tebukuro",
"jm_kumo"
]
},
"speed": {
"title": "Speed",
"description": "Speed of the generated audio. Default is 1.0.",
"default": 1,
"type": "number",
"minimum": 0.1,
"maximum": 5
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Kokoro lightweight TTS — natural Spanish voices with fast inference.
Pricing: ~$0.02 / 1k chars
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvoicestringspeednumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fkokoro%2Fspanish",
"title": "Kokoro (Spanish) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/kokoro/spanish.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/kokoro/spanish",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"voice": {
"title": "Voice",
"description": "Kokoro voice style.",
"default": "ef_dora",
"type": "string",
"enum": [
"ef_dora",
"em_alex",
"em_santa"
]
},
"speed": {
"title": "Speed",
"description": "Speed of the generated audio. Default is 1.0.",
"default": 1,
"type": "number",
"minimum": 0.1,
"maximum": 5
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Kokoro lightweight TTS — natural American English voices with fast inference.
Pricing: ~$0.02 / 1k chars
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvoicestringspeednumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fkokoro%2Famerican-english",
"title": "Kokoro (US English) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/kokoro/american-english.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/kokoro/american-english",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"voice": {
"title": "Voice",
"description": "Kokoro voice style. Click ▶ to preview any voice.",
"default": "af_heart",
"type": "string",
"enum": [
"af_heart",
"af_alloy",
"af_aoede",
"af_bella",
"af_jessica",
"af_kore",
"af_nicole",
"af_nova",
"af_river",
"af_sarah",
"af_sky",
"am_adam",
"am_echo",
"am_eric",
"am_fenrir",
"am_liam",
"am_michael",
"am_onyx",
"am_puck",
"am_santa"
]
},
"speed": {
"title": "Speed",
"description": "Speed of the generated audio. Default is 1.0.",
"default": 1,
"type": "number",
"minimum": 0.1,
"maximum": 5
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Google DeepMind's Lyria 2 music generation model with exceptional orchestral and instrumental quality.
Pricing: ~$0.10 / generation
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringseedinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Flyria2",
"title": "Lyria 2 (Music) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/lyria2.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/lyria2",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "A description of what to exclude from the generated audio",
"default": "low quality",
"type": "string"
},
"seed": {
"title": "Seed",
"description": "A seed for deterministic generation. If provided, the model will attempt to produce the same audio given the same prompt and other parameters.",
"type": "integer"
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Google's latest Lyria 3 Pro model for full-length music up to 3 minutes with multilingual vocals and optional image-based mood conditioning.
Pricing: ~$0.08 / generation
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Flyria3%2Fpro",
"title": "Lyria 3 Pro (Music) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/lyria3/pro.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/lyria3/pro",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "A description of what to exclude from the generated audio.",
"default": "",
"type": "string"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
MiniMax Music 2.6 generates vocal and instrumental music from text descriptions with optional custom lyrics.
Pricing: ~$0.15 / track (38 cr)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringlyrics_optimizerbooleanlyricsstringis_instrumentalbooleanoutput_formatstringsample_ratenumberbitratenumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fminimax-music%2Fv2.6",
"title": "MiniMax Music 2.6 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/minimax-music/v2.6.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/minimax-music/v2.6",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"lyrics_optimizer": {
"title": "Auto-generate Lyrics",
"description": "When enabled and lyrics is empty, the model auto-generates lyrics from the prompt.",
"default": false,
"type": "boolean"
},
"lyrics": {
"title": "Lyrics (optional)",
"description": "Song lyrics with structure tags: [Intro], [Verse], [Chorus], [Bridge], [Outro], [Hook]. Max 3500 chars.",
"default": "",
"type": "string"
},
"is_instrumental": {
"title": "Instrumental",
"description": "Generate vocal-free instrumental music without any singing.",
"default": false,
"type": "boolean"
},
"output_format": {
"title": "Format",
"description": "Audio file format of the generated track.",
"default": "mp3",
"type": "string",
"enum": [
"mp3",
"wav",
"pcm"
]
},
"sample_rate": {
"title": "Sample Rate",
"description": "Sample rate of the generated audio.",
"default": "44100",
"type": "number",
"enum": [
16000,
24000,
32000,
44100
]
},
"bitrate": {
"title": "Bitrate",
"description": "Bitrate of the generated audio (MP3 / PCM only).",
"default": "256000",
"type": "number",
"enum": [
32000,
64000,
128000,
256000
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
MiniMax's high-definition TTS model with 37-language support and expressive voice personas.
Pricing: ~$0.10 / 1k chars
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvoice_idstringlanguage_booststringspeednumbervolnumberpitchnumberemotionstringenglish_normalizationbooleanoutput_formatstringtone_listarrayas_formatstringas_sample_ratenumberas_bitratenumberas_channelnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fminimax%2Fspeech-02-hd",
"title": "MiniMax Speech-02 HD generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/minimax/speech-02-hd.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/minimax/speech-02-hd",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"voice_id": {
"title": "Voice",
"description": "MiniMax pre-trained voice persona.",
"default": "Wise_Woman",
"type": "string",
"enum": [
"Abbess",
"Calm_Woman",
"Casual_Guy",
"Decent_Boy",
"Deep_Voice_Man",
"Determined_Man",
"Elegant_Man",
"Exuberant_Girl",
"Friendly_Person",
"Imposing_Manner",
"Inspirational_girl",
"Lively_Girl",
"Lovely_Girl",
"Patient_Man",
"Sweet_Girl_2",
"Wise_Woman",
"Young_Knight"
]
},
"language_boost": {
"title": "Language Boost",
"description": "Boosts recognition accuracy for the selected language. Use Auto for mixed-language text.",
"default": "auto",
"type": "string",
"enum": [
"auto",
"English",
"Chinese",
"Chinese,Yue",
"Japanese",
"Korean",
"Spanish",
"French",
"German",
"Portuguese",
"Arabic",
"Hindi",
"Russian",
"Dutch",
"Turkish",
"Italian",
"Polish",
"Swedish",
"Ukrainian",
"Vietnamese",
"Indonesian",
"Thai",
"Romanian",
"Greek",
"Czech",
"Finnish",
"Danish",
"Hebrew",
"Malay",
"Slovak",
"Croatian",
"Hungarian",
"Norwegian",
"Bulgarian",
"Slovenian",
"Catalan",
"Afrikaans",
"Nynorsk"
]
},
"speed": {
"title": "Speed",
"description": "Speech speed multiplier (0.5–2.0).",
"default": 1,
"type": "number",
"minimum": 0.5,
"maximum": 2,
"multipleOf": 0.05
},
"vol": {
"title": "Volume",
"description": "Output volume level (0.01–10). 1 is the default.",
"default": 1,
"type": "number",
"minimum": 0.01,
"maximum": 10,
"multipleOf": 0.05
},
"pitch": {
"title": "Pitch",
"description": "Voice pitch shift in semitones (-12 to +12). 0 is unchanged.",
"default": 0,
"type": "number",
"minimum": -12,
"maximum": 12,
"multipleOf": 1
},
"emotion": {
"title": "Emotion",
"description": "Emotional tone of the generated speech.",
"default": "",
"type": "string",
"enum": [
"",
"happy",
"sad",
"angry",
"fearful",
"disgusted",
"surprised",
"neutral"
]
},
"english_normalization": {
"title": "English Normalization",
"description": "Improves number reading (e.g. dates, prices). Adds slight latency.",
"default": false,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "Format of the output content (non-streaming only).",
"default": "hex",
"type": "string",
"enum": [
"url",
"hex"
]
},
"tone_list": {
"title": "Tone List",
"description": "Pronunciation replacements in 'text/(pronunciation)' format. For Chinese, use tones 1–5.",
"type": "array",
"items": {
"type": "string"
}
},
"as_format": {
"title": "Audio Format",
"description": "Output audio encoding format.",
"default": "mp3",
"type": "string",
"enum": [
"mp3",
"pcm",
"flac"
]
},
"as_sample_rate": {
"title": "Sample Rate",
"description": "Sample rate of the generated audio in Hz.",
"default": "32000",
"type": "number",
"enum": [
8000,
16000,
22050,
24000,
32000,
44100
]
},
"as_bitrate": {
"title": "Bitrate",
"description": "Audio bitrate in bits per second.",
"default": "128000",
"type": "number",
"enum": [
32000,
64000,
128000,
256000
]
},
"as_channel": {
"title": "Channels",
"description": "Number of audio channels.",
"default": "1",
"type": "number",
"enum": [
1,
2
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
MiniMax's faster, more affordable TTS model with the same 37-language coverage and voice personas as Speech-02 HD at a lower cost.
Pricing: ~$0.06 / 1k chars
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvoice_idstringlanguage_booststringspeednumbervolnumberpitchnumberemotionstringenglish_normalizationbooleanoutput_formatstringtone_listarrayas_formatstringas_sample_ratenumberas_bitratenumberas_channelnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fminimax%2Fspeech-02-turbo",
"title": "MiniMax Speech-02 Turbo generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/minimax/speech-02-turbo.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/minimax/speech-02-turbo",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"voice_id": {
"title": "Voice",
"description": "MiniMax pre-trained voice persona.",
"default": "Wise_Woman",
"type": "string",
"enum": [
"Abbess",
"Calm_Woman",
"Casual_Guy",
"Decent_Boy",
"Deep_Voice_Man",
"Determined_Man",
"Elegant_Man",
"Exuberant_Girl",
"Friendly_Person",
"Imposing_Manner",
"Inspirational_girl",
"Lively_Girl",
"Lovely_Girl",
"Patient_Man",
"Sweet_Girl_2",
"Wise_Woman",
"Young_Knight"
]
},
"language_boost": {
"title": "Language Boost",
"description": "Boosts recognition accuracy for the selected language. Use Auto for mixed-language text.",
"default": "auto",
"type": "string",
"enum": [
"auto",
"English",
"Chinese",
"Chinese,Yue",
"Japanese",
"Korean",
"Spanish",
"French",
"German",
"Portuguese",
"Arabic",
"Hindi",
"Russian",
"Dutch",
"Turkish",
"Italian",
"Polish",
"Swedish",
"Ukrainian",
"Vietnamese",
"Indonesian",
"Thai",
"Romanian",
"Greek",
"Czech",
"Finnish",
"Danish",
"Hebrew",
"Malay",
"Slovak",
"Croatian",
"Hungarian",
"Norwegian",
"Bulgarian",
"Slovenian",
"Catalan",
"Afrikaans",
"Nynorsk"
]
},
"speed": {
"title": "Speed",
"description": "Speech speed multiplier (0.5–2.0).",
"default": 1,
"type": "number",
"minimum": 0.5,
"maximum": 2,
"multipleOf": 0.05
},
"vol": {
"title": "Volume",
"description": "Output volume level (0.01–10). 1 is the default.",
"default": 1,
"type": "number",
"minimum": 0.01,
"maximum": 10,
"multipleOf": 0.05
},
"pitch": {
"title": "Pitch",
"description": "Voice pitch shift in semitones (-12 to +12). 0 is unchanged.",
"default": 0,
"type": "number",
"minimum": -12,
"maximum": 12,
"multipleOf": 1
},
"emotion": {
"title": "Emotion",
"description": "Emotional tone of the generated speech.",
"default": "",
"type": "string",
"enum": [
"",
"happy",
"sad",
"angry",
"fearful",
"disgusted",
"surprised",
"neutral"
]
},
"english_normalization": {
"title": "English Normalization",
"description": "Improves number reading (e.g. dates, prices). Adds slight latency.",
"default": false,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "Format of the output content (non-streaming only).",
"default": "hex",
"type": "string",
"enum": [
"url",
"hex"
]
},
"tone_list": {
"title": "Tone List",
"description": "Pronunciation replacements in 'text/(pronunciation)' format. For Chinese, use tones 1–5.",
"type": "array",
"items": {
"type": "string"
}
},
"as_format": {
"title": "Audio Format",
"description": "Output audio encoding format.",
"default": "mp3",
"type": "string",
"enum": [
"mp3",
"pcm",
"flac"
]
},
"as_sample_rate": {
"title": "Sample Rate",
"description": "Sample rate of the generated audio in Hz.",
"default": "32000",
"type": "number",
"enum": [
8000,
16000,
22050,
24000,
32000,
44100
]
},
"as_bitrate": {
"title": "Bitrate",
"description": "Audio bitrate in bits per second.",
"default": "128000",
"type": "number",
"enum": [
32000,
64000,
128000,
256000
]
},
"as_channel": {
"title": "Channels",
"description": "Number of audio channels.",
"default": "1",
"type": "number",
"enum": [
1,
2
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Clone any voice from a 10+ second audio sample using MiniMax's voice cloning model.
Pricing: $1.50 per voice clone + $0.30/1k chars of preview text
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnoise_reductionbooleanneed_volume_normalizationbooleanmodelstringaccuracynumberaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fminimax%2Fvoice-clone",
"title": "MiniMax Voice Clone generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/minimax/voice-clone.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/minimax/voice-clone",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"noise_reduction": {
"title": "Noise Reduction",
"description": "Apply noise reduction to the input audio before cloning.",
"default": false,
"type": "boolean"
},
"need_volume_normalization": {
"title": "Volume Normalization",
"description": "Normalize the volume of the input audio before cloning.",
"default": false,
"type": "boolean"
},
"model": {
"title": "Preview Model",
"description": "TTS model used to generate the preview sample with the cloned voice.",
"default": "speech-02-hd",
"type": "string",
"enum": [
"speech-02-hd",
"speech-02-turbo",
"speech-01-hd",
"speech-01-turbo"
]
},
"accuracy": {
"title": "Accuracy",
"description": "Text validation accuracy threshold (0–1). Lower values are more permissive.",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.01
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"audio_url"
],
"additionalProperties": false
}
Extend an existing audio clip forward in time, preserving timbre, rhythm, and tail using Mirelo SFX v1.6.
Pricing: ~$0.01 / sec
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringambiencebooleandouble_outputbooleanappend_durationnumbernum_samplesnumberseedintegerupload_audio_formatstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=mirelo-ai%2Fsfx1.6%2Fextend-audio",
"title": "Mirelo SFX v1.6 (Audio Extend) generation request",
"description": "Request body accepted by POST /api/v1/generate for mirelo-ai/sfx1.6/extend-audio.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "mirelo-ai/sfx1.6/extend-audio",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"ambience": {
"title": "Ambience",
"description": "When true, run the extend+loop path for seamless tiling. When false, run a one-shot extension.",
"default": false,
"type": "boolean"
},
"double_output": {
"title": "Double Output",
"description": "Only used when ambience=true: concatenate the loop with itself for a 2x-length output.",
"default": false,
"type": "boolean"
},
"append_duration": {
"title": "Append Duration",
"description": "How many seconds to add after the prefix. Total output = prefix + append_duration, capped at 60s.",
"default": 10,
"type": "number",
"minimum": 1,
"maximum": 57,
"multipleOf": 1
},
"num_samples": {
"title": "Variations",
"description": "Number of variations to generate.",
"default": 1,
"type": "number",
"minimum": 1,
"maximum": 4,
"multipleOf": 1
},
"seed": {
"title": "Seed",
"description": "Seed for generation. -1 or None for random.",
"type": "integer",
"minimum": -1
},
"upload_audio_format": {
"title": "Format",
"description": "Audio file format of the returned files.",
"default": "wav",
"type": "string",
"enum": [
"wav",
"mp3",
"aac",
"flac"
]
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"audio_url"
],
"additionalProperties": false
}
Replace a section of an existing audio clip with AI-generated SFX that matches the surrounding context.
Pricing: ~$0.01 / sec
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringseedintegernum_samplesnumbersegment_start_snumbersegment_end_snumberupload_audio_formatstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=mirelo-ai%2Fsfx1.6%2Finpaint-audio",
"title": "Mirelo SFX v1.6 (Audio Inpaint) generation request",
"description": "Request body accepted by POST /api/v1/generate for mirelo-ai/sfx1.6/inpaint-audio.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "mirelo-ai/sfx1.6/inpaint-audio",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"seed": {
"title": "Seed",
"description": "Seed for generation. -1 or None for random.",
"type": "integer",
"minimum": -1
},
"num_samples": {
"title": "Variations",
"description": "Number of variations to generate.",
"default": 1,
"type": "number",
"minimum": 1,
"maximum": 4,
"multipleOf": 1
},
"segment_start_s": {
"title": "Inpaint Start (s)",
"description": "Start of the inpaint region in seconds. Must leave a 1s gap from clip start.",
"default": 1,
"type": "number",
"minimum": 1,
"maximum": 9,
"multipleOf": 0.5
},
"segment_end_s": {
"title": "Inpaint End (s)",
"description": "End of the inpaint region in seconds. The inpaint span (end − start) must be ≤ 8.0 s.",
"default": 5,
"type": "number",
"minimum": 2,
"maximum": 10,
"multipleOf": 0.5
},
"upload_audio_format": {
"title": "Format",
"description": "Audio file format of the returned files.",
"default": "wav",
"type": "string",
"enum": [
"wav",
"mp3",
"aac",
"flac"
]
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"segment_start_s",
"segment_end_s",
"audio_url"
],
"additionalProperties": false
}
Generate high-quality sound effects from text descriptions using Mirelo SFX v1.6. Supports looping ambience generation.
Pricing: ~$0.01 / sec
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringseedintegerambiencebooleandouble_outputbooleannum_samplesnumberdurationnumberupload_audio_formatstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=mirelo-ai%2Fsfx1.6%2Ftext-to-audio",
"title": "Mirelo SFX v1.6 (Text → Audio) generation request",
"description": "Request body accepted by POST /api/v1/generate for mirelo-ai/sfx1.6/text-to-audio.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "mirelo-ai/sfx1.6/text-to-audio",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"seed": {
"title": "Seed",
"description": "Seed for generation. -1 for random.",
"type": "integer",
"minimum": -1
},
"ambience": {
"title": "Ambience",
"description": "Generate a seamlessly loopable ambience tile (room tone, rain, drones, etc.) instead of a one-shot SFX.",
"default": false,
"type": "boolean"
},
"double_output": {
"title": "Double Output",
"description": "Only when Ambience is on: concatenate the loop with itself for a 2× length output.",
"default": false,
"type": "boolean"
},
"num_samples": {
"title": "Variations",
"description": "Number of variations to generate in one request.",
"default": 1,
"type": "number",
"minimum": 1,
"maximum": 4,
"multipleOf": 1
},
"duration": {
"title": "Duration",
"description": "Duration of the generated audio in seconds (0.1–60).",
"default": 10,
"type": "number",
"minimum": 0.1,
"maximum": 60,
"multipleOf": 0.1
},
"upload_audio_format": {
"title": "Format",
"description": "Audio file format of the returned files.",
"default": "wav",
"type": "string",
"enum": [
"wav",
"mp3",
"aac",
"flac"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
High-quality English TTS with natural human-like prosody and support for expressive emotion tags.
Pricing: ~$0.05 / 1k chars
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvoicestringtemperaturenumberrepetition_penaltynumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Forpheus-tts",
"title": "Orpheus TTS generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/orpheus-tts.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/orpheus-tts",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"voice": {
"title": "Voice",
"description": "Orpheus pre-trained voice character. Click to preview any voice.",
"default": "tara",
"type": "string",
"enum": [
"tara",
"leah",
"jess",
"leo",
"dan",
"mia",
"zac",
"zoe"
]
},
"temperature": {
"title": "Temperature",
"description": "Generation randomness. Lower = more stable, higher = more expressive.",
"default": 0.7,
"type": "number",
"minimum": 0,
"maximum": 2,
"multipleOf": 0.05
},
"repetition_penalty": {
"title": "Repetition Penalty",
"description": "Discourages repeated sounds or words. 1.1 is the API minimum for stable generation.",
"default": 1.2,
"type": "number",
"minimum": 1.1,
"maximum": 2,
"multipleOf": 0.05
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Alibaba's commercial Qwen 3 TTS Flash via DashScope — fast, natural multilingual speech with 17 preset voices and dialect support.
Pricing: ~$0.011 / 1k characters (DashScope)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvoicestringlanguage_typestring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=alibaba%2Fqwen3-tts-flash",
"title": "Qwen 3 TTS Flash (Alibaba) generation request",
"description": "Request body accepted by POST /api/v1/generate for alibaba/qwen3-tts-flash.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "alibaba/qwen3-tts-flash",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"voice": {
"title": "Voice",
"description": "DashScope preset voice. Dialect voices (Dylan, Jada, Sunny) speak regional Chinese.",
"default": "Cherry",
"type": "string",
"enum": [
"Cherry",
"Serena",
"Ethan",
"Chelsie",
"Dylan",
"Jada",
"Sunny",
"Eric",
"Ryan",
"Katerina",
"Elias",
"Jennifer",
"Marcus",
"Roy",
"Peter",
"Rocky",
"Kiki"
]
},
"language_type": {
"title": "Language",
"description": "Hinting the language improves pronunciation and prosody.",
"default": "Auto",
"type": "string",
"enum": [
"Auto",
"Chinese",
"English",
"Spanish",
"French",
"German",
"Italian",
"Japanese",
"Korean",
"Portuguese",
"Russian"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Design a custom voice from a text description and synthesize speech in that voice using Qwen 3 TTS.
Pricing: $0.09 / 1k chars (fal-published)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvoice_stylestringlanguagestringtemperaturenumberrepetition_penaltynumbertop_pnumbertop_knumbermax_new_tokensnumbersubtalker_dosamplebooleansubtalker_temperaturenumbersubtalker_top_knumbersubtalker_top_pnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fqwen-3-tts%2Fvoice-design%2F1.7b",
"title": "Qwen 3 TTS Voice Design (1.7B) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/qwen-3-tts/voice-design/1.7b.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/qwen-3-tts/voice-design/1.7b",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"voice_style": {
"title": "Voice Style",
"description": "Describe the voice characteristics — tone, accent, emotion, pace. e.g. 'Warm middle-aged woman, soft British accent, gentle pace'.",
"default": "",
"type": "string"
},
"language": {
"title": "Language",
"description": "The language of the voice to be designed.",
"default": "Auto",
"type": "string",
"enum": [
"Auto",
"English",
"Chinese",
"Spanish",
"French",
"German",
"Italian",
"Japanese",
"Korean",
"Portuguese",
"Russian"
]
},
"temperature": {
"title": "Temperature",
"description": "Speech randomness. Lower = more consistent, higher = more varied.",
"default": 0.9,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"repetition_penalty": {
"title": "Repetition Penalty",
"description": "Penalizes repeated sounds or audio patterns.",
"default": 1.05,
"type": "number",
"minimum": 0,
"maximum": 2,
"multipleOf": 0.05
},
"top_p": {
"title": "Top P",
"description": "Top-p sampling parameter.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"top_k": {
"title": "Top K",
"description": "Top-k sampling parameter.",
"default": 50,
"type": "number",
"minimum": 0,
"maximum": 200,
"multipleOf": 1
},
"max_new_tokens": {
"title": "Max New Tokens",
"description": "Maximum number of new codec tokens to generate.",
"default": 200,
"type": "number",
"minimum": 1,
"maximum": 8192,
"multipleOf": 1
},
"subtalker_dosample": {
"title": "Subtalker Dosample",
"description": "Sampling switch for the sub-talker.",
"default": true,
"type": "boolean"
},
"subtalker_temperature": {
"title": "Subtalker Temperature",
"description": "Temperature for sub-talker sampling.",
"default": 0.9,
"type": "number",
"minimum": 0,
"maximum": 1
},
"subtalker_top_k": {
"title": "Subtalker Top K",
"description": "Top-k for sub-talker sampling.",
"default": 50,
"type": "number",
"minimum": 0,
"multipleOf": 1
},
"subtalker_top_p": {
"title": "Subtalker Top P",
"description": "Top-p for sub-talker sampling.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Clone a voice and hear it speak in one step — upload a 10+ second recording, write what it should say, and Qwen 3 TTS answers in the cloned voice. The reusable speaker embedding is saved alongside the audio.
Pricing: 1 cr (clone) + $0.09/1k chars (speech)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringreference_textstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fqwen-3-tts%2Fclone-voice%2F1.7b",
"title": "Qwen 3 Voice Clone generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/qwen-3-tts/clone-voice/1.7b.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/qwen-3-tts/clone-voice/1.7b",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"reference_text": {
"title": "Reference Text",
"description": "Optional transcript of the reference recording — can improve clone quality.",
"default": "",
"type": "string"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"audio_url"
],
"additionalProperties": false
}
Isolate a specific sound from any audio file using a text prompt. SAM Audio returns both the isolated target track and the residual (everything else).
Pricing: ~$0.10 / min
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringpredict_spansbooleanreranking_candidatesnumberaccelerationstringmax_chunk_durationnumberchunk_overlapnumberoutput_formatstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fsam-audio%2Fseparate",
"title": "SAM Audio (Text Separation) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/sam-audio/separate.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/sam-audio/separate",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"predict_spans": {
"title": "Predict Spans",
"description": "Automatically predict temporal spans where the target sound occurs.",
"default": false,
"type": "boolean"
},
"reranking_candidates": {
"title": "Reranking Candidates",
"description": "Number of candidates to generate and rank. Higher improves quality but increases latency and cost.",
"default": 1,
"type": "number",
"minimum": 1,
"maximum": 7,
"multipleOf": 1
},
"acceleration": {
"title": "Acceleration",
"description": "Speed vs quality trade-off. Fast is quickest, Quality is most accurate.",
"default": "balanced",
"type": "string",
"enum": [
"fast",
"balanced",
"quality"
]
},
"max_chunk_duration": {
"title": "Max Chunk Duration (s)",
"description": "Maximum audio duration (s) to process in a single pass. Longer audio is chunked with overlap and blended.",
"default": 60,
"type": "number",
"minimum": 10,
"maximum": 60,
"multipleOf": 1
},
"chunk_overlap": {
"title": "Chunk Overlap (s)",
"description": "Overlap duration (s) between chunks for crossfade blending.",
"default": 5,
"type": "number",
"minimum": 0,
"maximum": 30,
"multipleOf": 1
},
"output_format": {
"title": "Output Format",
"description": "Output audio format.",
"default": "wav",
"type": "string",
"enum": [
"wav",
"mp3"
]
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"audio_url"
],
"additionalProperties": false
}
Generate high-quality stereo music and audio up to 380 seconds from text prompts using Stability AI's Stable Audio 3 Medium — trained on licensed data for commercial use.
Pricing: ~$0.04 / generation (any duration)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringdurationnumberoutput_formatstringbitratestringnegative_promptstringnum_inference_stepsnumberguidance_scalenumberseedintegerenable_prompt_expansionbooleanenable_safety_checkerboolean
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fstable-audio-3%2Fmedium%2Ftext-to-audio",
"title": "Stable Audio 3 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/stable-audio-3/medium/text-to-audio.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/stable-audio-3/medium/text-to-audio",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"duration": {
"title": "Duration (s)",
"description": "Duration of the generated audio in seconds (1–380).",
"default": 30,
"type": "number",
"minimum": 1,
"maximum": 380,
"multipleOf": 1
},
"output_format": {
"title": "Output Format",
"description": "Audio container/codec for the output file.",
"default": "mp3",
"type": "string",
"enum": [
"mp3",
"wav",
"flac",
"ogg",
"opus",
"m4a",
"aac"
]
},
"bitrate": {
"title": "Bitrate",
"description": "Bitrate for compressed output formats.",
"default": "192k",
"type": "string",
"enum": [
"192k",
"320k"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Describe what the audio should avoid.",
"default": "",
"type": "string"
},
"num_inference_steps": {
"title": "Inference Steps",
"description": "Number of diffusion steps. Higher = slightly better quality, slower.",
"default": 8,
"type": "number",
"minimum": 1,
"maximum": 100,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "How closely the model follows the prompt. Higher = more literal.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 25,
"multipleOf": 0.5
},
"seed": {
"title": "Seed",
"description": "Set a seed for reproducible results. Leave blank for random.",
"type": "integer"
},
"enable_prompt_expansion": {
"title": "Prompt Expansion",
"description": "Let the model expand short prompts into richer descriptions.",
"default": false,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Safety Checker",
"description": "Screen the output for unsafe content.",
"default": true,
"type": "boolean"
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
The full Stable Audio 3 Medium base checkpoint for more deliberate, higher-step music generation.
Pricing: ~$0.05 / generation
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringdurationnumbernegative_promptstringnum_inference_stepsnumberguidance_scalenumberoutput_formatstringbitratestringseedintegerenable_prompt_expansionbooleanenable_safety_checkerboolean
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fstable-audio-3%2Fmedium%2Fbase%2Ftext-to-audio",
"title": "Stable Audio 3 Base generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/stable-audio-3/medium/base/text-to-audio.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/stable-audio-3/medium/base/text-to-audio",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"duration": {
"title": "Duration (s)",
"default": 30,
"type": "number",
"minimum": 1,
"maximum": 380,
"multipleOf": 1
},
"negative_prompt": {
"title": "Avoid",
"default": "",
"type": "string"
},
"num_inference_steps": {
"title": "Inference Steps",
"default": 50,
"type": "number",
"minimum": 1,
"maximum": 100,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance",
"default": 7,
"type": "number",
"minimum": 0,
"maximum": 25,
"multipleOf": 0.5
},
"output_format": {
"title": "Output Format",
"default": "mp3",
"type": "string",
"enum": [
"mp3",
"wav",
"flac",
"ogg",
"opus",
"m4a",
"aac"
]
},
"bitrate": {
"title": "Bitrate",
"default": "192k",
"type": "string",
"enum": [
"192k",
"320k"
]
},
"seed": {
"title": "Seed",
"type": "integer"
},
"enable_prompt_expansion": {
"title": "Prompt Expansion",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Higher-step continuation before or after an existing track.
Pricing: ~$0.05 / generation
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringextend_seconds_beforenumberextend_seconds_afternumbernegative_promptstringnum_inference_stepsnumberguidance_scalenumberoutput_formatstringbitratestringseedintegerenable_prompt_expansionbooleanenable_safety_checkerbooleanaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fstable-audio-3%2Fmedium%2Fbase%2Faudio-outpainting",
"title": "Stable Audio 3 Base Extend generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/stable-audio-3/medium/base/audio-outpainting.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/stable-audio-3/medium/base/audio-outpainting",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"extend_seconds_before": {
"title": "Add Before (s)",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 379,
"multipleOf": 1
},
"extend_seconds_after": {
"title": "Add After (s)",
"default": 30,
"type": "number",
"minimum": 0,
"maximum": 379,
"multipleOf": 1
},
"negative_prompt": {
"title": "Avoid",
"default": "",
"type": "string"
},
"num_inference_steps": {
"title": "Inference Steps",
"default": 50,
"type": "number",
"minimum": 1,
"maximum": 100,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance",
"default": 7,
"type": "number",
"minimum": 0,
"maximum": 25,
"multipleOf": 0.5
},
"output_format": {
"title": "Output Format",
"default": "mp3",
"type": "string",
"enum": [
"mp3",
"wav",
"flac",
"ogg",
"opus",
"m4a",
"aac"
]
},
"bitrate": {
"title": "Bitrate",
"default": "192k",
"type": "string",
"enum": [
"192k",
"320k"
]
},
"seed": {
"title": "Seed",
"type": "integer"
},
"enable_prompt_expansion": {
"title": "Prompt Expansion",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"audio_url"
],
"additionalProperties": false
}
Higher-step replacement of a selected audio section.
Pricing: $0.0537 / generation
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringmask_start_secondsnumbermask_end_secondsnumbernegative_promptstringnum_inference_stepsnumberguidance_scalenumberoutput_formatstringbitratestringseedintegerenable_prompt_expansionbooleanenable_safety_checkerbooleanaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fstable-audio-3%2Fmedium%2Fbase%2Faudio-inpainting",
"title": "Stable Audio 3 Base Inpaint generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/stable-audio-3/medium/base/audio-inpainting.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/stable-audio-3/medium/base/audio-inpainting",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"mask_start_seconds": {
"title": "Start (s)",
"default": 5,
"type": "number",
"minimum": 0,
"maximum": 379,
"multipleOf": 0.1
},
"mask_end_seconds": {
"title": "End (s)",
"default": 10,
"type": "number",
"minimum": 0.1,
"maximum": 380,
"multipleOf": 0.1
},
"negative_prompt": {
"title": "Avoid",
"default": "",
"type": "string"
},
"num_inference_steps": {
"title": "Inference Steps",
"default": 50,
"type": "number",
"minimum": 1,
"maximum": 100,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance",
"default": 7,
"type": "number",
"minimum": 0,
"maximum": 25,
"multipleOf": 0.5
},
"output_format": {
"title": "Output Format",
"default": "mp3",
"type": "string",
"enum": [
"mp3",
"wav",
"flac",
"ogg",
"opus",
"m4a",
"aac"
]
},
"bitrate": {
"title": "Bitrate",
"default": "192k",
"type": "string",
"enum": [
"192k",
"320k"
]
},
"seed": {
"title": "Seed",
"type": "integer"
},
"enable_prompt_expansion": {
"title": "Prompt Expansion",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"mask_start_seconds",
"mask_end_seconds",
"audio_url"
],
"additionalProperties": false
}
Higher-step Stable Audio 3 restyling with detailed prompt control.
Pricing: $0.0523 / generation
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringdurationnumberinit_noise_levelnumbernegative_promptstringnum_inference_stepsnumberguidance_scalenumberoutput_formatstringbitratestringseedintegerenable_prompt_expansionbooleanenable_safety_checkerbooleanaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fstable-audio-3%2Fmedium%2Fbase%2Faudio-to-audio",
"title": "Stable Audio 3 Base Restyle generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/stable-audio-3/medium/base/audio-to-audio.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/stable-audio-3/medium/base/audio-to-audio",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"duration": {
"title": "Duration (s)",
"default": 30,
"type": "number",
"minimum": 1,
"maximum": 380,
"multipleOf": 1
},
"init_noise_level": {
"title": "Transformation",
"default": 0.55,
"type": "number",
"minimum": 0.1,
"maximum": 1,
"multipleOf": 0.05
},
"negative_prompt": {
"title": "Avoid",
"default": "",
"type": "string"
},
"num_inference_steps": {
"title": "Inference Steps",
"default": 50,
"type": "number",
"minimum": 1,
"maximum": 100,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance",
"default": 7,
"type": "number",
"minimum": 0,
"maximum": 25,
"multipleOf": 0.5
},
"output_format": {
"title": "Output Format",
"default": "mp3",
"type": "string",
"enum": [
"mp3",
"wav",
"flac",
"ogg",
"opus",
"m4a",
"aac"
]
},
"bitrate": {
"title": "Bitrate",
"default": "192k",
"type": "string",
"enum": [
"192k",
"320k"
]
},
"seed": {
"title": "Seed",
"type": "integer"
},
"enable_prompt_expansion": {
"title": "Prompt Expansion",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"audio_url"
],
"additionalProperties": false
}
Continue a track before or after its current boundaries while preserving its musical identity.
Pricing: ~$0.04 / generation
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringextend_seconds_beforenumberextend_seconds_afternumbernegative_promptstringnum_inference_stepsnumberguidance_scalenumberoutput_formatstringbitratestringseedintegerenable_prompt_expansionbooleanenable_safety_checkerbooleanaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fstable-audio-3%2Fmedium%2Faudio-outpainting",
"title": "Stable Audio 3 Extend generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/stable-audio-3/medium/audio-outpainting.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/stable-audio-3/medium/audio-outpainting",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"extend_seconds_before": {
"title": "Add Before (s)",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 379,
"multipleOf": 1
},
"extend_seconds_after": {
"title": "Add After (s)",
"default": 30,
"type": "number",
"minimum": 0,
"maximum": 379,
"multipleOf": 1
},
"negative_prompt": {
"title": "Avoid",
"default": "",
"type": "string"
},
"num_inference_steps": {
"title": "Inference Steps",
"default": 8,
"type": "number",
"minimum": 1,
"maximum": 100,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 25,
"multipleOf": 0.5
},
"output_format": {
"title": "Output Format",
"default": "mp3",
"type": "string",
"enum": [
"mp3",
"wav",
"flac",
"ogg",
"opus",
"m4a",
"aac"
]
},
"bitrate": {
"title": "Bitrate",
"default": "192k",
"type": "string",
"enum": [
"192k",
"320k"
]
},
"seed": {
"title": "Seed",
"type": "integer"
},
"enable_prompt_expansion": {
"title": "Prompt Expansion",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"audio_url"
],
"additionalProperties": false
}
Replace a selected time range while matching the surrounding track.
Pricing: ~$0.04 / generation
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringmask_start_secondsnumbermask_end_secondsnumbernegative_promptstringnum_inference_stepsnumberguidance_scalenumberoutput_formatstringbitratestringseedintegerenable_prompt_expansionbooleanenable_safety_checkerbooleanaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fstable-audio-3%2Fmedium%2Faudio-inpainting",
"title": "Stable Audio 3 Inpaint generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/stable-audio-3/medium/audio-inpainting.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/stable-audio-3/medium/audio-inpainting",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"mask_start_seconds": {
"title": "Start (s)",
"default": 5,
"type": "number",
"minimum": 0,
"maximum": 379,
"multipleOf": 0.1
},
"mask_end_seconds": {
"title": "End (s)",
"default": 10,
"type": "number",
"minimum": 0.1,
"maximum": 380,
"multipleOf": 0.1
},
"negative_prompt": {
"title": "Avoid",
"default": "",
"type": "string"
},
"num_inference_steps": {
"title": "Inference Steps",
"default": 8,
"type": "number",
"minimum": 1,
"maximum": 100,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 25,
"multipleOf": 0.5
},
"output_format": {
"title": "Output Format",
"default": "mp3",
"type": "string",
"enum": [
"mp3",
"wav",
"flac",
"ogg",
"opus",
"m4a",
"aac"
]
},
"bitrate": {
"title": "Bitrate",
"default": "192k",
"type": "string",
"enum": [
"192k",
"320k"
]
},
"seed": {
"title": "Seed",
"type": "integer"
},
"enable_prompt_expansion": {
"title": "Prompt Expansion",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"mask_start_seconds",
"mask_end_seconds",
"audio_url"
],
"additionalProperties": false
}
Transform an uploaded track while preserving as much of its structure as you choose.
Pricing: ~$0.04 / generation
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringdurationnumberinit_noise_levelnumbernegative_promptstringnum_inference_stepsnumberguidance_scalenumberoutput_formatstringbitratestringseedintegerenable_prompt_expansionbooleanenable_safety_checkerbooleanaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fstable-audio-3%2Fmedium%2Faudio-to-audio",
"title": "Stable Audio 3 Restyle generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/stable-audio-3/medium/audio-to-audio.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/stable-audio-3/medium/audio-to-audio",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"duration": {
"title": "Duration (s)",
"default": 30,
"type": "number",
"minimum": 1,
"maximum": 380,
"multipleOf": 1
},
"init_noise_level": {
"title": "Transformation",
"description": "Lower values preserve more of the source; higher values make a larger change.",
"default": 0.55,
"type": "number",
"minimum": 0.1,
"maximum": 1,
"multipleOf": 0.05
},
"negative_prompt": {
"title": "Avoid",
"default": "",
"type": "string"
},
"num_inference_steps": {
"title": "Inference Steps",
"default": 8,
"type": "number",
"minimum": 1,
"maximum": 100,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 25,
"multipleOf": 0.5
},
"output_format": {
"title": "Output Format",
"default": "mp3",
"type": "string",
"enum": [
"mp3",
"wav",
"flac",
"ogg",
"opus",
"m4a",
"aac"
]
},
"bitrate": {
"title": "Bitrate",
"default": "192k",
"type": "string",
"enum": [
"192k",
"320k"
]
},
"seed": {
"title": "Seed",
"type": "integer"
},
"enable_prompt_expansion": {
"title": "Prompt Expansion",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"audio_url"
],
"additionalProperties": false
}
Suno v4 music generation (fast, lower cost) — full songs with vocals or instrumental, from a text description or your own lyrics + style. Two variations per run.
Pricing: Two songs per generation (Suno API). Confirm rate against your sunoapi.org plan.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringinstrumentalbooleancustom_modebooleanstylestringtitlestringnegative_tagsstringvocal_genderstringpersona_idstringpersona_modelstringstyle_weightnumberweirdness_constraintnumberaudio_weightnumberaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=suno%2Fv4%2Fmusic",
"title": "Suno v4 generation request",
"description": "Request body accepted by POST /api/v1/generate for suno/v4/music.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "suno/v4/music",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"instrumental": {
"title": "Instrumental",
"description": "Generate music with no vocals.",
"default": false,
"type": "boolean"
},
"custom_mode": {
"title": "Custom Mode",
"description": "Off: the prompt is a song description. On: the prompt is your lyrics — also set Style and Title.",
"default": false,
"type": "boolean"
},
"style": {
"title": "Style",
"description": "Custom mode only: genre/style tags, e.g. 'lofi hip hop, mellow, rainy'. Max 200 chars.",
"default": "",
"type": "string"
},
"title": {
"title": "Title",
"description": "Custom mode only: the song title.",
"default": "",
"type": "string"
},
"negative_tags": {
"title": "Exclude Styles",
"description": "Styles to avoid, e.g. 'heavy metal, screaming'.",
"default": "",
"type": "string"
},
"vocal_gender": {
"title": "Vocal Gender",
"description": "Preferred lead vocal gender.",
"default": "",
"type": "string",
"enum": [
"",
"m",
"f"
]
},
"persona_id": {
"title": "Persona ID",
"description": "Optional persona or voice ID from your Suno account. Pair with Persona Model.",
"default": "",
"type": "string"
},
"persona_model": {
"title": "Persona Model",
"description": "Persona type: style_persona clones style, voice_persona clones the voice (requires V5 or V5.5).",
"default": "style_persona",
"type": "string",
"enum": [
"style_persona",
"voice_persona"
]
},
"style_weight": {
"title": "Style Weight",
"description": "How strongly to follow the style (0–1).",
"default": 0.65,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.01
},
"weirdness_constraint": {
"title": "Weirdness",
"description": "Creativity/experimentation (0–1).",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.01
},
"audio_weight": {
"title": "Audio Weight",
"description": "Adherence to any reference audio (0–1). Leave at 0 unless you have reference audio.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.01
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id"
],
"additionalProperties": false
}
Suno v4.5 music generation (balanced quality and speed) — full songs with vocals or instrumental, from a text description or your own lyrics + style. Two variations per run.
Pricing: Two songs per generation (Suno API). Confirm rate against your sunoapi.org plan.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringinstrumentalbooleancustom_modebooleanstylestringtitlestringnegative_tagsstringvocal_genderstringpersona_idstringpersona_modelstringstyle_weightnumberweirdness_constraintnumberaudio_weightnumberaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=suno%2Fv4.5%2Fmusic",
"title": "Suno v4.5 generation request",
"description": "Request body accepted by POST /api/v1/generate for suno/v4.5/music.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "suno/v4.5/music",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"instrumental": {
"title": "Instrumental",
"description": "Generate music with no vocals.",
"default": false,
"type": "boolean"
},
"custom_mode": {
"title": "Custom Mode",
"description": "Off: the prompt is a song description. On: the prompt is your lyrics — also set Style and Title.",
"default": false,
"type": "boolean"
},
"style": {
"title": "Style",
"description": "Custom mode only: genre/style tags, e.g. 'lofi hip hop, mellow, rainy'. Max 1000 chars.",
"default": "",
"type": "string"
},
"title": {
"title": "Title",
"description": "Custom mode only: the song title.",
"default": "",
"type": "string"
},
"negative_tags": {
"title": "Exclude Styles",
"description": "Styles to avoid, e.g. 'heavy metal, screaming'.",
"default": "",
"type": "string"
},
"vocal_gender": {
"title": "Vocal Gender",
"description": "Preferred lead vocal gender.",
"default": "",
"type": "string",
"enum": [
"",
"m",
"f"
]
},
"persona_id": {
"title": "Persona ID",
"description": "Optional persona or voice ID from your Suno account. Pair with Persona Model.",
"default": "",
"type": "string"
},
"persona_model": {
"title": "Persona Model",
"description": "Persona type: style_persona clones style, voice_persona clones the voice (requires V5 or V5.5).",
"default": "style_persona",
"type": "string",
"enum": [
"style_persona",
"voice_persona"
]
},
"style_weight": {
"title": "Style Weight",
"description": "How strongly to follow the style (0–1).",
"default": 0.65,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.01
},
"weirdness_constraint": {
"title": "Weirdness",
"description": "Creativity/experimentation (0–1).",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.01
},
"audio_weight": {
"title": "Audio Weight",
"description": "Adherence to any reference audio (0–1). Leave at 0 unless you have reference audio.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.01
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id"
],
"additionalProperties": false
}
Suno v4.5 All music generation (stronger full-song structure) — full songs with vocals or instrumental, from a text description or your own lyrics + style. Two variations per run.
Pricing: Two songs per generation (Suno API). Confirm rate against your sunoapi.org plan.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringinstrumentalbooleancustom_modebooleanstylestringtitlestringnegative_tagsstringvocal_genderstringpersona_idstringpersona_modelstringstyle_weightnumberweirdness_constraintnumberaudio_weightnumberaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=suno%2Fv4.5-all%2Fmusic",
"title": "Suno v4.5 All generation request",
"description": "Request body accepted by POST /api/v1/generate for suno/v4.5-all/music.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "suno/v4.5-all/music",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"instrumental": {
"title": "Instrumental",
"description": "Generate music with no vocals.",
"default": false,
"type": "boolean"
},
"custom_mode": {
"title": "Custom Mode",
"description": "Off: the prompt is a song description. On: the prompt is your lyrics — also set Style and Title.",
"default": false,
"type": "boolean"
},
"style": {
"title": "Style",
"description": "Custom mode only: genre/style tags, e.g. 'lofi hip hop, mellow, rainy'. Max 1000 chars.",
"default": "",
"type": "string"
},
"title": {
"title": "Title",
"description": "Custom mode only: the song title.",
"default": "",
"type": "string"
},
"negative_tags": {
"title": "Exclude Styles",
"description": "Styles to avoid, e.g. 'heavy metal, screaming'.",
"default": "",
"type": "string"
},
"vocal_gender": {
"title": "Vocal Gender",
"description": "Preferred lead vocal gender.",
"default": "",
"type": "string",
"enum": [
"",
"m",
"f"
]
},
"persona_id": {
"title": "Persona ID",
"description": "Optional persona or voice ID from your Suno account. Pair with Persona Model.",
"default": "",
"type": "string"
},
"persona_model": {
"title": "Persona Model",
"description": "Persona type: style_persona clones style, voice_persona clones the voice (requires V5 or V5.5).",
"default": "style_persona",
"type": "string",
"enum": [
"style_persona",
"voice_persona"
]
},
"style_weight": {
"title": "Style Weight",
"description": "How strongly to follow the style (0–1).",
"default": 0.65,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.01
},
"weirdness_constraint": {
"title": "Weirdness",
"description": "Creativity/experimentation (0–1).",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.01
},
"audio_weight": {
"title": "Audio Weight",
"description": "Adherence to any reference audio (0–1). Leave at 0 unless you have reference audio.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.01
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id"
],
"additionalProperties": false
}
Suno v4.5+ music generation (richer sound, longer songs) — full songs with vocals or instrumental, from a text description or your own lyrics + style. Two variations per run.
Pricing: Two songs per generation (Suno API). Confirm rate against your sunoapi.org plan.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringinstrumentalbooleancustom_modebooleanstylestringtitlestringnegative_tagsstringvocal_genderstringpersona_idstringpersona_modelstringstyle_weightnumberweirdness_constraintnumberaudio_weightnumberaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=suno%2Fv4.5-plus%2Fmusic",
"title": "Suno v4.5+ generation request",
"description": "Request body accepted by POST /api/v1/generate for suno/v4.5-plus/music.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "suno/v4.5-plus/music",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"instrumental": {
"title": "Instrumental",
"description": "Generate music with no vocals.",
"default": false,
"type": "boolean"
},
"custom_mode": {
"title": "Custom Mode",
"description": "Off: the prompt is a song description. On: the prompt is your lyrics — also set Style and Title.",
"default": false,
"type": "boolean"
},
"style": {
"title": "Style",
"description": "Custom mode only: genre/style tags, e.g. 'lofi hip hop, mellow, rainy'. Max 1000 chars.",
"default": "",
"type": "string"
},
"title": {
"title": "Title",
"description": "Custom mode only: the song title.",
"default": "",
"type": "string"
},
"negative_tags": {
"title": "Exclude Styles",
"description": "Styles to avoid, e.g. 'heavy metal, screaming'.",
"default": "",
"type": "string"
},
"vocal_gender": {
"title": "Vocal Gender",
"description": "Preferred lead vocal gender.",
"default": "",
"type": "string",
"enum": [
"",
"m",
"f"
]
},
"persona_id": {
"title": "Persona ID",
"description": "Optional persona or voice ID from your Suno account. Pair with Persona Model.",
"default": "",
"type": "string"
},
"persona_model": {
"title": "Persona Model",
"description": "Persona type: style_persona clones style, voice_persona clones the voice (requires V5 or V5.5).",
"default": "style_persona",
"type": "string",
"enum": [
"style_persona",
"voice_persona"
]
},
"style_weight": {
"title": "Style Weight",
"description": "How strongly to follow the style (0–1).",
"default": 0.65,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.01
},
"weirdness_constraint": {
"title": "Weirdness",
"description": "Creativity/experimentation (0–1).",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.01
},
"audio_weight": {
"title": "Audio Weight",
"description": "Adherence to any reference audio (0–1). Leave at 0 unless you have reference audio.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.01
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id"
],
"additionalProperties": false
}
Suno v5 music generation (newest flagship, highest fidelity) — full songs with vocals or instrumental, from a text description or your own lyrics + style. Two variations per run.
Pricing: Two songs per generation (Suno API). Confirm rate against your sunoapi.org plan.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringinstrumentalbooleancustom_modebooleanstylestringtitlestringnegative_tagsstringvocal_genderstringpersona_idstringpersona_modelstringstyle_weightnumberweirdness_constraintnumberaudio_weightnumberaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=suno%2Fv5%2Fmusic",
"title": "Suno v5 generation request",
"description": "Request body accepted by POST /api/v1/generate for suno/v5/music.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "suno/v5/music",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"instrumental": {
"title": "Instrumental",
"description": "Generate music with no vocals.",
"default": false,
"type": "boolean"
},
"custom_mode": {
"title": "Custom Mode",
"description": "Off: the prompt is a song description. On: the prompt is your lyrics — also set Style and Title.",
"default": false,
"type": "boolean"
},
"style": {
"title": "Style",
"description": "Custom mode only: genre/style tags, e.g. 'lofi hip hop, mellow, rainy'. Max 1000 chars.",
"default": "",
"type": "string"
},
"title": {
"title": "Title",
"description": "Custom mode only: the song title.",
"default": "",
"type": "string"
},
"negative_tags": {
"title": "Exclude Styles",
"description": "Styles to avoid, e.g. 'heavy metal, screaming'.",
"default": "",
"type": "string"
},
"vocal_gender": {
"title": "Vocal Gender",
"description": "Preferred lead vocal gender.",
"default": "",
"type": "string",
"enum": [
"",
"m",
"f"
]
},
"persona_id": {
"title": "Persona ID",
"description": "Optional persona or voice ID from your Suno account. Pair with Persona Model.",
"default": "",
"type": "string"
},
"persona_model": {
"title": "Persona Model",
"description": "Persona type: style_persona clones style, voice_persona clones the voice (requires V5 or V5.5).",
"default": "style_persona",
"type": "string",
"enum": [
"style_persona",
"voice_persona"
]
},
"style_weight": {
"title": "Style Weight",
"description": "How strongly to follow the style (0–1).",
"default": 0.65,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.01
},
"weirdness_constraint": {
"title": "Weirdness",
"description": "Creativity/experimentation (0–1).",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.01
},
"audio_weight": {
"title": "Audio Weight",
"description": "Adherence to any reference audio (0–1). Leave at 0 unless you have reference audio.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.01
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id"
],
"additionalProperties": false
}
Suno v5.5 music generation (latest, highest fidelity + voice_persona) — full songs with vocals or instrumental, from a text description or your own lyrics + style. Two variations per run.
Pricing: Two songs per generation (Suno API). Confirm rate against your sunoapi.org plan.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringinstrumentalbooleancustom_modebooleanstylestringtitlestringnegative_tagsstringvocal_genderstringpersona_idstringpersona_modelstringstyle_weightnumberweirdness_constraintnumberaudio_weightnumberaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=suno%2Fv5.5%2Fmusic",
"title": "Suno v5.5 generation request",
"description": "Request body accepted by POST /api/v1/generate for suno/v5.5/music.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "suno/v5.5/music",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"instrumental": {
"title": "Instrumental",
"description": "Generate music with no vocals.",
"default": false,
"type": "boolean"
},
"custom_mode": {
"title": "Custom Mode",
"description": "Off: the prompt is a song description. On: the prompt is your lyrics — also set Style and Title.",
"default": false,
"type": "boolean"
},
"style": {
"title": "Style",
"description": "Custom mode only: genre/style tags, e.g. 'lofi hip hop, mellow, rainy'. Max 1000 chars.",
"default": "",
"type": "string"
},
"title": {
"title": "Title",
"description": "Custom mode only: the song title.",
"default": "",
"type": "string"
},
"negative_tags": {
"title": "Exclude Styles",
"description": "Styles to avoid, e.g. 'heavy metal, screaming'.",
"default": "",
"type": "string"
},
"vocal_gender": {
"title": "Vocal Gender",
"description": "Preferred lead vocal gender.",
"default": "",
"type": "string",
"enum": [
"",
"m",
"f"
]
},
"persona_id": {
"title": "Persona ID",
"description": "Optional persona or voice ID from your Suno account. Pair with Persona Model.",
"default": "",
"type": "string"
},
"persona_model": {
"title": "Persona Model",
"description": "Persona type: style_persona clones style, voice_persona clones the voice (requires V5 or V5.5).",
"default": "style_persona",
"type": "string",
"enum": [
"style_persona",
"voice_persona"
]
},
"style_weight": {
"title": "Style Weight",
"description": "How strongly to follow the style (0–1).",
"default": 0.65,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.01
},
"weirdness_constraint": {
"title": "Weirdness",
"description": "Creativity/experimentation (0–1).",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.01
},
"audio_weight": {
"title": "Audio Weight",
"description": "Adherence to any reference audio (0–1). Leave at 0 unless you have reference audio.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.01
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id"
],
"additionalProperties": false
}
OpenAI Whisper large-v3 for high-accuracy transcription and translation across 99 languages with speaker diarization.
Pricing: ~$0.006 / min
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringbatch_sizenumberdiarizebooleannum_speakersnumberchunk_levelstringtaskstringlanguagestringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fwhisper",
"title": "Whisper (Transcribe) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/whisper.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/whisper",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"batch_size": {
"title": "Batch Size",
"description": "Number of parallel audio chunks processed at once. Higher values are faster but use more memory.",
"default": 64,
"type": "number",
"minimum": 1,
"maximum": 64,
"multipleOf": 1
},
"diarize": {
"title": "Diarize",
"description": "Whether to diarize the audio file. Defaults to false. Setting to true will add costs proportional to diarization inference time.",
"default": false,
"type": "boolean"
},
"num_speakers": {
"title": "Num Speakers",
"description": "Number of speakers in the audio file. Defaults to null. If not provided, the number of speakers will be automatically detected.",
"type": "number",
"minimum": 1,
"multipleOf": 1
},
"chunk_level": {
"title": "Chunk Level",
"description": "Level of the chunks to return. Either none, segment or word.",
"default": "segment",
"type": "string",
"enum": [
"none",
"segment",
"word"
]
},
"task": {
"title": "Task",
"description": "Task to perform on the audio file. Either transcribe or translate.",
"default": "transcribe",
"type": "string",
"enum": [
"transcribe",
"translate"
]
},
"language": {
"title": "Language",
"description": "Language of the audio file. Leave on Auto-detect unless you know the source language.",
"default": "",
"type": "string",
"enum": [
"",
"af",
"am",
"ar",
"as",
"az",
"ba",
"be",
"bg",
"bn",
"bo",
"br",
"bs",
"ca",
"cs",
"cy",
"da",
"de",
"el",
"en",
"es",
"et",
"eu",
"fa",
"fi",
"fo",
"fr",
"gl",
"gu",
"ha",
"haw",
"he",
"hi",
"hr",
"ht",
"hu",
"hy",
"id",
"is",
"it",
"ja",
"jw",
"ka",
"kk",
"km",
"kn",
"ko",
"la",
"lb",
"ln",
"lo",
"lt",
"lv",
"mg",
"mi",
"mk",
"ml",
"mn",
"mr",
"ms",
"mt",
"my",
"ne",
"nl",
"nn",
"no",
"oc",
"pa",
"pl",
"ps",
"pt",
"ro",
"ru",
"sa",
"sd",
"si",
"sk",
"sl",
"sn",
"so",
"sq",
"sr",
"su",
"sv",
"sw",
"ta",
"te",
"tg",
"th",
"tk",
"tl",
"tr",
"tt",
"uk",
"ur",
"uz",
"vi",
"yi",
"yo",
"zh"
]
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"audio_url"
],
"additionalProperties": false
}
AI Retoucher — smooths skin, enhances facial details, and professionally retouches portraits.
Pricing: ~$0.004 / image (compute-second estimate)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringseedintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fretoucher",
"title": "AI Retoucher generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/retoucher.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/retoucher",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"seed": {
"title": "Seed",
"description": "Seed for reproducibility. Different seeds will make slightly different results.",
"type": "integer"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Aura Flow — open-source flow-matching model that generates vibrant, detailed images at fixed 1024×1024.
Pricing: ~$0.007 / image
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringexpand_promptbooleannum_inference_stepsnumberguidance_scalenumberseedintegernum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Faura-flow",
"title": "Aura Flow generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/aura-flow.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/aura-flow",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "Whether to perform prompt expansion (recommended)",
"default": true,
"type": "boolean"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to take.",
"default": 50,
"type": "number",
"minimum": 20,
"maximum": 50,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Classifier-free guidance scale. Higher values follow the prompt more strictly.",
"default": 3.5,
"type": "number",
"minimum": 0,
"maximum": 20,
"multipleOf": 0.5
},
"seed": {
"title": "Seed",
"description": "The seed to use for generating images. Leave blank for random.",
"type": "integer"
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 2
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
AuraSR — fast 4x upscaler with sharp, detailed enhancement and optional tile overlap.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringupscale_factornumberoverlapping_tilesbooleancheckpointstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Faura-sr",
"title": "AuraSR generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/aura-sr.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/aura-sr",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"upscale_factor": {
"title": "Upscale Factor",
"description": "Upscaling factor. More coming soon.",
"default": 4,
"type": "number"
},
"overlapping_tiles": {
"title": "Overlapping Tiles",
"description": "Whether to use overlapping tiles for upscaling. Setting this to true helps remove seams but doubles the inference time.",
"default": false,
"type": "boolean"
},
"checkpoint": {
"title": "Checkpoint",
"description": "Checkpoint to use for upscaling. More coming soon.",
"default": "v1",
"type": "string",
"enum": [
"v1",
"v2"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Bernini-R image editing — instruction-based edits from ByteDance's unified generation/editing model, preserving everything the instruction doesn't touch.
Pricing: $0.03 / output megapixel, ceil'd (fal-published) — 1MP at ≤848px, 2MP ($0.06) at 1280px
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringnum_inference_stepsnumbermax_image_sizenumberenable_prompt_expansionbooleanseedintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fbernini-r%2Fedit-image",
"title": "Bernini-R Edit Image generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/bernini-r/edit-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/bernini-r/edit-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Leave blank to keep the model's tuned Wan2.2 default negative prompt.",
"default": "",
"type": "string"
},
"num_inference_steps": {
"title": "Steps",
"description": "Number of denoising steps.",
"default": 30,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"max_image_size": {
"title": "Output Size (long edge)",
"description": "Long-edge cap in pixels — output follows the source aspect ratio up to this size. Billing tier follows this value.",
"default": "848",
"type": "number",
"enum": [
576,
848,
1280
]
},
"enable_prompt_expansion": {
"title": "Prompt Expansion",
"description": "Rewrite the instruction with an LLM before editing. The model is tuned on enhanced prompts.",
"default": false,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Seed for reproducibility. Random when omitted.",
"type": "integer"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
BiRefNet V2 — improved background removal with additional model variants including 2K and dynamic resolution support.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringmodelstringoperating_resolutionstringoutput_formatstringrefine_foregroundbooleanmask_onlybooleanoutput_maskbooleanreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fbirefnet%2Fv2",
"title": "BiRefNet V2 (BG Remove) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/birefnet/v2.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/birefnet/v2",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"model": {
"title": "Model",
"description": "Model to use for background removal.",
"default": "General Use (Light)",
"type": "string",
"enum": [
"General Use (Light)",
"General Use (Light 2K)",
"General Use (Heavy)",
"Matting",
"Portrait",
"General Use (Dynamic)"
]
},
"operating_resolution": {
"title": "Operating Resolution",
"description": "The resolution to operate on. 2304x2304 is only available with General Use (Dynamic).",
"default": "1024x1024",
"type": "string",
"enum": [
"1024x1024",
"2048x2048",
"2304x2304"
]
},
"output_format": {
"title": "Output Format",
"description": "The format of the output image.",
"default": "png",
"type": "string",
"enum": [
"webp",
"png",
"gif"
]
},
"refine_foreground": {
"title": "Refine Foreground",
"description": "Whether to refine the foreground using the estimated mask.",
"default": true,
"type": "boolean"
},
"mask_only": {
"title": "Mask Only",
"description": "Return only the segmentation mask without applying it to the image. Skips foreground refinement.",
"default": false,
"type": "boolean"
},
"output_mask": {
"title": "Output Mask",
"description": "Whether to output the mask used to remove the background.",
"default": false,
"type": "boolean"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Boogu-Image — bilingual (English/Chinese) instruction-following text-to-image generation with up to 2K native output.
Pricing: $0.04 / output megapixel × images (fal-published) — 1MP ≈ 10cr, 2K ≈ 40cr
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringnum_inference_stepsnumberguidance_scalenumbercfg_range_startnumbercfg_range_endnumberenable_safety_checkerbooleanseedintegeraspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fboogu-image",
"title": "Boogu Image generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/boogu-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/boogu-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Describes what should NOT appear in the image. Leave empty to disable negative guidance.",
"default": "",
"type": "string"
},
"num_inference_steps": {
"title": "Steps",
"description": "Number of denoising steps to perform.",
"default": 30,
"type": "number",
"minimum": 20,
"maximum": 50,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "How closely generation follows the text instruction. 1.0 disables text CFG.",
"default": 4,
"type": "number",
"minimum": 1,
"maximum": 8,
"multipleOf": 0.1
},
"cfg_range_start": {
"title": "CFG Range Start",
"description": "Start of the timestep fraction over which CFG is applied.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"cfg_range_end": {
"title": "CFG Range End",
"description": "End of the timestep fraction over which CFG is applied.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If true, the safety checker is run on the generated images.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Same seed + prompt reproduces the same image.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Boogu-Image Edit — bilingual (English/Chinese) instruction-based image editing with adjustable reference-image guidance.
Pricing: $0.04 / output megapixel × images (fal-published; output-only billing) — 1MP ≈ 10cr
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringnum_inference_stepsnumberguidance_scalenumberimage_guidance_scalenumbercfg_range_startnumbercfg_range_endnumberenable_safety_checkerbooleanseedintegeraspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fboogu-image%2Fedit",
"title": "Boogu Image (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/boogu-image/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/boogu-image/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Describes what should NOT appear in the edited image. Leave empty to disable negative guidance.",
"default": "",
"type": "string"
},
"num_inference_steps": {
"title": "Steps",
"description": "Number of denoising steps to perform.",
"default": 30,
"type": "number",
"minimum": 20,
"maximum": 50,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "How closely the edit follows the text instruction.",
"default": 4,
"type": "number",
"minimum": 1,
"maximum": 8,
"multipleOf": 0.1
},
"image_guidance_scale": {
"title": "Image Guidance",
"description": "Reference-image guidance strength. 1.0 disables image CFG; higher preserves the input image more strongly.",
"default": 1,
"type": "number",
"minimum": 1,
"maximum": 8,
"multipleOf": 0.1
},
"cfg_range_start": {
"title": "CFG Range Start",
"description": "Start of the timestep fraction over which CFG is applied.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"cfg_range_end": {
"title": "CFG Range End",
"description": "End of the timestep fraction over which CFG is applied.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If true, the safety checker is run on the input and output images.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Same seed, prompt, and input image reproduce the same result.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Generate a new object into a masked region of your image by prompt — trained exclusively on licensed data for safe commercial use.
Pricing: ~10 cr / image (Bria bills $0.04/MP — flat-priced at the 1MP typical)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringmask_urlstringnegative_promptstringrefine_promptbooleanpreserve_alphabooleanseedintegernum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fgen-fill%2Fadd-object",
"title": "Bria Add Object generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/gen-fill/add-object.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/gen-fill/add-object",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"mask_url": {
"title": "Mask Url",
"description": "The URL of the binary mask image marking the area where the object will be added. Use Draw mask to paint it over your image.",
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Describe attributes to exclude from the generated object.",
"default": "",
"type": "string"
},
"refine_prompt": {
"title": "Refine Prompt",
"description": "Let Bria auto-refine your prompt for better fills.",
"default": true,
"type": "boolean"
},
"preserve_alpha": {
"title": "Preserve Alpha",
"description": "When enabled, preserves the alpha channel of the input image. Bria's API default.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Same seed + same prompt = same image every time. Leave empty for a random seed.",
"type": "integer",
"multipleOf": 1
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"mask_url",
"reference_image_url"
],
"additionalProperties": false
}
Add a described object to an image without drawing a mask.
Pricing: Bria image edit
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fv2%2Fadd-object-by-text",
"title": "Bria Add Object by Text generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/v2/add-object-by-text.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/v2/add-object-by-text",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Bria Background Remove — cleanly removes backgrounds while preserving hair and fine detail edges.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringpreserve_alphabooleanreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fbria%2Fbackground%2Fremove",
"title": "Bria Background Remove generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/bria/background/remove.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/bria/background/remove",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"preserve_alpha": {
"title": "Preserve Alpha",
"description": "When enabled, preserves the alpha channel of the input image. Bria's API default.",
"default": true,
"type": "boolean"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Blend visual changes naturally into the source image from an instruction.
Pricing: Bria image edit
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fv2%2Fblend",
"title": "Bria Blend generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/v2/blend.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/v2/blend",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Apply depth-aware blur to the detected background.
Pricing: Bria image edit
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringscalenumberpreserve_alphabooleanreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fv2%2Fblur-background",
"title": "Bria Blur Background generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/v2/blur-background.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/v2/blur-background",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"scale": {
"title": "Blur strength",
"description": "Background blur strength from 1 to 5.",
"default": 5,
"type": "number",
"minimum": 1,
"maximum": 5,
"multipleOf": 1
},
"preserve_alpha": {
"title": "Preserve alpha",
"description": "Preserve transparency from the input image.",
"default": true,
"type": "boolean"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Change a scene to spring, summer, autumn, or winter.
Pricing: Bria image edit
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringseasonstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fv2%2Freseason",
"title": "Bria Change Season generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/v2/reseason.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/v2/reseason",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"season": {
"title": "Season",
"description": "The target season. A season named in the instruction takes precedence.",
"default": "summer",
"type": "string",
"enum": [
"spring",
"summer",
"autumn",
"winter"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Colorize or recolor an image using an official Bria color treatment.
Pricing: Bria image edit
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringcolorstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fv2%2Fcolorize",
"title": "Bria Colorize generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/v2/colorize.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/v2/colorize",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"color": {
"title": "Color treatment",
"description": "The official Bria color treatment. A treatment named in the instruction takes precedence.",
"default": "color_contemporary",
"type": "string",
"enum": [
"color_contemporary",
"color_vivid",
"black_and_white",
"sepia_vintage"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Detect and crop tightly around the main foreground subject.
Pricing: Bria image edit
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpaddingnumberforce_background_detectionbooleanpreserve_alphabooleanreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fv2%2Fcrop-foreground",
"title": "Bria Crop Foreground generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/v2/crop-foreground.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/v2/crop-foreground",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"padding": {
"title": "Padding",
"description": "Padding in pixels around the detected foreground.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 2048,
"multipleOf": 1
},
"force_background_detection": {
"title": "Force background detection",
"default": false,
"type": "boolean"
},
"preserve_alpha": {
"title": "Preserve alpha",
"default": true,
"type": "boolean"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Improve detail, clarity, and overall image quality.
Pricing: Bria image edit
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpreserve_alphabooleanseedintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fv2%2Fenhance",
"title": "Bria Enhance generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/v2/enhance.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/v2/enhance",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"preserve_alpha": {
"title": "Preserve alpha",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"type": "integer",
"multipleOf": 1
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Remove an object by naming it, with no painted mask required.
Pricing: Bria image edit
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fv2%2Ferase-by-text",
"title": "Bria Erase by Text generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/v2/erase-by-text.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/v2/erase-by-text",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Remove the detected foreground and retain the background.
Pricing: Bria image edit
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpreserve_alphabooleanreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fv2%2Ferase-foreground",
"title": "Bria Erase Foreground generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/v2/erase-foreground.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/v2/erase-foreground",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"preserve_alpha": {
"title": "Preserve alpha",
"description": "Preserve transparency from the input image.",
"default": true,
"type": "boolean"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Precisely remove unwanted objects from images using a binary mask — trained exclusively on licensed data for safe commercial use.
Pricing: ~10 cr / image
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringmask_urlstringpreserve_alphabooleanreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fbria%2Feraser",
"title": "Bria Eraser generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/bria/eraser.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/bria/eraser",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"mask_url": {
"title": "Mask Url",
"description": "The URL of the binary mask image that represents the area that will be cleaned. Use Draw mask to paint it over your image.",
"type": "string"
},
"preserve_alpha": {
"title": "Preserve Alpha",
"description": "When enabled, preserves the alpha channel of the input image. Bria's API default.",
"default": true,
"type": "boolean"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"mask_url",
"reference_image_url"
],
"additionalProperties": false
}
Extend an image beyond its original borders with generated surroundings.
Pricing: 10 cr / generation
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringcanvas_sizearraynegative_promptstringseedintegeraspect_ratiostringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fbria%2Fexpand",
"title": "Bria Expand generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/bria/expand.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/bria/expand",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"canvas_size": {
"title": "Canvas Size",
"description": "Final [width, height] in pixels. The selected aspect ratio is used automatically unless this is customized.",
"default": "[1536, 1024]",
"type": "array",
"items": {
"type": "string"
}
},
"negative_prompt": {
"title": "Negative Prompt",
"default": "",
"type": "string"
},
"seed": {
"title": "Seed",
"type": "integer",
"multipleOf": 1
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"2:3",
"3:2",
"3:4",
"4:3",
"4:5",
"5:4",
"9:16",
"16:9"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Outpaint an image to a selected aspect ratio or canvas size.
Pricing: Bria image edit
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringcanvas_sizearrayoriginal_image_sizearrayoriginal_image_locationarraypreserve_alphabooleanseedintegeraspect_ratiostringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fv2%2Fexpand",
"title": "Bria Expand generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/v2/expand.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/v2/expand",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative prompt",
"description": "Describe content to avoid in the expanded area.",
"default": "",
"type": "string"
},
"canvas_size": {
"title": "Canvas size",
"description": "Optional final [width, height]. Leave empty to use the selected aspect ratio.",
"type": "array",
"items": {
"type": "string"
}
},
"original_image_size": {
"title": "Original image size",
"description": "Optional [width, height] placement size on the expanded canvas.",
"type": "array",
"items": {
"type": "string"
}
},
"original_image_location": {
"title": "Original image location",
"description": "Optional [x, y] placement on the expanded canvas.",
"type": "array",
"items": {
"type": "string"
}
},
"preserve_alpha": {
"title": "Preserve alpha",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"type": "integer",
"multipleOf": 1
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"2:3",
"3:2",
"3:4",
"4:3",
"4:5",
"5:4",
"9:16",
"16:9"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Extract a described object from an image as a transparent cutout.
Pricing: 10 cr / image
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringautocropbooleanremove_backgroundbooleanreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fextract-object",
"title": "Bria Extract Object generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/extract-object.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/extract-object",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"autocrop": {
"title": "Auto Crop",
"description": "Tighten the output canvas around the extracted object.",
"default": true,
"type": "boolean"
},
"remove_background": {
"title": "Refine Transparency",
"description": "Refine the cutout edge with background removal.",
"default": true,
"type": "boolean"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
High-fidelity image generation with accurate typography and structured prompt control.
Pricing: 10 cr / image
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringsteps_numnumberresolutionstringnegative_promptstringstructured_promptobjectseedintegeraspect_ratiostringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Ffibo%2Fgenerate",
"title": "Bria Fibo generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/fibo/generate.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/fibo/generate",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"steps_num": {
"title": "Steps",
"default": 50,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"resolution": {
"title": "Resolution",
"default": "1MP",
"type": "string",
"enum": [
"1MP",
"4MP"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"default": "",
"type": "string"
},
"structured_prompt": {
"title": "Structured Prompt",
"type": "object",
"additionalProperties": true
},
"seed": {
"title": "Seed",
"type": "integer",
"multipleOf": 1
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"2:3",
"3:2",
"3:4",
"4:3",
"4:5",
"5:4",
"9:16",
"16:9"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Bria Fibo Edit — instruction-based image editing that modifies specific elements of a photo while preserving the rest.
Pricing: $0.04 / image (1 Bria credit)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringmask_urlstringnegative_promptstringsteps_numnumberguidance_scalenumberseedintegeroutput_typestringstructured_instructionobjectnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Ffibo-edit%2Fedit",
"title": "Bria Fibo Edit generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/fibo-edit/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/fibo-edit/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"mask_url": {
"title": "Mask Url",
"description": "Optional mask limiting the edit to the painted area — use Draw mask to paint it over your image.",
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Describe what to avoid in the edited result.",
"default": "",
"type": "string"
},
"steps_num": {
"title": "Steps",
"description": "Number of inference steps (20–50).",
"default": 30,
"type": "number",
"minimum": 20,
"maximum": 50,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "How strongly the model follows the instruction (3-5).",
"default": 5,
"type": "number",
"minimum": 3,
"maximum": 5,
"multipleOf": 1
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility.",
"default": 5555,
"type": "integer",
"multipleOf": 1
},
"output_type": {
"title": "Output Format",
"description": "File format of the edited image.",
"default": "png",
"type": "string",
"enum": [
"png",
"jpeg"
]
},
"structured_instruction": {
"title": "Structured Instruction (JSON)",
"description": "Full structured-edit JSON (from a previous response or /v2/structured_instruction/generate). Overrides the plain instruction for precise, programmatic control.",
"type": "object",
"additionalProperties": true
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Bria Fibo Edit 1.5 edits one or more source images using a natural-language instruction, a structured instruction, and an optional mask.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringmask_urlstringaspect_ratiostringimage_urlsarrayinstructionstringstructured_instructionobjectseedinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Ffibo-edit-1.5%2Fedit",
"title": "Bria Fibo Edit 1.5 generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/fibo-edit-1.5/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/fibo-edit-1.5/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"mask_url": {
"title": "Mask URL",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"2:3",
"3:2",
"3:4",
"4:3",
"4:5",
"5:4",
"9:16",
"16:9"
]
},
"image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 10
},
"instruction": {
"title": "Edit Instruction",
"description": "Describe the changes to make.",
"type": "string"
},
"structured_instruction": {
"title": "Structured Instruction",
"type": "object",
"additionalProperties": true
},
"seed": {
"title": "Seed",
"default": 5555,
"type": "integer"
}
},
"required": [
"model_id"
],
"additionalProperties": false
}
Bria Fibo Gen 1.5 creates commercially safe images from either a natural-language prompt or a structured prompt object.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaspect_ratiostringseedintegerresolutionstringstructured_promptobject
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Ffibo-gen-1.5%2Ftext-to-image",
"title": "Bria Fibo Gen 1.5 generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/fibo-gen-1.5/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/fibo-gen-1.5/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"2:3",
"3:2",
"3:4",
"4:3",
"4:5",
"5:4",
"9:16",
"16:9"
]
},
"seed": {
"title": "Seed",
"default": 5555,
"type": "integer"
},
"resolution": {
"type": "string",
"enum": [
"1MP",
"4MP"
]
},
"structured_prompt": {
"title": "Structured Prompt",
"description": "Optional structured Fibo prompt object.",
"type": "object",
"additionalProperties": true
}
},
"required": [
"model_id"
],
"additionalProperties": false
}
Fast, licensed-data text-to-image model from Bria — production-grade quality with low latency and full commercial rights.
Pricing: $0.02 / image (0.5 Bria credit)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringoutput_typestringstructured_promptobjectseedintegeraspect_ratiostringnum_imagesintegerimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Ffibo-lite%2Fgenerate",
"title": "Bria Fibo Lite generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/fibo-lite/generate.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/fibo-lite/generate",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"output_type": {
"title": "Output Format",
"description": "File format of the generated image.",
"default": "png",
"type": "string",
"enum": [
"png",
"jpeg"
]
},
"structured_prompt": {
"title": "Structured Prompt (JSON)",
"description": "JSON structured prompt from a previous generation's response or /v2/structured_prompt/generate/lite — for precise refinement. Overrides prompt details.",
"type": "object",
"additionalProperties": true
},
"seed": {
"title": "Seed",
"description": "Same seed + same prompt = same image every time. Leave empty for a random seed.",
"type": "integer",
"multipleOf": 1
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"2:3",
"3:2",
"3:4",
"4:3",
"4:5",
"5:4",
"9:16",
"16:9"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Generate or replace content inside a painted region of an image.
Pricing: 10 cr / generation
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringmask_urlstringsteps_numnumberseedintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fgenfill%2Fv2",
"title": "Bria GenFill v2 generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/genfill/v2.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/genfill/v2",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"mask_url": {
"title": "Painted Area",
"description": "Paint directly on the Image Studio canvas.",
"type": "string"
},
"steps_num": {
"title": "Steps",
"default": 30,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"seed": {
"title": "Seed",
"type": "integer",
"multipleOf": 1
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"mask_url",
"reference_image_url"
],
"additionalProperties": false
}
Bria Photo Restore — automatically denoises, deblurs, and enhances old or damaged photos while preserving their original character.
Pricing: $0.04 / image (1 Bria credit)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringdesired_increasenumberpreserve_alphabooleanreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Ffibo-edit%2Frestore",
"title": "Bria Photo Restore generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/fibo-edit/restore.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/fibo-edit/restore",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"desired_increase": {
"title": "Resolution Multiplier",
"description": "How much to increase the resolution — up to a total output of 8192x8192 pixels.",
"default": "2",
"type": "number",
"enum": [
2,
4
]
},
"preserve_alpha": {
"title": "Preserve Alpha",
"description": "When enabled, preserves the alpha channel of the input image. Bria's API default.",
"default": true,
"type": "boolean"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Place any product in any scene with a prompt or reference image — maintains product integrity, trained on licensed data for safe commercial use.
Pricing: $0.04 / shot (1 Bria credit)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringmodestringplacement_typestringmanual_placement_selectionstringshot_widthnumbershot_heightnumberpadding_topnumberpadding_rightnumberpadding_bottomnumberpadding_leftnumberoptimize_descriptionbooleanexclude_elementsstringoriginal_qualitybooleanforce_rmbgbooleanaspect_ratiostringfg_widthnumberfg_heightnumberfg_xnumberfg_ynumbernum_imagesintegerreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fbria%2Fproduct-shot",
"title": "Bria Product Shot generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/bria/product-shot.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/bria/product-shot",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"mode": {
"title": "Mode",
"description": "Fast is quickest; High Control follows the scene description most closely.",
"default": "fast",
"type": "string",
"enum": [
"fast",
"base",
"high_control"
]
},
"placement_type": {
"title": "Placement Type",
"description": "Controls how the product is positioned in the output image.",
"default": "original",
"type": "string",
"enum": [
"original",
"automatic",
"automatic_aspect_ratio",
"manual_placement",
"manual_padding",
"custom_coordinates"
]
},
"manual_placement_selection": {
"title": "Placement Position",
"description": "Which position to use when placement_type is manual_placement.",
"default": "upper_left",
"type": "string",
"enum": [
"upper_left",
"upper_right",
"bottom_left",
"bottom_right",
"right_center",
"left_center",
"upper_center",
"bottom_center",
"center_vertical",
"center_horizontal"
]
},
"shot_width": {
"title": "Shot Width",
"description": "Width of the output product shot in pixels.",
"default": 1000,
"type": "number",
"minimum": 256,
"maximum": 2048,
"multipleOf": 1
},
"shot_height": {
"title": "Shot Height",
"description": "Height of the output product shot in pixels.",
"default": 1000,
"type": "number",
"minimum": 256,
"maximum": 2048,
"multipleOf": 1
},
"padding_top": {
"title": "Padding Top",
"description": "Top padding in pixels (only used when Placement Type = Manual Padding).",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 2048,
"multipleOf": 1
},
"padding_right": {
"title": "Padding Right",
"description": "Right padding in pixels (Manual Padding only).",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 2048,
"multipleOf": 1
},
"padding_bottom": {
"title": "Padding Bottom",
"description": "Bottom padding in pixels (Manual Padding only).",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 2048,
"multipleOf": 1
},
"padding_left": {
"title": "Padding Left",
"description": "Left padding in pixels (Manual Padding only).",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 2048,
"multipleOf": 1
},
"optimize_description": {
"title": "Optimize Description",
"description": "Let Bria refine the scene description for better results.",
"default": true,
"type": "boolean"
},
"exclude_elements": {
"title": "Exclude Elements",
"description": "Elements to keep out of the generated scene (only applied when Optimize Description is on).",
"type": "string"
},
"original_quality": {
"title": "Original Quality",
"description": "Preserve the original product resolution/quality in the composite.",
"default": false,
"type": "boolean"
},
"force_rmbg": {
"title": "Force Background Removal",
"description": "Re-run background removal on the product image even if it already has an alpha channel.",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"title": "Scene Aspect Ratio",
"description": "Output aspect ratio (only used when Placement Type = Automatic (Aspect Ratio)).",
"default": "1:1",
"type": "string",
"enum": [
"1:1",
"2:3",
"3:2",
"3:4",
"4:3",
"4:5",
"5:4",
"9:16",
"16:9"
]
},
"fg_width": {
"title": "Product Width",
"description": "Product width in pixels (Custom Coordinates only).",
"default": 500,
"type": "number",
"minimum": 1,
"maximum": 2048,
"multipleOf": 1
},
"fg_height": {
"title": "Product Height",
"description": "Product height in pixels (Custom Coordinates only).",
"default": 500,
"type": "number",
"minimum": 1,
"maximum": 2048,
"multipleOf": 1
},
"fg_x": {
"title": "Product X",
"description": "Product left offset in pixels (Custom Coordinates only).",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 2048,
"multipleOf": 1
},
"fg_y": {
"title": "Product Y",
"description": "Product top offset in pixels (Custom Coordinates only).",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 2048,
"multipleOf": 1
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 2
}
},
"required": [
"model_id",
"reference_image_urls"
],
"additionalProperties": false
}
Reimagine a source image while preserving its structure and composition.
Pricing: 10 cr / generation
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstructure_ref_influencenumberfastbooleannum_inference_stepsnumberseedintegernum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fbria%2Freimagine",
"title": "Bria Reimagine generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/bria/reimagine.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/bria/reimagine",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"structure_ref_influence": {
"title": "Structure Strength",
"description": "How closely the new image follows the source composition.",
"default": 0.75,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"fast": {
"title": "Fast Mode",
"description": "Generate faster with the optimized model.",
"default": true,
"type": "boolean"
},
"num_inference_steps": {
"title": "Steps",
"default": 30,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"seed": {
"title": "Seed",
"type": "integer",
"multipleOf": 1
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Change the light source and direction while preserving the scene.
Pricing: Bria image edit
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringlight_typestringlight_directionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fv2%2Frelight",
"title": "Bria Relight generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/v2/relight.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/v2/relight",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"light_type": {
"title": "Light type",
"description": "Lighting preset defined by Bria. Lighting named in the instruction takes precedence.",
"default": "midday",
"type": "string",
"enum": [
"midday",
"blue hour light",
"low-angle sunlight",
"sunrise light",
"spotlight on subject, keep background settings",
"overcast light",
"soft overcast daylight lighting",
"cloud-filtered lighting",
"fog-diffused lighting",
"moonlight lighting",
"starlight lighting nighttime",
"soft bokeh lighting",
"harsh studio lighting keep background setting"
]
},
"light_direction": {
"title": "Light direction",
"description": "Direction of the new light source.",
"default": "front",
"type": "string",
"enum": [
"front",
"side",
"bottom",
"top-down"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Bria Replace Background — replaces the background of a photo using a text prompt while keeping the subject perfectly intact.
Pricing: $0.04 / image (1 Bria credit)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringmodestringnegative_promptstringrefine_promptbooleanenhance_ref_imagesbooleanoriginal_qualitybooleanforce_background_detectionbooleanseedintegerreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Freplace-background",
"title": "Bria Replace Background generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/replace-background.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/replace-background",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"mode": {
"title": "Mode",
"description": "High Control follows the prompt/reference most closely; Fast trades quality for speed.",
"default": "high_control",
"type": "string",
"enum": [
"high_control",
"base",
"fast"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Describe what to avoid in the generated background.",
"default": "",
"type": "string"
},
"refine_prompt": {
"title": "Refine Prompt",
"description": "Let Bria auto-refine your prompt for better backgrounds.",
"default": true,
"type": "boolean"
},
"enhance_ref_images": {
"title": "Enhance Reference",
"description": "Enhance the optional background reference image (second upload) before using it. Note: use a reference OR a prompt, not both.",
"default": true,
"type": "boolean"
},
"original_quality": {
"title": "Original Quality",
"description": "Preserve the input image's original resolution/quality.",
"default": false,
"type": "boolean"
},
"force_background_detection": {
"title": "Force Background Detection",
"description": "Force re-detection of the background even when an alpha channel is present.",
"default": false,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility.",
"type": "integer"
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 2
}
},
"required": [
"model_id",
"reference_image_urls"
],
"additionalProperties": false
}
Replace whatever is inside the masked region with the object you describe — trained exclusively on licensed data for safe commercial use.
Pricing: ~10 cr / image (Bria bills $0.04/MP — flat-priced at the 1MP typical)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringmask_urlstringnegative_promptstringrefine_promptbooleanpreserve_alphabooleanseedintegernum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fgen-fill%2Freplace-object",
"title": "Bria Replace Object generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/gen-fill/replace-object.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/gen-fill/replace-object",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"mask_url": {
"title": "Mask Url",
"description": "The URL of the binary mask image marking the object to replace. Use Draw mask to paint it over your image.",
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Describe attributes to exclude from the replacement object.",
"default": "",
"type": "string"
},
"refine_prompt": {
"title": "Refine Prompt",
"description": "Let Bria auto-refine your prompt for better fills.",
"default": true,
"type": "boolean"
},
"preserve_alpha": {
"title": "Preserve Alpha",
"description": "When enabled, preserves the alpha channel of the input image. Bria's API default.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Same seed + same prompt = same image every time. Leave empty for a random seed.",
"type": "integer",
"multipleOf": 1
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"mask_url",
"reference_image_url"
],
"additionalProperties": false
}
Replace a described object in an image without drawing a mask.
Pricing: Bria image edit
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fv2%2Freplace-object-by-text",
"title": "Bria Replace Object by Text generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/v2/replace-object-by-text.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/v2/replace-object-by-text",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Restore damaged, noisy, blurred, or aged photographs.
Pricing: Bria image edit
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fv2%2Frestore",
"title": "Bria Restore Photo generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/v2/restore.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/v2/restore",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Apply a supported art direction while preserving source content.
Pricing: Bria image edit
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstylestringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fv2%2Frestyle",
"title": "Bria Restyle generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/v2/restyle.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/v2/restyle",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"style": {
"title": "Style",
"description": "The official Bria style. A style named in the instruction takes precedence.",
"default": "render_3d",
"type": "string",
"enum": [
"render_3d",
"cubism",
"oil_painting",
"anime",
"cartoon",
"coloring_book",
"retro_ad",
"pop_art_halftone",
"vector_art",
"story_board",
"art_nouveau",
"cross_etching",
"wood_cut"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Rewrite visible text inside an image while preserving the design.
Pricing: Bria image edit
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fv2%2Frewrite-text",
"title": "Bria Rewrite Text generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/v2/rewrite-text.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/v2/rewrite-text",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Turn a sketch into a finished colored image.
Pricing: Bria image edit
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fv2%2Fsketch-to-image",
"title": "Bria Sketch to Image generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/v2/sketch-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/v2/sketch-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Bria's HD text-to-image model trained exclusively on licensed data — commercial-safe, photorealistic output with aspect ratio control.
Pricing: $0.04 / image (1 Bria credit)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_inference_stepsnumberresolutionstringnegative_promptstringoutput_typestringstructured_promptobjectseedintegeraspect_ratiostringnum_imagesintegerimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fbria%2Ftext-to-image%2Fhd",
"title": "Bria Text-to-Image HD generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/bria/text-to-image/hd.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/bria/text-to-image/hd",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"num_inference_steps": {
"title": "Steps",
"description": "Number of diffusion steps to refine the image.",
"default": 50,
"type": "number",
"minimum": 35,
"maximum": 50,
"multipleOf": 1
},
"resolution": {
"title": "Resolution",
"description": "4MP improves detail (especially photorealism) but adds ~30s of latency.",
"default": "1MP",
"type": "string",
"enum": [
"1MP",
"4MP"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Describe what to avoid in the image.",
"default": "",
"type": "string"
},
"output_type": {
"title": "Output Format",
"description": "File format of the generated image.",
"default": "png",
"type": "string",
"enum": [
"png",
"jpeg"
]
},
"structured_prompt": {
"title": "Structured Prompt (JSON)",
"description": "JSON structured prompt from a previous generation's response or /v2/structured_prompt/generate — for precise refinement. Overrides prompt details.",
"type": "object",
"additionalProperties": true
},
"seed": {
"title": "Seed",
"description": "Same seed + same prompt = same image every time. Leave empty for a random seed.",
"type": "integer",
"multipleOf": 1
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"2:3",
"3:2",
"3:4",
"4:3",
"4:5",
"5:4",
"9:16",
"16:9"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
CCSR — content-consistent super-resolution that preserves content while recovering high-frequency texture detail.
Pricing: ~$0.015 / image (compute-second estimate at the 50-step default)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringt_maxnumbertile_diffusionstringcolor_fix_typestringtile_diffusion_stridenumbertile_vae_encoder_sizenumbertile_vaebooleanstepsnumbert_minnumberscalenumbertile_diffusion_sizenumberseedintegertile_vae_decoder_sizenumberreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fccsr",
"title": "CCSR generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ccsr.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ccsr",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"t_max": {
"title": "T Max",
"description": "The ending point of uniform sampling strategy.",
"default": 0.6667,
"type": "number",
"minimum": 0,
"maximum": 1
},
"tile_diffusion": {
"title": "Tile Diffusion",
"description": "If specified, a patch-based sampling strategy will be used for sampling.",
"default": "none",
"type": "string",
"enum": [
"none",
"mix",
"gaussian"
]
},
"color_fix_type": {
"title": "Color Fix Type",
"description": "Type of color correction for samples.",
"default": "adain",
"type": "string",
"enum": [
"none",
"wavelet",
"adain"
]
},
"tile_diffusion_stride": {
"title": "Tile Diffusion Stride",
"description": "Stride of sliding patch.",
"default": 512,
"type": "number",
"minimum": 128,
"maximum": 1024,
"multipleOf": 1
},
"tile_vae_encoder_size": {
"title": "Tile Vae Encoder Size",
"description": "Size of latent image",
"default": 1024,
"type": "number",
"minimum": 128,
"maximum": 2048,
"multipleOf": 1
},
"tile_vae": {
"title": "Tile Vae",
"description": "If specified, a patch-based sampling strategy will be used for VAE decoding.",
"default": false,
"type": "boolean"
},
"steps": {
"title": "Steps",
"description": "The number of steps to run the model for. The higher the number the better the quality and longer it will take to generate.",
"default": 50,
"type": "number",
"minimum": 10,
"maximum": 100,
"multipleOf": 1
},
"t_min": {
"title": "T Min",
"description": "The starting point of uniform sampling strategy.",
"default": 0.3333,
"type": "number",
"minimum": 0,
"maximum": 1
},
"scale": {
"title": "Scale",
"description": "The scale of the output image. The higher the scale, the bigger the output image will be.",
"default": 2,
"type": "number",
"minimum": 1,
"maximum": 4,
"multipleOf": 1
},
"tile_diffusion_size": {
"title": "Tile Diffusion Size",
"description": "Size of patch.",
"default": 1024,
"type": "number",
"minimum": 256,
"maximum": 2048,
"multipleOf": 1
},
"seed": {
"title": "Seed",
"description": "Seed for reproducibility. Different seeds will make slightly different results.",
"type": "integer"
},
"tile_vae_decoder_size": {
"title": "Tile Vae Decoder Size",
"description": "Size of VAE patch.",
"default": 226,
"type": "number",
"minimum": 64,
"maximum": 2048,
"multipleOf": 1
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Clarity Upscaler — enhances resolution while recovering fine texture and detail with diffusion-based upscaling.
Pricing: $0.03 / output MP — ~4 MP at the default 2x upscale of a 1MP image
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringnum_inference_stepsnumbercreativitynumberguidance_scalenumberupscale_factornumberresemblancenumberseedintegerenable_safety_checkerbooleanreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fclarity-upscaler",
"title": "Clarity Upscaler generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/clarity-upscaler.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/clarity-upscaler",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to use. Use it to address details that you don't want in the image.",
"default": "(worst quality, low quality, normal quality:2)",
"type": "string"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 18,
"type": "number",
"minimum": 4,
"maximum": 50,
"multipleOf": 1
},
"creativity": {
"title": "Creativity",
"description": "The creativity of the model. The higher the creativity, the more the model will deviate from the prompt. Refers to the denoise strength of the samplin",
"default": 0.35,
"type": "number",
"minimum": 0,
"maximum": 1
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 4,
"type": "number",
"minimum": 0,
"maximum": 20
},
"upscale_factor": {
"title": "Upscale Factor",
"description": "The upscale factor. Fractional values are allowed (e.g. 1.5x). Price scales with the square of the factor.",
"default": 2,
"type": "number",
"minimum": 1,
"maximum": 4,
"multipleOf": 0.1
},
"resemblance": {
"title": "Resemblance",
"description": "The resemblance of the upscaled image to the original image. The higher the resemblance, the more the model will try to keep the original image. Refer",
"default": 0.6,
"type": "number",
"minimum": 0,
"maximum": 1
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time.",
"type": "integer",
"minimum": 0
},
"enable_safety_checker": {
"title": "Safety Checker",
"description": "If enabled, the resulting image will be checked for potentially unsafe content.",
"default": true,
"type": "boolean"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
CodeFormer — reconstructs fine facial details from damaged or low-quality photos while preserving identity.
Pricing: $0.0021 / output MP — ~4 MP at the default 2x upscale of a 1MP image
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringface_upscalebooleanonly_center_facebooleanfidelitynumberupscale_factornumberseedintegeralignedbooleanreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fcodeformer",
"title": "CodeFormer (Face Restore) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/codeformer.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/codeformer",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"face_upscale": {
"title": "Face Upscale",
"description": "Should faces be upscaled",
"default": true,
"type": "boolean"
},
"only_center_face": {
"title": "Only Center Face",
"description": "Should only center face be restored",
"default": false,
"type": "boolean"
},
"fidelity": {
"title": "Fidelity",
"description": "Balance between quality (0) and fidelity to the input face (1).",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"upscale_factor": {
"title": "Upscale Factor",
"description": "Output upscaling factor applied after face restoration.",
"default": 2,
"type": "number",
"minimum": 1,
"maximum": 4,
"multipleOf": 0.5
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducible generation.",
"type": "integer"
},
"aligned": {
"title": "Aligned",
"description": "Should faces be aligned before restoration.",
"default": false,
"type": "boolean"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Creative Upscaler — adds imaginative detail and texture as it increases resolution.
Pricing: ~$0.015 / image (compute-second estimate; large scales cost more)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringoverride_size_limitsbooleanbase_model_urlstringskip_ccsrbooleandetailnumberseedintegeradditional_lora_urlstringadditional_embedding_urlstringprompt_suffixstringenable_safety_checksbooleanscalenumbermodel_typestringnegative_promptstringadditional_lora_scalenumberguidance_scalenumbershape_preservationnumbernum_inference_stepsnumbercreativitynumberreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fcreative-upscaler",
"title": "Creative Upscaler generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/creative-upscaler.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/creative-upscaler",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"override_size_limits": {
"title": "Override Size Limits",
"description": "Allow for large uploads that could take a very long time.",
"default": false,
"type": "boolean"
},
"base_model_url": {
"title": "Base Model Url",
"description": "The URL to the base model to use for the upscaling",
"type": "string"
},
"skip_ccsr": {
"title": "Skip Ccsr",
"description": "If set to true, the image will not be processed by the CCSR model before being processed by the creativity model.",
"default": false,
"type": "boolean"
},
"detail": {
"title": "Detail",
"description": "How much detail to add",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 5
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time.",
"type": "integer"
},
"additional_lora_url": {
"title": "Additional Lora Url",
"description": "The URL to the additional LORA model to use for the upscaling. Default is None",
"type": "string"
},
"additional_embedding_url": {
"title": "Additional Embedding Url",
"description": "The URL to the additional embeddings to use for the upscaling. Default is None",
"type": "string"
},
"prompt_suffix": {
"title": "Prompt Suffix",
"description": "The suffix to add to the prompt. This is useful to add a common ending to all prompts such as 'high quality' etc or embedding tokens.",
"default": " high quality, highly detailed, high resolution, sharp",
"type": "string"
},
"enable_safety_checks": {
"title": "Enable Safety Checks",
"description": "If set to true, the resulting image will be checked whether it includes any potentially unsafe content. If it does, it will be replaced with a black i",
"default": true,
"type": "boolean"
},
"scale": {
"title": "Scale",
"description": "The scale of the output image. The higher the scale, the bigger the output image will be.",
"default": 2,
"type": "number",
"minimum": 1,
"maximum": 5
},
"model_type": {
"title": "Model Type",
"description": "The type of model to use for the upscaling. Default is SD_1_5",
"default": "SD_1_5",
"type": "string",
"enum": [
"SD_1_5",
"SDXL"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to use.Use it to address details that you don't want in the image. This could be colors, objects, scenery and even the small detai",
"default": "blurry, low resolution, bad, ugly, low quality, pixelated, interpolated, compression artifacts, noisey, grainy",
"type": "string"
},
"additional_lora_scale": {
"title": "Additional Lora Scale",
"description": "The scale of the additional LORA model to use for the upscaling. Default is 1.0",
"default": 1,
"type": "number"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 7.5,
"type": "number",
"minimum": 0,
"maximum": 16
},
"shape_preservation": {
"title": "Shape Preservation",
"description": "How much to preserve the shape of the original image",
"default": 0.25,
"type": "number",
"minimum": 0,
"maximum": 3
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to use for generating the image. The more steps the better the image will be but it will also take longer to generate.",
"default": 20,
"type": "number",
"minimum": 1,
"maximum": 200,
"multipleOf": 1
},
"creativity": {
"title": "Creativity",
"description": "How much the output can deviate from the original",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Dola Seedream 5.0 Pro — ByteDance's flagship image model for precise compositions, multilingual text, infographics, and photorealistic commercial work.
Pricing: $0.045 / 1K image; $0.09 / 2K image (BytePlus list price)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringoutput_formatstringwatermarkbooleanaspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bytedance%2Fseedream-5-0-pro%2Ftext-to-image",
"title": "Dola Seedream 5.0 Pro generation request",
"description": "Request body accepted by POST /api/v1/generate for bytedance/seedream-5-0-pro/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bytedance/seedream-5-0-pro/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"output_format": {
"title": "Output Format",
"description": "File format for the generated image.",
"default": "png",
"type": "string",
"enum": [
"png",
"jpeg"
]
},
"watermark": {
"title": "Watermark",
"description": "Adds the provider's AI-generated watermark to the image.",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3",
"21:9"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Dola Seedream 5.0 Pro Edit — precision image editing and compositing with subject consistency across up to 10 reference images.
Pricing: $0.045 / 1K image; $0.09 / 2K image; first reference free, then $0.003 / image (BytePlus list price)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringoutput_formatstringwatermarkbooleanaspect_ratiostringresolutionstringreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bytedance%2Fseedream-5-0-pro%2Fedit",
"title": "Dola Seedream 5.0 Pro (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for bytedance/seedream-5-0-pro/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bytedance/seedream-5-0-pro/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"output_format": {
"title": "Output Format",
"description": "File format for the generated image.",
"default": "png",
"type": "string",
"enum": [
"png",
"jpeg"
]
},
"watermark": {
"title": "Watermark",
"description": "Adds the provider's AI-generated watermark to the image.",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3",
"21:9"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 10
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Dreamshaper — popular SDXL fine-tune for creative, photorealistic, and cinematic imagery.
Pricing: ~$0.002 / image (compute-second estimate)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_inference_stepsnumberguidance_scalenumberseedintegernegative_promptstringexpand_promptbooleanenable_safety_checkerbooleanformatstringsafety_checker_versionstringlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberembedding_pathstringembedding_tokensarrayembedding_path_2stringembedding_tokens_2arrayembedding_path_3stringembedding_tokens_3arrayaspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fdreamshaper",
"title": "Dreamshaper generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/dreamshaper.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/dreamshaper",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 35,
"type": "number",
"minimum": 1,
"maximum": 70,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 5,
"type": "number",
"minimum": 0,
"maximum": 20,
"multipleOf": 0.1
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time.",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to use. Use it to address details that you don't want in the image.",
"default": "(worst quality, low quality, normal quality, lowres, low details, oversaturated, undersaturated, overexposed, underexposed, grayscale, bw, bad photo, bad photography, bad art:1.4), (watermark, signature, text font, username, error, logo, words, letters, digits, autograph, trademark, name:1.2), (blur, blurry, grainy), morbid, ugly, asymmetrical, mutated malformed, mutilated, poorly lit, bad shadow, draft, cropped, out of frame, cut off, censored, jpeg artifacts, out of focus, glitch, duplicate, (airbrushed, cartoon, anime, semi-realistic, cgi, render, blender, digital art, manga, amateur:1.3), (3D ,3D Game, 3D Game Scene, 3D Character:1.1), (bad hands, bad anatomy, bad body, bad face, bad teeth, bad arms, bad legs, deformities:1.3)",
"type": "string"
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "If set to true, the prompt will be expanded with additional prompts.",
"default": false,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"format": {
"title": "Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"safety_checker_version": {
"title": "Safety Checker Version",
"description": "The version of the safety checker to use. v1 is the default CompVis safety checker. v2 uses a custom ViT model.",
"default": "v1",
"type": "string",
"enum": [
"v1",
"v2"
]
},
"lora_path": {
"title": "LoRA Path",
"description": "URL or Hugging Face path to LoRA weights.",
"type": "string"
},
"lora_scale": {
"title": "LoRA Scale",
"description": "Strength of the LoRA effect (0–1).",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"lora_path_2": {
"title": "LoRA Path 2",
"description": "URL or Hugging Face path to a second LoRA.",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA Scale 2",
"description": "Strength of the second LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"lora_path_3": {
"title": "LoRA Path 3",
"description": "URL or Hugging Face path to a third LoRA.",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA Scale 3",
"description": "Strength of the third LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"embedding_path": {
"title": "Embedding Path",
"description": "URL or Hugging Face path to textual-inversion embedding weights.",
"type": "string"
},
"embedding_tokens": {
"title": "Embedding Tokens",
"description": "Tokens that trigger the embedding when used in your prompt.",
"type": "array",
"items": {
"type": "string"
}
},
"embedding_path_2": {
"title": "Embedding Path 2",
"description": "URL or Hugging Face path to a second embedding.",
"type": "string"
},
"embedding_tokens_2": {
"title": "Embedding Tokens 2",
"description": "Tokens for the second embedding.",
"type": "array",
"items": {
"type": "string"
}
},
"embedding_path_3": {
"title": "Embedding Path 3",
"description": "URL or Hugging Face path to a third embedding.",
"type": "string"
},
"embedding_tokens_3": {
"title": "Embedding Tokens 3",
"description": "Tokens for the third embedding.",
"type": "array",
"items": {
"type": "string"
}
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
ERNIE-Image LoRA — Baidu's ERNIE image model with LoRA and Chinese artistic style support.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringaccelerationstringnum_inference_stepsnumberguidance_scalenumberenable_prompt_expansionbooleanenable_safety_checkerbooleanoutput_formatstringseedintegerlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberaspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fernie-image%2Flora",
"title": "ERNIE-Image LoRA generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ernie-image/lora.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ernie-image/lora",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt to guide what should not be in the image.",
"default": "",
"type": "string"
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use for the image generation.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular",
"high"
]
},
"num_inference_steps": {
"title": "Steps",
"description": "Number of denoising steps.",
"default": 50,
"type": "number",
"minimum": 1,
"maximum": 100,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Classifier-free guidance scale.",
"default": 5,
"type": "number",
"minimum": 1,
"maximum": 20,
"multipleOf": 0.1
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "If True, the prompt will be enhanced using an LLM for more detailed results.",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Enable NSFW safety checking on the generated images.",
"default": true,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "Output image format.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility.",
"type": "integer"
},
"lora_path": {
"title": "LoRA 1",
"description": "URL or path to the first LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale": {
"title": "LoRA 1 Scale",
"description": "Blend strength for LoRA 1 (0 = off, 1 = full, up to 4).",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_2": {
"title": "LoRA 2",
"description": "URL or path to the second LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA 2 Scale",
"description": "Blend strength for LoRA 2.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_3": {
"title": "LoRA 3",
"description": "URL or path to the third LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA 3 Scale",
"description": "Blend strength for LoRA 3.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
ERNIE-Image LoRA Turbo — fast version of ERNIE-Image LoRA optimized for quick generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_inference_stepsnumberguidance_scalenumberseedintegeraccelerationstringenable_prompt_expansionbooleanenable_safety_checkerbooleannegative_promptstringoutput_formatstringlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberaspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fernie-image%2Flora%2Fturbo",
"title": "ERNIE-Image LoRA Turbo generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ernie-image/lora/turbo.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ernie-image/lora/turbo",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"num_inference_steps": {
"title": "Steps",
"description": "Number of denoising steps. Turbo model is optimized for 8 steps.",
"default": 8,
"type": "number",
"minimum": 1,
"maximum": 20,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Classifier-free guidance scale.",
"default": 1,
"type": "number",
"minimum": 1,
"maximum": 20,
"multipleOf": 0.1
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility.",
"type": "integer"
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use for the image generation.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular",
"high"
]
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "If True, the prompt will be enhanced using an LLM for more detailed results.",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Enable NSFW safety checking on the generated images.",
"default": true,
"type": "boolean"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt to guide what should not be in the image.",
"default": "",
"type": "string"
},
"output_format": {
"title": "Output Format",
"description": "Output image format.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"lora_path": {
"title": "LoRA 1",
"description": "URL or path to the first LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale": {
"title": "LoRA 1 Scale",
"description": "Blend strength for LoRA 1 (0 = off, 1 = full, up to 4).",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_2": {
"title": "LoRA 2",
"description": "URL or path to the second LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA 2 Scale",
"description": "Blend strength for LoRA 2.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_3": {
"title": "LoRA 3",
"description": "URL or path to the third LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA 3 Scale",
"description": "Blend strength for LoRA 3.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
ESRGAN — deep GAN-based upscaling for sharp, artifact-free results with anime and realistic options.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringmodelstringfacebooleanscalenumbertilenumberoutput_formatstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fesrgan",
"title": "ESRGAN generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/esrgan.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/esrgan",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"model": {
"title": "Model",
"description": "Model to use for upscaling",
"default": "RealESRGAN_x4plus",
"type": "string",
"enum": [
"RealESRGAN_x4plus",
"RealESRGAN_x2plus",
"RealESRGAN_x4plus_anime_6B",
"RealESRGAN_x4_v3",
"RealESRGAN_x4_wdn_v3",
"RealESRGAN_x4_anime_v3"
]
},
"face": {
"title": "Face",
"description": "Upscaling a face",
"default": false,
"type": "boolean"
},
"scale": {
"title": "Scale",
"description": "Rescaling factor",
"default": 2,
"type": "number",
"minimum": 1,
"maximum": 8,
"multipleOf": 0.5
},
"tile": {
"title": "Tile",
"description": "Tile size (0 = no tile). Set to 400 or 200 if running out of GPU memory.",
"default": 0,
"type": "number",
"multipleOf": 1
},
"output_format": {
"title": "Output Format",
"description": "Output image format.",
"default": "png",
"type": "string",
"enum": [
"png",
"jpeg"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
FASHN v1.6 — state-of-the-art virtual try-on. Proprietary fashion model trained on millions of garments; photorealistic fit with strong logo, print and texture preservation. Commercially permissible.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringcategorystringmodestringgarment_photo_typestringmoderation_levelstringsegmentation_freebooleannum_samplesnumberoutput_formatstringseedintegerreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Ffashn%2Ftryon%2Fv1.6",
"title": "FASHN v1.6 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/fashn/tryon/v1.6.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/fashn/tryon/v1.6",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"category": {
"title": "Category",
"description": "Garment category; 'auto' detects it from the garment image.",
"default": "auto",
"type": "string",
"enum": [
"auto",
"tops",
"bottoms",
"one-pieces"
]
},
"mode": {
"title": "Mode",
"description": "Speed vs. quality tradeoff. 'quality' is the most photorealistic.",
"default": "balanced",
"type": "string",
"enum": [
"performance",
"balanced",
"quality"
]
},
"garment_photo_type": {
"title": "Garment Photo Type",
"description": "Whether the garment photo is on a model or a flat-lay.",
"default": "auto",
"type": "string",
"enum": [
"auto",
"model",
"flat-lay"
]
},
"moderation_level": {
"title": "Moderation Level",
"description": "Content moderation strictness.",
"default": "permissive",
"type": "string",
"enum": [
"none",
"permissive",
"conservative"
]
},
"segmentation_free": {
"title": "Segmentation Free",
"description": "Maskless try-on for more natural blending.",
"default": true,
"type": "boolean"
},
"num_samples": {
"title": "Num Samples",
"description": "Number of try-on variations to generate.",
"default": 1,
"type": "number",
"minimum": 1,
"maximum": 4,
"multipleOf": 1
},
"output_format": {
"title": "Output Format",
"description": "Output image format.",
"default": "png",
"type": "string",
"enum": [
"png",
"jpeg"
]
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducible results.",
"type": "integer"
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 2,
"maxItems": 2
}
},
"required": [
"model_id",
"reference_image_urls"
],
"additionalProperties": false
}
Fast Lightning SDXL — ultra-fast SDXL variant with very low inference steps.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_inference_stepsnumberexpand_promptbooleanseedintegersafety_checker_versionstringformatstringenable_safety_checkerbooleanembedding_pathstringembedding_tokensarrayembedding_path_2stringembedding_tokens_2arrayembedding_path_3stringembedding_tokens_3arrayaspect_ratiostringresolutionstringoutput_formatstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Ffast-lightning-sdxl",
"title": "Fast Lightning SDXL generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/fast-lightning-sdxl.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/fast-lightning-sdxl",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": "4",
"type": "number",
"enum": [
1,
2,
4,
8
]
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "If set to true, the prompt will be expanded with additional prompts.",
"default": false,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time.",
"type": "integer"
},
"safety_checker_version": {
"title": "Safety Checker Version",
"description": "The version of the safety checker to use. v1 is the default CompVis safety checker. v2 uses a custom ViT model.",
"default": "v1",
"type": "string",
"enum": [
"v1",
"v2"
]
},
"format": {
"title": "Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"embedding_path": {
"title": "Embedding Path",
"description": "URL or Hugging Face path to textual-inversion embedding weights.",
"type": "string"
},
"embedding_tokens": {
"title": "Embedding Tokens",
"description": "Tokens that trigger the embedding when used in your prompt.",
"type": "array",
"items": {
"type": "string"
}
},
"embedding_path_2": {
"title": "Embedding Path 2",
"description": "URL or Hugging Face path to a second embedding.",
"type": "string"
},
"embedding_tokens_2": {
"title": "Embedding Tokens 2",
"description": "Tokens for the second embedding.",
"type": "array",
"items": {
"type": "string"
}
},
"embedding_path_3": {
"title": "Embedding Path 3",
"description": "URL or Hugging Face path to a third embedding.",
"type": "string"
},
"embedding_tokens_3": {
"title": "Embedding Tokens 3",
"description": "Tokens for the third embedding.",
"type": "array",
"items": {
"type": "string"
}
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"output_format": {
"type": "string",
"enum": [
"png",
"jpeg"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Fast SDXL — accelerated SDXL generation for quick, high-resolution image creation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringseedintegernum_inference_stepsnumbernegative_promptstringexpand_promptbooleanformatstringguidance_scalenumbersafety_checker_versionstringenable_safety_checkerbooleanlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberembedding_pathstringembedding_tokensarrayembedding_path_2stringembedding_tokens_2arrayembedding_path_3stringembedding_tokens_3arrayaspect_ratiostringresolutionstringoutput_formatstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Ffast-sdxl",
"title": "Fast SDXL generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/fast-sdxl.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/fast-sdxl",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time.",
"type": "integer"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 25,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to use. Use it to address details that you don't want in the image. This could be colors, objects, scenery and even the small deta",
"default": "",
"type": "string"
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "If set to true, the prompt will be expanded with additional prompts.",
"default": false,
"type": "boolean"
},
"format": {
"title": "Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 7.5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"safety_checker_version": {
"title": "Safety Checker Version",
"description": "The version of the safety checker to use. v1 is the default CompVis safety checker. v2 uses a custom ViT model.",
"default": "v1",
"type": "string",
"enum": [
"v1",
"v2"
]
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"lora_path": {
"title": "LoRA Path",
"description": "URL or Hugging Face path to LoRA weights (e.g. username/repo or https://…).",
"type": "string"
},
"lora_scale": {
"title": "LoRA Scale",
"description": "Strength of the LoRA effect. 1 = default weight.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"lora_path_2": {
"title": "LoRA Path 2",
"description": "URL or Hugging Face path to a second set of LoRA weights.",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA Scale 2",
"description": "Strength of the second LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"lora_path_3": {
"title": "LoRA Path 3",
"description": "URL or Hugging Face path to a third set of LoRA weights.",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA Scale 3",
"description": "Strength of the third LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"embedding_path": {
"title": "Embedding Path",
"description": "URL or Hugging Face path to textual-inversion embedding weights.",
"type": "string"
},
"embedding_tokens": {
"title": "Embedding Tokens",
"description": "Tokens that trigger the embedding when used in your prompt.",
"type": "array",
"items": {
"type": "string"
}
},
"embedding_path_2": {
"title": "Embedding Path 2",
"description": "URL or Hugging Face path to a second embedding.",
"type": "string"
},
"embedding_tokens_2": {
"title": "Embedding Tokens 2",
"description": "Tokens for the second embedding.",
"type": "array",
"items": {
"type": "string"
}
},
"embedding_path_3": {
"title": "Embedding Path 3",
"description": "URL or Hugging Face path to a third embedding.",
"type": "string"
},
"embedding_tokens_3": {
"title": "Embedding Tokens 3",
"description": "Tokens for the third embedding.",
"type": "array",
"items": {
"type": "string"
}
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"output_format": {
"type": "string",
"enum": [
"png",
"jpeg"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Fast SDXL Edit — image-to-image editing using accelerated SDXL.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringseedintegernum_inference_stepsnumbercrop_outputbooleannegative_promptstringexpand_promptbooleanformatstringstrengthnumberguidance_scalenumbersafety_checker_versionstringpreserve_aspect_ratiobooleanenable_safety_checkerbooleanlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberembedding_pathstringembedding_tokensarrayembedding_path_2stringembedding_tokens_2arrayembedding_path_3stringembedding_tokens_3arrayaspect_ratiostringresolutionstringoutput_formatstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Ffast-sdxl%2Fimage-to-image",
"title": "Fast SDXL (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/fast-sdxl/image-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/fast-sdxl/image-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time.",
"type": "integer"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 25,
"type": "number",
"minimum": 1,
"maximum": 65,
"multipleOf": 1
},
"crop_output": {
"title": "Crop Output",
"description": "If set to true, the output cropped to the proper aspect ratio after generating.",
"default": false,
"type": "boolean"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to use.Use it to address details that you don't want in the image. This could be colors, objects, scenery and even the small detai",
"default": "",
"type": "string"
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "If set to true, the prompt will be expanded with additional prompts.",
"default": false,
"type": "boolean"
},
"format": {
"title": "Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"strength": {
"title": "Strength",
"description": "determines how much the generated image resembles the initial image",
"default": 0.95,
"type": "number",
"minimum": 0.05,
"maximum": 1
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 7.5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"safety_checker_version": {
"title": "Safety Checker Version",
"description": "The version of the safety checker to use. v1 is the default CompVis safety checker. v2 uses a custom ViT model.",
"default": "v1",
"type": "string",
"enum": [
"v1",
"v2"
]
},
"preserve_aspect_ratio": {
"title": "Preserve Aspect Ratio",
"description": "If set to true, the aspect ratio of the generated image will be preserved even if the image size is too large. However, if the image is not a multiple",
"default": false,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"lora_path": {
"title": "LoRA Path",
"description": "URL or Hugging Face path to LoRA weights (e.g. username/repo or https://…).",
"type": "string"
},
"lora_scale": {
"title": "LoRA Scale",
"description": "Strength of the LoRA effect. 1 = default weight.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"lora_path_2": {
"title": "LoRA Path 2",
"description": "URL or Hugging Face path to a second set of LoRA weights.",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA Scale 2",
"description": "Strength of the second LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"lora_path_3": {
"title": "LoRA Path 3",
"description": "URL or Hugging Face path to a third set of LoRA weights.",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA Scale 3",
"description": "Strength of the third LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"embedding_path": {
"title": "Embedding Path",
"description": "URL or Hugging Face path to textual-inversion embedding weights.",
"type": "string"
},
"embedding_tokens": {
"title": "Embedding Tokens",
"description": "Tokens that trigger the embedding when used in your prompt.",
"type": "array",
"items": {
"type": "string"
}
},
"embedding_path_2": {
"title": "Embedding Path 2",
"description": "URL or Hugging Face path to a second embedding.",
"type": "string"
},
"embedding_tokens_2": {
"title": "Embedding Tokens 2",
"description": "Tokens for the second embedding.",
"type": "array",
"items": {
"type": "string"
}
},
"embedding_path_3": {
"title": "Embedding Path 3",
"description": "URL or Hugging Face path to a third embedding.",
"type": "string"
},
"embedding_tokens_3": {
"title": "Embedding Tokens 3",
"description": "Tokens for the third embedding.",
"type": "array",
"items": {
"type": "string"
}
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"output_format": {
"type": "string",
"enum": [
"png",
"jpeg"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
FeyNoBg — precise automatic background removal for people, products, hair, fur, and other fine edges, returned with a transparent alpha channel.
Pricing: $0.001 per successful generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringimage_urlstringseedintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Ffeynobg",
"title": "FeyNoBg Background Remover generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/feynobg.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/feynobg",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"image_url": {
"type": "string",
"format": "uri"
},
"seed": {
"title": "Seed",
"description": "Optional seed for reproducible background removal.",
"type": "integer"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Flux 1 Schnell — the original ultra-fast FLUX distilled model, ideal for rapid iteration.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaccelerationstringnum_inference_stepsnumberguidance_scalenumberseedintegerenable_safety_checkerbooleanoutput_formatstringaspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-1%2Fschnell",
"title": "Flux 1 Schnell generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-1/schnell.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-1/schnell",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"acceleration": {
"title": "Acceleration",
"description": "The speed of the generation. The higher the speed, the faster the generation.",
"default": "none",
"type": "string",
"enum": [
"none",
"regular",
"high"
]
},
"num_inference_steps": {
"title": "Steps",
"description": "The number of inference steps to perform.",
"default": 4,
"type": "number",
"minimum": 1,
"maximum": 12,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance Scale — how closely the model follows the prompt.",
"default": 3.5,
"type": "number",
"minimum": 1,
"maximum": 20,
"multipleOf": 0.1
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same image every time.",
"type": "integer"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048",
"4096"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Flux 2 — Black Forest Labs' open-weight diffusion model with strong prompt adherence and flexible output resolution.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaccelerationstringenable_prompt_expansionbooleannum_inference_stepsnumberguidance_scalenumberseedintegeroutput_formatstringenable_safety_checkerbooleanaspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2",
"title": "Flux 2 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use for the image generation.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular",
"high"
]
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "If set to true, the prompt will be expanded for better results.",
"default": false,
"type": "boolean"
},
"num_inference_steps": {
"title": "Steps",
"description": "The number of inference steps to perform.",
"default": 28,
"type": "number",
"minimum": 4,
"maximum": 50,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance Scale — how closely the model follows the prompt.",
"default": 2.5,
"type": "number",
"minimum": 0,
"maximum": 20,
"multipleOf": 0.1
},
"seed": {
"title": "Seed",
"description": "The seed to use for the generation. If not provided, a random seed will be used.",
"type": "integer"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048",
"4096"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Flux 2 Edit — instruction-guided image editing using Black Forest Labs' Flux 2 model.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaccelerationstringenable_prompt_expansionbooleannum_inference_stepsnumberguidance_scalenumberseedintegeroutput_formatstringenable_safety_checkerbooleanaspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2%2Fedit",
"title": "Flux 2 (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use for the image generation.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular",
"high"
]
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "If set to true, the prompt will be expanded for better results.",
"default": false,
"type": "boolean"
},
"num_inference_steps": {
"title": "Steps",
"description": "The number of inference steps to perform.",
"default": 28,
"type": "number",
"minimum": 4,
"maximum": 50,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance Scale — how closely the model follows the prompt.",
"default": 2.5,
"type": "number",
"minimum": 0,
"maximum": 20,
"multipleOf": 0.1
},
"seed": {
"title": "Seed",
"description": "The seed to use for the generation. If not provided, a random seed will be used.",
"type": "integer"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048",
"4096"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Flux 2 Face to Full Portrait — generates a full-body portrait from a face reference using a gallery LoRA.
Pricing: $0.021 / processed MP (input + output)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaccelerationstringnum_inference_stepsnumberlora_scalenumberenable_safety_checkerbooleanoutput_formatstringseedintegerguidance_scalenumberaspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2-lora-gallery%2Fface-to-full-portrait",
"title": "Flux 2 Face to Full Portrait generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2-lora-gallery/face-to-full-portrait.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2-lora-gallery/face-to-full-portrait",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"acceleration": {
"title": "Acceleration",
"description": "Acceleration level for image generation. 'regular' balances speed and quality.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular"
]
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 40,
"type": "number",
"minimum": 4,
"maximum": 50,
"multipleOf": 1
},
"lora_scale": {
"title": "Lora Scale",
"description": "The strength of the LoRA effect.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 2
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "The format of the output image",
"default": "png",
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
]
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. Same seed with same prompt will produce same result.",
"type": "integer"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale. Controls how closely the model follows the prompt.",
"default": 2.5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Flux 2 Flash — ultra-fast distilled model for the quickest generation cycles.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenable_prompt_expansionbooleanenable_safety_checkerbooleanguidance_scalenumberseedintegeroutput_formatstringaspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2%2Fflash",
"title": "Flux 2 Flash generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2/flash.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2/flash",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "If set to true, the prompt will be expanded for better results.",
"default": false,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance Scale — how closely the model follows the prompt.",
"default": 2.5,
"type": "number",
"minimum": 0,
"maximum": 20,
"multipleOf": 0.1
},
"seed": {
"title": "Seed",
"description": "The seed to use for the generation. If not provided, a random seed will be used.",
"type": "integer"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048",
"4096"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Flux 2 Flash Edit — ultra-fast image-to-image editing.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenable_prompt_expansionbooleanenable_safety_checkerbooleanguidance_scalenumberseedintegeroutput_formatstringaspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2%2Fflash%2Fedit",
"title": "Flux 2 Flash (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2/flash/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2/flash/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "If set to true, the prompt will be expanded for better results.",
"default": false,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance Scale — how closely the model follows the prompt.",
"default": 2.5,
"type": "number",
"minimum": 0,
"maximum": 20,
"multipleOf": 0.1
},
"seed": {
"title": "Seed",
"description": "The seed to use for the generation. If not provided, a random seed will be used.",
"type": "integer"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048",
"4096"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Flux 2 Flex — flexible guidance Flux 2 variant with fine-tuned CFG range for creative control.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringsafety_tolerancenumbernum_inference_stepsnumberguidance_scalenumberseedintegerenable_safety_checkerbooleanoutput_formatstringaspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2-flex",
"title": "Flux 2 Flex generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2-flex.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2-flex",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "Safety tolerance level — 1 = most strict, 5 = most permissive.",
"default": "2",
"type": "number",
"enum": [
1,
2,
3,
4,
5
]
},
"num_inference_steps": {
"title": "Steps",
"description": "The number of inference steps to perform.",
"default": 28,
"type": "number",
"minimum": 2,
"maximum": 50,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance Scale — how closely the model follows the prompt.",
"default": 3.5,
"type": "number",
"minimum": 1.5,
"maximum": 10,
"multipleOf": 0.1
},
"seed": {
"title": "Seed",
"description": "The seed to use for the generation.",
"type": "integer"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Whether to enable the safety checker.",
"default": true,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Flux 2 Flex Edit — image-to-image editing using the flexible guidance Flux 2 Flex model.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringsafety_tolerancenumbernum_inference_stepsnumberguidance_scalenumberseedintegerenable_safety_checkerbooleanoutput_formatstringaspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2-flex%2Fedit",
"title": "Flux 2 Flex (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2-flex/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2-flex/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "Safety tolerance level — 1 = most strict, 5 = most permissive.",
"default": "2",
"type": "number",
"enum": [
1,
2,
3,
4,
5
]
},
"num_inference_steps": {
"title": "Steps",
"description": "The number of inference steps to perform.",
"default": 28,
"type": "number",
"minimum": 2,
"maximum": 50,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance Scale — how closely the model follows the prompt.",
"default": 3.5,
"type": "number",
"minimum": 1.5,
"maximum": 10,
"multipleOf": 0.1
},
"seed": {
"title": "Seed",
"description": "The seed to use for the generation.",
"type": "integer"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Whether to enable the safety checker.",
"default": true,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Flux 2 Klein 4B LoRA — fast 4B parameter Klein model with LoRA support for efficient custom training.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberaccelerationstringnegative_promptstringguidance_scalenumberenable_safety_checkerbooleannum_inference_stepsnumberoutput_formatstringseedintegeraspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2%2Fklein%2F4b%2Fbase%2Flora",
"title": "Flux 2 Klein 4B LoRA generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2/klein/4b/base/lora.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2/klein/4b/base/lora",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"lora_path": {
"title": "LoRA 1",
"description": "URL or path to the first LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale": {
"title": "LoRA 1 Scale",
"description": "Blend strength for LoRA 1 (0 = off, 1 = full).",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_2": {
"title": "LoRA 2",
"description": "URL or path to the second LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA 2 Scale",
"description": "Blend strength for LoRA 2.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_3": {
"title": "LoRA 3",
"description": "URL or path to the third LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA 3 Scale",
"description": "Blend strength for LoRA 3.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use for image generation.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular",
"high"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt for classifier-free guidance. Describes what to avoid in the image.",
"default": "",
"type": "string"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance scale for classifier-free guidance.",
"default": 5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 28,
"type": "number",
"minimum": 4,
"maximum": 50,
"multipleOf": 1
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"seed": {
"title": "Seed",
"description": "The seed to use for the generation. If not provided, a random seed will be used.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048",
"4096"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Flux 2 Klein 4B LoRA Edit — fast image-to-image editing with 4B Klein model and custom LoRA.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberaccelerationstringnegative_promptstringguidance_scalenumberenable_safety_checkerbooleannum_inference_stepsnumberoutput_formatstringseedintegeraspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2%2Fklein%2F4b%2Fbase%2Fedit%2Flora",
"title": "Flux 2 Klein 4B LoRA (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2/klein/4b/base/edit/lora.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2/klein/4b/base/edit/lora",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"lora_path": {
"title": "LoRA 1",
"description": "URL or path to the first LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale": {
"title": "LoRA 1 Scale",
"description": "Blend strength for LoRA 1 (0 = off, 1 = full).",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_2": {
"title": "LoRA 2",
"description": "URL or path to the second LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA 2 Scale",
"description": "Blend strength for LoRA 2.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_3": {
"title": "LoRA 3",
"description": "URL or path to the third LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA 3 Scale",
"description": "Blend strength for LoRA 3.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use for image generation.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular",
"high"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt for classifier-free guidance. Describes what to avoid in the image.",
"default": "",
"type": "string"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance scale for classifier-free guidance.",
"default": 5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 28,
"type": "number",
"minimum": 4,
"maximum": 50,
"multipleOf": 1
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"seed": {
"title": "Seed",
"description": "The seed to use for the generation. If not provided, a random seed will be used.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048",
"4096"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Flux 2 Klein 9B — distilled 9-billion parameter model for fast, high-quality generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_inference_stepsnumberseedintegerenable_safety_checkerbooleanoutput_formatstringaspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2%2Fklein%2F9b",
"title": "Flux 2 Klein 9B generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2/klein/9b.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2/klein/9b",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"num_inference_steps": {
"title": "Steps",
"description": "The number of inference steps to perform.",
"default": 4,
"type": "number",
"minimum": 4,
"maximum": 8,
"multipleOf": 1
},
"seed": {
"title": "Seed",
"description": "The seed to use for the generation. If not provided, a random seed will be used.",
"type": "integer"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048",
"4096"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Flux 2 Klein 9B Edit — fast image-to-image editing with the 9B distilled Klein model.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_inference_stepsnumberseedintegerenable_safety_checkerbooleanoutput_formatstringaspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2%2Fklein%2F9b%2Fedit",
"title": "Flux 2 Klein 9B (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2/klein/9b/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2/klein/9b/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"num_inference_steps": {
"title": "Steps",
"description": "The number of inference steps to perform.",
"default": 4,
"type": "number",
"minimum": 4,
"maximum": 8,
"multipleOf": 1
},
"seed": {
"title": "Seed",
"description": "The seed to use for the generation. If not provided, a random seed will be used.",
"type": "integer"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048",
"4096"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Flux 2 Klein 9B LoRA — 9B parameter Klein model with LoRA support for high-quality custom generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberaccelerationstringnegative_promptstringguidance_scalenumberenable_safety_checkerbooleannum_inference_stepsnumberoutput_formatstringseedintegeraspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2%2Fklein%2F9b%2Fbase%2Flora",
"title": "Flux 2 Klein 9B LoRA generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2/klein/9b/base/lora.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2/klein/9b/base/lora",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"lora_path": {
"title": "LoRA 1",
"description": "URL or path to the first LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale": {
"title": "LoRA 1 Scale",
"description": "Blend strength for LoRA 1 (0 = off, 1 = full).",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_2": {
"title": "LoRA 2",
"description": "URL or path to the second LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA 2 Scale",
"description": "Blend strength for LoRA 2.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_3": {
"title": "LoRA 3",
"description": "URL or path to the third LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA 3 Scale",
"description": "Blend strength for LoRA 3.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use for image generation.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular",
"high"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt for classifier-free guidance. Describes what to avoid in the image.",
"default": "",
"type": "string"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance scale for classifier-free guidance.",
"default": 5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 28,
"type": "number",
"minimum": 4,
"maximum": 50,
"multipleOf": 1
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"seed": {
"title": "Seed",
"description": "The seed to use for the generation. If not provided, a random seed will be used.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048",
"4096"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Flux 2 Klein 9B LoRA Edit — image-to-image editing with 9B Klein model and custom LoRA.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberaccelerationstringnegative_promptstringguidance_scalenumberenable_safety_checkerbooleannum_inference_stepsnumberoutput_formatstringseedintegeraspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2%2Fklein%2F9b%2Fbase%2Fedit%2Flora",
"title": "Flux 2 Klein 9B LoRA (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2/klein/9b/base/edit/lora.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2/klein/9b/base/edit/lora",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"lora_path": {
"title": "LoRA 1",
"description": "URL or path to the first LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale": {
"title": "LoRA 1 Scale",
"description": "Blend strength for LoRA 1 (0 = off, 1 = full).",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_2": {
"title": "LoRA 2",
"description": "URL or path to the second LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA 2 Scale",
"description": "Blend strength for LoRA 2.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_3": {
"title": "LoRA 3",
"description": "URL or path to the third LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA 3 Scale",
"description": "Blend strength for LoRA 3.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use for image generation.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular",
"high"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt for classifier-free guidance. Describes what to avoid in the image.",
"default": "",
"type": "string"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance scale for classifier-free guidance.",
"default": 5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 28,
"type": "number",
"minimum": 4,
"maximum": 50,
"multipleOf": 1
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"seed": {
"title": "Seed",
"description": "The seed to use for the generation. If not provided, a random seed will be used.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048",
"4096"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Flux 2 LoRA — text-to-image with custom LoRA weights using the Flux 2 dev base model.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberseedintegernum_inference_stepsnumberaccelerationstringenable_prompt_expansionbooleanenable_safety_checkerbooleanoutput_formatstringguidance_scalenumberaspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2%2Flora",
"title": "Flux 2 LoRA generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2/lora.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2/lora",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"lora_path": {
"title": "LoRA 1",
"description": "URL or path to the first LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale": {
"title": "LoRA 1 Scale",
"description": "Blend strength for LoRA 1 (0 = off, 1 = full).",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_2": {
"title": "LoRA 2",
"description": "URL or path to the second LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA 2 Scale",
"description": "Blend strength for LoRA 2.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_3": {
"title": "LoRA 3",
"description": "URL or path to the third LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA 3 Scale",
"description": "Blend strength for LoRA 3.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"seed": {
"title": "Seed",
"description": "The seed to use for the generation. If not provided, a random seed will be used.",
"type": "integer"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 28,
"type": "number",
"minimum": 4,
"maximum": 50,
"multipleOf": 1
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use for the image generation.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular",
"high"
]
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "If set to true, the prompt will be expanded for better results.",
"default": false,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance Scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you.",
"default": 2.5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Flux 2 LoRA Edit — image-to-image editing with custom LoRA weights using Flux 2.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberseedintegernum_inference_stepsnumberaccelerationstringenable_prompt_expansionbooleanenable_safety_checkerbooleanoutput_formatstringguidance_scalenumberaspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2%2Flora%2Fedit",
"title": "Flux 2 LoRA (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2/lora/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2/lora/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"lora_path": {
"title": "LoRA 1",
"description": "URL or path to the first LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale": {
"title": "LoRA 1 Scale",
"description": "Blend strength for LoRA 1 (0 = off, 1 = full).",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_2": {
"title": "LoRA 2",
"description": "URL or path to the second LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA 2 Scale",
"description": "Blend strength for LoRA 2.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_3": {
"title": "LoRA 3",
"description": "URL or path to the third LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA 3 Scale",
"description": "Blend strength for LoRA 3.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"seed": {
"title": "Seed",
"description": "The seed to use for the generation. If not provided, a random seed will be used.",
"type": "integer"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 28,
"type": "number",
"minimum": 4,
"maximum": 50,
"multipleOf": 1
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use for the image generation.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular",
"high"
]
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "If set to true, the prompt will be expanded for better results.",
"default": false,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance Scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you.",
"default": 2.5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Flux 2 Max — Black Forest Labs' highest-quality model with superior detail, coherence, and prompt adherence.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringsafety_tolerancenumberseedintegerenable_safety_checkerbooleanoutput_formatstringaspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2-max",
"title": "Flux 2 Max generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2-max.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2-max",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive.",
"default": "2",
"type": "number",
"enum": [
1,
2,
3,
4,
5
]
},
"seed": {
"title": "Seed",
"description": "The seed to use for the generation.",
"type": "integer"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Whether to enable the safety checker.",
"default": true,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048",
"4096"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Flux 2 Max Edit — maximum-quality inpainting and editing using Black Forest Labs' Flux 2 Max model.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringsafety_tolerancenumberseedintegerenable_safety_checkerbooleanoutput_formatstringaspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2-max%2Fedit",
"title": "Flux 2 Max (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2-max/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2-max/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive.",
"default": "2",
"type": "number",
"enum": [
1,
2,
3,
4,
5
]
},
"seed": {
"title": "Seed",
"description": "The seed to use for the generation.",
"type": "integer"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Whether to enable the safety checker.",
"default": true,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048",
"4096"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Flux 2 Pro — Black Forest Labs' flagship photorealistic model with best-in-class prompt following and detail.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringsafety_tolerancenumberseedintegerenable_safety_checkerbooleanoutput_formatstringaspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2-pro",
"title": "Flux 2 Pro generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2-pro.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2-pro",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "Safety tolerance level — 1 = most strict, 5 = most permissive.",
"default": "2",
"type": "number",
"enum": [
1,
2,
3,
4,
5
]
},
"seed": {
"title": "Seed",
"description": "The seed to use for the generation.",
"type": "integer"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Whether to enable the safety checker.",
"default": true,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048",
"4096"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Flux 2 Pro Edit — professional-grade inpainting and image editing using Black Forest Labs' Flux 2 Pro model.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringsafety_tolerancenumberseedintegerenable_safety_checkerbooleanoutput_formatstringaspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2-pro%2Fedit",
"title": "Flux 2 Pro (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2-pro/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2-pro/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "Safety tolerance level — 1 = most strict, 5 = most permissive.",
"default": "2",
"type": "number",
"enum": [
1,
2,
3,
4,
5
]
},
"seed": {
"title": "Seed",
"description": "The seed to use for the generation.",
"type": "integer"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Whether to enable the safety checker.",
"default": true,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048",
"4096"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Flux 2 Pro Outpaint — expand images in any direction with AI-generated content using Black Forest Labs' Flux 2 Pro.
Pricing: ~$0.045 typical (input + first output MP; large expansions add $0.015/MP)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringexpand_topnumberexpand_rightnumberexpand_bottomnumberexpand_leftnumberauto_cropbooleanenable_safety_checkerbooleanoutput_formatstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2-pro%2Foutpaint",
"title": "Flux 2 Pro Outpaint generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2-pro/outpaint.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2-pro/outpaint",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"expand_top": {
"title": "Expand Top",
"description": "Pixels to expand at the top of the image.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 2048,
"multipleOf": 1
},
"expand_right": {
"title": "Expand Right",
"description": "Pixels to expand on the right of the image.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 2048,
"multipleOf": 1
},
"expand_bottom": {
"title": "Expand Bottom",
"description": "Pixels to expand at the bottom of the image.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 2048,
"multipleOf": 1
},
"expand_left": {
"title": "Expand Left",
"description": "Pixels to expand on the left of the image.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 2048,
"multipleOf": 1
},
"auto_crop": {
"title": "Auto Crop",
"description": "Automatically crop the reference image when the expanded canvas does not fully contain it.",
"default": false,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Whether to enable the safety checker.",
"default": true,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Flux 2 Turbo — fast distilled version of Flux 2 for rapid iteration and large-batch generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenable_prompt_expansionbooleanenable_safety_checkerbooleanguidance_scalenumberseedintegeroutput_formatstringaspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2%2Fturbo",
"title": "Flux 2 Turbo generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2/turbo.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2/turbo",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "If set to true, the prompt will be expanded for better results.",
"default": false,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance Scale — how closely the model follows the prompt.",
"default": 2.5,
"type": "number",
"minimum": 0,
"maximum": 20,
"multipleOf": 0.1
},
"seed": {
"title": "Seed",
"description": "The seed to use for the generation. If not provided, a random seed will be used.",
"type": "integer"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048",
"4096"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Flux 2 Turbo Edit — fast image-to-image editing with the Flux 2 Turbo distilled model.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenable_prompt_expansionbooleanenable_safety_checkerbooleanguidance_scalenumberseedintegeroutput_formatstringaspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2%2Fturbo%2Fedit",
"title": "Flux 2 Turbo (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2/turbo/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2/turbo/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "If set to true, the prompt will be expanded for better results.",
"default": false,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance Scale — how closely the model follows the prompt.",
"default": 2.5,
"type": "number",
"minimum": 0,
"maximum": 20,
"multipleOf": 0.1
},
"seed": {
"title": "Seed",
"description": "The seed to use for the generation. If not provided, a random seed will be used.",
"type": "integer"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048",
"4096"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Flux 2 Virtual Try-On — virtually try on garments by combining a person photo with a clothing photo.
Pricing: $0.021 / processed MP — ~3 MP typical (2 inputs + output)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaccelerationstringnum_inference_stepsnumberlora_scalenumberenable_safety_checkerbooleanoutput_formatstringseedintegerguidance_scalenumberreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-2-lora-gallery%2Fvirtual-tryon",
"title": "Flux 2 Virtual Try-On generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-2-lora-gallery/virtual-tryon.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-2-lora-gallery/virtual-tryon",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"acceleration": {
"title": "Acceleration",
"description": "Acceleration level for image generation. 'regular' balances speed and quality.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular"
]
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 40,
"type": "number",
"minimum": 4,
"maximum": 50,
"multipleOf": 1
},
"lora_scale": {
"title": "Lora Scale",
"description": "The strength of the virtual try-on effect.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 2
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "The format of the output image",
"default": "png",
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
]
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. Same seed with same prompt will produce same result.",
"type": "integer"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale. Controls how closely the model follows the prompt.",
"default": 2.5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 2
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Flux Pro Kontext — Black Forest Labs' reference-guided editing model that precisely follows text instructions while preserving context.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenhance_promptbooleanseedintegersafety_tolerancenumberguidance_scalenumberaspect_ratiostringoutput_formatstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-pro%2Fkontext",
"title": "Flux Pro Kontext generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-pro/kontext.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-pro/kontext",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enhance_prompt": {
"title": "Enhance Prompt",
"description": "Whether to enhance the prompt for better results.",
"default": false,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same image every time.",
"type": "integer"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive.",
"default": "2",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 3.5,
"type": "number",
"minimum": 1,
"maximum": 20,
"multipleOf": 0.1
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3"
]
},
"output_format": {
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Flux Pro Kontext Text to Image — Black Forest Labs' Kontext model for text-to-image generation without a reference image.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenhance_promptbooleanseedintegersafety_tolerancenumberguidance_scalenumberaspect_ratiostringoutput_formatstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-pro%2Fkontext%2Ftext-to-image",
"title": "Flux Pro Kontext (Text → Image) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-pro/kontext/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-pro/kontext/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enhance_prompt": {
"title": "Enhance Prompt",
"description": "Whether to enhance the prompt for better results.",
"default": false,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same image every time.",
"type": "integer"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive.",
"default": "2",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 3.5,
"type": "number",
"minimum": 1,
"maximum": 20,
"multipleOf": 0.1
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3",
"21:9",
"9:21"
]
},
"output_format": {
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Flux Pro Kontext Max — the highest-quality version of Black Forest Labs' reference-guided editing model.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenhance_promptbooleanseedintegersafety_tolerancenumberguidance_scalenumberaspect_ratiostringoutput_formatstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-pro%2Fkontext%2Fmax",
"title": "Flux Pro Kontext Max generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-pro/kontext/max.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-pro/kontext/max",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enhance_prompt": {
"title": "Enhance Prompt",
"description": "Whether to enhance the prompt for better results.",
"default": false,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same image every time.",
"type": "integer"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive.",
"default": "2",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 3.5,
"type": "number",
"minimum": 1,
"maximum": 20,
"multipleOf": 0.1
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3",
"21:9",
"9:21"
]
},
"output_format": {
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Flux Pro Kontext Max Multi — multi-reference version of Kontext Max for editing with multiple input images.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenhance_promptbooleanseedintegersafety_tolerancenumberguidance_scalenumberaspect_ratiostringoutput_formatstringnum_imagesintegerreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-pro%2Fkontext%2Fmax%2Fmulti",
"title": "Flux Pro Kontext Max (Multi) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-pro/kontext/max/multi.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-pro/kontext/max/multi",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enhance_prompt": {
"title": "Enhance Prompt",
"description": "Whether to enhance the prompt for better results.",
"default": false,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same image every time.",
"type": "integer"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive.",
"default": "2",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 3.5,
"type": "number",
"minimum": 1,
"maximum": 20,
"multipleOf": 0.1
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3",
"21:9",
"9:21"
]
},
"output_format": {
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 4
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Flux Pro Virtual Try-On — realistic garment try-on from a person image and a garment reference.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringoutput_formatstringseedintegerreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-pro%2Fv1%2Fvto",
"title": "Flux Pro VTO generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-pro/v1/vto.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-pro/v1/vto",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"seed": {
"title": "Seed",
"description": "The same seed and the same input will output the same image every time.",
"type": "integer"
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 2,
"maxItems": 2
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Flux PuLID — Flux-backbone identity preservation for high-quality consistent portraits with natural lighting and sharp detail.
Pricing: $0.0333 / megapixel
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_inference_stepsnumberid_weightnumberguidance_scalenumbertrue_cfgnumberstart_stepnumbermax_sequence_lengthstringnegative_promptstringenable_safety_checkerbooleanseedintegeraspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-pulid",
"title": "Flux PuLID generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-pulid.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-pulid",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"num_inference_steps": {
"title": "Steps",
"description": "Number of denoising steps. Higher = more detail.",
"default": 20,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"id_weight": {
"title": "Identity Weight",
"description": "Strength of face identity preservation. Higher = closer match to the reference.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "How closely the model follows the prompt.",
"default": 4,
"type": "number",
"minimum": 0,
"maximum": 20,
"multipleOf": 0.5
},
"true_cfg": {
"title": "True CFG",
"description": "True classifier-free guidance scale. 1 uses the faster distilled guidance; above 1 switches to real CFG.",
"default": 1,
"type": "number",
"minimum": 1,
"maximum": 10,
"multipleOf": 0.5
},
"start_step": {
"title": "ID Start Step",
"description": "Denoising step at which identity conditioning kicks in. Later start = more prompt freedom, weaker likeness.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 50,
"multipleOf": 1
},
"max_sequence_length": {
"title": "Max Sequence Length",
"description": "Maximum prompt token length. Longer allows more detailed prompts at some speed cost.",
"default": "128",
"type": "string",
"enum": [
"128",
"256",
"512"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Elements to exclude from the generated image.",
"default": "",
"type": "string"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Whether to enable the safety checker.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
FLUX.1 General — advanced LoRA-capable generation with NAG, reference-only, and full ControlNet support.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberoutput_formatstringbase_shiftnumbersigma_schedulestringreference_endnumberreal_cfg_scalenumbernag_endnumberreference_strengthnumberseedintegeruse_beta_schedulebooleannegative_promptstringnag_taunumberreference_startnumbermax_shiftnumberguidance_scalenumberreference_image_urlstringschedulerstringnag_alphanumberuse_cfg_zerobooleanuse_real_cfgbooleannag_scalenumberenable_safety_checkerbooleannum_inference_stepsnumberfill_imagestringcontrolnetsobjectcontrolnet_unionsobjectip_adaptersobjectcontrol_lorasobjecteasycontrolsobjectaspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-general",
"title": "FLUX.1 General generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-general.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-general",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"lora_path": {
"title": "LoRA 1",
"description": "URL or path to the first LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale": {
"title": "LoRA 1 Scale",
"description": "Blend strength for LoRA 1 (0 = off, 1 = full).",
"default": 1,
"type": "number",
"minimum": -4,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_2": {
"title": "LoRA 2",
"description": "URL or path to the second LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA 2 Scale",
"description": "Blend strength for LoRA 2.",
"default": 1,
"type": "number",
"minimum": -4,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_3": {
"title": "LoRA 3",
"description": "URL or path to the third LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA 3 Scale",
"description": "Blend strength for LoRA 3.",
"default": 1,
"type": "number",
"minimum": -4,
"maximum": 4,
"multipleOf": 0.05
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"base_shift": {
"title": "Base Shift",
"description": "Base shift for the scheduled timesteps",
"default": 0.5,
"type": "number",
"minimum": 0.01,
"maximum": 5
},
"sigma_schedule": {
"title": "Sigma Schedule",
"description": "Sigmas schedule for the denoising process.",
"type": "string",
"enum": [
"sgm_uniform"
]
},
"reference_end": {
"title": "Reference End",
"description": "The percentage of the total timesteps when the reference guidance is to be ended.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"real_cfg_scale": {
"title": "Real Cfg Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 3.5,
"type": "number",
"minimum": 0,
"maximum": 5
},
"nag_end": {
"title": "Nag End",
"description": "The proportion of steps to apply NAG. After the specified proportion of steps has been iterated, the remaining steps will use original attention proce",
"default": 0.25,
"type": "number",
"maximum": 1
},
"reference_strength": {
"title": "Reference Strength",
"description": "Strength of reference_only generation. Only used if a reference image is provided.",
"default": 0.65,
"type": "number",
"minimum": -3,
"maximum": 3
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same image every time.",
"type": "integer"
},
"use_beta_schedule": {
"title": "Use Beta Schedule",
"description": "Specifies whether beta sigmas ought to be used.",
"default": false,
"type": "boolean"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt to steer the image generation away from unwanted features. By default, we will be using NAG for processing the negative prompt.",
"default": "",
"type": "string"
},
"nag_tau": {
"title": "Nag Tau",
"description": "The tau for NAG. Controls the normalization of the hidden state. Higher values will result in a less aggressive normalization, but may also lead to un",
"default": 2.5,
"type": "number"
},
"reference_start": {
"title": "Reference Start",
"description": "The percentage of the total timesteps when the reference guidance is to bestarted.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 1
},
"max_shift": {
"title": "Max Shift",
"description": "Max shift for the scheduled timesteps",
"default": 1.15,
"type": "number",
"minimum": 0.01,
"maximum": 5
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 3.5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"reference_image_url": {
"title": "Reference Image Url",
"description": "URL of Image for Reference-Only",
"type": "string"
},
"scheduler": {
"title": "Scheduler",
"description": "Scheduler for the denoising process.",
"default": "euler",
"type": "string",
"enum": [
"euler",
"dpmpp_2m"
]
},
"nag_alpha": {
"title": "Nag Alpha",
"description": "The alpha value for NAG. This value is used as a final weighting factor for steering the normalized guidance (positive and negative prompts) in the di",
"default": 0.25,
"type": "number",
"maximum": 1
},
"use_cfg_zero": {
"title": "Use Cfg Zero",
"description": "Uses CFG-zero init sampling as in https://arxiv.org/abs/2503.18886.",
"default": false,
"type": "boolean"
},
"use_real_cfg": {
"title": "Use Real Cfg",
"description": "Uses classical CFG as in SD1.5, SDXL, etc. Increases generation times and price when set to be true. If using XLabs IP-Adapter v1, this will be turned",
"default": false,
"type": "boolean"
},
"nag_scale": {
"title": "Nag Scale",
"description": "The scale for NAG. Higher values will result in a image that is more distant to the negative prompt.",
"default": 3,
"type": "number",
"maximum": 10
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 28,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"fill_image": {
"title": "Fill Image URL",
"description": "URL of an image used to fill masked areas / influence the generation.",
"type": "string"
},
"controlnets": {
"title": "ControlNets (JSON)",
"description": "JSON array of ControlNet configs, e.g. [{\"path\":\"...\",\"control_image_url\":\"...\",\"conditioning_scale\":1}]. Only one controlnet is supported at this time.",
"type": "object",
"additionalProperties": true
},
"controlnet_unions": {
"title": "ControlNet Unions (JSON)",
"description": "JSON array of ControlNet Union configs, e.g. [{\"path\":\"...\",\"controls\":[...]}].",
"type": "object",
"additionalProperties": true
},
"ip_adapters": {
"title": "IP-Adapters (JSON)",
"description": "JSON array of IP-Adapter configs, e.g. [{\"path\":\"...\",\"image_encoder_path\":\"...\",\"image_url\":\"...\",\"scale\":1}].",
"type": "object",
"additionalProperties": true
},
"control_loras": {
"title": "Control LoRAs (JSON)",
"description": "JSON array of control-image LoRAs, e.g. [{\"path\":\"...\",\"control_image_url\":\"...\",\"scale\":1,\"preprocess\":\"canny\"}].",
"type": "object",
"additionalProperties": true
},
"easycontrols": {
"title": "EasyControls (JSON)",
"description": "JSON array of EasyControl inputs, e.g. [{\"control_method_url\":\"...\",\"image_url\":\"...\",\"image_control_type\":\"...\",\"scale\":1}].",
"type": "object",
"additionalProperties": true
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
FLUX.1 General Image-to-Image — advanced reference-guided editing with NAG and ControlNet support.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberstrengthnumberoutput_formatstringbase_shiftnumbersigma_schedulestringreference_endnumberreal_cfg_scalenumbernag_endnumberseedintegerreference_strengthnumberuse_beta_schedulebooleannegative_promptstringreference_startnumbernag_taunumbermax_shiftnumberguidance_scalenumberreference_image_urlstringschedulerstringnag_alphanumberuse_cfg_zerobooleanuse_real_cfgbooleannag_scalenumberenable_safety_checkerbooleannum_inference_stepsnumberfill_imagestringcontrolnetsobjectcontrolnet_unionsobjectip_adaptersobjectcontrol_lorasobjecteasycontrolsobjectaspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-general%2Fimage-to-image",
"title": "FLUX.1 General (I2I) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-general/image-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-general/image-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"lora_path": {
"title": "LoRA 1",
"description": "URL or path to the first LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale": {
"title": "LoRA 1 Scale",
"description": "Blend strength for LoRA 1 (0 = off, 1 = full).",
"default": 1,
"type": "number",
"minimum": -4,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_2": {
"title": "LoRA 2",
"description": "URL or path to the second LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA 2 Scale",
"description": "Blend strength for LoRA 2.",
"default": 1,
"type": "number",
"minimum": -4,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_3": {
"title": "LoRA 3",
"description": "URL or path to the third LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA 3 Scale",
"description": "Blend strength for LoRA 3.",
"default": 1,
"type": "number",
"minimum": -4,
"maximum": 4,
"multipleOf": 0.05
},
"strength": {
"title": "Strength",
"description": "The strength to use for inpainting/image-to-image. Only used if the image_url is provided. 1.0 is completely remakes the image while 0.0 preserves the",
"default": 0.85,
"type": "number",
"minimum": 0.01,
"maximum": 1
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"base_shift": {
"title": "Base Shift",
"description": "Base shift for the scheduled timesteps",
"default": 0.5,
"type": "number",
"minimum": 0.01,
"maximum": 5
},
"sigma_schedule": {
"title": "Sigma Schedule",
"description": "Sigmas schedule for the denoising process.",
"type": "string",
"enum": [
"sgm_uniform"
]
},
"reference_end": {
"title": "Reference End",
"description": "The percentage of the total timesteps when the reference guidance is to be ended.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"real_cfg_scale": {
"title": "Real Cfg Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 3.5,
"type": "number",
"minimum": 0,
"maximum": 5
},
"nag_end": {
"title": "Nag End",
"description": "The proportion of steps to apply NAG. After the specified proportion of steps has been iterated, the remaining steps will use original attention proce",
"default": 0.25,
"type": "number",
"maximum": 1
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same image every time.",
"type": "integer"
},
"reference_strength": {
"title": "Reference Strength",
"description": "Strength of reference_only generation. Only used if a reference image is provided.",
"default": 0.65,
"type": "number",
"minimum": -3,
"maximum": 3
},
"use_beta_schedule": {
"title": "Use Beta Schedule",
"description": "Specifies whether beta sigmas ought to be used.",
"default": false,
"type": "boolean"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt to steer the image generation away from unwanted features. By default, we will be using NAG for processing the negative prompt.",
"default": "",
"type": "string"
},
"reference_start": {
"title": "Reference Start",
"description": "The percentage of the total timesteps when the reference guidance is to bestarted.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 1
},
"nag_tau": {
"title": "Nag Tau",
"description": "The tau for NAG. Controls the normalization of the hidden state. Higher values will result in a less aggressive normalization, but may also lead to un",
"default": 2.5,
"type": "number"
},
"max_shift": {
"title": "Max Shift",
"description": "Max shift for the scheduled timesteps",
"default": 1.15,
"type": "number",
"minimum": 0.01,
"maximum": 5
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 3.5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"reference_image_url": {
"title": "Reference Image Url",
"description": "URL of Image for Reference-Only",
"type": "string"
},
"scheduler": {
"title": "Scheduler",
"description": "Scheduler for the denoising process.",
"default": "euler",
"type": "string",
"enum": [
"euler",
"dpmpp_2m"
]
},
"nag_alpha": {
"title": "Nag Alpha",
"description": "The alpha value for NAG. This value is used as a final weighting factor for steering the normalized guidance (positive and negative prompts) in the di",
"default": 0.25,
"type": "number",
"maximum": 1
},
"use_cfg_zero": {
"title": "Use Cfg Zero",
"description": "Uses CFG-zero init sampling as in https://arxiv.org/abs/2503.18886.",
"default": false,
"type": "boolean"
},
"use_real_cfg": {
"title": "Use Real Cfg",
"description": "Uses classical CFG as in SD1.5, SDXL, etc. Increases generation times and price when set to be true. If using XLabs IP-Adapter v1, this will be turned",
"default": false,
"type": "boolean"
},
"nag_scale": {
"title": "Nag Scale",
"description": "The scale for NAG. Higher values will result in a image that is more distant to the negative prompt.",
"default": 3,
"type": "number",
"maximum": 10
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 28,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"fill_image": {
"title": "Fill Image URL",
"description": "URL of an image used to fill masked areas / influence the generation.",
"type": "string"
},
"controlnets": {
"title": "ControlNets (JSON)",
"description": "JSON array of ControlNet configs, e.g. [{\"path\":\"...\",\"control_image_url\":\"...\",\"conditioning_scale\":1}]. Only one controlnet is supported at this time.",
"type": "object",
"additionalProperties": true
},
"controlnet_unions": {
"title": "ControlNet Unions (JSON)",
"description": "JSON array of ControlNet Union configs, e.g. [{\"path\":\"...\",\"controls\":[...]}].",
"type": "object",
"additionalProperties": true
},
"ip_adapters": {
"title": "IP-Adapters (JSON)",
"description": "JSON array of IP-Adapter configs, e.g. [{\"path\":\"...\",\"image_encoder_path\":\"...\",\"image_url\":\"...\",\"scale\":1}].",
"type": "object",
"additionalProperties": true
},
"control_loras": {
"title": "Control LoRAs (JSON)",
"description": "JSON array of control-image LoRAs, e.g. [{\"path\":\"...\",\"control_image_url\":\"...\",\"scale\":1,\"preprocess\":\"canny\"}].",
"type": "object",
"additionalProperties": true
},
"easycontrols": {
"title": "EasyControls (JSON)",
"description": "JSON array of EasyControl inputs, e.g. [{\"control_method_url\":\"...\",\"image_url\":\"...\",\"image_control_type\":\"...\",\"scale\":1}].",
"type": "object",
"additionalProperties": true
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
FLUX.1 General Inpainting — advanced masked inpainting with NAG and full LoRA support.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberstrengthnumberoutput_formatstringbase_shiftnumbersigma_schedulestringreference_endnumberreal_cfg_scalenumbernag_endnumberseedintegerreference_strengthnumberuse_beta_schedulebooleannegative_promptstringreference_startnumbernag_taunumbermax_shiftnumberguidance_scalenumberreference_image_urlstringschedulerstringmask_urlstringnag_alphanumberuse_cfg_zerobooleanuse_real_cfgbooleannag_scalenumberenable_safety_checkerbooleannum_inference_stepsnumberfill_imagestringcontrolnetsobjectcontrolnet_unionsobjectip_adaptersobjectcontrol_lorasobjecteasycontrolsobjectaspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-general%2Finpainting",
"title": "FLUX.1 General Inpainting generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-general/inpainting.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-general/inpainting",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"lora_path": {
"title": "LoRA 1",
"description": "URL or path to the first LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale": {
"title": "LoRA 1 Scale",
"description": "Blend strength for LoRA 1 (0 = off, 1 = full).",
"default": 1,
"type": "number",
"minimum": -4,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_2": {
"title": "LoRA 2",
"description": "URL or path to the second LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA 2 Scale",
"description": "Blend strength for LoRA 2.",
"default": 1,
"type": "number",
"minimum": -4,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_3": {
"title": "LoRA 3",
"description": "URL or path to the third LoRA weights.",
"default": "",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA 3 Scale",
"description": "Blend strength for LoRA 3.",
"default": 1,
"type": "number",
"minimum": -4,
"maximum": 4,
"multipleOf": 0.05
},
"strength": {
"title": "Strength",
"description": "The strength to use for inpainting/image-to-image. Only used if the image_url is provided. 1.0 is completely remakes the image while 0.0 preserves the",
"default": 0.85,
"type": "number",
"minimum": 0.01,
"maximum": 1
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"base_shift": {
"title": "Base Shift",
"description": "Base shift for the scheduled timesteps",
"default": 0.5,
"type": "number",
"minimum": 0.01,
"maximum": 5
},
"sigma_schedule": {
"title": "Sigma Schedule",
"description": "Sigmas schedule for the denoising process.",
"type": "string",
"enum": [
"sgm_uniform"
]
},
"reference_end": {
"title": "Reference End",
"description": "The percentage of the total timesteps when the reference guidance is to be ended.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"real_cfg_scale": {
"title": "Real Cfg Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 3.5,
"type": "number",
"minimum": 0,
"maximum": 5
},
"nag_end": {
"title": "Nag End",
"description": "The proportion of steps to apply NAG. After the specified proportion of steps has been iterated, the remaining steps will use original attention proce",
"default": 0.25,
"type": "number",
"minimum": 0,
"maximum": 1
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same image every time.",
"type": "integer"
},
"reference_strength": {
"title": "Reference Strength",
"description": "Strength of reference_only generation. Only used if a reference image is provided.",
"default": 0.65,
"type": "number",
"minimum": -3,
"maximum": 3
},
"use_beta_schedule": {
"title": "Use Beta Schedule",
"description": "Specifies whether beta sigmas ought to be used.",
"default": false,
"type": "boolean"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt to steer the image generation away from unwanted features. By default, we will be using NAG for processing the negative prompt.",
"default": "",
"type": "string"
},
"reference_start": {
"title": "Reference Start",
"description": "The percentage of the total timesteps when the reference guidance is to bestarted.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 1
},
"nag_tau": {
"title": "Nag Tau",
"description": "The tau for NAG. Controls the normalization of the hidden state. Higher values will result in a less aggressive normalization, but may also lead to un",
"default": 2.5,
"type": "number",
"minimum": 0
},
"max_shift": {
"title": "Max Shift",
"description": "Max shift for the scheduled timesteps",
"default": 1.15,
"type": "number",
"minimum": 0.01,
"maximum": 5
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 3.5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"reference_image_url": {
"title": "Reference Image Url",
"description": "URL of Image for Reference-Only",
"type": "string"
},
"scheduler": {
"title": "Scheduler",
"description": "Scheduler for the denoising process.",
"default": "euler",
"type": "string",
"enum": [
"euler",
"dpmpp_2m"
]
},
"mask_url": {
"title": "Mask Url",
"description": "The mask to area to Inpaint in.",
"type": "string"
},
"nag_alpha": {
"title": "Nag Alpha",
"description": "The alpha value for NAG. This value is used as a final weighting factor for steering the normalized guidance (positive and negative prompts) in the di",
"default": 0.25,
"type": "number",
"minimum": 0,
"maximum": 1
},
"use_cfg_zero": {
"title": "Use Cfg Zero",
"description": "Uses CFG-zero init sampling as in https://arxiv.org/abs/2503.18886.",
"default": false,
"type": "boolean"
},
"use_real_cfg": {
"title": "Use Real Cfg",
"description": "Uses classical CFG as in SD1.5, SDXL, etc. Increases generation times and price when set to be true. If using XLabs IP-Adapter v1, this will be turned",
"default": false,
"type": "boolean"
},
"nag_scale": {
"title": "Nag Scale",
"description": "The scale for NAG. Higher values will result in a image that is more distant to the negative prompt.",
"default": 3,
"type": "number",
"minimum": 1,
"maximum": 10
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 28,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"fill_image": {
"title": "Fill Image URL",
"description": "URL of an image used to fill masked areas / influence the generation.",
"type": "string"
},
"controlnets": {
"title": "ControlNets (JSON)",
"description": "JSON array of ControlNet configs, e.g. [{\"path\":\"...\",\"control_image_url\":\"...\",\"conditioning_scale\":1}]. Only one controlnet is supported at this time.",
"type": "object",
"additionalProperties": true
},
"controlnet_unions": {
"title": "ControlNet Unions (JSON)",
"description": "JSON array of ControlNet Union configs, e.g. [{\"path\":\"...\",\"controls\":[...]}].",
"type": "object",
"additionalProperties": true
},
"ip_adapters": {
"title": "IP-Adapters (JSON)",
"description": "JSON array of IP-Adapter configs, e.g. [{\"path\":\"...\",\"image_encoder_path\":\"...\",\"image_url\":\"...\",\"scale\":1}].",
"type": "object",
"additionalProperties": true
},
"control_loras": {
"title": "Control LoRAs (JSON)",
"description": "JSON array of control-image LoRAs, e.g. [{\"path\":\"...\",\"control_image_url\":\"...\",\"scale\":1,\"preprocess\":\"canny\"}].",
"type": "object",
"additionalProperties": true
},
"easycontrols": {
"title": "EasyControls (JSON)",
"description": "JSON array of EasyControl inputs, e.g. [{\"control_method_url\":\"...\",\"image_url\":\"...\",\"image_control_type\":\"...\",\"scale\":1}].",
"type": "object",
"additionalProperties": true
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt",
"mask_url",
"reference_image_url"
],
"additionalProperties": false
}
FLUX.1 Pro Erase — remove objects or text from images using a binary mask with Black Forest Labs' Pro model.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringdilate_pixelsnumberoutput_formatstringmask_urlstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-pro%2Fv1%2Ferase",
"title": "FLUX.1 Pro Erase generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-pro/v1/erase.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flux-pro/v1/erase",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"dilate_pixels": {
"title": "Dilate Pixels",
"description": "Number of pixels to expand the mask edges by. Higher values produce cleaner erase results around the masked region.",
"default": 10,
"type": "number",
"minimum": 0,
"maximum": 100,
"multipleOf": 1
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"mask_url": {
"title": "Mask Url",
"description": "The URL of a black/white mask image where white (255) marks pixels to erase and black (0) marks pixels to keep. Needs to match the dimensions of the i",
"type": "string"
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"mask_url",
"reference_image_url"
],
"additionalProperties": false
}
Google Virtual Try-On — generate realistic try-on images from a person photo and a clothing product photo.
Pricing: $0.075 per generated image (fal-published)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringperson_image_urlstringproduct_image_urlstringnum_imagesintegerreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=google%2Fvirtual-try-on",
"title": "Google Virtual Try-On generation request",
"description": "Request body accepted by POST /api/v1/generate for google/virtual-try-on.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "google/virtual-try-on",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"person_image_url": {
"type": "string",
"format": "uri"
},
"product_image_url": {
"type": "string",
"format": "uri"
},
"num_images": {
"type": "integer"
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 2,
"maxItems": 2
}
},
"required": [
"model_id",
"reference_image_urls"
],
"additionalProperties": false
}
GPT Image 2 — OpenAI's flagship image model with native text rendering, multilingual support, up to 2K output, and up to 16 reference images via the Edit variant.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringoutput_formatstringqualitystringmoderationstringoutput_compressionnumberaspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=openai%2Fgpt-image-2",
"title": "GPT Image 2 generation request",
"description": "Request body accepted by POST /api/v1/generate for openai/gpt-image-2.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "openai/gpt-image-2",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"output_format": {
"title": "Output Format",
"description": "Output format for the images",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"quality": {
"title": "Quality",
"description": "Quality for the generated image. Use 'auto' to let the model pick the best quality for the prompt.",
"default": "medium",
"type": "string",
"enum": [
"auto",
"low",
"medium",
"high"
]
},
"moderation": {
"title": "Moderation",
"description": "Content moderation strictness. 'low' uses less restrictive filtering.",
"default": "auto",
"type": "string",
"enum": [
"auto",
"low"
]
},
"output_compression": {
"title": "Output Compression",
"description": "Compression level for jpeg/webp output formats (100 = best quality).",
"default": 100,
"type": "number",
"minimum": 0,
"maximum": 100,
"multipleOf": 1
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"3:2",
"2:3",
"Auto"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
GPT Image 2 Edit — instruction-following image editing with up to 16 reference images, multilingual text, and up to 2K output.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringoutput_formatstringqualitystringmask_urlstringoutput_compressionnumberaspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=openai%2Fgpt-image-2%2Fedit",
"title": "GPT Image 2 (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for openai/gpt-image-2/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "openai/gpt-image-2/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"output_format": {
"title": "Output Format",
"description": "Output format for the images",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"quality": {
"title": "Quality",
"description": "Quality for the generated image. Use 'auto' to let the model pick the best quality for the prompt.",
"default": "medium",
"type": "string",
"enum": [
"auto",
"low",
"medium",
"high"
]
},
"mask_url": {
"title": "Mask URL",
"description": "URL of a mask image indicating which part of the image to edit (transparent areas are edited, opaque areas are preserved).",
"type": "string"
},
"output_compression": {
"title": "Output Compression",
"description": "Compression level for jpeg/webp output formats (100 = best quality).",
"default": 100,
"type": "number",
"minimum": 0,
"maximum": 100,
"multipleOf": 1
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"3:2",
"2:3",
"Auto"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 16
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
OpenAI's fast image model for everyday creative work. Five quality tiers through Max, transparent output, and 1K or 2K output.
Pricing: Estimated token-based pricing. Explicit quality and size determine output estimates; prompt tokens and 3,050 input tokens per reference are allowances, not measured usage. Actual OpenAI usage varies. 2K output is experimental.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringqualitystringoutput_formatstringbackgroundstringoutput_compressionnumbermoderationstringaspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=openai%2Fgpt-image-2.5-flare",
"title": "GPT Image 2.5 Flare generation request",
"description": "Request body accepted by POST /api/v1/generate for openai/gpt-image-2.5-flare.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "openai/gpt-image-2.5-flare",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"quality": {
"title": "Quality",
"description": "Explicit quality keeps the credit estimate aligned with the request. Low is the default; Max uses the most output tokens.",
"default": "low",
"type": "string",
"enum": [
"low",
"medium",
"high",
"xhigh",
"max"
]
},
"output_format": {
"title": "Output Format",
"default": "png",
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
]
},
"background": {
"title": "Background",
"description": "Transparent backgrounds require PNG or WebP.",
"default": "auto",
"type": "string",
"enum": [
"auto",
"opaque",
"transparent"
]
},
"output_compression": {
"title": "Output Compression",
"description": "JPEG/WebP only; 100 preserves the highest quality.",
"default": 100,
"type": "number",
"minimum": 0,
"maximum": 100,
"multipleOf": 1
},
"moderation": {
"title": "Moderation",
"default": "auto",
"type": "string",
"enum": [
"auto",
"low"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"3:2",
"2:3"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 10
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
OpenAI's fast image model for everyday creative work. Five quality tiers through Max, transparent output, and up to 16 reference images.
Pricing: Estimated token-based pricing. Explicit quality and size determine output estimates; prompt tokens and 3,050 input tokens per reference are allowances, not measured usage. Actual OpenAI usage varies. 2K output is experimental.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringqualitystringoutput_formatstringbackgroundstringoutput_compressionnumbermask_urlstringaspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=openai%2Fgpt-image-2.5-flare%2Fedit",
"title": "GPT Image 2.5 Flare (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for openai/gpt-image-2.5-flare/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "openai/gpt-image-2.5-flare/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"quality": {
"title": "Quality",
"description": "Explicit quality keeps the credit estimate aligned with the request. Low is the default; Max uses the most output tokens.",
"default": "low",
"type": "string",
"enum": [
"low",
"medium",
"high",
"xhigh",
"max"
]
},
"output_format": {
"title": "Output Format",
"default": "png",
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
]
},
"background": {
"title": "Background",
"description": "Transparent backgrounds require PNG or WebP.",
"default": "auto",
"type": "string",
"enum": [
"auto",
"opaque",
"transparent"
]
},
"output_compression": {
"title": "Output Compression",
"description": "JPEG/WebP only; 100 preserves the highest quality.",
"default": 100,
"type": "number",
"minimum": 0,
"maximum": 100,
"multipleOf": 1
},
"mask_url": {
"title": "Mask URL",
"description": "Transparent mask areas are edited; the mask applies to the first reference image.",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"3:2",
"2:3"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 10
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 16
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
OpenAI's flagship image model for precise generation and editing. Five quality tiers through Max, transparent output, and 1K or 2K output.
Pricing: Estimated token-based pricing. Explicit quality and size determine output estimates; prompt tokens and 3,050 input tokens per reference are allowances, not measured usage. Actual OpenAI usage varies. 2K output is experimental.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringqualitystringoutput_formatstringbackgroundstringoutput_compressionnumbermoderationstringaspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=openai%2Fgpt-image-2.5-sunburst",
"title": "GPT Image 2.5 Sunburst generation request",
"description": "Request body accepted by POST /api/v1/generate for openai/gpt-image-2.5-sunburst.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "openai/gpt-image-2.5-sunburst",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"quality": {
"title": "Quality",
"description": "Explicit quality keeps the credit estimate aligned with the request. Low is the default; Max uses the most output tokens.",
"default": "low",
"type": "string",
"enum": [
"low",
"medium",
"high",
"xhigh",
"max"
]
},
"output_format": {
"title": "Output Format",
"default": "png",
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
]
},
"background": {
"title": "Background",
"description": "Transparent backgrounds require PNG or WebP.",
"default": "auto",
"type": "string",
"enum": [
"auto",
"opaque",
"transparent"
]
},
"output_compression": {
"title": "Output Compression",
"description": "JPEG/WebP only; 100 preserves the highest quality.",
"default": 100,
"type": "number",
"minimum": 0,
"maximum": 100,
"multipleOf": 1
},
"moderation": {
"title": "Moderation",
"default": "auto",
"type": "string",
"enum": [
"auto",
"low"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"3:2",
"2:3"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 10
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
OpenAI's flagship image model for precise generation and editing. Five quality tiers through Max, transparent output, and up to 16 reference images.
Pricing: Estimated token-based pricing. Explicit quality and size determine output estimates; prompt tokens and 3,050 input tokens per reference are allowances, not measured usage. Actual OpenAI usage varies. 2K output is experimental.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringqualitystringoutput_formatstringbackgroundstringoutput_compressionnumbermask_urlstringaspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=openai%2Fgpt-image-2.5-sunburst%2Fedit",
"title": "GPT Image 2.5 Sunburst (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for openai/gpt-image-2.5-sunburst/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "openai/gpt-image-2.5-sunburst/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"quality": {
"title": "Quality",
"description": "Explicit quality keeps the credit estimate aligned with the request. Low is the default; Max uses the most output tokens.",
"default": "low",
"type": "string",
"enum": [
"low",
"medium",
"high",
"xhigh",
"max"
]
},
"output_format": {
"title": "Output Format",
"default": "png",
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
]
},
"background": {
"title": "Background",
"description": "Transparent backgrounds require PNG or WebP.",
"default": "auto",
"type": "string",
"enum": [
"auto",
"opaque",
"transparent"
]
},
"output_compression": {
"title": "Output Compression",
"description": "JPEG/WebP only; 100 preserves the highest quality.",
"default": 100,
"type": "number",
"minimum": 0,
"maximum": 100,
"multipleOf": 1
},
"mask_url": {
"title": "Mask URL",
"description": "Transparent mask areas are edited; the mask applies to the first reference image.",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"3:2",
"2:3"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 10
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 16
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Grok Imagine — xAI's fast creative image generator with web-search-augmented prompting and high visual quality.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaspect_ratiostringresolutionstringoutput_formatstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=xai%2Fgrok-imagine-image",
"title": "Grok Imagine generation request",
"description": "Request body accepted by POST /api/v1/generate for xai/grok-imagine-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "xai/grok-imagine-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3"
]
},
"resolution": {
"type": "string",
"enum": [
"1k",
"2k"
]
},
"output_format": {
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Grok Imagine Edit — instruction-based image editing powered by xAI's Grok model.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaspect_ratiostringresolutionstringoutput_formatstringnum_imagesintegerreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=xai%2Fgrok-imagine-image%2Fedit",
"title": "Grok Imagine (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for xai/grok-imagine-image/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "xai/grok-imagine-image/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3"
]
},
"resolution": {
"type": "string",
"enum": [
"1k",
"2k"
]
},
"output_format": {
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 3
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
xAI Grok Imagine Image 2.0 creates polished images with selectable Low or Medium quality and output up to 2K.
Pricing: Quality-aware per-image pricing at 1K and 2K on fal.ai.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_imagesintegeraspect_ratiostringresolutionstringoutput_formatstringqualitystring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=xai%2Fgrok-imagine-image%2Fv2.0%2Ftext-to-image",
"title": "Grok Imagine Image 2.0 generation request",
"description": "Request body accepted by POST /api/v1/generate for xai/grok-imagine-image/v2.0/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "xai/grok-imagine-image/v2.0/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"maxLength": 8000
},
"num_images": {
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"2:1",
"20:9",
"19.5:9",
"16:9",
"4:3",
"3:2",
"1:1",
"2:3",
"3:4",
"9:16",
"9:19.5",
"9:20",
"1:2"
]
},
"resolution": {
"type": "string",
"enum": [
"1k",
"2k"
]
},
"output_format": {
"type": "string"
},
"quality": {
"type": "string"
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
xAI Grok Imagine Image 2.0 Edit performs precise instruction-based edits with up to three source images and output up to 2K.
Pricing: Quality-aware output pricing at 1K and 2K, plus a per-input-image charge on fal.ai.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_imagesintegeraspect_ratiostringresolutionstringoutput_formatstringimage_urlsarrayqualitystring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=xai%2Fgrok-imagine-image%2Fv2.0%2Fedit",
"title": "Grok Imagine Image 2.0 (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for xai/grok-imagine-image/v2.0/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "xai/grok-imagine-image/v2.0/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"maxLength": 8000
},
"num_images": {
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"2:1",
"20:9",
"19.5:9",
"16:9",
"4:3",
"3:2",
"1:1",
"2:3",
"3:4",
"9:16",
"9:19.5",
"9:20",
"1:2"
]
},
"resolution": {
"type": "string",
"enum": [
"1k",
"2k"
]
},
"output_format": {
"type": "string"
},
"image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 1,
"maxItems": 3
},
"quality": {
"type": "string"
}
},
"required": [
"model_id",
"prompt",
"image_urls"
],
"additionalProperties": false
}
Grok Imagine Quality — xAI's high-fidelity image generator with enhanced details, stronger text rendering, and 2K resolution support.
Pricing: $0.05 / img (1k) · $0.07 / img (2k)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaspect_ratiostringresolutionstringoutput_formatstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=xai%2Fgrok-imagine-image%2Fquality%2Ftext-to-image",
"title": "Grok Imagine Quality generation request",
"description": "Request body accepted by POST /api/v1/generate for xai/grok-imagine-image/quality/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "xai/grok-imagine-image/quality/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"2:1",
"20:9",
"19.5:9",
"16:9",
"4:3",
"3:2",
"1:1",
"2:3",
"3:4",
"9:16",
"9:19.5",
"9:20",
"1:2"
]
},
"resolution": {
"type": "string",
"enum": [
"1k",
"2k"
]
},
"output_format": {
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Grok Imagine Quality Edit — instruction-based image editing using xAI's most advanced model with enhanced details and higher creative control.
Pricing: $0.05 / img (1k) · $0.07 / img (2k) + $0.01 per input image
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaspect_ratiostringresolutionstringoutput_formatstringnum_imagesintegerreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=xai%2Fgrok-imagine-image%2Fquality%2Fedit",
"title": "Grok Imagine Quality (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for xai/grok-imagine-image/quality/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "xai/grok-imagine-image/quality/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"2:1",
"1:2",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3"
]
},
"resolution": {
"type": "string",
"enum": [
"1k",
"2k"
]
},
"output_format": {
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 3
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
HiDream Edit — instruction-based image editing using HiDream I1 Full for high-quality transformations with LoRA support.
Pricing: ~$0.05 / MP · 1024² ≈ 13 cr · 2048² ≈ 50 cr
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_inference_stepsnumberguidance_scalenumberstrengthnumbernegative_promptstringenable_safety_checkerbooleanlora_pathstringlora_scalenumberlora_weight_namestringlora_path_2stringlora_scale_2numberlora_weight_name_2stringlora_path_3stringlora_scale_3numberlora_weight_name_3stringoutput_formatstringseedintegeraspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fhidream-i1-full%2Fimage-to-image",
"title": "HiDream Edit generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/hidream-i1-full/image-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/hidream-i1-full/image-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"num_inference_steps": {
"title": "Steps",
"description": "Number of inference steps. More = higher quality, slower.",
"default": 50,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "How closely to follow the prompt. Higher = more faithful, less creative.",
"default": 5,
"type": "number",
"minimum": 0,
"maximum": 20,
"multipleOf": 0.1
},
"strength": {
"title": "Strength",
"description": "Denoising strength. 0 = identical to input, 1 = full transformation.",
"default": 0.75,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.01
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Elements to exclude from the image — colors, objects, styles, or qualities to avoid.",
"default": "",
"type": "string"
},
"enable_safety_checker": {
"title": "Safety Checker",
"description": "Filter potentially unsafe content from the output.",
"default": true,
"type": "boolean"
},
"lora_path": {
"title": "LoRA Path",
"description": "URL or Hugging Face path to LoRA weights (e.g. username/repo or https://…).",
"type": "string"
},
"lora_scale": {
"title": "LoRA Scale",
"description": "Strength of the LoRA effect. 1 = default weight, higher = stronger influence.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_weight_name": {
"title": "LoRA Weight Name",
"description": "Safetensors filename within the HuggingFace repo (only needed if the repo has multiple .safetensors files).",
"type": "string"
},
"lora_path_2": {
"title": "LoRA Path 2",
"description": "URL or Hugging Face path to a second set of LoRA weights.",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA Scale 2",
"description": "Strength of the second LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_weight_name_2": {
"title": "LoRA Weight Name 2",
"description": "Safetensors filename for the second LoRA repo (optional).",
"type": "string"
},
"lora_path_3": {
"title": "LoRA Path 3",
"description": "URL or Hugging Face path to a third set of LoRA weights.",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA Scale 3",
"description": "Strength of the third LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_weight_name_3": {
"title": "LoRA Weight Name 3",
"description": "Safetensors filename for the third LoRA repo (optional).",
"type": "string"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt will output the same image every time.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
HiDream I1 Full — 17B-parameter open-source text-to-image model delivering state-of-the-art photorealism with LoRA support.
Pricing: ~$0.05 / MP · 1024² ≈ 13 cr · 2048² ≈ 50 cr
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_inference_stepsnumberguidance_scalenumbernegative_promptstringenable_safety_checkerbooleanlora_pathstringlora_scalenumberlora_weight_namestringlora_path_2stringlora_scale_2numberlora_weight_name_2stringlora_path_3stringlora_scale_3numberlora_weight_name_3stringoutput_formatstringseedintegeraspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fhidream-i1-full",
"title": "HiDream I1 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/hidream-i1-full.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/hidream-i1-full",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"num_inference_steps": {
"title": "Steps",
"description": "Number of inference steps. More = higher quality, slower.",
"default": 50,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "How closely to follow the prompt. Higher = more faithful, less creative.",
"default": 5,
"type": "number",
"minimum": 0,
"maximum": 20,
"multipleOf": 0.1
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Elements to exclude from the image — colors, objects, styles, or qualities to avoid.",
"default": "",
"type": "string"
},
"enable_safety_checker": {
"title": "Safety Checker",
"description": "Filter potentially unsafe content from the output.",
"default": true,
"type": "boolean"
},
"lora_path": {
"title": "LoRA Path",
"description": "URL or Hugging Face path to LoRA weights (e.g. username/repo or https://…).",
"type": "string"
},
"lora_scale": {
"title": "LoRA Scale",
"description": "Strength of the LoRA effect. 1 = default weight, higher = stronger influence.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_weight_name": {
"title": "LoRA Weight Name",
"description": "Safetensors filename within the HuggingFace repo (only needed if the repo has multiple .safetensors files).",
"type": "string"
},
"lora_path_2": {
"title": "LoRA Path 2",
"description": "URL or Hugging Face path to a second set of LoRA weights.",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA Scale 2",
"description": "Strength of the second LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_weight_name_2": {
"title": "LoRA Weight Name 2",
"description": "Safetensors filename for the second LoRA repo (optional).",
"type": "string"
},
"lora_path_3": {
"title": "LoRA Path 3",
"description": "URL or Hugging Face path to a third set of LoRA weights.",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA Scale 3",
"description": "Strength of the third LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_weight_name_3": {
"title": "LoRA Weight Name 3",
"description": "Safetensors filename for the third LoRA repo (optional).",
"type": "string"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt will output the same image every time.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
HiDream I1 Fast — accelerated 17B-parameter text-to-image model delivering high quality in just 16 steps.
Pricing: ~$0.01 / MP · 1024² ≈ 3 cr · 2048² ≈ 10 cr
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_inference_stepsnumbernegative_promptstringenable_safety_checkerbooleanoutput_formatstringseedintegeraspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fhidream-i1-fast",
"title": "HiDream I1 Fast generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/hidream-i1-fast.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/hidream-i1-fast",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"num_inference_steps": {
"title": "Steps",
"description": "Number of inference steps. Fast model runs well at 16.",
"default": 16,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Elements to exclude from the image — colors, objects, styles, or qualities to avoid.",
"default": "",
"type": "string"
},
"enable_safety_checker": {
"title": "Safety Checker",
"description": "Filter potentially unsafe content from the output.",
"default": true,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt will output the same image every time.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
HiDream O1 — unified reasoning-powered model for text-to-image, instruction editing, and multi-reference subject personalization in one endpoint.
Pricing: ~$0.01 / MP · 1024² ≈ 3 cr · 2048² ≈ 10 cr
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_inference_stepsnumberguidance_scalenumberkeep_original_aspectbooleanenable_safety_checkerbooleanoutput_formatstringseedintegeraspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fhidream-o1-image",
"title": "HiDream O1 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/hidream-o1-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/hidream-o1-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"num_inference_steps": {
"title": "Steps",
"description": "Number of denoising steps. More = higher quality, slower.",
"default": 50,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Classifier-free guidance scale. Higher = more faithful to prompt.",
"default": 5,
"type": "number",
"minimum": 0,
"maximum": 20,
"multipleOf": 0.1
},
"keep_original_aspect": {
"title": "Keep Original Aspect",
"description": "When one reference image is provided, preserve its aspect ratio for the output.",
"default": false,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Safety Checker",
"description": "Filter potentially unsafe content from the output.",
"default": true,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "Output image format.",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducible generation.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
HiDream O1 Edit — dedicated editing endpoint requiring a reference image for instruction-based transformation and subject personalization.
Pricing: ~$0.01 / MP · 1024² ≈ 3 cr · 2048² ≈ 10 cr
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_inference_stepsnumberguidance_scalenumberkeep_original_aspectbooleanenable_safety_checkerbooleanoutput_formatstringseedintegeraspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fhidream-o1-image%2Fedit",
"title": "HiDream O1 Edit generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/hidream-o1-image/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/hidream-o1-image/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"num_inference_steps": {
"title": "Steps",
"description": "Number of denoising steps. More = higher quality, slower.",
"default": 50,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Classifier-free guidance scale. Higher = more faithful to prompt.",
"default": 5,
"type": "number",
"minimum": 0,
"maximum": 20,
"multipleOf": 0.1
},
"keep_original_aspect": {
"title": "Keep Original Aspect",
"description": "When one reference image is provided, preserve its aspect ratio for the output.",
"default": false,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Safety Checker",
"description": "Filter potentially unsafe content from the output.",
"default": true,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "Output image format.",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducible generation.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 4
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Prompt-guided identity and full-head replacement that preserves the target pose, clothing, lighting, and scene.
Pricing: $0.10 per output MP, or $0.15 per output MP with reasoning enabled; the pre-generation estimate assumes 1 MP.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringimage_sizestringnum_inference_stepsnumberenable_thinkingbooleanoutput_formatstringseedintegerreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fhy-wu-edit",
"title": "HY-WU Identity Edit generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/hy-wu-edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/hy-wu-edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"image_size": {
"title": "Output framing",
"description": "Match the target automatically, or choose a supported output frame.",
"default": "auto",
"type": "string",
"enum": [
"auto",
"square_hd",
"square",
"portrait_4_3",
"portrait_16_9",
"landscape_4_3",
"landscape_16_9"
]
},
"num_inference_steps": {
"title": "Quality steps",
"description": "More steps can refine detail but take longer. The provider default is 30.",
"default": 30,
"type": "number",
"minimum": 1,
"multipleOf": 1
},
"enable_thinking": {
"title": "Identity reasoning",
"description": "Let the model reason over both references before editing for stronger identity consistency.",
"default": true,
"type": "boolean"
},
"output_format": {
"title": "Output format",
"description": "PNG preserves maximum image fidelity; JPEG creates a smaller file.",
"default": "png",
"type": "string",
"enum": [
"png",
"jpeg"
]
},
"seed": {
"title": "Seed",
"description": "Optional random seed for a repeatable edit.",
"type": "integer"
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 2,
"maxItems": 2
}
},
"required": [
"model_id",
"prompt",
"image_size",
"output_format",
"reference_image_urls"
],
"additionalProperties": false
}
Ideogram Character — generates consistent character scenes from a reference identity image.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringexpand_promptbooleanstylestringreference_image_urlsarrayreference_mask_urlsarraycolor_palettestringstyle_codesarrayimage_urlsarrayseedintegeraspect_ratiostringresolutionstringqualitystringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fcharacter",
"title": "Ideogram Character generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/character.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ideogram/character",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Description of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt.",
"default": "",
"type": "string"
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "Determine if MagicPrompt should be used in generating the request or not.",
"default": true,
"type": "boolean"
},
"style": {
"title": "Style",
"description": "The style type to generate with. Cannot be used with style_codes.",
"default": "AUTO",
"type": "string",
"enum": [
"AUTO",
"REALISTIC",
"FICTION"
]
},
"reference_image_urls": {
"title": "Character Reference Images",
"description": "URLs of images to use as character references. Currently only one image is supported.",
"type": "array",
"items": {
"type": "string"
}
},
"reference_mask_urls": {
"title": "Character Reference Masks",
"description": "Masks to apply to the character references. Currently only one mask is supported.",
"type": "array",
"items": {
"type": "string"
}
},
"color_palette": {
"title": "Color Palette",
"description": "A color palette preset to guide the colors of the generated image.",
"type": "string",
"enum": [
"EMBER",
"FRESH",
"JUNGLE",
"MAGIC",
"MELON",
"MOSAIC",
"PASTEL",
"ULTRAMARINE"
]
},
"style_codes": {
"title": "Style Codes",
"description": "List of 8-character hex style codes to guide the image style. Cannot be used with style or image_urls.",
"type": "array",
"items": {
"type": "string"
}
},
"image_urls": {
"title": "Style Reference Images",
"description": "URLs of images to use as style references (max 10MB total, JPEG/PNG/WebP). Cannot be used with style_codes.",
"type": "array",
"items": {
"type": "string"
}
},
"seed": {
"title": "Seed",
"description": "Seed for the random number generator",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"quality": {
"type": "string",
"enum": [
"low",
"medium",
"high"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Ideogram Character Edit — inpainting on a character scene while preserving identity consistency.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringexpand_promptbooleanmask_urlstringreference_image_urlsarrayreference_mask_urlsarraycolor_palettestringstyle_codesarrayimage_urlsarrayseedintegeraspect_ratiostringresolutionstringqualitystringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fcharacter%2Fedit",
"title": "Ideogram Character (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/character/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ideogram/character/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "Determine if MagicPrompt should be used in generating the request or not.",
"default": true,
"type": "boolean"
},
"mask_url": {
"title": "Mask Url",
"description": "Handled by the canvas mask editor.",
"type": "string"
},
"reference_image_urls": {
"title": "Character Reference Images",
"description": "URLs of images to use as character references. Currently only one image is supported.",
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 2,
"maxItems": 4
},
"reference_mask_urls": {
"title": "Character Reference Masks",
"description": "Masks to apply to the character references. Currently only one mask is supported.",
"type": "array",
"items": {
"type": "string"
}
},
"color_palette": {
"title": "Color Palette",
"description": "A color palette preset to guide the colors of the generated image.",
"type": "string",
"enum": [
"EMBER",
"FRESH",
"JUNGLE",
"MAGIC",
"MELON",
"MOSAIC",
"PASTEL",
"ULTRAMARINE"
]
},
"style_codes": {
"title": "Style Codes",
"description": "List of 8-character hex style codes to guide the image style. Cannot be used with image_urls.",
"type": "array",
"items": {
"type": "string"
}
},
"image_urls": {
"title": "Style Reference Images",
"description": "URLs of images to use as style references (max 10MB total, JPEG/PNG/WebP). Cannot be used with style_codes.",
"type": "array",
"items": {
"type": "string"
}
},
"seed": {
"title": "Seed",
"description": "Seed for the random number generator",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"quality": {
"type": "string",
"enum": [
"low",
"medium",
"high"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt",
"mask_url",
"reference_image_urls"
],
"additionalProperties": false
}
Ideogram Character Remix — remixes a character scene with style and strength controls.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringstylestringstrengthnumberexpand_promptbooleanreference_image_urlsarrayreference_mask_urlsarraycolor_palettestringstyle_codesarrayimage_urlsarrayseedintegeraspect_ratiostringresolutionstringqualitystringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fcharacter%2Fremix",
"title": "Ideogram Character Remix generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/character/remix.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ideogram/character/remix",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Description of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt.",
"default": "",
"type": "string"
},
"style": {
"title": "Style",
"description": "The style type to generate with. Cannot be used with style_codes.",
"default": "AUTO",
"type": "string",
"enum": [
"AUTO",
"REALISTIC",
"FICTION"
]
},
"strength": {
"title": "Strength",
"description": "Strength of the input image in the remix",
"default": 0.8,
"type": "number",
"minimum": 0.01,
"maximum": 1,
"multipleOf": 0.01
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "Determine if MagicPrompt should be used in generating the request or not.",
"default": true,
"type": "boolean"
},
"reference_image_urls": {
"title": "Character Reference Images",
"description": "URLs of images to use as character references. Currently only one image is supported.",
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 2,
"maxItems": 4
},
"reference_mask_urls": {
"title": "Character Reference Masks",
"description": "Masks to apply to the character references. Currently only one mask is supported.",
"type": "array",
"items": {
"type": "string"
}
},
"color_palette": {
"title": "Color Palette",
"description": "A color palette preset to guide the colors of the generated image.",
"type": "string",
"enum": [
"EMBER",
"FRESH",
"JUNGLE",
"MAGIC",
"MELON",
"MOSAIC",
"PASTEL",
"ULTRAMARINE"
]
},
"style_codes": {
"title": "Style Codes",
"description": "List of 8-character hex style codes to guide the image style. Cannot be used with style or image_urls.",
"type": "array",
"items": {
"type": "string"
}
},
"image_urls": {
"title": "Style Reference Images",
"description": "URLs of images to use as style references (max 10MB total, JPEG/PNG/WebP). Cannot be used with style_codes.",
"type": "array",
"items": {
"type": "string"
}
},
"seed": {
"title": "Seed",
"description": "Seed for the random number generator",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"quality": {
"type": "string",
"enum": [
"low",
"medium",
"high"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Ideogram Custom Models — generate images using a trained Ideogram custom model by model ID.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringexpand_promptbooleanseedintegernegative_promptstringcustom_model_idstringaspect_ratiostringresolutionstringqualitystringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fcustom-models%2Fgenerate",
"title": "Ideogram Custom Models generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/custom-models/generate.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ideogram/custom-models/generate",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "Whether to expand the prompt with MagicPrompt functionality.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Seed for the random number generator.",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Description of what to exclude from the image. Descriptions in the prompt take precedence over descriptions in the negative prompt.",
"default": "",
"type": "string"
},
"custom_model_id": {
"title": "Model Id",
"description": "The id of a trained custom model returned by /train. The model must have finished training (status COMPLETED).",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"10:16",
"16:10",
"3:2",
"2:3",
"1:3",
"3:1",
"1:2",
"2:1",
"4:5",
"5:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"quality": {
"type": "string",
"enum": [
"low",
"medium",
"high"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt",
"custom_model_id"
],
"additionalProperties": false
}
Ideogram Remove Background — removes backgrounds with clean, sharp edges, outputting a transparent PNG.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fremove-background",
"title": "Ideogram Remove BG generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/remove-background.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ideogram/remove-background",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Ideogram Upscale — AI upscaler with superior text and graphic element preservation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringdetailnumberexpand_promptbooleanresemblancenumberseedintegeraspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fupscale",
"title": "Ideogram Upscale generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/upscale.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ideogram/upscale",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"detail": {
"title": "Detail",
"description": "The detail of the upscaled image",
"default": 50,
"type": "number",
"minimum": 1,
"maximum": 100,
"multipleOf": 1
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "Whether to expand the prompt with MagicPrompt functionality.",
"default": false,
"type": "boolean"
},
"resemblance": {
"title": "Resemblance",
"description": "The resemblance of the upscaled image to the original image",
"default": 50,
"type": "number",
"minimum": 1,
"maximum": 100,
"multipleOf": 1
},
"seed": {
"title": "Seed",
"description": "Seed for the random number generator",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Ideogram v2 — powerful text-rendering and design model with style controls.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringstylestringexpand_promptbooleanseedintegeraspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fv2",
"title": "Ideogram v2 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/v2.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ideogram/v2",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "A negative prompt to avoid in the generated image",
"default": "",
"type": "string"
},
"style": {
"title": "Style",
"description": "The style of the generated image",
"default": "auto",
"type": "string",
"enum": [
"auto",
"general",
"realistic",
"design",
"render_3D",
"anime"
]
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "Whether to expand the prompt with MagicPrompt functionality.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Seed for the random number generator",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"10:16",
"16:10",
"3:2",
"2:3",
"1:3",
"3:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Ideogram v2 Edit — inpainting-based image editing with Ideogram v2's text-rendering capabilities.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringseedintegerstylestringexpand_promptbooleanmask_urlstringaspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fv2%2Fedit",
"title": "Ideogram v2 (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/v2/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ideogram/v2/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"seed": {
"title": "Seed",
"description": "Seed for the random number generator",
"type": "integer"
},
"style": {
"title": "Style",
"description": "The style of the generated image",
"default": "auto",
"type": "string",
"enum": [
"auto",
"general",
"realistic",
"design",
"render_3D",
"anime"
]
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "Whether to expand the prompt with MagicPrompt functionality.",
"default": true,
"type": "boolean"
},
"mask_url": {
"title": "Mask Url",
"description": "Handled by the canvas mask editor.",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"mask_url",
"reference_image_url"
],
"additionalProperties": false
}
Ideogram v2 Remix — style-transfer remix using a reference image as visual guidance.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstylestringstrengthnumberexpand_promptbooleanseedintegeraspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fv2%2Fremix",
"title": "Ideogram v2 Remix generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/v2/remix.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ideogram/v2/remix",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"style": {
"title": "Style",
"description": "The style of the generated image",
"default": "auto",
"type": "string",
"enum": [
"auto",
"general",
"realistic",
"design",
"render_3D",
"anime"
]
},
"strength": {
"title": "Strength",
"description": "Strength of the input image in the remix",
"default": 0.8,
"type": "number",
"minimum": 0.01,
"maximum": 1,
"multipleOf": 0.01
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "Whether to expand the prompt with MagicPrompt functionality.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Seed for the random number generator",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"10:16",
"16:10",
"3:2",
"2:3",
"1:3",
"3:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Ideogram v2 Turbo — fast version of Ideogram v2 for rapid text-rendering and design generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringstylestringexpand_promptbooleanseedintegeraspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fv2%2Fturbo",
"title": "Ideogram v2 Turbo generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/v2/turbo.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ideogram/v2/turbo",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "A negative prompt to avoid in the generated image",
"default": "",
"type": "string"
},
"style": {
"title": "Style",
"description": "The style of the generated image",
"default": "auto",
"type": "string",
"enum": [
"auto",
"general",
"realistic",
"design",
"render_3D",
"anime"
]
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "Whether to expand the prompt with MagicPrompt functionality.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Seed for the random number generator",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"10:16",
"16:10",
"3:2",
"2:3",
"1:3",
"3:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Ideogram v2a — affordable Ideogram v2 variant for accessible text-rendering and design.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstylestringexpand_promptbooleanseedintegeraspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fv2a",
"title": "Ideogram v2a generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/v2a.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ideogram/v2a",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"style": {
"title": "Style",
"description": "The style of the generated image",
"default": "auto",
"type": "string",
"enum": [
"auto",
"general",
"realistic",
"design",
"render_3D",
"anime"
]
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "Whether to expand the prompt with MagicPrompt functionality.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Seed for the random number generator",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"10:16",
"16:10",
"3:2",
"2:3",
"1:3",
"3:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Ideogram v3 — latest Ideogram model with style presets, rendering speed controls, and top-tier text rendering.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringstyle_presetstringstylestringexpand_promptbooleancolor_palettestringstyle_codesarrayimage_urlsarrayseedintegeraspect_ratiostringresolutionstringqualitystringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fv3",
"title": "Ideogram v3 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/v3.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ideogram/v3",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Description of what to exclude from the generated image.",
"default": "",
"type": "string"
},
"style_preset": {
"title": "Style Preset",
"description": "Style preset for generation. The chosen style preset will guide the generation.",
"type": "string",
"enum": [
"80S_ILLUSTRATION",
"90S_NOSTALGIA",
"ABSTRACT_ORGANIC",
"ANALOG_NOSTALGIA",
"ART_BRUT",
"ART_DECO",
"ART_POSTER",
"AURA",
"AVANT_GARDE",
"BAUHAUS",
"BLUEPRINT",
"BLURRY_MOTION",
"BRIGHT_ART",
"C4D_CARTOON",
"CHILDRENS_BOOK",
"COLLAGE",
"COLORING_BOOK_I",
"COLORING_BOOK_II",
"CUBISM",
"DARK_AURA",
"DOODLE",
"DOUBLE_EXPOSURE",
"DRAMATIC_CINEMA",
"EDITORIAL",
"EMOTIONAL_MINIMAL",
"ETHEREAL_PARTY",
"EXPIRED_FILM",
"FLAT_ART",
"FLAT_VECTOR",
"FOREST_REVERIE",
"GEO_MINIMALIST",
"GLASS_PRISM",
"GOLDEN_HOUR",
"GRAFFITI_I",
"GRAFFITI_II",
"HALFTONE_PRINT",
"HIGH_CONTRAST",
"HIPPIE_ERA",
"ICONIC",
"JAPANDI_FUSION",
"JAZZY",
"LONG_EXPOSURE",
"MAGAZINE_EDITORIAL",
"MINIMAL_ILLUSTRATION",
"MIXED_MEDIA",
"MONOCHROME",
"NIGHTLIFE",
"OIL_PAINTING",
"OLD_CARTOONS",
"PAINT_GESTURE",
"POP_ART",
"RETRO_ETCHING",
"RIVIERA_POP",
"SPOTLIGHT_80S",
"STYLIZED_RED",
"SURREAL_COLLAGE",
"TRAVEL_POSTER",
"VINTAGE_GEO",
"VINTAGE_POSTER",
"WATERCOLOR",
"WEIRD",
"WOODBLOCK_PRINT"
]
},
"style": {
"title": "Style",
"description": "The style type to generate with. Cannot be used with style_codes.",
"type": "string",
"enum": [
"AUTO",
"GENERAL",
"REALISTIC",
"DESIGN"
]
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "Determine if MagicPrompt should be used in generating the request or not.",
"default": true,
"type": "boolean"
},
"color_palette": {
"title": "Color Palette",
"description": "A color palette preset to guide the colors of the generated image.",
"type": "string",
"enum": [
"EMBER",
"FRESH",
"JUNGLE",
"MAGIC",
"MELON",
"MOSAIC",
"PASTEL",
"ULTRAMARINE"
]
},
"style_codes": {
"title": "Style Codes",
"description": "List of 8-character hex style codes to guide the image style. Cannot be used with style or image_urls.",
"type": "array",
"items": {
"type": "string"
}
},
"image_urls": {
"title": "Style Reference Images",
"description": "URLs of images to use as style references (max 10MB total, JPEG/PNG/WebP). Cannot be used with style_codes.",
"type": "array",
"items": {
"type": "string"
}
},
"seed": {
"title": "Seed",
"description": "Seed for the random number generator",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"10:16",
"16:10",
"3:2",
"2:3",
"1:3",
"3:1",
"1:2",
"2:1",
"4:5",
"5:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"quality": {
"type": "string",
"enum": [
"low",
"medium",
"high"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Ideogram v3 Edit — mask-based inpainting with Ideogram v3's advanced style and rendering controls.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstyle_presetstringexpand_promptbooleanmask_urlstringcolor_palettestringstyle_codesarrayimage_urlsarrayseedintegeraspect_ratiostringresolutionstringqualitystringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fv3%2Fedit",
"title": "Ideogram v3 (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/v3/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ideogram/v3/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"style_preset": {
"title": "Style Preset",
"description": "Style preset for generation. The chosen style preset will guide the generation.",
"type": "string",
"enum": [
"80S_ILLUSTRATION",
"90S_NOSTALGIA",
"ABSTRACT_ORGANIC",
"ANALOG_NOSTALGIA",
"ART_BRUT",
"ART_DECO",
"ART_POSTER",
"AURA",
"AVANT_GARDE",
"BAUHAUS",
"BLUEPRINT",
"BLURRY_MOTION",
"BRIGHT_ART",
"C4D_CARTOON",
"CHILDRENS_BOOK",
"COLLAGE",
"COLORING_BOOK_I",
"COLORING_BOOK_II",
"CUBISM",
"DARK_AURA",
"DOODLE",
"DOUBLE_EXPOSURE",
"DRAMATIC_CINEMA",
"EDITORIAL",
"EMOTIONAL_MINIMAL",
"ETHEREAL_PARTY",
"EXPIRED_FILM",
"FLAT_ART",
"FLAT_VECTOR",
"FOREST_REVERIE",
"GEO_MINIMALIST",
"GLASS_PRISM",
"GOLDEN_HOUR",
"GRAFFITI_I",
"GRAFFITI_II",
"HALFTONE_PRINT",
"HIGH_CONTRAST",
"HIPPIE_ERA",
"ICONIC",
"JAPANDI_FUSION",
"JAZZY",
"LONG_EXPOSURE",
"MAGAZINE_EDITORIAL",
"MINIMAL_ILLUSTRATION",
"MIXED_MEDIA",
"MONOCHROME",
"NIGHTLIFE",
"OIL_PAINTING",
"OLD_CARTOONS",
"PAINT_GESTURE",
"POP_ART",
"RETRO_ETCHING",
"RIVIERA_POP",
"SPOTLIGHT_80S",
"STYLIZED_RED",
"SURREAL_COLLAGE",
"TRAVEL_POSTER",
"VINTAGE_GEO",
"VINTAGE_POSTER",
"WATERCOLOR",
"WEIRD",
"WOODBLOCK_PRINT"
]
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "Determine if MagicPrompt should be used in generating the request or not.",
"default": true,
"type": "boolean"
},
"mask_url": {
"title": "Mask Url",
"description": "Handled by the canvas mask editor.",
"type": "string"
},
"color_palette": {
"title": "Color Palette",
"description": "A color palette preset to guide the colors of the generated image.",
"type": "string",
"enum": [
"EMBER",
"FRESH",
"JUNGLE",
"MAGIC",
"MELON",
"MOSAIC",
"PASTEL",
"ULTRAMARINE"
]
},
"style_codes": {
"title": "Style Codes",
"description": "List of 8-character hex style codes to guide the image style. Cannot be used with style_preset or image_urls.",
"type": "array",
"items": {
"type": "string"
}
},
"image_urls": {
"title": "Style Reference Images",
"description": "URLs of images to use as style references (max 10MB total, JPEG/PNG/WebP). Cannot be used with style_codes.",
"type": "array",
"items": {
"type": "string"
}
},
"seed": {
"title": "Seed",
"description": "Seed for the random number generator",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"quality": {
"type": "string",
"enum": [
"low",
"medium",
"high"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"mask_url",
"reference_image_url"
],
"additionalProperties": false
}
Ideogram v3 Layerize Text — integrates layered typography into an existing image with custom font support.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringseedintegerfont_file_body_urlstringfont_name_h1stringfont_name_h2stringfont_file_h1_urlstringfont_name_smallstringfont_file_h2_urlstringfont_name_bodystringfont_file_small_urlstringaspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fv3%2Flayerize-text",
"title": "Ideogram v3 Layerize generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/v3/layerize-text.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ideogram/v3/layerize-text",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"seed": {
"title": "Seed",
"description": "Seed for the random number generator.",
"type": "integer"
},
"font_file_body_url": {
"title": "Font File Body Url",
"description": "URL of the font file to use for body text. Cannot be used with font_name_body.",
"type": "string"
},
"font_name_h1": {
"title": "Font Name H1",
"description": "Name of the font to use for h1 text. Cannot be used with font_file_h1_url.",
"type": "string"
},
"font_name_h2": {
"title": "Font Name H2",
"description": "Name of the font to use for h2 text. Cannot be used with font_file_h2_url.",
"type": "string"
},
"font_file_h1_url": {
"title": "Font File H1 Url",
"description": "URL of the font file to use for h1 text. Cannot be used with font_name_h1.",
"type": "string"
},
"font_name_small": {
"title": "Font Name Small",
"description": "Name of the font to use for small text. Cannot be used with font_file_small_url.",
"type": "string"
},
"font_file_h2_url": {
"title": "Font File H2 Url",
"description": "URL of the font file to use for h2 text. Cannot be used with font_name_h2.",
"type": "string"
},
"font_name_body": {
"title": "Font Name Body",
"description": "Name of the font to use for body text. Cannot be used with font_file_body_url.",
"type": "string"
},
"font_file_small_url": {
"title": "Font File Small Url",
"description": "URL of the font file to use for small text. Cannot be used with font_name_small.",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Ideogram v3 Reframe — outpainting that expands the canvas beyond the original image boundaries.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstyle_presetstringstylestringcolor_palettestringstyle_codesarrayimage_urlsarrayseedintegeraspect_ratiostringresolutionstringqualitystringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fv3%2Freframe",
"title": "Ideogram v3 Reframe generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/v3/reframe.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ideogram/v3/reframe",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"style_preset": {
"title": "Style Preset",
"description": "Style preset for generation. The chosen style preset will guide the generation.",
"type": "string",
"enum": [
"80S_ILLUSTRATION",
"90S_NOSTALGIA",
"ABSTRACT_ORGANIC",
"ANALOG_NOSTALGIA",
"ART_BRUT",
"ART_DECO",
"ART_POSTER",
"AURA",
"AVANT_GARDE",
"BAUHAUS",
"BLUEPRINT",
"BLURRY_MOTION",
"BRIGHT_ART",
"C4D_CARTOON",
"CHILDRENS_BOOK",
"COLLAGE",
"COLORING_BOOK_I",
"COLORING_BOOK_II",
"CUBISM",
"DARK_AURA",
"DOODLE",
"DOUBLE_EXPOSURE",
"DRAMATIC_CINEMA",
"EDITORIAL",
"EMOTIONAL_MINIMAL",
"ETHEREAL_PARTY",
"EXPIRED_FILM",
"FLAT_ART",
"FLAT_VECTOR",
"FOREST_REVERIE",
"GEO_MINIMALIST",
"GLASS_PRISM",
"GOLDEN_HOUR",
"GRAFFITI_I",
"GRAFFITI_II",
"HALFTONE_PRINT",
"HIGH_CONTRAST",
"HIPPIE_ERA",
"ICONIC",
"JAPANDI_FUSION",
"JAZZY",
"LONG_EXPOSURE",
"MAGAZINE_EDITORIAL",
"MINIMAL_ILLUSTRATION",
"MIXED_MEDIA",
"MONOCHROME",
"NIGHTLIFE",
"OIL_PAINTING",
"OLD_CARTOONS",
"PAINT_GESTURE",
"POP_ART",
"RETRO_ETCHING",
"RIVIERA_POP",
"SPOTLIGHT_80S",
"STYLIZED_RED",
"SURREAL_COLLAGE",
"TRAVEL_POSTER",
"VINTAGE_GEO",
"VINTAGE_POSTER",
"WATERCOLOR",
"WEIRD",
"WOODBLOCK_PRINT"
]
},
"style": {
"title": "Style",
"description": "The style type to generate with. Cannot be used with style_codes.",
"type": "string",
"enum": [
"AUTO",
"GENERAL",
"REALISTIC",
"DESIGN"
]
},
"color_palette": {
"title": "Color Palette",
"description": "A color palette preset to guide the colors of the generated image.",
"type": "string",
"enum": [
"EMBER",
"FRESH",
"JUNGLE",
"MAGIC",
"MELON",
"MOSAIC",
"PASTEL",
"ULTRAMARINE"
]
},
"style_codes": {
"title": "Style Codes",
"description": "List of 8-character hex style codes to guide the image style. Cannot be used with style or image_urls.",
"type": "array",
"items": {
"type": "string"
}
},
"image_urls": {
"title": "Style Reference Images",
"description": "URLs of images to use as style references (max 10MB total, JPEG/PNG/WebP). Cannot be used with style_codes.",
"type": "array",
"items": {
"type": "string"
}
},
"seed": {
"title": "Seed",
"description": "Seed for the random number generator",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"quality": {
"type": "string",
"enum": [
"low",
"medium",
"high"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Ideogram v3 Remix — reference-guided remixing with Ideogram v3's full style and rendering controls.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringseedintegernegative_promptstringstylestringstrengthnumberexpand_promptbooleancolor_palettestringstyle_codesarrayimage_urlsarrayaspect_ratiostringresolutionstringqualitystringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fv3%2Fremix",
"title": "Ideogram v3 Remix generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/v3/remix.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ideogram/v3/remix",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"seed": {
"title": "Seed",
"description": "Seed for the random number generator",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Description of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt.",
"default": "",
"type": "string"
},
"style": {
"title": "Style",
"description": "The style type to generate with. Cannot be used with style_codes.",
"type": "string",
"enum": [
"AUTO",
"GENERAL",
"REALISTIC",
"DESIGN"
]
},
"strength": {
"title": "Strength",
"description": "Strength of the input image in the remix",
"default": 0.8,
"type": "number",
"minimum": 0.01,
"maximum": 1,
"multipleOf": 0.01
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "Determine if MagicPrompt should be used in generating the request or not.",
"default": true,
"type": "boolean"
},
"color_palette": {
"title": "Color Palette",
"description": "A color palette preset to guide the colors of the generated image.",
"type": "string",
"enum": [
"EMBER",
"FRESH",
"JUNGLE",
"MAGIC",
"MELON",
"MOSAIC",
"PASTEL",
"ULTRAMARINE"
]
},
"style_codes": {
"title": "Style Codes",
"description": "List of 8-character hex style codes to guide the image style. Cannot be used with style or image_urls.",
"type": "array",
"items": {
"type": "string"
}
},
"image_urls": {
"title": "Style Reference Images",
"description": "URLs of images to use as style references (max 10MB total, JPEG/PNG/WebP). Cannot be used with style_codes.",
"type": "array",
"items": {
"type": "string"
}
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"quality": {
"type": "string",
"enum": [
"low",
"medium",
"high"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Ideogram v3 Replace Background — intelligent background replacement using a reference subject image.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstyle_presetstringstylestringexpand_promptbooleancolor_palettestringstyle_codesarrayimage_urlsarrayseedintegeraspect_ratiostringresolutionstringqualitystringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fv3%2Freplace-background",
"title": "Ideogram v3 Replace BG generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/v3/replace-background.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ideogram/v3/replace-background",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"style_preset": {
"title": "Style Preset",
"description": "Style preset for generation. The chosen style preset will guide the generation.",
"type": "string",
"enum": [
"80S_ILLUSTRATION",
"90S_NOSTALGIA",
"ABSTRACT_ORGANIC",
"ANALOG_NOSTALGIA",
"ART_BRUT",
"ART_DECO",
"ART_POSTER",
"AURA",
"AVANT_GARDE",
"BAUHAUS",
"BLUEPRINT",
"BLURRY_MOTION",
"BRIGHT_ART",
"C4D_CARTOON",
"CHILDRENS_BOOK",
"COLLAGE",
"COLORING_BOOK_I",
"COLORING_BOOK_II",
"CUBISM",
"DARK_AURA",
"DOODLE",
"DOUBLE_EXPOSURE",
"DRAMATIC_CINEMA",
"EDITORIAL",
"EMOTIONAL_MINIMAL",
"ETHEREAL_PARTY",
"EXPIRED_FILM",
"FLAT_ART",
"FLAT_VECTOR",
"FOREST_REVERIE",
"GEO_MINIMALIST",
"GLASS_PRISM",
"GOLDEN_HOUR",
"GRAFFITI_I",
"GRAFFITI_II",
"HALFTONE_PRINT",
"HIGH_CONTRAST",
"HIPPIE_ERA",
"ICONIC",
"JAPANDI_FUSION",
"JAZZY",
"LONG_EXPOSURE",
"MAGAZINE_EDITORIAL",
"MINIMAL_ILLUSTRATION",
"MIXED_MEDIA",
"MONOCHROME",
"NIGHTLIFE",
"OIL_PAINTING",
"OLD_CARTOONS",
"PAINT_GESTURE",
"POP_ART",
"RETRO_ETCHING",
"RIVIERA_POP",
"SPOTLIGHT_80S",
"STYLIZED_RED",
"SURREAL_COLLAGE",
"TRAVEL_POSTER",
"VINTAGE_GEO",
"VINTAGE_POSTER",
"WATERCOLOR",
"WEIRD",
"WOODBLOCK_PRINT"
]
},
"style": {
"title": "Style",
"description": "The style type to generate with. Cannot be used with style_codes.",
"type": "string",
"enum": [
"AUTO",
"GENERAL",
"REALISTIC",
"DESIGN"
]
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "Determine if MagicPrompt should be used in generating the request or not.",
"default": true,
"type": "boolean"
},
"color_palette": {
"title": "Color Palette",
"description": "A color palette preset to guide the colors of the generated image.",
"type": "string",
"enum": [
"EMBER",
"FRESH",
"JUNGLE",
"MAGIC",
"MELON",
"MOSAIC",
"PASTEL",
"ULTRAMARINE"
]
},
"style_codes": {
"title": "Style Codes",
"description": "List of 8-character hex style codes to guide the image style. Cannot be used with style or image_urls.",
"type": "array",
"items": {
"type": "string"
}
},
"image_urls": {
"title": "Style Reference Images",
"description": "URLs of images to use as style references (max 10MB total, JPEG/PNG/WebP). Cannot be used with style_codes.",
"type": "array",
"items": {
"type": "string"
}
},
"seed": {
"title": "Seed",
"description": "Seed for the random number generator",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"quality": {
"type": "string",
"enum": [
"low",
"medium",
"high"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Ideogram v3 Generate Transparent — generates images with transparent backgrounds for stickers and assets.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringexpand_promptbooleanseedintegeraspect_ratiostringresolutionstringqualitystringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fv3%2Fgenerate-transparent",
"title": "Ideogram v3 Transparent generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/v3/generate-transparent.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ideogram/v3/generate-transparent",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Description of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt.",
"default": "",
"type": "string"
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "Determine if MagicPrompt should be used in generating the request or not.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Seed for the random number generator",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"10:16",
"16:10",
"3:2",
"2:3",
"1:3",
"3:1",
"1:2",
"2:1",
"4:5",
"5:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"quality": {
"type": "string",
"enum": [
"low",
"medium",
"high"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Image Apps v2 Virtual Try-On — virtually try on garments with an updated multimodal approach.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringpreserve_posebooleanaspect_ratiostringreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fimage-apps-v2%2Fvirtual-try-on",
"title": "Image Apps v2 Try-On generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/image-apps-v2/virtual-try-on.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/image-apps-v2/virtual-try-on",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"preserve_pose": {
"title": "Preserve Pose",
"description": "Keep the person's original pose in the try-on result.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 2,
"maxItems": 2
}
},
"required": [
"model_id",
"reference_image_urls"
],
"additionalProperties": false
}
Imagineart 2.0 — high-fidelity image generation with reasoning level control for complex scenes.
Pricing: 1K $0.03 / 2K $0.05 per image (fal-published)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringreasoningstringseedintegeraspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=imagineart%2Fimagineart-2.0-preview%2Ftext-to-image",
"title": "Imagineart 2.0 generation request",
"description": "Request body accepted by POST /api/v1/generate for imagineart/imagineart-2.0-preview/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "imagineart/imagineart-2.0-preview/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"reasoning": {
"title": "Reasoning",
"description": "Visual Understanding Level: low (default) or high. High reasoning takes more time but generates better images.",
"default": "low",
"type": "string",
"enum": [
"high",
"low"
]
},
"seed": {
"title": "Seed",
"description": "Default is random (0 and -1 are treated as random)",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3",
"3:1",
"1:3",
"21:9",
"4:5",
"5:4",
"4:1",
"1:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1K",
"2K"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Imagineart 2.0 Edit — instruction-based image editing with Imagineart's photorealistic quality.
Pricing: $0.05 per edit; fal adds $0.007 per input image beyond the first (absorbed by margin, not billed)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaspect_ratiostringreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=imagineart%2Fimagineart-2.0-edit-preview%2Fimage-to-image",
"title": "Imagineart 2.0 Edit generation request",
"description": "Request body accepted by POST /api/v1/generate for imagineart/imagineart-2.0-edit-preview/image-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "imagineart/imagineart-2.0-edit-preview/image-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"Auto",
"1:1",
"16:9",
"9:16",
"3:2",
"2:3",
"4:3",
"3:4",
"4:5",
"5:4",
"3:1",
"1:3",
"21:9"
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 4
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Kling Image o1 — Kling's advanced image model via the Omni endpoint. Accepts reference images, 1K/2K output, and auto aspect ratio. Embed negative descriptions directly in the prompt.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringresult_typestringseries_amountstringaspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=kling%2Fimage%2Fo1%2Ftext-to-image",
"title": "Kling Image o1 generation request",
"description": "Request body accepted by POST /api/v1/generate for kling/image/o1/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "kling/image/o1/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"result_type": {
"title": "Result Type",
"description": "Generate independent images or an ordered visual series.",
"default": "single",
"type": "string",
"enum": [
"single",
"series"
]
},
"series_amount": {
"title": "Series Amount",
"description": "Used only when Result Type is Image Series. Auto is excluded because its variable output count cannot be priced before generation.",
"default": "4",
"type": "string",
"enum": [
"2",
"3",
"4",
"5",
"6",
"7",
"8",
"9"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3",
"21:9",
"auto"
]
},
"resolution": {
"type": "string",
"enum": [
"1k",
"2k"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 9
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 10
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Kling Image v3 — Kling's latest image generation model with cinematic realism and reference image support.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringelement_idsarrayaspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fkling-image%2Fv3%2Ftext-to-image",
"title": "Kling Image v3 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/kling-image/v3/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/kling-image/v3/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Content to exclude from the generated image.",
"type": "string"
},
"element_ids": {
"title": "Element IDs",
"description": "Optional Kling image Element IDs. The reference image and Element count together cannot exceed 10.",
"type": "array",
"items": {
"type": "string"
}
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3",
"21:9"
]
},
"resolution": {
"type": "string",
"enum": [
"1k",
"2k"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 9
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Kling Image v3 Omni — multimodal image generation via the Omni endpoint. Accepts reference images, up to 4K output, and auto aspect ratio. Embed negative descriptions directly in the prompt.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringresult_typestringseries_amountstringaspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=kling%2Fimage%2Fv3-omni%2Ftext-to-image",
"title": "Kling Image v3 Omni generation request",
"description": "Request body accepted by POST /api/v1/generate for kling/image/v3-omni/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "kling/image/v3-omni/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"result_type": {
"title": "Result Type",
"description": "Generate independent images or an ordered visual series.",
"default": "single",
"type": "string",
"enum": [
"single",
"series"
]
},
"series_amount": {
"title": "Series Amount",
"description": "Used only when Result Type is Image Series. Auto is excluded because its variable output count cannot be priced before generation.",
"default": "4",
"type": "string",
"enum": [
"2",
"3",
"4",
"5",
"6",
"7",
"8",
"9"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3",
"21:9",
"auto"
]
},
"resolution": {
"type": "string",
"enum": [
"1k",
"2k",
"4k"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 9
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 10
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Krea v2 Large — high-fidelity generation with creativity control and optional style references.
Pricing: $0.06 / image ($0.065 with style references)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringcreativitystringseedintegerstyle_idstringstyle_strengthnumberstyle_id_2stringstyle_strength_2numberstyle_id_3stringstyle_strength_3numberimage_style_ref_urlstringimage_style_ref_strengthnumberimage_style_ref_url_2stringimage_style_ref_strength_2numberimage_style_ref_url_3stringimage_style_ref_strength_3numbermoodboard_idstringmoodboard_strengthnumberaspect_ratiostring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=krea%2Fv2%2Flarge%2Ftext-to-image",
"title": "Krea v2 Large generation request",
"description": "Request body accepted by POST /api/v1/generate for krea/v2/large/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "krea/v2/large/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"creativity": {
"title": "Creativity",
"description": "Controls how loosely the model interprets the prompt. Higher values produce more creative results that may drift from the prompt; lower values stay closer.",
"default": "medium",
"type": "string",
"enum": [
"raw",
"low",
"medium",
"high"
]
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducible generation.",
"type": "integer"
},
"style_id": {
"title": "Style ID",
"description": "Krea style preset ID (a LoRA-based preset style identifier).",
"type": "string"
},
"style_strength": {
"title": "Style Strength",
"description": "Influence strength for the style (-2 to 2).",
"default": 1,
"type": "number",
"minimum": -2,
"maximum": 2,
"multipleOf": 0.05
},
"style_id_2": {
"title": "Style ID 2",
"description": "A second Krea style preset ID.",
"type": "string"
},
"style_strength_2": {
"title": "Style Strength 2",
"description": "Influence strength for style 2.",
"default": 1,
"type": "number",
"minimum": -2,
"maximum": 2,
"multipleOf": 0.05
},
"style_id_3": {
"title": "Style ID 3",
"description": "A third Krea style preset ID.",
"type": "string"
},
"style_strength_3": {
"title": "Style Strength 3",
"description": "Influence strength for style 3.",
"default": 1,
"type": "number",
"minimum": -2,
"maximum": 2,
"multipleOf": 0.05
},
"image_style_ref_url": {
"title": "Style Ref URL",
"description": "Publicly accessible URL of a reference image to guide style.",
"type": "string"
},
"image_style_ref_strength": {
"title": "Style Ref Strength",
"description": "Influence strength for the style reference (-2 to 2).",
"default": 1,
"type": "number",
"minimum": -2,
"maximum": 2,
"multipleOf": 0.05
},
"image_style_ref_url_2": {
"title": "Style Ref URL 2",
"description": "A second reference image URL.",
"type": "string"
},
"image_style_ref_strength_2": {
"title": "Style Ref Strength 2",
"description": "Influence strength for style reference 2.",
"default": 1,
"type": "number",
"minimum": -2,
"maximum": 2,
"multipleOf": 0.05
},
"image_style_ref_url_3": {
"title": "Style Ref URL 3",
"description": "A third reference image URL.",
"type": "string"
},
"image_style_ref_strength_3": {
"title": "Style Ref Strength 3",
"description": "Influence strength for style reference 3.",
"default": 1,
"type": "number",
"minimum": -2,
"maximum": 2,
"multipleOf": 0.05
},
"moodboard_id": {
"title": "Moodboard ID",
"description": "Krea moodboard UUID to guide the generation's mood and atmosphere.",
"type": "string"
},
"moodboard_strength": {
"title": "Moodboard Strength",
"description": "Influence strength of the moodboard (0 to 1).",
"default": 0.23,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"4:3",
"3:2",
"16:9",
"2.35:1",
"4:5",
"2:3",
"9:16"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Krea v2 Medium — fast, high-quality generation with creativity control and optional style references.
Pricing: $0.03 / image ($0.035 with style references)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringcreativitystringseedintegerstyle_idstringstyle_strengthnumberstyle_id_2stringstyle_strength_2numberstyle_id_3stringstyle_strength_3numberimage_style_ref_urlstringimage_style_ref_strengthnumberimage_style_ref_url_2stringimage_style_ref_strength_2numberimage_style_ref_url_3stringimage_style_ref_strength_3numbermoodboard_idstringmoodboard_strengthnumberaspect_ratiostring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=krea%2Fv2%2Fmedium%2Ftext-to-image",
"title": "Krea v2 Medium generation request",
"description": "Request body accepted by POST /api/v1/generate for krea/v2/medium/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "krea/v2/medium/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"creativity": {
"title": "Creativity",
"description": "Controls how loosely the model interprets the prompt. Higher values produce more creative results that may drift from the prompt; lower values stay closer.",
"default": "medium",
"type": "string",
"enum": [
"raw",
"low",
"medium",
"high"
]
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducible generation.",
"type": "integer"
},
"style_id": {
"title": "Style ID",
"description": "Krea style preset ID (a LoRA-based preset style identifier).",
"type": "string"
},
"style_strength": {
"title": "Style Strength",
"description": "Influence strength for the style (-2 to 2).",
"default": 1,
"type": "number",
"minimum": -2,
"maximum": 2,
"multipleOf": 0.05
},
"style_id_2": {
"title": "Style ID 2",
"description": "A second Krea style preset ID.",
"type": "string"
},
"style_strength_2": {
"title": "Style Strength 2",
"description": "Influence strength for style 2.",
"default": 1,
"type": "number",
"minimum": -2,
"maximum": 2,
"multipleOf": 0.05
},
"style_id_3": {
"title": "Style ID 3",
"description": "A third Krea style preset ID.",
"type": "string"
},
"style_strength_3": {
"title": "Style Strength 3",
"description": "Influence strength for style 3.",
"default": 1,
"type": "number",
"minimum": -2,
"maximum": 2,
"multipleOf": 0.05
},
"image_style_ref_url": {
"title": "Style Ref URL",
"description": "Publicly accessible URL of a reference image to guide style.",
"type": "string"
},
"image_style_ref_strength": {
"title": "Style Ref Strength",
"description": "Influence strength for the style reference (-2 to 2).",
"default": 1,
"type": "number",
"minimum": -2,
"maximum": 2,
"multipleOf": 0.05
},
"image_style_ref_url_2": {
"title": "Style Ref URL 2",
"description": "A second reference image URL.",
"type": "string"
},
"image_style_ref_strength_2": {
"title": "Style Ref Strength 2",
"description": "Influence strength for style reference 2.",
"default": 1,
"type": "number",
"minimum": -2,
"maximum": 2,
"multipleOf": 0.05
},
"image_style_ref_url_3": {
"title": "Style Ref URL 3",
"description": "A third reference image URL.",
"type": "string"
},
"image_style_ref_strength_3": {
"title": "Style Ref Strength 3",
"description": "Influence strength for style reference 3.",
"default": 1,
"type": "number",
"minimum": -2,
"maximum": 2,
"multipleOf": 0.05
},
"moodboard_id": {
"title": "Moodboard ID",
"description": "Krea moodboard UUID to guide the generation's mood and atmosphere.",
"type": "string"
},
"moodboard_strength": {
"title": "Moodboard Strength",
"description": "Influence strength of the moodboard (0 to 1).",
"default": 0.23,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"4:3",
"3:2",
"16:9",
"2.35:1",
"4:5",
"2:3",
"9:16"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Luma Photon — Luma's high-quality photorealistic image model with cinematic composition and lighting.
Pricing: $0.0404 flat per image (direct Luma API, uni-1).
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaspect_ratiostring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fluma-photon",
"title": "Luma Photon generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/luma-photon.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/luma-photon",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Luma Photon Flash — fast Luma photorealistic image generation with cinematic quality.
Pricing: $0.005 / megapixel (fal-published) — output short side ~1024, so wide/tall ratios bill 2-3 MP
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaspect_ratiostring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fluma-photon%2Fflash",
"title": "Luma Photon Flash generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/luma-photon/flash.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/luma-photon/flash",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"9:21"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Nano Banana 2 — next-generation image model with extended aspect ratios, high thinking support, and multi-resolution output.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenable_web_searchbooleansafety_tolerancenumbersystem_promptstringthinking_levelstringaspect_ratiostringresolutionstringoutput_formatstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fnano-banana-2",
"title": "Nano Banana 2 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/nano-banana-2.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/nano-banana-2",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enable_web_search": {
"title": "Enable Web Search",
"description": "Enable web search for the image generation task. This will allow the model to use the latest information from the web to generate the image.",
"default": false,
"type": "boolean"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.",
"default": "4",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"system_prompt": {
"title": "System Prompt",
"description": "Optional system instruction that steers the model's persona and output style across the request. Leave blank to omit; when provided, it is sent as the system prompt.",
"default": "",
"type": "string"
},
"thinking_level": {
"title": "Thinking Level",
"description": "When set, enables model thinking with the given level ('minimal' or 'high') and includes thoughts in the generation. Omit to disable.",
"type": "string",
"enum": [
"minimal",
"high"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"21:9",
"16:9",
"3:2",
"4:3",
"5:4",
"1:1",
"4:5",
"3:4",
"2:3",
"9:16",
"4:1",
"1:4",
"8:1",
"1:8"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048",
"4096"
]
},
"output_format": {
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Nano Banana 2 Edit — next-generation instruction-based editing with thinking capabilities.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenable_web_searchbooleansafety_tolerancenumbersystem_promptstringthinking_levelstringaspect_ratiostringresolutionstringoutput_formatstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fnano-banana-2%2Fedit",
"title": "Nano Banana 2 (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/nano-banana-2/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/nano-banana-2/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enable_web_search": {
"title": "Enable Web Search",
"description": "Enable web search for the image generation task. This will allow the model to use the latest information from the web to generate the image.",
"default": false,
"type": "boolean"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.",
"default": "4",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"system_prompt": {
"title": "System Prompt",
"description": "Optional system instruction that steers the model's persona and output style across the request. Leave blank to omit; when provided, it is sent as the system prompt.",
"default": "",
"type": "string"
},
"thinking_level": {
"title": "Thinking Level",
"description": "When set, enables model thinking with the given level ('minimal' or 'high') and includes thoughts in the generation. Omit to disable.",
"type": "string",
"enum": [
"minimal",
"high"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"21:9",
"16:9",
"3:2",
"4:3",
"5:4",
"1:1",
"4:5",
"3:4",
"2:3",
"9:16",
"4:1",
"1:4",
"8:1",
"1:8"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048",
"4096"
]
},
"output_format": {
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Nano Banana 2 Lite — the fastest and cheapest model in the Nano Banana family, generating images in about 4 seconds at 1K resolution.
Pricing: ~9 cr / image
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringsafety_tolerancenumbersystem_promptstringthinking_levelstringaspect_ratiostringresolutionstringoutput_formatstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fnano-banana-2-lite",
"title": "Nano Banana 2 Lite generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/nano-banana-2-lite.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/nano-banana-2-lite",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.",
"default": "4",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"system_prompt": {
"title": "System Prompt",
"description": "Optional system instruction that steers the model's persona and output style across the request. Leave blank to omit; when provided, it is sent as the system prompt.",
"default": "",
"type": "string"
},
"thinking_level": {
"title": "Thinking Level",
"description": "When set, enables model thinking with the given level ('minimal' or 'high') and includes thoughts in the generation. Omit to disable.",
"type": "string",
"enum": [
"minimal",
"high"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"21:9",
"16:9",
"3:2",
"4:3",
"5:4",
"1:1",
"4:5",
"3:4",
"2:3",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"output_format": {
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Nano Banana 2 Lite Edit — instruction-based image editing at Lite speed and price, ~4s generations at 1K resolution.
Pricing: ~9 cr / image
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringsafety_tolerancenumbersystem_promptstringthinking_levelstringaspect_ratiostringresolutionstringoutput_formatstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fnano-banana-2-lite%2Fedit",
"title": "Nano Banana 2 Lite (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/nano-banana-2-lite/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/nano-banana-2-lite/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.",
"default": "4",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"system_prompt": {
"title": "System Prompt",
"description": "Optional system instruction that steers the model's persona and output style across the request. Leave blank to omit; when provided, it is sent as the system prompt.",
"default": "",
"type": "string"
},
"thinking_level": {
"title": "Thinking Level",
"description": "When set, enables model thinking with the given level ('minimal' or 'high') and includes thoughts in the generation. Omit to disable.",
"type": "string",
"enum": [
"minimal",
"high"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"21:9",
"16:9",
"3:2",
"4:3",
"5:4",
"1:1",
"4:5",
"3:4",
"2:3",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"output_format": {
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Nano Banana Pro — high-quality text-to-image generation with web search augmentation and 4K resolution support.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenable_web_searchbooleansafety_tolerancenumbersystem_promptstringaspect_ratiostringresolutionstringoutput_formatstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fnano-banana-pro",
"title": "Nano Banana Pro generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/nano-banana-pro.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/nano-banana-pro",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enable_web_search": {
"title": "Enable Web Search",
"description": "Enable web search for the image generation task. This will allow the model to use the latest information from the web to generate the image.",
"default": false,
"type": "boolean"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.",
"default": "4",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"system_prompt": {
"title": "System Prompt",
"description": "Optional system instruction that steers the model's persona and output style across the request. Leave blank to omit; when provided, it is sent as the system prompt.",
"default": "",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"21:9",
"16:9",
"3:2",
"4:3",
"5:4",
"1:1",
"4:5",
"3:4",
"2:3",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"4096"
]
},
"output_format": {
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Nano Banana Pro Edit — high-quality instruction-based editing with web search augmentation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenable_web_searchbooleansafety_tolerancenumbersystem_promptstringaspect_ratiostringresolutionstringoutput_formatstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fnano-banana-pro%2Fedit",
"title": "Nano Banana Pro (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/nano-banana-pro/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/nano-banana-pro/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enable_web_search": {
"title": "Enable Web Search",
"description": "Enable web search for the image generation task. This will allow the model to use the latest information from the web to generate the image.",
"default": false,
"type": "boolean"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.",
"default": "4",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"system_prompt": {
"title": "System Prompt",
"description": "Optional system instruction that steers the model's persona and output style across the request. Leave blank to omit; when provided, it is sent as the system prompt.",
"default": "",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"21:9",
"16:9",
"3:2",
"4:3",
"5:4",
"1:1",
"4:5",
"3:4",
"2:3",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"4096"
]
},
"output_format": {
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
PixArt Sigma — efficient transformer-based image generation with style presets and scheduler options.
Pricing: ~$0.003 / image (compute-second estimate)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringschedulerstringseedintegerguidance_scalenumbernum_inference_stepsnumberstylestringnegative_promptstringenable_safety_checkerbooleanaspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fpixart-sigma",
"title": "PixArt Sigma generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/pixart-sigma.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/pixart-sigma",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"scheduler": {
"title": "Scheduler",
"description": "The scheduler to use for the model.",
"default": "DPM-SOLVER",
"type": "string",
"enum": [
"DPM-SOLVER",
"SA-SOLVER"
]
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time.",
"type": "integer"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 4.5,
"type": "number",
"minimum": 1,
"maximum": 10,
"multipleOf": 0.1
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 35,
"type": "number",
"minimum": 5,
"maximum": 50,
"multipleOf": 1
},
"style": {
"title": "Style",
"description": "The style to apply to the image.",
"default": "(No style)",
"type": "string",
"enum": [
"(No style)",
"Cinematic",
"Photographic",
"Anime",
"Manga",
"Digital Art",
"Pixel art",
"Fantasy art",
"Neonpunk",
"3D Model"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to use. Use it to address details that you don't want in the image. This could be colors, objects, scenery and even the small deta",
"default": "",
"type": "string"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Playground v2.5 — versatile open-source image model with style presets and prompt expansion.
Pricing: ~$0.003 / image (compute-second estimate)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringformatstringseedintegernegative_promptstringguidance_scalenumbersafety_checker_versionstringnum_inference_stepsnumberexpand_promptbooleanenable_safety_checkerbooleanembedding_pathstringembedding_tokensarrayembedding_path_2stringembedding_tokens_2arrayembedding_path_3stringembedding_tokens_3arrayaspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fplayground-v25",
"title": "Playground v2.5 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/playground-v25.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/playground-v25",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"format": {
"title": "Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time.",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to use. Use it to address details that you don't want in the image. This could be colors, objects, scenery and even the small deta",
"default": "",
"type": "string"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 3,
"type": "number",
"minimum": 0,
"maximum": 20,
"multipleOf": 0.1
},
"safety_checker_version": {
"title": "Safety Checker Version",
"description": "The version of the safety checker to use. v1 is the default CompVis safety checker. v2 uses a custom ViT model.",
"default": "v1",
"type": "string",
"enum": [
"v1",
"v2"
]
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 25,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "If set to true, the prompt will be expanded with additional prompts.",
"default": false,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"embedding_path": {
"title": "Embedding Path",
"description": "URL or Hugging Face path to textual-inversion embedding weights.",
"type": "string"
},
"embedding_tokens": {
"title": "Embedding Tokens",
"description": "Tokens that trigger the embedding when used in your prompt.",
"type": "array",
"items": {
"type": "string"
}
},
"embedding_path_2": {
"title": "Embedding Path 2",
"description": "URL or Hugging Face path to a second embedding.",
"type": "string"
},
"embedding_tokens_2": {
"title": "Embedding Tokens 2",
"description": "Tokens for the second embedding.",
"type": "array",
"items": {
"type": "string"
}
},
"embedding_path_3": {
"title": "Embedding Path 3",
"description": "URL or Hugging Face path to a third embedding.",
"type": "string"
},
"embedding_tokens_3": {
"title": "Embedding Tokens 3",
"description": "Tokens for the third embedding.",
"type": "array",
"items": {
"type": "string"
}
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
PuLID — tuning-free face-identity preservation that generates consistent portraits with high fidelity or extreme style control.
Pricing: ~$0.02 / image
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_inference_stepsnumberid_scalenumberguidance_scalenumbermodestringid_mixbooleannegative_promptstringseedintegeraspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fpulid",
"title": "PuLID generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/pulid.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/pulid",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"num_inference_steps": {
"title": "Steps",
"description": "Number of denoising steps.",
"default": 4,
"type": "number",
"minimum": 1,
"maximum": 12,
"multipleOf": 1
},
"id_scale": {
"title": "ID Scale",
"description": "Strength of identity preservation. Higher = closer to the reference face.",
"default": 0.8,
"type": "number",
"minimum": 0,
"maximum": 5
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Classifier-free guidance scale.",
"default": 1.2,
"type": "number",
"minimum": 1,
"maximum": 1.5,
"multipleOf": 0.05
},
"mode": {
"title": "Mode",
"description": "Fidelity preserves facial features closely; extreme style allows stronger artistic transformation.",
"default": "fidelity",
"type": "string",
"enum": [
"fidelity",
"extreme style"
]
},
"id_mix": {
"title": "ID Mix",
"description": "Enable to blend identity from two reference images instead of one.",
"default": false,
"type": "boolean"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Elements to exclude from the generated image.",
"default": "flaws in the eyes, flaws in the face, flaws, lowres, non-HDRi, low quality, worst quality,artifacts noise, text, watermark, glitch, deformed, mutated, ugly, disfigured, hands, low resolution, partially rendered objects, deformed or partially rendered eyes, deformed, deformed eyeballs, cross-eyed,blurry",
"type": "string"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 4
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Qwen Face to Full Portrait 2509 — generates a full-body portrait from a face reference using Qwen 2509.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaccelerationstringnegative_promptstringoutput_formatstringenable_safety_checkerbooleannum_inference_stepsnumberlora_scalenumberguidance_scalenumberseedintegeraspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fqwen-image-edit-2509-lora-gallery%2Fface-to-full-portrait",
"title": "Qwen Face to Full Portrait (2509) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/qwen-image-edit-2509-lora-gallery/face-to-full-portrait.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/qwen-image-edit-2509-lora-gallery/face-to-full-portrait",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"acceleration": {
"title": "Acceleration",
"description": "Acceleration level for image generation.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Content to avoid in the generated image.",
"default": " ",
"type": "string"
},
"output_format": {
"title": "Output Format",
"description": "The format of the output image.",
"default": "png",
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
]
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 6,
"type": "number",
"minimum": 2,
"maximum": 50,
"multipleOf": 1
},
"lora_scale": {
"title": "Lora Scale",
"description": "The strength of the LoRA effect.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG guidance scale.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 20
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Qwen Face to Full Portrait Plus — generates a full-body portrait from a face reference using Qwen Plus.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaccelerationstringnegative_promptstringoutput_formatstringenable_safety_checkerbooleannum_inference_stepsnumberlora_scalenumberguidance_scalenumberseedintegeraspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fqwen-image-edit-plus-lora-gallery%2Fface-to-full-portrait",
"title": "Qwen Face to Full Portrait (Plus) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/qwen-image-edit-plus-lora-gallery/face-to-full-portrait.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/qwen-image-edit-plus-lora-gallery/face-to-full-portrait",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"acceleration": {
"title": "Acceleration",
"description": "Acceleration level for image generation.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Content to avoid in the generated image.",
"default": " ",
"type": "string"
},
"output_format": {
"title": "Output Format",
"description": "The format of the output image.",
"default": "png",
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
]
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 6,
"type": "number",
"minimum": 2,
"maximum": 50,
"multipleOf": 1
},
"lora_scale": {
"title": "Lora Scale",
"description": "The strength of the LoRA effect.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG guidance scale.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 20
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Qwen Image 2.0 — Alibaba's image model with negative prompts, prompt expansion, and up to 6 variants per request. Supports optional reference-image editing.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenable_prompt_expansionbooleannegative_promptstringseedintegerwatermarkbooleanaspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fqwen-image-2%2Ftext-to-image",
"title": "Qwen Image 2.0 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/qwen-image-2/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/qwen-image-2/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Enable LLM prompt optimization for better results.",
"default": true,
"type": "boolean"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Content to avoid in the generated image. Max 500 characters.",
"default": "",
"type": "string"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility (0-2147483647).",
"type": "integer"
},
"watermark": {
"title": "Watermark",
"description": "Adds a \"Qwen-Image\" watermark to the bottom-right corner.",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 6
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Qwen Image 2.0 Pro — premium Qwen v2 model for complex multi-element compositions and detailed scenes, with negative prompts and up to 6 variants. Supports optional reference-image editing.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenable_prompt_expansionbooleannegative_promptstringseedintegerwatermarkbooleanaspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fqwen-image-2%2Fpro%2Ftext-to-image",
"title": "Qwen Image 2.0 Pro generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/qwen-image-2/pro/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/qwen-image-2/pro/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Enable LLM prompt optimization for better results.",
"default": true,
"type": "boolean"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Content to avoid in the generated image. Max 500 characters.",
"default": "",
"type": "string"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility (0-2147483647).",
"type": "integer"
},
"watermark": {
"title": "Watermark",
"description": "Adds a \"Qwen-Image\" watermark to the bottom-right corner.",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 6
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Realistic Vision — SD fine-tune optimized for photorealistic portraits and scenes.
Pricing: ~$0.002 / image (compute-second estimate)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringseedintegernegative_promptstringsafety_checker_versionstringguidance_scalenumbernum_inference_stepsnumberexpand_promptbooleanformatstringenable_safety_checkerbooleanlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberembedding_pathstringembedding_tokensarrayembedding_path_2stringembedding_tokens_2arrayembedding_path_3stringembedding_tokens_3arrayaspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Frealistic-vision",
"title": "Realistic Vision generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/realistic-vision.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/realistic-vision",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time.",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to use. Use it to address details that you don't want in the image.",
"default": "(worst quality, low quality, normal quality, lowres, low details, oversaturated, undersaturated, overexposed, underexposed, grayscale, bw, bad photo, bad photography, bad art:1.4), (watermark, signature, text font, username, error, logo, words, letters, digits, autograph, trademark, name:1.2), (blur, blurry, grainy), morbid, ugly, asymmetrical, mutated malformed, mutilated, poorly lit, bad shadow, draft, cropped, out of frame, cut off, censored, jpeg artifacts, out of focus, glitch, duplicate, (airbrushed, cartoon, anime, semi-realistic, cgi, render, blender, digital art, manga, amateur:1.3), (3D ,3D Game, 3D Game Scene, 3D Character:1.1), (bad hands, bad anatomy, bad body, bad face, bad teeth, bad arms, bad legs, deformities:1.3)",
"type": "string"
},
"safety_checker_version": {
"title": "Safety Checker Version",
"description": "The version of the safety checker to use. v1 is the default CompVis safety checker. v2 uses a custom ViT model.",
"default": "v1",
"type": "string",
"enum": [
"v1",
"v2"
]
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 5,
"type": "number",
"minimum": 0,
"maximum": 20,
"multipleOf": 0.1
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 35,
"type": "number",
"minimum": 1,
"maximum": 70,
"multipleOf": 1
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "If set to true, the prompt will be expanded with additional prompts.",
"default": false,
"type": "boolean"
},
"format": {
"title": "Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"lora_path": {
"title": "LoRA Path",
"description": "URL or Hugging Face path to LoRA weights.",
"type": "string"
},
"lora_scale": {
"title": "LoRA Scale",
"description": "Strength of the LoRA effect (0–1).",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"lora_path_2": {
"title": "LoRA Path 2",
"description": "URL or Hugging Face path to a second LoRA.",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA Scale 2",
"description": "Strength of the second LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"lora_path_3": {
"title": "LoRA Path 3",
"description": "URL or Hugging Face path to a third LoRA.",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA Scale 3",
"description": "Strength of the third LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"embedding_path": {
"title": "Embedding Path",
"description": "URL or Hugging Face path to textual-inversion embedding weights.",
"type": "string"
},
"embedding_tokens": {
"title": "Embedding Tokens",
"description": "Tokens that trigger the embedding when used in your prompt.",
"type": "array",
"items": {
"type": "string"
}
},
"embedding_path_2": {
"title": "Embedding Path 2",
"description": "URL or Hugging Face path to a second embedding.",
"type": "string"
},
"embedding_tokens_2": {
"title": "Embedding Tokens 2",
"description": "Tokens for the second embedding.",
"type": "array",
"items": {
"type": "string"
}
},
"embedding_path_3": {
"title": "Embedding Path 3",
"description": "URL or Hugging Face path to a third embedding.",
"type": "string"
},
"embedding_tokens_3": {
"title": "Embedding Tokens 3",
"description": "Tokens for the third embedding.",
"type": "array",
"items": {
"type": "string"
}
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Recraft 20B — compact but capable image generation model with rich style options.
Pricing: $0.022 / image — $0.044 with a vector style
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstyle_idstringstylestringcolorsobjectenable_safety_checkerbooleanaspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Frecraft-20b",
"title": "Recraft 20B generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/recraft-20b.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/recraft-20b",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"style_id": {
"title": "Style Id",
"description": "The ID of the custom style reference (optional)",
"type": "string"
},
"style": {
"title": "Style",
"description": "The style of the generated images. Vector images cost 2X as much.",
"default": "realistic_image",
"type": "string",
"enum": [
"any",
"realistic_image",
"digital_illustration",
"vector_illustration",
"realistic_image/b_and_w",
"realistic_image/enterprise",
"realistic_image/hard_flash",
"realistic_image/hdr",
"realistic_image/motion_blur",
"realistic_image/natural_light",
"realistic_image/studio_portrait",
"digital_illustration/2d_art_poster",
"digital_illustration/2d_art_poster_2",
"digital_illustration/3d",
"digital_illustration/80s",
"digital_illustration/engraving_color",
"digital_illustration/glow",
"digital_illustration/grain",
"digital_illustration/hand_drawn",
"digital_illustration/hand_drawn_outline",
"digital_illustration/handmade_3d",
"digital_illustration/infantile_sketch",
"digital_illustration/kawaii",
"digital_illustration/pixel_art",
"digital_illustration/psychedelic",
"digital_illustration/seamless",
"digital_illustration/voxel",
"digital_illustration/watercolor",
"vector_illustration/cartoon",
"vector_illustration/doodle_line_art",
"vector_illustration/engraving",
"vector_illustration/flat_2",
"vector_illustration/kawaii",
"vector_illustration/line_art",
"vector_illustration/line_circuit",
"vector_illustration/linocut",
"vector_illustration/seamless"
]
},
"colors": {
"title": "Colors",
"description": "An array of preferable colors, e.g. [{\"r\":255,\"g\":0,\"b\":0}]",
"type": "object",
"additionalProperties": true
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Recraft Creative Upscaler — enhance illustrations and artwork with generative detail.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenable_safety_checkerbooleanreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Frecraft%2Fupscale%2Fcreative",
"title": "Recraft Upscale Creative generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/recraft/upscale/creative.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/recraft/upscale/creative",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": false,
"type": "boolean"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Recraft Crisp Upscaler — sharpen edges and fine detail without hallucination.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenable_safety_checkerbooleanreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Frecraft%2Fupscale%2Fcrisp",
"title": "Recraft Upscale Crisp generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/recraft/upscale/crisp.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/recraft/upscale/crisp",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": false,
"type": "boolean"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Recraft v3 — premium image generation with extensive style control and vector support.
Pricing: $0.04 / image — $0.08 with a vector style
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstyle_idstringstylestringcolorsobjectenable_safety_checkerbooleanaspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Frecraft%2Fv3%2Ftext-to-image",
"title": "Recraft v3 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/recraft/v3/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/recraft/v3/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"style_id": {
"title": "Style Id",
"description": "The ID of the custom style reference (optional)",
"type": "string"
},
"style": {
"title": "Style",
"description": "The style of the generated images. Vector images cost 2X as much.",
"default": "realistic_image",
"type": "string",
"enum": [
"any",
"realistic_image",
"digital_illustration",
"vector_illustration",
"realistic_image/b_and_w",
"realistic_image/hard_flash",
"realistic_image/hdr",
"realistic_image/natural_light",
"realistic_image/studio_portrait",
"realistic_image/enterprise",
"realistic_image/motion_blur",
"realistic_image/evening_light",
"realistic_image/faded_nostalgia",
"realistic_image/forest_life",
"realistic_image/mystic_naturalism",
"realistic_image/natural_tones",
"realistic_image/organic_calm",
"realistic_image/real_life_glow",
"realistic_image/retro_realism",
"realistic_image/retro_snapshot",
"realistic_image/urban_drama",
"realistic_image/village_realism",
"realistic_image/warm_folk",
"digital_illustration/pixel_art",
"digital_illustration/hand_drawn",
"digital_illustration/grain",
"digital_illustration/infantile_sketch",
"digital_illustration/2d_art_poster",
"digital_illustration/handmade_3d",
"digital_illustration/hand_drawn_outline",
"digital_illustration/engraving_color",
"digital_illustration/2d_art_poster_2",
"digital_illustration/antiquarian",
"digital_illustration/bold_fantasy",
"digital_illustration/child_book",
"digital_illustration/child_books",
"digital_illustration/cover",
"digital_illustration/crosshatch",
"digital_illustration/digital_engraving",
"digital_illustration/expressionism",
"digital_illustration/freehand_details",
"digital_illustration/grain_20",
"digital_illustration/graphic_intensity",
"digital_illustration/hard_comics",
"digital_illustration/long_shadow",
"digital_illustration/modern_folk",
"digital_illustration/multicolor",
"digital_illustration/neon_calm",
"digital_illustration/noir",
"digital_illustration/nostalgic_pastel",
"digital_illustration/outline_details",
"digital_illustration/pastel_gradient",
"digital_illustration/pastel_sketch",
"digital_illustration/pop_art",
"digital_illustration/pop_renaissance",
"digital_illustration/street_art",
"digital_illustration/tablet_sketch",
"digital_illustration/urban_glow",
"digital_illustration/urban_sketching",
"digital_illustration/vanilla_dreams",
"digital_illustration/young_adult_book",
"digital_illustration/young_adult_book_2",
"vector_illustration/bold_stroke",
"vector_illustration/chemistry",
"vector_illustration/colored_stencil",
"vector_illustration/contour_pop_art",
"vector_illustration/cosmics",
"vector_illustration/cutout",
"vector_illustration/depressive",
"vector_illustration/editorial",
"vector_illustration/emotional_flat",
"vector_illustration/infographical",
"vector_illustration/marker_outline",
"vector_illustration/mosaic",
"vector_illustration/naivector",
"vector_illustration/roundish_flat",
"vector_illustration/segmented_colors",
"vector_illustration/sharp_contrast",
"vector_illustration/thin",
"vector_illustration/vector_photo",
"vector_illustration/vivid_shapes",
"vector_illustration/engraving",
"vector_illustration/line_art",
"vector_illustration/line_circuit",
"vector_illustration/linocut"
]
},
"colors": {
"title": "Colors",
"description": "An array of preferable colors, e.g. [{\"r\":255,\"g\":0,\"b\":0}]",
"type": "object",
"additionalProperties": true
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Recraft v3 image-to-image — style-transfer editing with extensive recraft style options.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringstyle_idstringstrengthnumberstylestringcolorsobjectaspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Frecraft%2Fv3%2Fimage-to-image",
"title": "Recraft v3 (I2I) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/recraft/v3/image-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/recraft/v3/image-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "A text description of undesired elements on an image",
"type": "string"
},
"style_id": {
"title": "Style Id",
"description": "The ID of the custom style reference (optional)",
"type": "string"
},
"strength": {
"title": "Strength",
"description": "Defines the difference with the original image, should lie in [0, 1], where 0 means almost identical, and 1 means miserable similarity",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1
},
"style": {
"title": "Style",
"description": "The style of the generated images. Vector images cost 2X as much.",
"default": "realistic_image",
"type": "string",
"enum": [
"any",
"realistic_image",
"digital_illustration",
"vector_illustration",
"realistic_image/b_and_w",
"realistic_image/hard_flash",
"realistic_image/hdr",
"realistic_image/natural_light",
"realistic_image/studio_portrait",
"realistic_image/enterprise",
"realistic_image/motion_blur",
"realistic_image/evening_light",
"realistic_image/faded_nostalgia",
"realistic_image/forest_life",
"realistic_image/mystic_naturalism",
"realistic_image/natural_tones",
"realistic_image/organic_calm",
"realistic_image/real_life_glow",
"realistic_image/retro_realism",
"realistic_image/retro_snapshot",
"realistic_image/urban_drama",
"realistic_image/village_realism",
"realistic_image/warm_folk",
"digital_illustration/pixel_art",
"digital_illustration/hand_drawn",
"digital_illustration/grain",
"digital_illustration/infantile_sketch",
"digital_illustration/2d_art_poster",
"digital_illustration/handmade_3d",
"digital_illustration/hand_drawn_outline",
"digital_illustration/engraving_color",
"digital_illustration/2d_art_poster_2",
"digital_illustration/antiquarian",
"digital_illustration/bold_fantasy",
"digital_illustration/child_book",
"digital_illustration/child_books",
"digital_illustration/cover",
"digital_illustration/crosshatch",
"digital_illustration/digital_engraving",
"digital_illustration/expressionism",
"digital_illustration/freehand_details",
"digital_illustration/grain_20",
"digital_illustration/graphic_intensity",
"digital_illustration/hard_comics",
"digital_illustration/long_shadow",
"digital_illustration/modern_folk",
"digital_illustration/multicolor",
"digital_illustration/neon_calm",
"digital_illustration/noir",
"digital_illustration/nostalgic_pastel",
"digital_illustration/outline_details",
"digital_illustration/pastel_gradient",
"digital_illustration/pastel_sketch",
"digital_illustration/pop_art",
"digital_illustration/pop_renaissance",
"digital_illustration/street_art",
"digital_illustration/tablet_sketch",
"digital_illustration/urban_glow",
"digital_illustration/urban_sketching",
"digital_illustration/vanilla_dreams",
"digital_illustration/young_adult_book",
"digital_illustration/young_adult_book_2",
"vector_illustration/bold_stroke",
"vector_illustration/chemistry",
"vector_illustration/colored_stencil",
"vector_illustration/contour_pop_art",
"vector_illustration/cosmics",
"vector_illustration/cutout",
"vector_illustration/depressive",
"vector_illustration/editorial",
"vector_illustration/emotional_flat",
"vector_illustration/infographical",
"vector_illustration/marker_outline",
"vector_illustration/mosaic",
"vector_illustration/naivector",
"vector_illustration/roundish_flat",
"vector_illustration/segmented_colors",
"vector_illustration/sharp_contrast",
"vector_illustration/thin",
"vector_illustration/vector_photo",
"vector_illustration/vivid_shapes",
"vector_illustration/engraving",
"vector_illustration/line_art",
"vector_illustration/line_circuit",
"vector_illustration/linocut"
]
},
"colors": {
"title": "Colors",
"description": "An array of preferable colors, e.g. [{\"r\":255,\"g\":0,\"b\":0}]",
"type": "object",
"additionalProperties": true
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Recraft v4 — next-generation image generation with improved quality and style consistency.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringcolorsobjectbackground_colorobjectenable_safety_checkerbooleanaspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Frecraft%2Fv4%2Ftext-to-image",
"title": "Recraft v4 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/recraft/v4/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/recraft/v4/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"colors": {
"title": "Colors",
"description": "An array of preferable colors, e.g. [{\"r\":255,\"g\":0,\"b\":0}]",
"type": "object",
"additionalProperties": true
},
"background_color": {
"title": "Background Color",
"description": "Preferable background color as an RGB object, e.g. {\"r\":255,\"g\":255,\"b\":255}",
"type": "object",
"additionalProperties": true
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Recraft v4 Vector — generate scalable SVG vector artwork from text descriptions.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringcolorsobjectbackground_colorobjectenable_safety_checkerbooleanaspect_ratiostringresolutionstringoutput_formatstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Frecraft%2Fv4%2Ftext-to-vector",
"title": "Recraft v4 (Vector) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/recraft/v4/text-to-vector.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/recraft/v4/text-to-vector",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"colors": {
"title": "Colors",
"description": "An array of preferable colors, e.g. [{\"r\":255,\"g\":0,\"b\":0}]",
"type": "object",
"additionalProperties": true
},
"background_color": {
"title": "Background Color",
"description": "Preferable background color as an RGB object, e.g. {\"r\":255,\"g\":255,\"b\":255}",
"type": "object",
"additionalProperties": true
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"output_format": {
"type": "string",
"enum": [
"svg"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Recraft v4 Pro — premium-quality Recraft v4 for cinematic and book cover imagery.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringcolorsobjectbackground_colorobjectenable_safety_checkerbooleanaspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Frecraft%2Fv4%2Fpro%2Ftext-to-image",
"title": "Recraft v4 Pro generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/recraft/v4/pro/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/recraft/v4/pro/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"colors": {
"title": "Colors",
"description": "An array of preferable colors, e.g. [{\"r\":255,\"g\":0,\"b\":0}]",
"type": "object",
"additionalProperties": true
},
"background_color": {
"title": "Background Color",
"description": "Preferable background color as an RGB object, e.g. {\"r\":255,\"g\":255,\"b\":255}",
"type": "object",
"additionalProperties": true
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048",
"4096"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Recraft v4 Pro Vector — premium SVG vector output for large-format and brand work.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringcolorsobjectbackground_colorobjectenable_safety_checkerbooleanaspect_ratiostringresolutionstringoutput_formatstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Frecraft%2Fv4%2Fpro%2Ftext-to-vector",
"title": "Recraft v4 Pro (Vector) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/recraft/v4/pro/text-to-vector.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/recraft/v4/pro/text-to-vector",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"colors": {
"title": "Colors",
"description": "An array of preferable colors, e.g. [{\"r\":255,\"g\":0,\"b\":0}]",
"type": "object",
"additionalProperties": true
},
"background_color": {
"title": "Background Color",
"description": "Preferable background color as an RGB object, e.g. {\"r\":255,\"g\":255,\"b\":255}",
"type": "object",
"additionalProperties": true
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048",
"4096"
]
},
"output_format": {
"type": "string",
"enum": [
"svg"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Recraft V4 Style generates raster images while matching an optional Recraft style and reference-image set.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstyle_idstringstyle_matchstringcolorsarraybackground_colorobjectimage_urlsarrayenable_safety_checkerbooleanimage_sizestring / object
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=recraft%2Fv4%2Fstyle%2Ftext-to-image",
"title": "Recraft V4 Style generation request",
"description": "Request body accepted by POST /api/v1/generate for recraft/v4/style/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "recraft/v4/style/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"minLength": 1,
"maxLength": 10000
},
"style_id": {
"title": "Style ID",
"description": "Optional Recraft style identifier.",
"type": "string"
},
"style_match": {
"title": "Style Match",
"type": "string",
"enum": [
"precise",
"flexible"
]
},
"colors": {
"title": "Preferred Colors",
"description": "JSON array of RGB color objects.",
"type": "array",
"items": {
"type": "object"
}
},
"background_color": {
"title": "Background Color",
"description": "RGB background-color object.",
"type": "object",
"additionalProperties": true
},
"image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 1,
"maxItems": 10
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"image_size": {
"title": "Image Size",
"default": "square_hd",
"anyOf": [
{
"type": "string",
"enum": [
"square_hd",
"square",
"portrait_4_3",
"portrait_16_9",
"landscape_4_3",
"landscape_16_9"
]
},
{
"type": "object",
"additionalProperties": true
}
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Recraft V4 Style Pro generates raster images while matching an optional Recraft style and reference-image set.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstyle_idstringstyle_matchstringcolorsarraybackground_colorobjectimage_urlsarrayenable_safety_checkerbooleanimage_sizestring / object
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=recraft%2Fv4%2Fstyle%2Fpro%2Ftext-to-image",
"title": "Recraft V4 Style Pro generation request",
"description": "Request body accepted by POST /api/v1/generate for recraft/v4/style/pro/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "recraft/v4/style/pro/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"minLength": 1,
"maxLength": 10000
},
"style_id": {
"title": "Style ID",
"description": "Optional Recraft style identifier.",
"type": "string"
},
"style_match": {
"title": "Style Match",
"type": "string",
"enum": [
"precise",
"flexible"
]
},
"colors": {
"title": "Preferred Colors",
"description": "JSON array of RGB color objects.",
"type": "array",
"items": {
"type": "object"
}
},
"background_color": {
"title": "Background Color",
"description": "RGB background-color object.",
"type": "object",
"additionalProperties": true
},
"image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 1,
"maxItems": 10
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"image_size": {
"title": "Image Size",
"default": "square_hd",
"anyOf": [
{
"type": "string",
"enum": [
"square_hd",
"square",
"portrait_4_3",
"portrait_16_9",
"landscape_4_3",
"landscape_16_9"
]
},
{
"type": "object",
"additionalProperties": true
}
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Recraft V4 Style Vector generates scalable vector artwork while matching an optional Recraft style and reference-image set.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstyle_idstringstyle_matchstringcolorsarraybackground_colorobjectimage_urlsarrayenable_safety_checkerbooleanimage_sizestring / object
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=recraft%2Fv4%2Fstyle%2Ftext-to-vector",
"title": "Recraft V4 Style Vector generation request",
"description": "Request body accepted by POST /api/v1/generate for recraft/v4/style/text-to-vector.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "recraft/v4/style/text-to-vector",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"minLength": 1,
"maxLength": 10000
},
"style_id": {
"title": "Style ID",
"description": "Optional Recraft style identifier.",
"type": "string"
},
"style_match": {
"title": "Style Match",
"type": "string",
"enum": [
"precise",
"flexible"
]
},
"colors": {
"title": "Preferred Colors",
"description": "JSON array of RGB color objects.",
"type": "array",
"items": {
"type": "object"
}
},
"background_color": {
"title": "Background Color",
"description": "RGB background-color object.",
"type": "object",
"additionalProperties": true
},
"image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 1,
"maxItems": 10
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"image_size": {
"title": "Image Size",
"default": "square_hd",
"anyOf": [
{
"type": "string",
"enum": [
"square_hd",
"square",
"portrait_4_3",
"portrait_16_9",
"landscape_4_3",
"landscape_16_9"
]
},
{
"type": "object",
"additionalProperties": true
}
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Recraft V4 Style Vector Pro generates scalable vector artwork while matching an optional Recraft style and reference-image set.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstyle_idstringstyle_matchstringcolorsarraybackground_colorobjectimage_urlsarrayenable_safety_checkerbooleanimage_sizestring / object
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=recraft%2Fv4%2Fstyle%2Fpro%2Ftext-to-vector",
"title": "Recraft V4 Style Vector Pro generation request",
"description": "Request body accepted by POST /api/v1/generate for recraft/v4/style/pro/text-to-vector.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "recraft/v4/style/pro/text-to-vector",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"minLength": 1,
"maxLength": 10000
},
"style_id": {
"title": "Style ID",
"description": "Optional Recraft style identifier.",
"type": "string"
},
"style_match": {
"title": "Style Match",
"type": "string",
"enum": [
"precise",
"flexible"
]
},
"colors": {
"title": "Preferred Colors",
"description": "JSON array of RGB color objects.",
"type": "array",
"items": {
"type": "object"
}
},
"background_color": {
"title": "Background Color",
"description": "RGB background-color object.",
"type": "object",
"additionalProperties": true
},
"image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 1,
"maxItems": 10
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"image_size": {
"title": "Image Size",
"default": "square_hd",
"anyOf": [
{
"type": "string",
"enum": [
"square_hd",
"square",
"portrait_4_3",
"portrait_16_9",
"landscape_4_3",
"landscape_16_9"
]
},
{
"type": "object",
"additionalProperties": true
}
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Recraft v4.1 — updated Recraft with improved quality and consistency.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringcolorsobjectbackground_colorobjectenable_safety_checkerbooleanaspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Frecraft%2Fv4.1%2Ftext-to-image",
"title": "Recraft v4.1 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/recraft/v4.1/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/recraft/v4.1/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"colors": {
"title": "Colors",
"description": "An array of preferable colors, e.g. [{\"r\":255,\"g\":0,\"b\":0}]",
"type": "object",
"additionalProperties": true
},
"background_color": {
"title": "Background Color",
"description": "Preferable background color as an RGB object, e.g. {\"r\":255,\"g\":255,\"b\":255}",
"type": "object",
"additionalProperties": true
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Recraft v4.1 Vector — generate scalable SVG icons and vector artwork.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringcolorsobjectbackground_colorobjectenable_safety_checkerbooleanaspect_ratiostringresolutionstringoutput_formatstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Frecraft%2Fv4.1%2Ftext-to-vector",
"title": "Recraft v4.1 (Vector) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/recraft/v4.1/text-to-vector.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/recraft/v4.1/text-to-vector",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"colors": {
"title": "Colors",
"description": "An array of preferable colors, e.g. [{\"r\":255,\"g\":0,\"b\":0}]",
"type": "object",
"additionalProperties": true
},
"background_color": {
"title": "Background Color",
"description": "Preferable background color as an RGB object, e.g. {\"r\":255,\"g\":255,\"b\":255}",
"type": "object",
"additionalProperties": true
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"output_format": {
"type": "string",
"enum": [
"svg"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Recraft v4.1 Pro — premium print-quality images targeting hero and campaign use.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringcolorsobjectbackground_colorobjectenable_safety_checkerbooleanaspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Frecraft%2Fv4.1%2Fpro%2Ftext-to-image",
"title": "Recraft v4.1 Pro generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/recraft/v4.1/pro/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/recraft/v4.1/pro/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"colors": {
"title": "Colors",
"description": "An array of preferable colors, e.g. [{\"r\":255,\"g\":0,\"b\":0}]",
"type": "object",
"additionalProperties": true
},
"background_color": {
"title": "Background Color",
"description": "Preferable background color as an RGB object, e.g. {\"r\":255,\"g\":255,\"b\":255}",
"type": "object",
"additionalProperties": true
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Recraft v4.1 Pro Vector — large-format editable SVGs for poster and brand work.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringcolorsobjectbackground_colorobjectenable_safety_checkerbooleanaspect_ratiostringresolutionstringoutput_formatstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Frecraft%2Fv4.1%2Fpro%2Ftext-to-vector",
"title": "Recraft v4.1 Pro (Vector) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/recraft/v4.1/pro/text-to-vector.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/recraft/v4.1/pro/text-to-vector",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"colors": {
"title": "Colors",
"description": "An array of preferable colors, e.g. [{\"r\":255,\"g\":0,\"b\":0}]",
"type": "object",
"additionalProperties": true
},
"background_color": {
"title": "Background Color",
"description": "Preferable background color as an RGB object, e.g. {\"r\":255,\"g\":255,\"b\":255}",
"type": "object",
"additionalProperties": true
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048",
"4096"
]
},
"output_format": {
"type": "string",
"enum": [
"svg"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Recraft v4.1 Utility — optimized for throughput and batch ideation at standard quality.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringcolorsobjectbackground_colorobjectenable_safety_checkerbooleanaspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Frecraft%2Fv4.1%2Futility%2Ftext-to-image",
"title": "Recraft v4.1 Utility generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/recraft/v4.1/utility/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/recraft/v4.1/utility/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"colors": {
"title": "Colors",
"description": "An array of preferable colors, e.g. [{\"r\":255,\"g\":0,\"b\":0}]",
"type": "object",
"additionalProperties": true
},
"background_color": {
"title": "Background Color",
"description": "Preferable background color as an RGB object, e.g. {\"r\":255,\"g\":255,\"b\":255}",
"type": "object",
"additionalProperties": true
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Recraft v4.1 Utility Pro — pro quality with a faster runtime profile for high-volume studios.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringcolorsobjectbackground_colorobjectenable_safety_checkerbooleanaspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Frecraft%2Fv4.1%2Futility%2Fpro%2Ftext-to-image",
"title": "Recraft v4.1 Utility Pro generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/recraft/v4.1/utility/pro/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/recraft/v4.1/utility/pro/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"colors": {
"title": "Colors",
"description": "An array of preferable colors, e.g. [{\"r\":255,\"g\":0,\"b\":0}]",
"type": "object",
"additionalProperties": true
},
"background_color": {
"title": "Background Color",
"description": "Preferable background color as an RGB object, e.g. {\"r\":255,\"g\":255,\"b\":255}",
"type": "object",
"additionalProperties": true
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Recraft Vectorize — convert any raster image to a clean, scalable SVG.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringoutput_formatstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Frecraft%2Fvectorize",
"title": "Recraft Vectorize generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/recraft/vectorize.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/recraft/vectorize",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"output_format": {
"type": "string",
"enum": [
"svg"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Reve Edit — instruction-based image editing with clean sky and foreground element preservation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringoutput_formatstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Freve%2Fedit",
"title": "Reve (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/reve/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/reve/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"output_format": {
"title": "Output Format",
"description": "Output format for the generated image.",
"default": "png",
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Reve 2.1 — premium text-to-image generation with exceptional prompt adherence, layout intelligence, and accurate typography.
Pricing: $0.25 per image (fal-published)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringoutput_formatstringaspect_ratiostringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=reve%2F2.1%2Ftext-to-image",
"title": "Reve 2.1 generation request",
"description": "Request body accepted by POST /api/v1/generate for reve/2.1/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "reve/2.1/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"output_format": {
"title": "Output Format",
"description": "File format for the generated image.",
"default": "png",
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"Auto",
"4:1",
"3:1",
"21:9",
"2:1",
"17:9",
"16:9",
"3:2",
"4:3",
"5:4",
"1:1",
"4:5",
"3:4",
"2:3",
"9:16",
"1:2",
"1:3",
"1:4"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Reve 2.1 Edit — precise instruction-guided editing that understands layout and preserves coherent typography and visual identity.
Pricing: $0.25 per image (fal-published)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringoutput_formatstringaspect_ratiostringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=reve%2F2.1%2Fedit",
"title": "Reve 2.1 Edit generation request",
"description": "Request body accepted by POST /api/v1/generate for reve/2.1/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "reve/2.1/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"output_format": {
"title": "Output Format",
"description": "File format for the generated image.",
"default": "png",
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"Auto",
"4:1",
"3:1",
"21:9",
"2:1",
"17:9",
"16:9",
"3:2",
"4:3",
"5:4",
"1:1",
"4:5",
"3:4",
"2:3",
"9:16",
"1:2",
"1:3",
"1:4"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Reve 2.1 Remix — combines up to eight reference images with frame-addressable prompting, strong composition, and accurate text rendering.
Pricing: $0.25 per image (fal-published)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringoutput_formatstringaspect_ratiostringnum_imagesintegerreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=reve%2F2.1%2Fremix",
"title": "Reve 2.1 Remix generation request",
"description": "Request body accepted by POST /api/v1/generate for reve/2.1/remix.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "reve/2.1/remix",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"output_format": {
"title": "Output Format",
"description": "File format for the generated image.",
"default": "png",
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"Auto",
"4:1",
"3:1",
"21:9",
"2:1",
"17:9",
"16:9",
"3:2",
"4:3",
"5:4",
"1:1",
"4:5",
"3:4",
"2:3",
"9:16",
"1:2",
"1:3",
"1:4"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 1,
"maxItems": 8
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Sana — NVIDIA fast linear-attention diffusion model for high-quality image generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstyle_namestringoutput_formatstringseedintegernegative_promptstringnum_inference_stepsnumberguidance_scalenumberenable_safety_checkerbooleanaspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fsana",
"title": "Sana generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/sana.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/sana",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"style_name": {
"title": "Style Name",
"description": "The style to generate the image in.",
"default": "(No style)",
"type": "string",
"enum": [
"(No style)",
"Cinematic",
"Photographic",
"Anime",
"Manga",
"Digital Art",
"Pixel art",
"Fantasy art",
"Neonpunk",
"3D Model"
]
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same image every time.",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to use. Use it to address details that you don't want in the image. This could be colors, objects, scenery and even the small deta",
"default": "",
"type": "string"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 18,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 5,
"type": "number",
"minimum": 0,
"maximum": 20,
"multipleOf": 0.1
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048",
"4096"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
SD 3 Medium — Stability AI's SD3 model optimized for quality and speed balance.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringprompt_expansionbooleannum_inference_stepsnumberseedintegerguidance_scalenumbernegative_promptstringenable_safety_checkerbooleanaspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fstable-diffusion-v3-medium",
"title": "SD 3 Medium generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/stable-diffusion-v3-medium.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/stable-diffusion-v3-medium",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"prompt_expansion": {
"title": "Prompt Expansion",
"description": "If set to true, prompt will be upsampled with more details.",
"default": false,
"type": "boolean"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 28,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time.",
"type": "integer"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to generate an image from.",
"default": "",
"type": "string"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
SD 3 Medium Edit — image-to-image editing with Stability AI's SD3 model.
Pricing: $0.035 / image (same rate as SD 3 Medium)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringprompt_expansionbooleannum_inference_stepsnumberstrengthnumberseedintegernegative_promptstringguidance_scalenumberenable_safety_checkerbooleanaspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fstable-diffusion-v3-medium%2Fimage-to-image",
"title": "SD 3 Medium (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/stable-diffusion-v3-medium/image-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/stable-diffusion-v3-medium/image-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"prompt_expansion": {
"title": "Prompt Expansion",
"description": "If set to true, prompt will be upsampled with more details.",
"default": false,
"type": "boolean"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 28,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"strength": {
"title": "Strength",
"description": "The strength of the image-to-image transformation.",
"default": 0.9,
"type": "number",
"minimum": 0.01,
"maximum": 1
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time.",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to generate an image from.",
"default": "",
"type": "string"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 4
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
SD 3.5 Large — Stability AI's flagship model with best-in-class quality for complex artistic compositions.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringseedintegernum_inference_stepsnumberoutput_formatstringguidance_scalenumbernegative_promptstringenable_safety_checkerbooleania_scalenumberia_pathstringia_weight_namestringia_image_encoder_pathstringlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberaspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fstable-diffusion-v35-large",
"title": "SD 3.5 Large generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/stable-diffusion-v35-large.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/stable-diffusion-v35-large",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same image every time.",
"type": "integer"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 28,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 3.5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to use. Use it to address details that you don't want in the image. This could be colors, objects, scenery and even the small deta",
"default": "",
"type": "string"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"ia_scale": {
"title": "IP-Adapter Scale",
"description": "Strength of the uploaded reference image's style influence. Only used when a reference image is uploaded.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 2
},
"ia_path": {
"title": "IP-Adapter Path",
"description": "HuggingFace path to the IP-Adapter weights. Leave default unless using a custom adapter.",
"default": "InstantX/SD3.5-Large-IP-Adapter",
"type": "string"
},
"ia_weight_name": {
"title": "IP-Adapter Weight Name",
"description": "Filename of the IP-Adapter weights inside the repo. Leave default unless using a custom adapter.",
"default": "ip-adapter.bin",
"type": "string"
},
"ia_image_encoder_path": {
"title": "Image Encoder Path",
"description": "HuggingFace path to the IP-Adapter's image encoder. Leave default unless using a custom adapter.",
"default": "google/siglip-so400m-patch14-384",
"type": "string"
},
"lora_path": {
"title": "LoRA Path",
"description": "URL or Hugging Face path to LoRA weights (e.g. username/repo or https://…).",
"type": "string"
},
"lora_scale": {
"title": "LoRA Scale",
"description": "Strength of the LoRA effect. 1 = default weight, higher = stronger influence.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4
},
"lora_path_2": {
"title": "LoRA Path 2",
"description": "URL or Hugging Face path to a second set of LoRA weights.",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA Scale 2",
"description": "Strength of the second LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4
},
"lora_path_3": {
"title": "LoRA Path 3",
"description": "URL or Hugging Face path to a third set of LoRA weights.",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA Scale 3",
"description": "Strength of the third LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
SD 3.5 Medium — balanced quality and speed for versatile image generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringoutput_formatstringguidance_scalenumbernum_inference_stepsnumberseedintegernegative_promptstringenable_safety_checkerbooleanauto_fixbooleanaspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fstable-diffusion-v35-medium",
"title": "SD 3.5 Medium generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/stable-diffusion-v35-medium.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/stable-diffusion-v35-medium",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 4.5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 40,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same image every time.",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to use. Use it to address details that you don't want in the image. This could be colors, objects, scenery and even the small deta",
"default": "",
"type": "string"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"auto_fix": {
"title": "Auto Fix Size",
"description": "Silently rounds the requested image size to the nearest value the model supports. Disable to get an error instead of a rounded size.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
ByteDance Seedream 4.0 — reliable text-to-image generation at low cost.
Pricing: $0.03 / image (cross-confirmed vs fal resale of the same model)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringseedintegeraspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bytedance%2Fseedream-4-0%2Ftext-to-image",
"title": "Seedream 4.0 generation request",
"description": "Request body accepted by POST /api/v1/generate for bytedance/seedream-4-0/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bytedance/seedream-4-0/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"seed": {
"title": "Seed",
"description": "Random seed to control the stochasticity of image generation.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Seedream 4.0 Edit — ByteDance Seedream v4 instruction-based image editing with prompt enhancement.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenhance_prompt_modestringseedintegermax_imagesnumberenable_safety_checkerbooleanaspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fbytedance%2Fseedream%2Fv4%2Fedit",
"title": "Seedream 4.0 (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/bytedance/seedream/v4/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/bytedance/seedream/v4/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enhance_prompt_mode": {
"title": "Enhance Prompt Mode",
"description": "Standard mode provides higher quality results but takes longer to generate. Fast mode provides average quality but is faster.",
"default": "standard",
"type": "string",
"enum": [
"standard",
"fast"
]
},
"seed": {
"title": "Seed",
"description": "Random seed to control the stochasticity of image generation.",
"type": "integer"
},
"max_images": {
"title": "Max Images",
"description": "If set to a number greater than one, enables multi-image generation. The model will potentially return up to `max_images` images every generation, and in total, `num_images` generations will be carried out.",
"default": 1,
"type": "number",
"minimum": 1,
"maximum": 6,
"multipleOf": 1
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
ByteDance Seedream 4.5 — high-quality text-to-image with balanced speed and detail.
Pricing: $0.04 / image (cross-confirmed vs fal resale of the same model)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringseedintegeraspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bytedance%2Fseedream-4-5%2Ftext-to-image",
"title": "Seedream 4.5 generation request",
"description": "Request body accepted by POST /api/v1/generate for bytedance/seedream-4-5/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bytedance/seedream-4-5/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"seed": {
"title": "Seed",
"description": "Random seed to control the stochasticity of image generation.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Seedream 4.5 — ByteDance's image generation model with multi-image support and reference image capability.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringseedintegermax_imagesnumberenable_safety_checkerbooleanaspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fbytedance%2Fseedream%2Fv4.5%2Ftext-to-image",
"title": "Seedream 4.5 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/bytedance/seedream/v4.5/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/bytedance/seedream/v4.5/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"seed": {
"title": "Seed",
"description": "Random seed to control the stochasticity of image generation.",
"type": "integer"
},
"max_images": {
"title": "Max Images",
"description": "If set to a number greater than one, enables multi-image generation. The model will potentially return up to `max_images` images every generation, and in total, `num_images` generations will be carried out.",
"default": 1,
"type": "number",
"minimum": 1,
"maximum": 6,
"multipleOf": 1
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Seedream 4.5 Edit — instruction-based image editing with multi-image generation support.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringseedintegermax_imagesnumberenable_safety_checkerbooleanaspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fbytedance%2Fseedream%2Fv4.5%2Fedit",
"title": "Seedream 4.5 (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/bytedance/seedream/v4.5/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/bytedance/seedream/v4.5/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"seed": {
"title": "Seed",
"description": "Random seed to control the stochasticity of image generation.",
"type": "integer"
},
"max_images": {
"title": "Max Images",
"description": "If set to a number greater than one, enables multi-image generation. The model will potentially return up to `max_images` images every generation, and in total, `num_images` generations will be carried out.",
"default": 1,
"type": "number",
"minimum": 1,
"maximum": 6,
"multipleOf": 1
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
Seedream 5 Lite Edit — fast and affordable Seedream 5 editing model for scene transformations.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringmax_imagesnumberenable_safety_checkerbooleanaspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fbytedance%2Fseedream%2Fv5%2Flite%2Fedit",
"title": "Seedream 5 Lite (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/bytedance/seedream/v5/lite/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/bytedance/seedream/v5/lite/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"max_images": {
"title": "Max Images",
"description": "If set to a number greater than one, enables multi-image generation. The model will potentially return up to `max_images` images every generation, and in total, `num_images` generations will be carried out.",
"default": 1,
"type": "number",
"minimum": 1,
"maximum": 6,
"multipleOf": 1
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}
ByteDance Seedream 5.0 Lite — fast, affordable text-to-image generation.
Pricing: $0.035 / image (cross-confirmed vs fal resale of the same model)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringseedintegeraspect_ratiostringresolutionstringnum_imagesinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bytedance%2Fseedream-5-0-lite%2Ftext-to-image",
"title": "Seedream 5.0 Lite generation request",
"description": "Request body accepted by POST /api/v1/generate for bytedance/seedream-5-0-lite/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bytedance/seedream-5-0-lite/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"seed": {
"title": "Seed",
"description": "Random seed to control the stochasticity of image generation.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
SeedVR Upscale — high-quality image upscaling with sharp, natural-looking detail recovery.
Pricing: $0.001 $/output MP — 2x factor of a 1MP image ≈ 4 MP
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringtarget_resolutionstringupscale_modestringupscale_factornumberoutput_formatstringseedintegernoise_scalenumberreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fseedvr%2Fupscale%2Fimage",
"title": "SeedVR Upscale generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/seedvr/upscale/image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/seedvr/upscale/image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"target_resolution": {
"title": "Target Resolution",
"description": "The target resolution to upscale to when `upscale_mode` is `target`.",
"default": "1080p",
"type": "string",
"enum": [
"720p",
"1080p",
"1440p",
"2160p"
]
},
"upscale_mode": {
"title": "Upscale Mode",
"description": "The mode to use for the upscale. If 'target', the upscale factor will be calculated based on the target resolution. If 'factor', the upscale factor wi",
"default": "factor",
"type": "string",
"enum": [
"target",
"factor"
]
},
"upscale_factor": {
"title": "Upscale Factor",
"description": "Upscaling factor to be used. Will multiply the dimensions with this factor when `upscale_mode` is `factor`.",
"default": 2,
"type": "number",
"minimum": 1,
"maximum": 10
},
"output_format": {
"title": "Output Format",
"description": "The format of the output image.",
"default": "jpg",
"type": "string",
"enum": [
"png",
"jpg",
"webp"
]
},
"seed": {
"title": "Seed",
"description": "The random seed used for the generation process.",
"type": "integer"
},
"noise_scale": {
"title": "Noise Scale",
"description": "The noise scale to use for the generation process.",
"default": 0.1,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.001
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
SeedVR Upscale Seamless — upscales textures and tiles while preserving seamless tiling.
Pricing: $0.0025 $/output MP — 2x factor of a 1MP image ≈ 4 MP
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringtarget_resolutionstringupscale_modestringupscale_factornumberoutput_formatstringseedintegernoise_scalenumberenable_safety_checkerbooleanreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fseedvr%2Fupscale%2Fimage%2Fseamless",
"title": "SeedVR Upscale Seamless generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/seedvr/upscale/image/seamless.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/seedvr/upscale/image/seamless",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"target_resolution": {
"title": "Target Resolution",
"description": "The target resolution to upscale to when `upscale_mode` is `target`.",
"default": "1080p",
"type": "string",
"enum": [
"720p",
"1080p",
"1440p",
"2160p"
]
},
"upscale_mode": {
"title": "Upscale Mode",
"description": "The mode to use for the upscale. If 'target', the upscale factor will be calculated based on the target resolution. If 'factor', the upscale factor wi",
"default": "factor",
"type": "string",
"enum": [
"target",
"factor"
]
},
"upscale_factor": {
"title": "Upscale Factor",
"description": "Upscaling factor to be used. Will multiply the dimensions with this factor when `upscale_mode` is `factor`.",
"default": 2,
"type": "number",
"minimum": 1,
"maximum": 10
},
"output_format": {
"title": "Output Format",
"description": "The format of the output image.",
"default": "png",
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
]
},
"seed": {
"title": "Seed",
"description": "The random seed used for the generation process.",
"type": "integer"
},
"noise_scale": {
"title": "Noise Scale",
"description": "The noise scale to use for the generation process.",
"default": 0.1,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.001
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
Smart Resize — AI-aware aspect-ratio resizer that intelligently extends or crops images to new dimensions.
Pricing: $0.15 / image + $0.05 vision fee per request
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringseedintegersafety_tolerancenumbernum_images_per_sizenumberoutput_formatstringaspect_ratiostringresolutionstringreference_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fsmart-resize",
"title": "Smart Resize generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/smart-resize.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/smart-resize",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"seed": {
"title": "Seed",
"description": "Optional random seed forwarded to the inner nano-banana-pro /edit calls for reproducibility. The same seed is used for every target size when set.",
"type": "integer"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level applied to the inner nano-banana-pro /edit calls. Higher numbers loosen safety filtering.",
"default": "4",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"num_images_per_size": {
"title": "Num Images Per Size",
"description": "The number of nano-banana-pro variants to produce for each target size. The response images list will contain ``len(target_sizes) * num_images_per_siz",
"default": 1,
"type": "number",
"minimum": 1,
"maximum": 4
},
"output_format": {
"title": "Output Format",
"description": "The output image format.",
"default": "png",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"21:9"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}
WAN 2.7 Image — Alibaba image model with accurate text rendering, brand-color fidelity, and character-consistent multi-image generation plus multi-image editing. Optional reference-image editing with up to 4 references.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringenable_prompt_expansionbooleanseedintegeraspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=wan%2Fv2.7-image",
"title": "WAN 2.7 Image generation request",
"description": "Request body accepted by POST /api/v1/generate for wan/v2.7-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "wan/v2.7-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Content to avoid in the generated image. Max 500 characters.",
"default": "",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Enable LLM prompt optimization for better results.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility (0-2147483647).",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
WAN 2.7 Image Pro — premium Alibaba image model with accurate text rendering, brand-color fidelity, and character-consistent multi-image generation plus multi-image editing. Optional reference-image editing with up to 4 references.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringenable_prompt_expansionbooleanseedintegeraspect_ratiostringresolutionstringnum_imagesintegerreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=wan%2Fv2.7-image%2Fpro",
"title": "WAN 2.7 Image Pro generation request",
"description": "Request body accepted by POST /api/v1/generate for wan/v2.7-image/pro.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "wan/v2.7-image/pro",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Content to avoid in the generated image. Max 500 characters.",
"default": "",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Enable LLM prompt optimization for better results.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility (0-2147483647).",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048",
"4096"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 4
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Z-Image Turbo — fast, low-cost image model on Alibaba DashScope, tuned for photorealistic portraits.
Pricing: $0.005 / image (cross-confirmed vs SiliconFlow + WaveSpeed resale; resolution-independent)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenable_prompt_expansionbooleanseedintegeraspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=z-image%2Fturbo%2Fdashscope",
"title": "Z-Image Turbo generation request",
"description": "Request body accepted by POST /api/v1/generate for z-image/turbo/dashscope.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "z-image/turbo/dashscope",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Enable LLM prompt optimization for better results.",
"default": false,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility (0-2147483647).",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
AI Avatar Multi generates a two-person conversation video from a portrait photo and audio files, with synchronized lip-sync for both speakers.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaccelerationstringseedintegernum_framesnumberuse_only_first_audiobooleansecond_audio_urlstringresolutionstringimage_urlstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fai-avatar%2Fmulti",
"title": "AI Avatar Multi (Audio) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ai-avatar/multi.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ai-avatar/multi",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use for generation.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular",
"high"
]
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. If None, a random seed is chosen.",
"default": 81,
"type": "integer",
"minimum": 0,
"maximum": 4294967295
},
"num_frames": {
"title": "Num Frames",
"description": "Number of frames to generate (41–241). Frames above 81 are billed at 1.25×.",
"default": 181,
"type": "number",
"minimum": 41,
"maximum": 241,
"multipleOf": 1
},
"use_only_first_audio": {
"title": "Use Only First Audio",
"description": "Whether to use only the first audio file.",
"default": false,
"type": "boolean"
},
"second_audio_url": {
"title": "Person 2 Audio URL",
"description": "Hosted URL of the second speaker's audio file. Leave blank for single-speaker mode.",
"type": "string"
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p"
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"image_url",
"audio_url"
],
"additionalProperties": false
}
AI Avatar Multi Text generates a two-person talking video from a portrait photo and typed dialogue — each speaker gets a separate voice.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaccelerationstringvoice2stringsecond_text_inputstringseedintegervoice1stringnum_framesnumberfirst_text_inputstringresolutionstringimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fai-avatar%2Fmulti-text",
"title": "AI Avatar Multi (Text) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ai-avatar/multi-text.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ai-avatar/multi-text",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use for generation.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular",
"high"
]
},
"voice2": {
"title": "Voice2",
"description": "The second person's voice to use for speech generation",
"default": "Roger",
"type": "string",
"enum": [
"Aria",
"Roger",
"Sarah",
"Laura",
"Charlie",
"George",
"Callum",
"River",
"Liam",
"Charlotte",
"Alice",
"Matilda",
"Will",
"Jessica",
"Eric",
"Chris",
"Brian",
"Daniel",
"Lily",
"Bill"
]
},
"second_text_input": {
"title": "Second Text Input",
"description": "The text input to guide video generation.",
"type": "string"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. If None, a random seed is chosen.",
"default": 81,
"type": "integer",
"minimum": 0,
"maximum": 4294967295
},
"voice1": {
"title": "Voice1",
"description": "The first person's voice to use for speech generation",
"default": "Sarah",
"type": "string",
"enum": [
"Aria",
"Roger",
"Sarah",
"Laura",
"Charlie",
"George",
"Callum",
"River",
"Liam",
"Charlotte",
"Alice",
"Matilda",
"Will",
"Jessica",
"Eric",
"Chris",
"Brian",
"Daniel",
"Lily",
"Bill"
]
},
"num_frames": {
"title": "Num Frames",
"description": "Number of frames to generate (41–241). Frames above 81 are billed at 1.25×.",
"default": 191,
"type": "number",
"minimum": 41,
"maximum": 241,
"multipleOf": 1
},
"first_text_input": {
"title": "First Text Input",
"description": "The text input to guide video generation.",
"type": "string"
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p"
]
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"second_text_input",
"first_text_input",
"image_url"
],
"additionalProperties": false
}
AI Avatar generates a talking video from a portrait photo and typed text — pick a voice and the model handles TTS, lip sync, and natural expressions.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaccelerationstringseedintegertext_inputstringvoicestringnum_framesnumberresolutionstringimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fai-avatar%2Fsingle-text",
"title": "AI Avatar Text (MultiTalk) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ai-avatar/single-text.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ai-avatar/single-text",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use for generation.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular",
"high"
]
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. If None, a random seed is chosen.",
"default": 42,
"type": "integer",
"minimum": 0,
"maximum": 4294967295
},
"text_input": {
"title": "Text Input",
"description": "The text input to guide video generation.",
"type": "string"
},
"voice": {
"title": "Voice",
"description": "The voice to use for speech generation",
"type": "string",
"enum": [
"Aria",
"Roger",
"Sarah",
"Laura",
"Charlie",
"George",
"Callum",
"River",
"Liam",
"Charlotte",
"Alice",
"Matilda",
"Will",
"Jessica",
"Eric",
"Chris",
"Brian",
"Daniel",
"Lily",
"Bill"
]
},
"num_frames": {
"title": "Num Frames",
"description": "Number of frames to generate (41-721, ~16fps). Frames above 81 are billed at 1.25×.",
"default": 145,
"type": "number",
"minimum": 41,
"maximum": 721,
"multipleOf": 1
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p"
]
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"text_input",
"voice",
"image_url"
],
"additionalProperties": false
}
Creatify Aurora animates a portrait image to a speech or music audio file with studio-quality lip sync, producing character-consistent talking video.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringguidance_scalenumberaudio_guidance_scalenumberresolutionstringimage_urlstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fcreatify%2Faurora",
"title": "Aurora generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/creatify/aurora.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/creatify/aurora",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance scale to be used for text prompt adherence.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 5,
"multipleOf": 0.1
},
"audio_guidance_scale": {
"title": "Audio Guidance Scale",
"description": "Guidance scale to be used for audio adherence.",
"default": 2,
"type": "number",
"minimum": 0,
"maximum": 5,
"multipleOf": 0.1
},
"resolution": {
"type": "string",
"enum": [
"720p",
"480p"
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"image_url",
"audio_url"
],
"additionalProperties": false
}
Auto Subtitle burns styled captions directly into a video with karaoke-style highlighting, customizable fonts, colors, and animation.
Pricing: $0.03/min of input video.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringpositionstringfont_namestringbackground_colorstringbackground_opacitynumberfont_colorstringlanguagestringy_offsetnumberstroke_colorstringwords_per_subtitlenumberenable_animationbooleanstroke_widthnumberfont_weightstringfont_sizenumberhighlight_colorstringvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fworkflow-utilities%2Fauto-subtitle",
"title": "Auto Subtitle generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/workflow-utilities/auto-subtitle.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/workflow-utilities/auto-subtitle",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"position": {
"title": "Position",
"description": "Vertical position of subtitles",
"default": "bottom",
"type": "string",
"enum": [
"top",
"center",
"bottom"
]
},
"font_name": {
"title": "Font Name",
"description": "Any Google Font name from fonts.google.com (e.g., 'Montserrat', 'Poppins', 'BBH Sans Hegarty')",
"default": "Montserrat",
"type": "string"
},
"background_color": {
"title": "Background Color",
"description": "Background color behind text ('none' or 'transparent' for no background)",
"default": "none",
"type": "string",
"enum": [
"black",
"white",
"red",
"green",
"blue",
"yellow",
"orange",
"purple",
"pink",
"brown",
"gray",
"cyan",
"magenta",
"none",
"transparent"
]
},
"background_opacity": {
"title": "Background Opacity",
"description": "Background opacity (0.0 = fully transparent, 1.0 = fully opaque)",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 1
},
"font_color": {
"title": "Font Color",
"description": "Subtitle text color for non-active words",
"default": "white",
"type": "string",
"enum": [
"white",
"black",
"red",
"green",
"blue",
"yellow",
"orange",
"purple",
"pink",
"brown",
"gray",
"cyan",
"magenta"
]
},
"language": {
"title": "Language",
"description": "Language code for transcription (e.g., 'en', 'es', 'fr', 'de', 'it', 'pt', 'nl', 'ja', 'zh', 'ko') or 3-letter ISO code (e.g., 'eng', 'spa', 'fra')",
"default": "en",
"type": "string"
},
"y_offset": {
"title": "Y Offset",
"description": "Vertical offset in pixels (positive = move down, negative = move up)",
"default": 75,
"type": "number",
"minimum": -200,
"maximum": 200,
"multipleOf": 1
},
"stroke_color": {
"title": "Stroke Color",
"description": "Text stroke/outline color",
"default": "black",
"type": "string",
"enum": [
"black",
"white",
"red",
"green",
"blue",
"yellow",
"orange",
"purple",
"pink",
"brown",
"gray",
"cyan",
"magenta"
]
},
"words_per_subtitle": {
"title": "Words Per Subtitle",
"description": "Maximum number of words per subtitle segment. Use 1 for single-word display, 2-3 for short phrases, or 8-12 for full sentences.",
"default": 3,
"type": "number",
"minimum": 1,
"maximum": 12,
"multipleOf": 1
},
"enable_animation": {
"title": "Enable Animation",
"description": "Enable animation effects for subtitles (bounce style entrance)",
"default": true,
"type": "boolean"
},
"stroke_width": {
"title": "Stroke Width",
"description": "Text stroke/outline width in pixels (0 for no stroke)",
"default": 3,
"type": "number",
"minimum": 0,
"maximum": 10,
"multipleOf": 1
},
"font_weight": {
"title": "Font Weight",
"description": "Font weight (TikTok style typically uses bold or black)",
"default": "bold",
"type": "string",
"enum": [
"normal",
"bold",
"black"
]
},
"font_size": {
"title": "Font Size",
"description": "Font size for subtitles (TikTok style uses larger text)",
"default": 100,
"type": "number",
"minimum": 20,
"maximum": 150,
"multipleOf": 1
},
"highlight_color": {
"title": "Highlight Color",
"description": "Color for the currently speaking word (karaoke-style highlight)",
"default": "purple",
"type": "string",
"enum": [
"white",
"black",
"red",
"green",
"blue",
"yellow",
"orange",
"purple",
"pink",
"brown",
"gray",
"cyan",
"magenta"
]
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"video_url"
],
"additionalProperties": false
}
Bernini-R text-to-video — ByteDance's unified video model with latent semantic planning for coherent, high-quality clips.
Pricing: $0.08/s at 848px (×0.5 at ≤576px, ×2 at 1280px); length = frames ÷ FPS (default 81/16 ≈ 5s)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringnum_inference_stepsnumbermax_image_sizenumbernum_framesnumberframes_per_secondnumberaccelerationstringenable_prompt_expansionbooleanseedintegeraspect_ratiostring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fbernini-r%2Ftext-to-video",
"title": "Bernini-R (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/bernini-r/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/bernini-r/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Leave blank to keep the model's tuned Wan2.2 default negative prompt.",
"default": "",
"type": "string"
},
"num_inference_steps": {
"title": "Steps",
"description": "Number of denoising steps.",
"default": 30,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"max_image_size": {
"title": "Output Size (long edge)",
"description": "Long-edge size in pixels — sets output size for generation and caps source/reference media for edits. Billing scales with this tier.",
"default": "848",
"type": "number",
"enum": [
576,
848,
1280
]
},
"num_frames": {
"title": "Num Frames",
"description": "Number of frames (snapped internally to 4k+1). Output length = frames ÷ FPS.",
"default": 81,
"type": "number",
"minimum": 5,
"maximum": 121,
"multipleOf": 1
},
"frames_per_second": {
"title": "FPS",
"description": "Output frames per second.",
"default": 16,
"type": "number",
"minimum": 4,
"maximum": 30,
"multipleOf": 1
},
"acceleration": {
"title": "Acceleration",
"description": "'regular' enables MagCache step-skipping for faster generation at a small quality cost.",
"default": "none",
"type": "string",
"enum": [
"none",
"regular"
]
},
"enable_prompt_expansion": {
"title": "Prompt Expansion",
"description": "Rewrite the prompt with an LLM before generation. The model is tuned on enhanced prompts.",
"default": false,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Seed for reproducibility. Random when omitted.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Bernini-R video editing — change objects, weather, background, or camera angle with a natural-language instruction while keeping the rest of the scene intact.
Pricing: $0.08/s at 848px (×0.5 at ≤576px, ×2 at 1280px); output length = frames ÷ FPS
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringnum_inference_stepsnumbermax_image_sizenumbernum_framesnumberframes_per_secondnumberaccelerationstringenable_prompt_expansionbooleanseedintegervideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fbernini-r%2Fedit-video",
"title": "Bernini-R Edit Video generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/bernini-r/edit-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/bernini-r/edit-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Leave blank to keep the model's tuned Wan2.2 default negative prompt.",
"default": "",
"type": "string"
},
"num_inference_steps": {
"title": "Steps",
"description": "Number of denoising steps.",
"default": 30,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"max_image_size": {
"title": "Output Size (long edge)",
"description": "Long-edge size in pixels — sets output size for generation and caps source/reference media for edits. Billing scales with this tier.",
"default": "848",
"type": "number",
"enum": [
576,
848,
1280
]
},
"num_frames": {
"title": "Num Frames",
"description": "Number of frames (snapped internally to 4k+1). Output length = frames ÷ FPS.",
"default": 81,
"type": "number",
"minimum": 5,
"maximum": 121,
"multipleOf": 1
},
"frames_per_second": {
"title": "FPS",
"description": "Output frames per second.",
"default": 16,
"type": "number",
"minimum": 4,
"maximum": 30,
"multipleOf": 1
},
"acceleration": {
"title": "Acceleration",
"description": "'regular' enables MagCache step-skipping for faster generation at a small quality cost.",
"default": "none",
"type": "string",
"enum": [
"none",
"regular"
]
},
"enable_prompt_expansion": {
"title": "Prompt Expansion",
"description": "Rewrite the prompt with an LLM before generation. The model is tuned on enhanced prompts.",
"default": false,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Seed for reproducibility. Random when omitted.",
"type": "integer"
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"video_url"
],
"additionalProperties": false
}
Bernini-R reference-guided video editing — garment swaps, subject insertion, and other edits guided by up to five reference images while preserving the source video.
Pricing: $0.08/s at 848px (×0.5 at ≤576px, ×2 at 1280px); output length = frames ÷ FPS
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringnum_inference_stepsnumbermax_image_sizenumbernum_framesnumberframes_per_secondnumberaccelerationstringenable_prompt_expansionbooleanseedintegerreference_image_urlsarrayvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fbernini-r%2Freference-edit-video",
"title": "Bernini-R Reference Edit generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/bernini-r/reference-edit-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/bernini-r/reference-edit-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Leave blank to keep the model's tuned Wan2.2 default negative prompt.",
"default": "",
"type": "string"
},
"num_inference_steps": {
"title": "Steps",
"description": "Number of denoising steps.",
"default": 30,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"max_image_size": {
"title": "Output Size (long edge)",
"description": "Long-edge size in pixels — sets output size for generation and caps source/reference media for edits. Billing scales with this tier.",
"default": "848",
"type": "number",
"enum": [
576,
848,
1280
]
},
"num_frames": {
"title": "Num Frames",
"description": "Number of frames (snapped internally to 4k+1). Output length = frames ÷ FPS.",
"default": 81,
"type": "number",
"minimum": 5,
"maximum": 121,
"multipleOf": 1
},
"frames_per_second": {
"title": "FPS",
"description": "Output frames per second.",
"default": 16,
"type": "number",
"minimum": 4,
"maximum": 30,
"multipleOf": 1
},
"acceleration": {
"title": "Acceleration",
"description": "'regular' enables MagCache step-skipping for faster generation at a small quality cost.",
"default": "none",
"type": "string",
"enum": [
"none",
"regular"
]
},
"enable_prompt_expansion": {
"title": "Prompt Expansion",
"description": "Rewrite the prompt with an LLM before generation. The model is tuned on enhanced prompts.",
"default": false,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Seed for reproducibility. Random when omitted.",
"type": "integer"
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 5
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls",
"video_url"
],
"additionalProperties": false
}
Bernini-R reference-to-video — turn up to five reference images into one continuous, consistent video with smooth stable camera motion and no scene cuts.
Pricing: $0.08/s at 848px (×0.5 at ≤576px, ×2 at 1280px); length = frames ÷ FPS
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringnum_inference_stepsnumbermax_image_sizenumbernum_framesnumberframes_per_secondnumberaccelerationstringenable_prompt_expansionbooleanseedintegeraspect_ratiostringreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fbernini-r%2Freference-to-video",
"title": "Bernini-R Reference Video generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/bernini-r/reference-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/bernini-r/reference-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Leave blank to keep the model's tuned Wan2.2 default negative prompt.",
"default": "",
"type": "string"
},
"num_inference_steps": {
"title": "Steps",
"description": "Number of denoising steps.",
"default": 30,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"max_image_size": {
"title": "Output Size (long edge)",
"description": "Long-edge size in pixels — sets output size for generation and caps source/reference media for edits. Billing scales with this tier.",
"default": "848",
"type": "number",
"enum": [
576,
848,
1280
]
},
"num_frames": {
"title": "Num Frames",
"description": "Number of frames (snapped internally to 4k+1). Output length = frames ÷ FPS.",
"default": 81,
"type": "number",
"minimum": 5,
"maximum": 121,
"multipleOf": 1
},
"frames_per_second": {
"title": "FPS",
"description": "Output frames per second.",
"default": 16,
"type": "number",
"minimum": 4,
"maximum": 30,
"multipleOf": 1
},
"acceleration": {
"title": "Acceleration",
"description": "'regular' enables MagCache step-skipping for faster generation at a small quality cost.",
"default": "none",
"type": "string",
"enum": [
"none",
"regular"
]
},
"enable_prompt_expansion": {
"title": "Prompt Expansion",
"description": "Rewrite the prompt with an LLM before generation. The model is tuned on enhanced prompts.",
"default": false,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Seed for reproducibility. Random when omitted.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 5
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Remove green-screen color spill from a keyed video while preserving edges and the original audio track.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringvideo_urlstringspill_suppressionnumberpreserve_audiobooleanoutput_container_and_codecstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fvideo%2Fbackground-removal%2Fgreen-screen-despill",
"title": "Bria Green Screen Despill generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/video/background-removal/green-screen-despill.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/video/background-removal/green-screen-despill",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"video_url": {
"type": "string",
"format": "uri"
},
"spill_suppression": {
"title": "Spill Suppression",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"preserve_audio": {
"title": "Preserve Audio",
"default": true,
"type": "boolean"
},
"output_container_and_codec": {
"title": "Container & Codec",
"default": "webm_vp9",
"type": "string",
"enum": [
"mp4_h265",
"mp4_h264",
"webm_vp9",
"mov_h265",
"mov_proresks",
"mkv_h265",
"mkv_h264",
"mkv_vp9",
"gif"
]
}
},
"required": [
"model_id",
"video_url"
],
"additionalProperties": false
}
Bria VRMBG 3.0 removes the background frame-perfectly from any video. Choose a replacement color or keep it transparent, preserve the original audio, and pick your output codec.
Pricing: $0.0042/s of input video.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringpreserve_audiobooleanbackground_colorstringoutput_container_and_codecstringvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fvideo%2Fbackground-removal%2Fv3",
"title": "Bria VRMBG 3.0 generation request",
"description": "Request body accepted by POST /api/v1/generate for bria/video/background-removal/v3.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bria/video/background-removal/v3",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"preserve_audio": {
"title": "Preserve Audio",
"description": "Keep the original audio track in the output video.",
"default": true,
"type": "boolean"
},
"background_color": {
"title": "Background Color",
"description": "Replacement background color behind the subject.",
"default": "Black",
"type": "string",
"enum": [
"Transparent",
"Black",
"White",
"Gray",
"Red",
"Green",
"Blue",
"Yellow",
"Cyan",
"Magenta",
"Orange"
]
},
"output_container_and_codec": {
"title": "Output Codec",
"description": "Output container and codec.",
"default": "webm_vp9",
"type": "string",
"enum": [
"mp4_h265",
"mp4_h264",
"webm_vp9",
"mov_h265",
"mov_proresks",
"mkv_h265",
"mkv_h264",
"mkv_vp9",
"gif"
]
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"video_url"
],
"additionalProperties": false
}
CassetteAI Sound Effects — automatically analyses a scene and generates contextually appropriate sound effects without needing a text prompt.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=cassetteai%2Fvideo-sound-effects-generator",
"title": "CassetteAI Sound Effects generation request",
"description": "Request body accepted by POST /api/v1/generate for cassetteai/video-sound-effects-generator.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "cassetteai/video-sound-effects-generator",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"video_url"
],
"additionalProperties": false
}
CogVideoX 5B image-to-video — animates a start image into a 720p video clip with CogVideoX's diffusion backbone.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringguidance_scalenumbernegative_promptstringseedintegeruse_rifebooleanexport_fpsnumbernum_inference_stepsnumberlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberaspect_ratiostringimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fcogvideox-5b%2Fimage-to-video",
"title": "CogVideoX 5B (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/cogvideox-5b/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/cogvideox-5b/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related video to show",
"default": 7,
"type": "number",
"minimum": 0,
"maximum": 20,
"multipleOf": 0.1
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to generate video from",
"default": "",
"type": "string"
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same video every time.",
"type": "integer"
},
"use_rife": {
"title": "Use Rife",
"description": "Use RIFE for video interpolation",
"default": true,
"type": "boolean"
},
"export_fps": {
"title": "Export Fps",
"description": "The target FPS of the video",
"default": 16,
"type": "number",
"minimum": 4,
"maximum": 32,
"multipleOf": 1
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 50,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"lora_path": {
"title": "LoRA Path",
"description": "URL or Hugging Face path to LoRA weights.",
"type": "string"
},
"lora_scale": {
"title": "LoRA Scale",
"description": "Strength of the LoRA effect.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_2": {
"title": "LoRA Path 2",
"description": "URL or Hugging Face path to a second LoRA.",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA Scale 2",
"description": "Strength of the second LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_3": {
"title": "LoRA Path 3",
"description": "URL or Hugging Face path to a third LoRA.",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA Scale 3",
"description": "Strength of the third LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
]
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
CogVideoX 5B video-to-video — transforms existing footage into a new visual style while preserving motion and structure.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringguidance_scalenumbernegative_promptstringstrengthnumberseedintegeruse_rifebooleanexport_fpsnumbernum_inference_stepsnumberlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberaspect_ratiostringvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fcogvideox-5b%2Fvideo-to-video",
"title": "CogVideoX 5B (V2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/cogvideox-5b/video-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/cogvideox-5b/video-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related video to show",
"default": 7,
"type": "number",
"minimum": 0,
"maximum": 20,
"multipleOf": 0.1
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to generate video from",
"default": "",
"type": "string"
},
"strength": {
"title": "Strength",
"description": "The strength to use for Video to Video. 1.0 completely remakes the video while 0.0 preserves the original.",
"default": 0.8,
"type": "number",
"minimum": 0.05,
"maximum": 1,
"multipleOf": 0.01
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same video every time.",
"type": "integer"
},
"use_rife": {
"title": "Use Rife",
"description": "Use RIFE for video interpolation",
"default": true,
"type": "boolean"
},
"export_fps": {
"title": "Export Fps",
"description": "The target FPS of the video",
"default": 16,
"type": "number",
"minimum": 4,
"maximum": 32,
"multipleOf": 1
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 50,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"lora_path": {
"title": "LoRA Path",
"description": "URL or Hugging Face path to LoRA weights.",
"type": "string"
},
"lora_scale": {
"title": "LoRA Scale",
"description": "Strength of the LoRA effect.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_2": {
"title": "LoRA Path 2",
"description": "URL or Hugging Face path to a second LoRA.",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA Scale 2",
"description": "Strength of the second LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_3": {
"title": "LoRA Path 3",
"description": "URL or Hugging Face path to a third LoRA.",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA Scale 3",
"description": "Strength of the third LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
]
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"video_url"
],
"additionalProperties": false
}
ByteDance's public multimodal video model for text-to-video, first/last-frame animation, multi-asset reference generation, video editing, extension, and native audio. It creates coherent clips up to 30 seconds at a fixed 24fps.
Pricing: $10.70/M tokens without video input or $6.40/M with video input at 480p/720p; 1080p uses $11.70/M or $7.00/M. Video input is billed for its measured duration, with a four-second minimum.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringseedance_task_typestringseedance_image_rolestringgenerate_audiobooleanoutput_formatstringvideo_urlsarrayaudio_urlsarrayaspect_ratiostringresolutionstringdurationnumberimage_urlstringend_image_urlstringreference_image_urlsarrayreference_video_urlsarrayreference_audio_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bytedance%2Fseedance-2.5%2Fmultimodal-to-video",
"title": "Dreamina Seedance 2.5 (Multimodal) generation request",
"description": "Request body accepted by POST /api/v1/generate for bytedance/seedance-2.5/multimodal-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bytedance/seedance-2.5/multimodal-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"seedance_task_type": {
"title": "Task Type",
"description": "Choose Edit or Extend when the prompt modifies or continues an attached source video. Put the primary source video first.",
"default": "generate",
"type": "string",
"enum": [
"generate",
"edit",
"extend"
]
},
"seedance_image_role": {
"title": "Image Role",
"description": "Auto treats one image as a first frame and multiple images, or images combined with video/audio, as multimodal references.",
"default": "auto",
"type": "string",
"enum": [
"auto",
"reference",
"first_frame"
]
},
"generate_audio": {
"title": "Generate Audio",
"description": "Generate synchronized audio with the video. Audio-only reference input is supported.",
"default": true,
"type": "boolean"
},
"output_format": {
"title": "Output Format",
"description": "Container format returned by BytePlus.",
"default": "mp4",
"type": "string",
"enum": [
"mp4",
"mov"
]
},
"video_urls": {
"title": "Reference Videos",
"description": "Up to 10 clips, 2–30 seconds each and 30 seconds total. Refer to them as @Video1, @Video2, and so on.",
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10
},
"audio_urls": {
"title": "Reference Audio",
"description": "Up to 10 clips, 2–30 seconds each and 30 seconds total. Refer to them as @Audio1, @Audio2, and so on.",
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26,
27,
28,
29,
30
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 30
},
"reference_video_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 10
},
"reference_audio_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 10
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
FlashHead creates a talking portrait from one image and typed text, with built-in ElevenLabs speech and synchronized facial animation.
Pricing: $0.005 per second of generated video. Speech is generated from the typed text.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringtextstringvoicestringstabilitynumberseedintegerimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflashhead",
"title": "FlashHead generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/flashhead.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/flashhead",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"text": {
"title": "Script",
"description": "The words the avatar will speak. Speech and lip sync are generated automatically.",
"type": "string"
},
"voice": {
"title": "Voice",
"description": "Built-in ElevenLabs voice used to generate the speech.",
"default": "Aria",
"type": "string",
"enum": [
"Aria",
"Roger",
"Sarah",
"Laura",
"Charlie",
"George",
"Callum",
"River",
"Liam",
"Charlotte",
"Alice",
"Matilda",
"Will",
"Jessica",
"Eric",
"Chris",
"Brian",
"Daniel",
"Lily",
"Bill"
]
},
"stability": {
"title": "Voice Stability",
"description": "Lower values sound more expressive; higher values are steadier.",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"seed": {
"title": "Seed",
"description": "Optional seed for reproducible results.",
"type": "integer",
"minimum": 0,
"maximum": 4294967295
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"text",
"voice",
"image_url"
],
"additionalProperties": false
}
Black Forest Labs FLUX Video Upscale increases source-video resolution while preserving motion and optionally reconstructing detail from a prompt.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvideo_urlstringupscale_factornumbercreativityintegersafety_toleranceinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=blackforestlabs%2Fflux-video-upscale",
"title": "FLUX Video Upscale generation request",
"description": "Request body accepted by POST /api/v1/generate for blackforestlabs/flux-video-upscale.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "blackforestlabs/flux-video-upscale",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"video_url": {
"type": "string",
"format": "uri"
},
"upscale_factor": {
"title": "Upscale Factor",
"default": 2,
"type": "number",
"minimum": 1.5,
"maximum": 3,
"multipleOf": 0.1
},
"creativity": {
"title": "Creativity",
"default": 1,
"type": "integer",
"enum": [
0,
1
]
},
"safety_tolerance": {
"title": "Safety Tolerance",
"default": 2,
"type": "integer",
"minimum": 0,
"maximum": 4,
"multipleOf": 1
}
},
"required": [
"model_id",
"video_url"
],
"additionalProperties": false
}
Animate an opening image as a fast FLUX.3 draft and retain the cache for a matching full-quality render.
Pricing: $0.03 per generated draft second; includes a reusable encrypted Draft Enhance cache.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringimage_urlstringgenerate_audiobooleanaspect_ratiostringsafety_tolerancenumberdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=blackforestlabs%2Fflux-3%2Fimage-to-video%2Fdraft",
"title": "FLUX.3 Draft (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for blackforestlabs/flux-3/image-to-video/draft.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "blackforestlabs/flux-3/image-to-video/draft",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"image_url": {
"type": "string",
"format": "uri"
},
"generate_audio": {
"title": "Generate audio",
"description": "Generate synchronized dialogue, ambience, and sound effects with the video.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"2:1",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"safety_tolerance": {
"title": "Safety tolerance",
"description": "Provider safety level. 0 is strictest; ArtEmotion keeps the provider default of 2.",
"default": 2,
"type": "number",
"enum": [
0,
1,
2,
3,
4
]
},
"duration": {
"type": "number",
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20
]
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
Generate a fast, low-cost FLUX.3 text-to-video preview and retain its encrypted cache for a matching full-quality render.
Pricing: $0.03 per generated draft second; includes a reusable encrypted Draft Enhance cache.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanaspect_ratiostringsafety_tolerancenumberdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=blackforestlabs%2Fflux-3%2Ftext-to-video%2Fdraft",
"title": "FLUX.3 Draft (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for blackforestlabs/flux-3/text-to-video/draft.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "blackforestlabs/flux-3/text-to-video/draft",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate audio",
"description": "Generate synchronized dialogue, ambience, and sound effects with the video.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"2:1",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"safety_tolerance": {
"title": "Safety tolerance",
"description": "Provider safety level. 0 is strictest; ArtEmotion keeps the provider default of 2.",
"default": 2,
"type": "number",
"enum": [
0,
1,
2,
3,
4
]
},
"duration": {
"type": "number",
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Render an approved FLUX.3 encrypted draft cache at full quality while preserving the draft's subjects, composition, and motion. ArtEmotion derives billing from owned drafts; external caches are billed at the 20-second maximum.
Pricing: $0.085 per source-draft second. Owned ArtEmotion drafts use verified duration metadata; external caches are billed at the 20-second maximum.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringdraft_cache_urlstringsafety_tolerancenumberaspect_ratiostringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=blackforestlabs%2Fflux-3%2Fdraft-enhance",
"title": "FLUX.3 Draft Enhance generation request",
"description": "Request body accepted by POST /api/v1/generate for blackforestlabs/flux-3/draft-enhance.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "blackforestlabs/flux-3/draft-enhance",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"draft_cache_url": {
"title": "Draft cache",
"description": "Encrypted cache bundle returned by any FLUX.3 Draft endpoint. It is stored separately from the preview video.",
"type": "string"
},
"safety_tolerance": {
"title": "Safety tolerance",
"description": "Provider safety level. 0 is strictest; ArtEmotion keeps the provider default of 2.",
"default": 2,
"type": "number",
"enum": [
0,
1,
2,
3,
4
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"2:1",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"duration": {
"type": "number",
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20
]
}
},
"required": [
"model_id",
"draft_cache_url"
],
"additionalProperties": false
}
Quickly preview a continuation of a source MP4 and retain its cache for a matching full-quality enhancement.
Pricing: $0.06 per generated draft continuation second; includes a reusable encrypted Draft Enhance cache.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvideo_urlstringgenerate_audiobooleanaspect_ratiostringsafety_tolerancenumberdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=blackforestlabs%2Fflux-3%2Fextend-video%2Fdraft",
"title": "FLUX.3 Draft Extend generation request",
"description": "Request body accepted by POST /api/v1/generate for blackforestlabs/flux-3/extend-video/draft.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "blackforestlabs/flux-3/extend-video/draft",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"video_url": {
"type": "string",
"format": "uri"
},
"generate_audio": {
"title": "Generate audio",
"description": "Generate synchronized dialogue, ambience, and sound effects with the video.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"2:1",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"safety_tolerance": {
"title": "Safety tolerance",
"description": "Provider safety level. 0 is strictest; ArtEmotion keeps the provider default of 2.",
"default": 2,
"type": "number",
"enum": [
0,
1,
2,
3,
4
]
},
"duration": {
"type": "number",
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20
]
}
},
"required": [
"model_id",
"prompt",
"video_url"
],
"additionalProperties": false
}
Preview the exact motion between required opening and closing images, then enhance the approved draft without changing its composition.
Pricing: $0.03 per generated draft second; includes a reusable encrypted Draft Enhance cache.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstart_image_urlstringend_image_urlstringgenerate_audiobooleanaspect_ratiostringsafety_tolerancenumberdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=blackforestlabs%2Fflux-3%2Ffirst-last-frame-to-video%2Fdraft",
"title": "FLUX.3 Draft First + Last generation request",
"description": "Request body accepted by POST /api/v1/generate for blackforestlabs/flux-3/first-last-frame-to-video/draft.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "blackforestlabs/flux-3/first-last-frame-to-video/draft",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"start_image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
},
"generate_audio": {
"title": "Generate audio",
"description": "Generate synchronized dialogue, ambience, and sound effects with the video.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"2:1",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"safety_tolerance": {
"title": "Safety tolerance",
"description": "Provider safety level. 0 is strictest; ArtEmotion keeps the provider default of 2.",
"default": 2,
"type": "number",
"enum": [
0,
1,
2,
3,
4
]
},
"duration": {
"type": "number",
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20
]
}
},
"required": [
"model_id",
"prompt",
"start_image_url",
"end_image_url"
],
"additionalProperties": false
}
Preview a controlled FLUX.3 shot from up to ten ordered keyframes, with optional exact positions at 24 fps.
Pricing: $0.03 per generated draft second; includes a reusable encrypted Draft Enhance cache.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringkeyframesarraygenerate_audiobooleanaspect_ratiostringsafety_tolerancenumberdurationnumberkeyframe_indicesstringreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=blackforestlabs%2Fflux-3%2Fkeyframes-to-video%2Fdraft",
"title": "FLUX.3 Draft Keyframes generation request",
"description": "Request body accepted by POST /api/v1/generate for blackforestlabs/flux-3/keyframes-to-video/draft.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "blackforestlabs/flux-3/keyframes-to-video/draft",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"keyframes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"image_url": {
"type": "string",
"format": "uri"
},
"timestamp": {
"type": "number",
"minimum": 0
}
},
"required": [
"image_url"
],
"additionalProperties": false
}
},
"generate_audio": {
"title": "Generate audio",
"description": "Generate synchronized dialogue, ambience, and sound effects with the video.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"2:1",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"safety_tolerance": {
"title": "Safety tolerance",
"description": "Provider safety level. 0 is strictest; ArtEmotion keeps the provider default of 2.",
"default": 2,
"type": "number",
"enum": [
0,
1,
2,
3,
4
]
},
"duration": {
"type": "number",
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20
]
},
"keyframe_indices": {
"title": "Keyframe positions",
"description": "Optional comma-separated frame positions at 24 fps, one per uploaded keyframe. Blank positions are spaced automatically.",
"type": "string"
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 1,
"maxItems": 10
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Edit a source video with natural-language instructions while preserving its motion, timing, and framing. MP4 input under 15 seconds and 50 MB; billed by the source clip's measured duration.
Pricing: $0.03 per edited second at 720p. Billing uses verified source duration; without a clip, the estimate reserves the 15-second upper bound. Duration and framing follow the source.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvideo_urlstringsafety_toleranceinteger
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=blackforestlabs%2Fflux-3%2Fedit-video",
"title": "FLUX.3 Edit Video generation request",
"description": "Request body accepted by POST /api/v1/generate for blackforestlabs/flux-3/edit-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "blackforestlabs/flux-3/edit-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"maxLength": 4096
},
"video_url": {
"type": "string",
"format": "uri"
},
"safety_tolerance": {
"title": "Safety tolerance",
"description": "Provider safety level. 0 is strictest; ArtEmotion keeps the provider default of 2.",
"default": 2,
"type": "integer",
"minimum": 0,
"maximum": 4,
"multipleOf": 1,
"enum": [
0,
1,
2,
3,
4
]
}
},
"required": [
"model_id",
"prompt",
"video_url"
],
"additionalProperties": false
}
Continue a source MP4 beyond its final frame while preserving motion, framing, dialogue, and audio continuity.
Pricing: $0.205 per generated continuation second at either 720p or 1080p.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvideo_urlstringgenerate_audiobooleanaspect_ratiostringresolutionstringsafety_tolerancenumberdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=blackforestlabs%2Fflux-3%2Fextend-video",
"title": "FLUX.3 Extend Video generation request",
"description": "Request body accepted by POST /api/v1/generate for blackforestlabs/flux-3/extend-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "blackforestlabs/flux-3/extend-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"video_url": {
"type": "string",
"format": "uri"
},
"generate_audio": {
"title": "Generate audio",
"description": "Generate synchronized dialogue, ambience, and sound effects with the video.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"2:1",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"safety_tolerance": {
"title": "Safety tolerance",
"description": "Provider safety level. 0 is strictest; ArtEmotion keeps the provider default of 2.",
"default": 2,
"type": "number",
"enum": [
0,
1,
2,
3,
4
]
},
"duration": {
"type": "number",
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20
]
}
},
"required": [
"model_id",
"prompt",
"video_url"
],
"additionalProperties": false
}
Create a FLUX.3 video that moves coherently between required opening and closing images, with exact duration control and native audio.
Pricing: $0.085 per generated second at either 720p or 1080p.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstart_image_urlstringend_image_urlstringgenerate_audiobooleanaspect_ratiostringresolutionstringsafety_tolerancenumberdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=blackforestlabs%2Fflux-3%2Ffirst-last-frame-to-video",
"title": "FLUX.3 First + Last Frame generation request",
"description": "Request body accepted by POST /api/v1/generate for blackforestlabs/flux-3/first-last-frame-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "blackforestlabs/flux-3/first-last-frame-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"start_image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
},
"generate_audio": {
"title": "Generate audio",
"description": "Generate synchronized dialogue, ambience, and sound effects with the video.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"2:1",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"safety_tolerance": {
"title": "Safety tolerance",
"description": "Provider safety level. 0 is strictest; ArtEmotion keeps the provider default of 2.",
"default": 2,
"type": "number",
"enum": [
0,
1,
2,
3,
4
]
},
"duration": {
"type": "number",
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20
]
}
},
"required": [
"model_id",
"prompt",
"start_image_url",
"end_image_url"
],
"additionalProperties": false
}
Control a FLUX.3 shot with up to ten ordered keyframe images and optional exact frame positions at 24 fps.
Pricing: $0.085 per generated second at either 720p or 1080p.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringkeyframesarraygenerate_audiobooleanaspect_ratiostringresolutionstringsafety_tolerancenumberdurationnumberkeyframe_indicesstringreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=blackforestlabs%2Fflux-3%2Fkeyframes-to-video",
"title": "FLUX.3 Keyframes generation request",
"description": "Request body accepted by POST /api/v1/generate for blackforestlabs/flux-3/keyframes-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "blackforestlabs/flux-3/keyframes-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"keyframes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"image_url": {
"type": "string",
"format": "uri"
},
"timestamp": {
"type": "number",
"minimum": 0
}
},
"required": [
"image_url"
],
"additionalProperties": false
}
},
"generate_audio": {
"title": "Generate audio",
"description": "Generate synchronized dialogue, ambience, and sound effects with the video.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"2:1",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"safety_tolerance": {
"title": "Safety tolerance",
"description": "Provider safety level. 0 is strictest; ArtEmotion keeps the provider default of 2.",
"default": 2,
"type": "number",
"enum": [
0,
1,
2,
3,
4
]
},
"duration": {
"type": "number",
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20
]
},
"keyframe_indices": {
"title": "Keyframe positions",
"description": "Optional comma-separated frame positions at 24 fps, one per uploaded keyframe. Blank positions are spaced automatically.",
"type": "string"
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 1,
"maxItems": 10
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Animate an opening image into a controlled FLUX.3 video with native synchronized audio and up to 20 seconds of motion.
Pricing: $0.085 per generated second at either 720p or 1080p.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringimage_urlstringgenerate_audiobooleanaspect_ratiostringresolutionstringsafety_tolerancenumberdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=blackforestlabs%2Fflux-3%2Fimage-to-video",
"title": "FLUX.3 Video (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for blackforestlabs/flux-3/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "blackforestlabs/flux-3/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"image_url": {
"type": "string",
"format": "uri"
},
"generate_audio": {
"title": "Generate audio",
"description": "Generate synchronized dialogue, ambience, and sound effects with the video.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"2:1",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"safety_tolerance": {
"title": "Safety tolerance",
"description": "Provider safety level. 0 is strictest; ArtEmotion keeps the provider default of 2.",
"default": 2,
"type": "number",
"enum": [
0,
1,
2,
3,
4
]
},
"duration": {
"type": "number",
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20
]
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
Black Forest Labs FLUX.3 text-to-video with native audio, multilingual dialogue, multi-shot prompting, and clips up to 20 seconds.
Pricing: $0.085 per generated second at either 720p or 1080p.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanaspect_ratiostringresolutionstringsafety_tolerancenumberdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=blackforestlabs%2Fflux-3%2Ftext-to-video",
"title": "FLUX.3 Video (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for blackforestlabs/flux-3/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "blackforestlabs/flux-3/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate audio",
"description": "Generate synchronized dialogue, ambience, and sound effects with the video.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"2:1",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"safety_tolerance": {
"title": "Safety tolerance",
"description": "Provider safety level. 0 is strictest; ArtEmotion keeps the provider default of 2.",
"default": 2,
"type": "number",
"enum": [
0,
1,
2,
3,
4
]
},
"duration": {
"type": "number",
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Google Gemini Omni Flash 1.1 — GA any-to-any video generation with native synchronized audio, cinematic control, and reference-image subject consistency in 3–10 second clips up to 4K.
Pricing: $0.03/s at 360p · $0.10/s at 720p · $0.15/s at 1080p · $0.30/s at 4K
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaspect_ratiostringresolutionstringdurationnumberreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=google%2Fgemini-omni-flash",
"title": "Gemini Omni Flash 1.1 generation request",
"description": "Request body accepted by POST /api/v1/generate for google/gemini-omni-flash.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "google/gemini-omni-flash",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"360p",
"720p",
"1080p",
"4k"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
9,
10
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 6
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Google Gemini Omni Flash 1.1 conversational video editing — change elements, lighting, background, style, motion, or timing while preserving everything else. Editing uploaded videos is unavailable in the EEA, Switzerland, and the UK; editing Omni-generated videos there is supported.
Pricing: $0.03/s at 360p · $0.10/s at 720p · $0.15/s at 1080p · $0.30/s at 4K
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringprevious_interaction_idstringresolutionstringvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=google%2Fgemini-omni-flash%2Fedit",
"title": "Gemini Omni Flash 1.1 (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for google/gemini-omni-flash/edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "google/gemini-omni-flash/edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"previous_interaction_id": {
"title": "Continue From Interaction ID",
"description": "Continue from a previous Gemini Omni generation without uploading the video again.",
"default": "",
"type": "string"
},
"resolution": {
"type": "string",
"enum": [
"360p",
"720p",
"1080p",
"4k"
]
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Extend the end of an uploaded or previously generated Gemini Omni video with a coherent 3–10 second continuation, preserving characters, motion, and audio across turns (up to 40 seconds total).
Pricing: $0.03/s at 360p · $0.10/s at 720p · $0.15/s at 1080p · $0.30/s at 4K
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringprevious_interaction_idstringresolutionstringdurationnumbervideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=google%2Fgemini-omni-flash%2Fextend",
"title": "Gemini Omni Flash 1.1 (Extend) generation request",
"description": "Request body accepted by POST /api/v1/generate for google/gemini-omni-flash/extend.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "google/gemini-omni-flash/extend",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"previous_interaction_id": {
"title": "Continue From Interaction ID",
"description": "Continue from a previous Gemini Omni generation without uploading the video again.",
"default": "",
"type": "string"
},
"resolution": {
"type": "string",
"enum": [
"360p",
"720p",
"1080p",
"4k"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
9,
10
]
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Google Gemini Omni Flash 1.1 image-to-video — animate a first frame or interpolate between first and last frames with synchronized audio, 3–10 second duration, and output up to 4K.
Pricing: $0.03/s at 360p · $0.10/s at 720p · $0.15/s at 1080p · $0.30/s at 4K
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaspect_ratiostringresolutionstringdurationnumberimage_urlstringend_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=google%2Fgemini-omni-flash%2Fimage-to-video",
"title": "Gemini Omni Flash 1.1 (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for google/gemini-omni-flash/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "google/gemini-omni-flash/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"360p",
"720p",
"1080p",
"4k"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
9,
10
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
Grok Edit Video — instruction-based video editing that replaces or transforms elements while keeping all subjects and motion intact.
Pricing: $0.06/s (480p) · $0.08/s (720p), output+input combined; input is truncated to 8s by the API.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringresolutionstringvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=xai%2Fgrok-imagine-video%2Fedit-video",
"title": "Grok Edit Video generation request",
"description": "Request body accepted by POST /api/v1/generate for xai/grok-imagine-video/edit-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "xai/grok-imagine-video/edit-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"resolution": {
"type": "string",
"enum": [
"auto",
"480p",
"720p"
]
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"video_url"
],
"additionalProperties": false
}
Grok Extend Video — seamlessly continues an existing video clip for 4–8 additional seconds while preserving cinematic pacing and motion.
Pricing: $0.06/s (480p) · $0.08/s (720p) — output matches your input video; estimated at the midpoint
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringdurationnumbervideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=xai%2Fgrok-imagine-video%2Fextend-video",
"title": "Grok Extend Video generation request",
"description": "Request body accepted by POST /api/v1/generate for xai/grok-imagine-video/extend-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "xai/grok-imagine-video/extend-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"duration": {
"type": "number",
"enum": [
4,
6,
8
]
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"video_url"
],
"additionalProperties": false
}
xAI Grok Imagine Video 1.5 image-to-video — animate one image into a 1–15 second cinematic video with synchronized audio at up to 1080p.
Pricing: $0.08/s at 480p · $0.14/s at 720p · $0.25/s at 1080p, plus $0.01 for the input image.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringimage_urlstringdurationnumberresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=xai%2Fgrok-imagine-video%2Fv1.5%2Fimage-to-video",
"title": "Grok Imagine 1.5 (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for xai/grok-imagine-video/v1.5/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "xai/grok-imagine-video/v1.5/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"maxLength": 4096
},
"image_url": {
"type": "string",
"format": "uri"
},
"duration": {
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p",
"1080p"
]
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
xAI Grok Imagine Video 1.5 reference-to-video — guide a 1–15 second video with up to seven image references while preserving subjects, style, and visual identity.
Pricing: $0.08/s at 480p · $0.14/s at 720p, plus $0.01 per reference image (1–7).
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringreference_image_urlsarraydurationnumberresolutionstringaspect_ratiostring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=xai%2Fgrok-imagine-video%2Fv1.5%2Freference-to-video",
"title": "Grok Imagine 1.5 (Reference) generation request",
"description": "Request body accepted by POST /api/v1/generate for xai/grok-imagine-video/v1.5/reference-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "xai/grok-imagine-video/v1.5/reference-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"maxLength": 4096
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 1,
"maxItems": 7
},
"duration": {
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"4:3",
"3:2",
"1:1",
"2:3",
"3:4",
"9:16"
]
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
xAI Grok Imagine Video 1.5 text-to-video — generate 1–15 second videos with synchronized audio from a prompt at up to 1080p.
Pricing: $0.08/s at 480p · $0.14/s at 720p · $0.25/s at 1080p.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringdurationnumberresolutionstringaspect_ratiostring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=xai%2Fgrok-imagine-video%2Fv1.5%2Ftext-to-video",
"title": "Grok Imagine 1.5 (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for xai/grok-imagine-video/v1.5/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "xai/grok-imagine-video/v1.5/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"maxLength": 4096
},
"duration": {
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p",
"1080p"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"4:3",
"3:2",
"1:1",
"2:3",
"3:4",
"9:16"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Grok Reference Video — generates video from up to 7 reference images, maintaining visual identity across shots with resolution selection.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaspect_ratiostringresolutionstringdurationnumberreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=xai%2Fgrok-imagine-video%2Freference-to-video",
"title": "Grok Reference Video generation request",
"description": "Request body accepted by POST /api/v1/generate for xai/grok-imagine-video/reference-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "xai/grok-imagine-video/reference-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"4:3",
"3:4",
"1:1",
"3:2",
"2:3"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p"
]
},
"duration": {
"type": "number",
"enum": [
6,
8,
10
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 7
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Grok Imagine Video image-to-video — xAI's image-to-video model with resolution selection and per-image pricing.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaspect_ratiostringresolutionstringdurationnumberimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=xai%2Fgrok-imagine-video%2Fimage-to-video",
"title": "Grok Video (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for xai/grok-imagine-video/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "xai/grok-imagine-video/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"16:9",
"9:16",
"4:3",
"3:4",
"1:1",
"3:2",
"2:3"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p"
]
},
"duration": {
"type": "number",
"enum": [
4,
6,
8,
10
]
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
Alibaba Happy Horse video-edit transforms an input video by style, weather, or setting while preserving the original motion.
Pricing: Billed by reference/source-video length (2s–10s), not a toolbar duration pick.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaudio_settingstringseedintegerresolutionstringvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=alibaba%2Fhappy-horse%2Fvideo-edit",
"title": "Happy Horse (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for alibaba/happy-horse/video-edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "alibaba/happy-horse/video-edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"audio_setting": {
"title": "Audio",
"description": "Whether the edited video keeps the input's original audio or lets the model decide.",
"default": "auto",
"type": "string",
"enum": [
"auto",
"origin"
]
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility (0-2147483647).",
"type": "integer"
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"video_url"
],
"additionalProperties": false
}
Alibaba Happy Horse 1.1 image-to-video animates a start frame with cinematic motion, supporting durations from 3 to 15 seconds.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaudiobooleannegative_promptstringenable_prompt_expansionbooleanseedintegerresolutionstringdurationnumberimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=alibaba%2Fhappy-horse%2Fimage-to-video",
"title": "Happy Horse 1.1 (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for alibaba/happy-horse/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "alibaba/happy-horse/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"audio": {
"title": "Generate Audio",
"description": "Native audio — dialogue, ambient sound, and music generated together with the video.",
"default": true,
"type": "boolean"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Content to avoid in the video.",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Enable intelligent prompt rewriting.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility (0-2147483647).",
"type": "integer"
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
Alibaba Happy Horse 1.1 reference-to-video places a reference character naturally into any prompted scene with cinematic flair and identity consistency.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaudiobooleannegative_promptstringenable_prompt_expansionbooleanseedintegeraspect_ratiostringresolutionstringdurationnumberreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=alibaba%2Fhappy-horse%2Freference-to-video",
"title": "Happy Horse 1.1 (Reference) generation request",
"description": "Request body accepted by POST /api/v1/generate for alibaba/happy-horse/reference-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "alibaba/happy-horse/reference-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"audio": {
"title": "Generate Audio",
"description": "Native audio — dialogue, ambient sound, and music generated together with the video.",
"default": true,
"type": "boolean"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Content to avoid in the video.",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Enable intelligent prompt rewriting.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility (0-2147483647).",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 9
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Alibaba Happy Horse 1.1 text-to-video generates cinematic clips from a prompt, with broad aspect ratio and resolution support.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaudiobooleannegative_promptstringenable_prompt_expansionbooleanseedintegeraspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=alibaba%2Fhappy-horse%2Ftext-to-video",
"title": "Happy Horse 1.1 (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for alibaba/happy-horse/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "alibaba/happy-horse/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"audio": {
"title": "Generate Audio",
"description": "Native audio — dialogue, ambient sound, and music generated together with the video.",
"default": true,
"type": "boolean"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Content to avoid in the video.",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Enable intelligent prompt rewriting.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility (0-2147483647).",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
HeyGen Avatar V Digital Twin — studio-quality talking-avatar video from your Digital Twin, driven by a script + voice. Routed directly to HeyGen's v3 API with the Avatar V engine.
Pricing: Estimated from script length (~15 chars/sec of speech); actual output may vary.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringavatar_idstringvoice_idstringvoice_speednumbervoice_pitchnumbervoice_volumenumberremove_backgroundbooleanfitstringlocalestringbg_typestringbg_valuestringoutput_formatstringaspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fheygen%2Favatar5%2Fdigital-twin",
"title": "HeyGen Avatar V Digital Twin generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/heygen/avatar5/digital-twin.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/heygen/avatar5/digital-twin",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"avatar_id": {
"title": "Digital Twin ID",
"description": "Your HeyGen Digital Twin look id — GET /v3/avatars/looks?avatar_type=digital_twin. Required.",
"default": "",
"type": "string"
},
"voice_id": {
"title": "Voice ID",
"description": "Your HeyGen voice_id (GET /v2/voices) — the voice the twin speaks your script in. Required.",
"default": "",
"type": "string"
},
"voice_speed": {
"title": "Voice Speed",
"description": "Speech speed multiplier (0.5–1.5).",
"default": 1,
"type": "number",
"minimum": 0.5,
"maximum": 1.5,
"multipleOf": 0.05
},
"voice_pitch": {
"title": "Voice Pitch",
"description": "Voice pitch adjustment (-50 to 50).",
"default": 0,
"type": "number",
"minimum": -50,
"maximum": 50,
"multipleOf": 1
},
"voice_volume": {
"title": "Voice Volume",
"description": "Voice audio volume. 1.0 = full, 0.0 = silent — useful when mixing with background audio.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"remove_background": {
"title": "Remove Background",
"description": "Render with a removed/transparent background (overrides the Background setting).",
"default": false,
"type": "boolean"
},
"fit": {
"title": "Fit",
"description": "How the avatar is fitted to the output canvas. Auto picks based on source/canvas orientation.",
"default": "",
"type": "string",
"enum": [
"",
"cover",
"contain"
]
},
"locale": {
"title": "Locale",
"description": "Optional BCP-47 locale for multilingual delivery (e.g. en-US, es-ES). Leave empty to auto-detect.",
"default": "",
"type": "string"
},
"bg_type": {
"title": "Background Type",
"description": "Background behind the avatar (ignored when Remove Background is on).",
"default": "color",
"type": "string",
"enum": [
"color",
"image"
]
},
"bg_value": {
"title": "Background",
"description": "Hex color (e.g. #1144FF) for 'color', or HTTP(S) image URL for 'image'.",
"default": "",
"type": "string"
},
"output_format": {
"title": "Output Format",
"description": "Video output format.",
"default": "mp4",
"type": "string",
"enum": [
"mp4",
"webm"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"4:5",
"5:4",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p",
"4k"
]
}
},
"required": [
"model_id",
"prompt",
"avatar_id",
"voice_id"
],
"additionalProperties": false
}
HeyGen Lipsync Precision delivers ultra-precise phoneme matching for professional dubbing, resyncing every mouth shape with maximum fidelity.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstart_timenumberend_timenumberdisable_music_trackbooleanenable_dynamic_durationbooleanenable_captionbooleanenable_speech_enhancementbooleanfps_modestringkeep_the_same_formatbooleantitlestringvideo_urlstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fheygen%2Fv3%2Flipsync%2Fprecision",
"title": "HeyGen Lipsync Precision generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/heygen/v3/lipsync/precision.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/heygen/v3/lipsync/precision",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"start_time": {
"title": "Start Time",
"description": "Start time in seconds for partial lipsync.",
"type": "number",
"minimum": 0
},
"end_time": {
"title": "End Time",
"description": "End time in seconds for partial lipsync.",
"type": "number",
"minimum": 0
},
"disable_music_track": {
"title": "Disable Music Track",
"description": "Remove background music from the source video.",
"default": false,
"type": "boolean"
},
"enable_dynamic_duration": {
"title": "Enable Dynamic Duration",
"description": "Allow duration adjustment to match the new audio.",
"default": true,
"type": "boolean"
},
"enable_caption": {
"title": "Enable Caption",
"description": "Generate captions in the output video.",
"default": false,
"type": "boolean"
},
"enable_speech_enhancement": {
"title": "Enable Speech Enhancement",
"description": "Enhance the replacement audio quality.",
"default": false,
"type": "boolean"
},
"fps_mode": {
"title": "FPS Mode",
"description": "Frame rate handling for the output video.",
"default": "",
"type": "string",
"enum": [
"",
"vfr",
"cfr",
"passthrough"
]
},
"keep_the_same_format": {
"title": "Keep Same Format",
"description": "Preserve the source video's resolution and bitrate.",
"default": false,
"type": "boolean"
},
"title": {
"title": "Title",
"description": "Optional title for the lipsync job.",
"type": "string"
},
"video_url": {
"type": "string",
"format": "uri"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"video_url",
"audio_url"
],
"additionalProperties": false
}
HeyGen Lipsync Speed re-dubs any speaking video with a new audio track quickly and naturally.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstart_timenumberend_timenumberdisable_music_trackbooleanenable_dynamic_durationbooleanenable_captionbooleanenable_speech_enhancementbooleanfps_modestringkeep_the_same_formatbooleantitlestringvideo_urlstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fheygen%2Fv3%2Flipsync%2Fspeed",
"title": "HeyGen Lipsync Speed generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/heygen/v3/lipsync/speed.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/heygen/v3/lipsync/speed",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"start_time": {
"title": "Start Time",
"description": "Start time in seconds for partial lipsync.",
"type": "number",
"minimum": 0
},
"end_time": {
"title": "End Time",
"description": "End time in seconds for partial lipsync.",
"type": "number",
"minimum": 0
},
"disable_music_track": {
"title": "Disable Music Track",
"description": "Remove background music from the source video.",
"default": false,
"type": "boolean"
},
"enable_dynamic_duration": {
"title": "Enable Dynamic Duration",
"description": "Allow duration adjustment to match the new audio.",
"default": true,
"type": "boolean"
},
"enable_caption": {
"title": "Enable Caption",
"description": "Generate captions in the output video.",
"default": false,
"type": "boolean"
},
"enable_speech_enhancement": {
"title": "Enable Speech Enhancement",
"description": "Enhance the replacement audio quality.",
"default": false,
"type": "boolean"
},
"fps_mode": {
"title": "FPS Mode",
"description": "Frame rate handling for the output video.",
"default": "",
"type": "string",
"enum": [
"",
"vfr",
"cfr",
"passthrough"
]
},
"keep_the_same_format": {
"title": "Keep Same Format",
"description": "Preserve the source video's resolution and bitrate.",
"default": false,
"type": "boolean"
},
"title": {
"title": "Title",
"description": "Optional title for the lipsync job.",
"type": "string"
},
"video_url": {
"type": "string",
"format": "uri"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"video_url",
"audio_url"
],
"additionalProperties": false
}
HeyGen Video Agent generates cinematic talking-head videos from a portrait image and an audio clip or text prompt, with realistic facial motion and atmosphere.
Pricing: Estimated from script length (~15 chars/sec of speech); actual output may vary.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringavatarstringvoicestringorientationstringstyle_idstringincognito_modeboolean
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fheygen%2Fv3%2Fvideo-agent",
"title": "HeyGen Video Agent generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/heygen/v3/video-agent.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/heygen/v3/video-agent",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"avatar": {
"title": "Avatar",
"description": "HeyGen avatar id, or 'auto' to let HeyGen choose.",
"default": "auto",
"type": "string"
},
"voice": {
"title": "Voice",
"description": "HeyGen voice id, or 'auto' to let HeyGen choose.",
"default": "auto",
"type": "string"
},
"orientation": {
"title": "Orientation",
"description": "Output orientation. Leave on Auto to let HeyGen decide.",
"default": "",
"type": "string",
"enum": [
"",
"landscape",
"portrait"
]
},
"style_id": {
"title": "Style ID",
"description": "Optional HeyGen style id to apply a visual template.",
"default": "",
"type": "string"
},
"incognito_mode": {
"title": "Incognito Mode",
"description": "Don't save this generation to your HeyGen project history.",
"default": false,
"type": "boolean"
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Tencent Hunyuan 1.5 text-to-video — full diffusion workbench with inference steps, guidance, and frame count controls for high-quality video generation.
Pricing: Flat $0.40 (fal bills ~$0.075/s at 480p; flat is the safe ceiling at max 121 frames).
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_inference_stepsnumberseedintegernegative_promptstringnum_framesnumberenable_prompt_expansionbooleanaspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=hunyuan-t2v",
"title": "Hunyuan 1.5 generation request",
"description": "Request body accepted by POST /api/v1/generate for hunyuan-t2v.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "hunyuan-t2v",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps.",
"default": 28,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility.",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to guide what not to generate.",
"default": "",
"type": "string"
},
"num_frames": {
"title": "Num Frames",
"description": "The number of frames to generate.",
"default": 121,
"type": "number",
"minimum": 1,
"maximum": 121,
"multipleOf": 1
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Enable prompt expansion to enhance the input prompt.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"480p"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Tencent Hunyuan 1.5 image-to-video — animate a start image with full diffusion controls including inference steps, guidance, and frame count.
Pricing: Flat $0.40 (fal bills ~$0.075/s at 480p; flat is the safe ceiling at max 121 frames).
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_inference_stepsnumberseedintegernegative_promptstringnum_framesnumberenable_prompt_expansionbooleanaspect_ratiostringresolutionstringimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=hunyuan-i2v",
"title": "Hunyuan 1.5 (i2v) generation request",
"description": "Request body accepted by POST /api/v1/generate for hunyuan-i2v.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "hunyuan-i2v",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps.",
"default": 28,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility.",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to guide what not to generate.",
"default": "",
"type": "string"
},
"num_frames": {
"title": "Num Frames",
"description": "The number of frames to generate.",
"default": 121,
"type": "number",
"minimum": 1,
"maximum": 121,
"multipleOf": 1
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Enable prompt expansion to enhance the input prompt.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"480p"
]
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
Tencent Hunyuan video-to-video style transfer — restyle existing footage with a text prompt while preserving motion structure. Pro mode doubles inference steps for higher quality.
Pricing: $0.40 flat per video ($0.80 with Pro Mode).
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_framesnumberstrengthnumberpro_modebooleanseedintegerenable_safety_checkerbooleanaspect_ratiostringresolutionstringvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fhunyuan-video%2Fvideo-to-video",
"title": "Hunyuan V2V generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/hunyuan-video/video-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/hunyuan-video/video-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"num_frames": {
"title": "Num Frames",
"description": "The number of frames to generate.",
"default": 129,
"type": "number",
"enum": [
129,
85
]
},
"strength": {
"title": "Strength",
"description": "Strength for Video-to-Video",
"default": 0.85,
"type": "number",
"minimum": 0.01,
"maximum": 1,
"multipleOf": 0.01
},
"pro_mode": {
"title": "Pro Mode",
"description": "By default, generations are done with 35 steps. Pro mode does 55 steps which results in higher quality videos but will take more time and cost 2x more",
"default": false,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "The seed to use for generating the video.",
"type": "integer"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the input safety checker before generation.",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"580p",
"720p"
]
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"video_url"
],
"additionalProperties": false
}
Tencent Hunyuan Foley — generate cinematic audio tightly synced to on-screen action from a silent video, guided by a text description of the desired sounds.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringtext_promptstringnegative_promptstringguidance_scalenumbernum_inference_stepsnumberseedintegervideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fhunyuan-video-foley",
"title": "Hunyuan Video Foley generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/hunyuan-video-foley.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/hunyuan-video-foley",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"text_prompt": {
"title": "Text Prompt",
"description": "Text description of the desired audio — describe sounds, ambience, instruments, etc.",
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt to avoid certain audio characteristics.",
"default": "noisy, harsh",
"type": "string"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance scale for audio generation.",
"default": 4.5,
"type": "number",
"minimum": 1,
"maximum": 10,
"multipleOf": 0.1
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "Number of inference steps for generation.",
"default": 50,
"type": "number",
"minimum": 10,
"maximum": 100,
"multipleOf": 1
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducible generation.",
"type": "integer"
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"text_prompt",
"video_url"
],
"additionalProperties": false
}
Kling 2.5 Turbo image-to-video — fast 1080p animation from a start image with optional end-frame.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringtail_image_urlstringresolutionstringdurationnumberimage_urlstringend_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=kling-video%2Fv2-5-turbo%2Fimage-to-video",
"title": "Kling 2.5 Turbo (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for kling-video/v2-5-turbo/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "kling-video/v2-5-turbo/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Things to avoid in the video.",
"default": "blur, distort, and low quality",
"type": "string"
},
"tail_image_url": {
"title": "Tail Image Url",
"description": "Handled by the End Frame canvas slot.",
"type": "string"
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
5,
10
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
Kling 2.5 Turbo text-to-video — max creativity with exceptional value. Fast 1080p generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringaspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=kling-video%2Fv2-5-turbo%2Ftext-to-video",
"title": "Kling 2.5 Turbo (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for kling-video/v2-5-turbo/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "kling-video/v2-5-turbo/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Things to avoid in the video.",
"default": "blur, distort, and low quality",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
5,
10
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Kling 2.6 image-to-video — animate a start image with strong audio-visual synchronisation and optional end frame.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringgenerate_audiobooleanvoice_idsarraytail_image_urlstringresolutionstringdurationnumberimage_urlstringend_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=kling-video%2Fv2-6%2Fimage-to-video",
"title": "Kling 2.6 (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for kling-video/v2-6/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "kling-video/v2-6/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Things to avoid in the video.",
"default": "blur, distort, and low quality",
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Generate native audio alongside the video. Native audio output uses 1080p for this model.",
"default": false,
"type": "boolean"
},
"voice_ids": {
"title": "Voice IDs",
"description": "Up to two Kling custom or preset Voice IDs. Reference them in the prompt as @1 and @2. Voice control enables native audio at 1080p and cannot be combined with an end frame.",
"type": "array",
"items": {
"type": "string"
}
},
"tail_image_url": {
"title": "Tail Image Url",
"description": "Handled by the End Frame canvas slot.",
"type": "string"
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
5,
10
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
Kling 2.6 text-to-video — see the sound, hear the visual. Specialised in audio-visual synchronisation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringgenerate_audiobooleanaspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=kling-video%2Fv2-6%2Ftext-to-video",
"title": "Kling 2.6 (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for kling-video/v2-6/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "kling-video/v2-6/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Things to avoid in the video.",
"default": "blur, distort, and low quality",
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Generate native audio alongside the video. Native audio output uses 720p for this model.",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
5,
10
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Kling 2.6 Motion Control — apply human motion from a reference video onto a character in a reference image. Output duration matches the reference video (3–30s).
Pricing: Billed by reference/source-video length (3s–30s), not a toolbar duration pick.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringcharacter_orientationstringkeep_original_soundbooleanelement_idsarraysource_video_durationnumberresolutionstringimage_urlstringvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=kling-video%2Fv2-6%2Fmotion-control",
"title": "Kling 2.6 Motion Control generation request",
"description": "Request body accepted by POST /api/v1/generate for kling-video/v2-6/motion-control.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "kling-video/v2-6/motion-control",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"character_orientation": {
"title": "Character Orientation",
"description": "Match Image: character faces same direction as the reference image (ref video max 10s). Match Video: character follows video orientation (ref video max 30s).",
"default": "image",
"type": "string",
"enum": [
"image",
"video"
]
},
"keep_original_sound": {
"title": "Keep Original Sound",
"description": "Preserve the audio from the reference motion video.",
"default": true,
"type": "boolean"
},
"element_ids": {
"title": "Element ID",
"description": "Optional Kling Element ID for stronger character consistency. Element input forces Match Video orientation; only the first ID is used.",
"type": "array",
"items": {
"type": "string"
}
},
"source_video_duration": {
"title": "Source Video Duration",
"description": "Public API billing input; the web app measures the motion clip automatically.",
"type": "number",
"minimum": 3,
"maximum": 30,
"multipleOf": 0.1
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"image_url",
"video_url"
],
"additionalProperties": false
}
Kling 3.0 image-to-video — animate a start image up to 4K with optional end-frame and native audio.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanmulti_shotbooleanelement_idsarraytail_image_urlstringresolutionstringdurationnumberimage_urlstringend_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=kling-video%2Fv3%2Fimage-to-video",
"title": "Kling 3.0 (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for kling-video/v3/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "kling-video/v3/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Generate native audio alongside the video.",
"default": false,
"type": "boolean"
},
"multi_shot": {
"title": "Multi-shot",
"description": "Allow prompts formatted as timed shots to generate a multi-shot sequence.",
"default": true,
"type": "boolean"
},
"element_ids": {
"title": "Element IDs",
"description": "Optional Kling Element IDs referenced in the prompt as @element_1 through @element_3.",
"type": "array",
"items": {
"type": "string"
}
},
"tail_image_url": {
"title": "Tail Image Url",
"description": "Handled by the End Frame canvas slot.",
"type": "string"
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p",
"4k"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
Kling 3.0 text-to-video — native audio, multi-shot storytelling, and strong element consistency up to 4K.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanmulti_shotbooleanaspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=kling-video%2Fv3%2Ftext-to-video",
"title": "Kling 3.0 (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for kling-video/v3/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "kling-video/v3/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Generate native audio alongside the video.",
"default": false,
"type": "boolean"
},
"multi_shot": {
"title": "Multi-shot",
"description": "Allow prompts formatted as timed shots to generate a multi-shot sequence.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p",
"4k"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Kling 3.0 Motion Control — apply human motion from a reference video onto a character in a reference image. Higher fidelity than 2.6. Output duration matches the reference video (3–30s).
Pricing: Billed by reference/source-video length (3s–30s), not a toolbar duration pick.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringcharacter_orientationstringkeep_original_soundbooleanelement_idsarraysource_video_durationnumberresolutionstringimage_urlstringvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=kling-video%2Fv3%2Fmotion-control",
"title": "Kling 3.0 Motion Control generation request",
"description": "Request body accepted by POST /api/v1/generate for kling-video/v3/motion-control.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "kling-video/v3/motion-control",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"character_orientation": {
"title": "Character Orientation",
"description": "Match Image: character faces same direction as the reference image (ref video max 10s). Match Video: character follows video orientation (ref video max 30s).",
"default": "image",
"type": "string",
"enum": [
"image",
"video"
]
},
"keep_original_sound": {
"title": "Keep Original Sound",
"description": "Preserve the audio from the reference motion video.",
"default": true,
"type": "boolean"
},
"element_ids": {
"title": "Element ID",
"description": "Optional Kling Element ID for stronger character consistency. Element input forces Match Video orientation; only the first ID is used.",
"type": "array",
"items": {
"type": "string"
}
},
"source_video_duration": {
"title": "Source Video Duration",
"description": "Public API billing input; the web app measures the motion clip automatically.",
"type": "number",
"minimum": 3,
"maximum": 30,
"multipleOf": 0.1
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"image_url",
"video_url"
],
"additionalProperties": false
}
Kling 3.0 Omni image-to-video — multimodal input animates a reference image with start/end frame control, reference video, and native audio.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanmulti_shotbooleanelement_idsarraytail_image_urlstringresolutionstringdurationnumberimage_urlstringend_image_urlstringreference_image_urlsarrayvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=kling-video%2Fv3-omni%2Fimage-to-video",
"title": "Kling 3.0 Omni (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for kling-video/v3-omni/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "kling-video/v3-omni/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Generate native audio alongside the video.",
"default": true,
"type": "boolean"
},
"multi_shot": {
"title": "Multi-shot",
"description": "Allow prompts formatted as timed shots to generate a multi-shot sequence.",
"default": true,
"type": "boolean"
},
"element_ids": {
"title": "Element IDs",
"description": "Optional Kling Element IDs referenced in the prompt as @element_1 through @element_3.",
"type": "array",
"items": {
"type": "string"
}
},
"tail_image_url": {
"title": "Tail Image Url",
"description": "Handled by the End Frame canvas slot.",
"type": "string"
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p",
"4k"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 7
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
Kling 3.0 Omni text-to-video — multimodal generation with reference images, reference video, native audio, and multi-shot storyboards.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanmulti_shotbooleanreference_video_modestringkeep_original_soundbooleansource_video_durationnumberelement_idsarrayaspect_ratiostringresolutionstringdurationnumberreference_image_urlsarrayvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=kling-video%2Fv3-omni%2Ftext-to-video",
"title": "Kling 3.0 Omni (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for kling-video/v3-omni/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "kling-video/v3-omni/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Generate native audio alongside the video.",
"default": true,
"type": "boolean"
},
"multi_shot": {
"title": "Multi-shot",
"description": "Allow prompts formatted as timed shots to generate a multi-shot sequence.",
"default": true,
"type": "boolean"
},
"reference_video_mode": {
"title": "Reference Video Mode",
"description": "Feature Reference follows the source motion; Edit Base Video transforms the source and disables first/end frames, native audio, and multi-shot.",
"default": "feature",
"type": "string",
"enum": [
"feature",
"base"
]
},
"keep_original_sound": {
"title": "Keep Original Sound",
"description": "When editing a base video, preserve its original audio.",
"default": true,
"type": "boolean"
},
"source_video_duration": {
"title": "Source Video Duration",
"description": "Public API billing input required for base-video mode; the web app measures this automatically.",
"type": "number",
"minimum": 3,
"maximum": 15.5,
"multipleOf": 0.1
},
"element_ids": {
"title": "Element IDs",
"description": "Optional Kling Element IDs referenced in the prompt as @element_1 through @element_3.",
"type": "array",
"items": {
"type": "string"
}
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p",
"4k"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 7
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Kling 3.0 Turbo image-to-video — animate a start image via the new Turbo API (first frame only).
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringresolutionstringdurationnumberimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=kling-video%2Fv3-turbo%2Fimage-to-video",
"title": "Kling 3.0 Turbo (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for kling-video/v3-turbo/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "kling-video/v3-turbo/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
Kling 3.0 Turbo text-to-video — consistently excellent results at a better cost point via the new Turbo API.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=kling-video%2Fv3-turbo%2Ftext-to-video",
"title": "Kling 3.0 Turbo (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for kling-video/v3-turbo/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "kling-video/v3-turbo/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Kling Avatar — bring a portrait to life with synchronized speech and expressive motion driven by an audio file.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringresolutionstringimage_urlstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=kling-video%2Favatar%2Fimage2video",
"title": "Kling Avatar generation request",
"description": "Request body accepted by POST /api/v1/generate for kling-video/avatar/image2video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "kling-video/avatar/image2video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"image_url",
"audio_url"
],
"additionalProperties": false
}
LatentSync is a fast open-source lipsync model trained on large-scale video data. Upload a portrait video and audio for natural-looking lipsync.
Pricing: $0.20 up to 40s, $0.005/s beyond — billed by output length: source video, or looped-to-audio length when loop mode is on.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringloop_modestringguidance_scalenumberseedintegervideo_urlstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Flatentsync",
"title": "LatentSync generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/latentsync.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/latentsync",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"loop_mode": {
"title": "Loop Mode",
"description": "How to fill video when audio is longer than the source clip. None = no extension; Pingpong = bounce; Loop = repeat.",
"default": "",
"type": "string",
"enum": [
"",
"pingpong",
"loop"
]
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Guidance scale for inference (1–2). Higher values follow the audio more strictly.",
"default": 1,
"type": "number",
"minimum": 1,
"maximum": 2,
"multipleOf": 0.1
},
"seed": {
"title": "Seed",
"description": "Random seed. Leave blank for a random result.",
"type": "integer"
},
"video_url": {
"type": "string",
"format": "uri"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"video_url",
"audio_url"
],
"additionalProperties": false
}
LTX 2.3 text-to-video — high-resolution cinematic clips up to 4K with native audio generation and resolution-scaled pricing.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanfpsnumberaspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=ltx-t2v",
"title": "LTX 2.3 generation request",
"description": "Request body accepted by POST /api/v1/generate for ltx-t2v.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "ltx-t2v",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate audio for the generated video",
"default": true,
"type": "boolean"
},
"fps": {
"title": "Fps",
"description": "The frames per second of the generated video",
"default": 25,
"type": "number",
"enum": [
24,
25,
48,
50
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"1080p",
"1440p",
"2160p"
]
},
"duration": {
"type": "number",
"enum": [
6,
8,
10
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Fast LTX 2.5 audio-driven video generation from a 2–20 second audio clip, with an optional first frame and optional visual prompt.
Pricing: $0.13 per second of input audio at 1080p on fal.ai.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaudio_urlstringimage_urlstringguidance_scalenumberaspect_ratiostring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=lightricks%2Fltx-2.5%2Faudio-to-video%2Ffast",
"title": "LTX 2.5 Fast (Audio to Video) generation request",
"description": "Request body accepted by POST /api/v1/generate for lightricks/ltx-2.5/audio-to-video/fast.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "lightricks/ltx-2.5/audio-to-video/fast",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"audio_url": {
"type": "string",
"format": "uri"
},
"image_url": {
"type": "string",
"format": "uri"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Prompt adherence. Provider defaults to 5 without an image and 9 with one.",
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 0.5
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"16:9",
"9:16"
]
}
},
"required": [
"model_id",
"audio_url"
],
"additionalProperties": false
}
Fast LTX 2.5 image-to-video with optional end-frame transitions, 6–20 second output up to 4K, and native audio.
Pricing: $0.09–$0.30/s depending on resolution on fal.ai.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringimage_urlstringend_image_urlstringdurationnumberresolutionstringaspect_ratiostringfpsnumbergenerate_audiobooleancamera_motionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=lightricks%2Fltx-2.5%2Fimage-to-video%2Ffast",
"title": "LTX 2.5 Fast (Image to Video) generation request",
"description": "Request body accepted by POST /api/v1/generate for lightricks/ltx-2.5/image-to-video/fast.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "lightricks/ltx-2.5/image-to-video/fast",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
},
"duration": {
"type": "number",
"enum": [
6,
8,
10,
12,
14,
16,
18,
20
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p",
"1440p",
"2160p"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"16:9",
"9:16"
]
},
"fps": {
"title": "Frame Rate",
"description": "Output frames per second.",
"default": 25,
"type": "number",
"enum": [
24,
25,
48,
50
]
},
"generate_audio": {
"title": "Generate Audio",
"description": "Generate synchronized native audio with the video.",
"default": true,
"type": "boolean"
},
"camera_motion": {
"title": "Camera Motion",
"description": "Optional camera movement preset.",
"type": "string",
"enum": [
"dolly_in",
"dolly_out",
"dolly_left",
"dolly_right",
"jib_up",
"jib_down",
"static",
"focus_shift"
]
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
Fast LTX 2.5 text-to-video with 6–20 second output up to 4K, synchronized native audio, and camera-motion control.
Pricing: $0.09–$0.30/s depending on resolution on fal.ai.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringdurationnumberresolutionstringaspect_ratiostringfpsnumbergenerate_audiobooleancamera_motionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=lightricks%2Fltx-2.5%2Ftext-to-video%2Ffast",
"title": "LTX 2.5 Fast (Text to Video) generation request",
"description": "Request body accepted by POST /api/v1/generate for lightricks/ltx-2.5/text-to-video/fast.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "lightricks/ltx-2.5/text-to-video/fast",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"duration": {
"type": "number",
"enum": [
6,
8,
10,
12,
14,
16,
18,
20
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p",
"1440p",
"2160p"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16"
]
},
"fps": {
"title": "Frame Rate",
"description": "Output frames per second.",
"default": 25,
"type": "number",
"enum": [
24,
25,
48,
50
]
},
"generate_audio": {
"title": "Generate Audio",
"description": "Generate synchronized native audio with the video.",
"default": true,
"type": "boolean"
},
"camera_motion": {
"title": "Camera Motion",
"description": "Optional camera movement preset.",
"type": "string",
"enum": [
"dolly_in",
"dolly_out",
"dolly_left",
"dolly_right",
"jib_up",
"jib_down",
"static",
"focus_shift"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
LTX 2.5 Pro audio-driven video generation from a 2–20 second audio clip, with an optional first frame and optional visual prompt.
Pricing: $0.17 per second of input audio at 1080p on fal.ai.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaudio_urlstringimage_urlstringguidance_scalenumberaspect_ratiostring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=lightricks%2Fltx-2.5%2Faudio-to-video%2Fpro",
"title": "LTX 2.5 Pro (Audio to Video) generation request",
"description": "Request body accepted by POST /api/v1/generate for lightricks/ltx-2.5/audio-to-video/pro.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "lightricks/ltx-2.5/audio-to-video/pro",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"audio_url": {
"type": "string",
"format": "uri"
},
"image_url": {
"type": "string",
"format": "uri"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Prompt adherence. Provider defaults to 5 without an image and 9 with one.",
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 0.5
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"16:9",
"9:16"
]
}
},
"required": [
"model_id",
"audio_url"
],
"additionalProperties": false
}
LTX 2.5 Pro image-to-video with optional end-frame transitions, synchronized native audio, and camera-motion control.
Pricing: $0.12/s at 720p or $0.17/s at 1080p on fal.ai.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringimage_urlstringend_image_urlstringdurationnumberresolutionstringaspect_ratiostringfpsnumbergenerate_audiobooleancamera_motionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=lightricks%2Fltx-2.5%2Fimage-to-video%2Fpro",
"title": "LTX 2.5 Pro (Image to Video) generation request",
"description": "Request body accepted by POST /api/v1/generate for lightricks/ltx-2.5/image-to-video/pro.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "lightricks/ltx-2.5/image-to-video/pro",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
},
"duration": {
"type": "number",
"enum": [
6,
8,
10
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"16:9",
"9:16"
]
},
"fps": {
"title": "Frame Rate",
"description": "Output frames per second.",
"default": 25,
"type": "number",
"enum": [
24,
25,
50
]
},
"generate_audio": {
"title": "Generate Audio",
"description": "Generate synchronized native audio with the video.",
"default": true,
"type": "boolean"
},
"camera_motion": {
"title": "Camera Motion",
"description": "Optional camera movement preset.",
"type": "string",
"enum": [
"dolly_in",
"dolly_out",
"dolly_left",
"dolly_right",
"jib_up",
"jib_down",
"static",
"focus_shift"
]
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
LTX 2.5 Pro text-to-video with cinematic 720p/1080p output, synchronized native audio, and camera-motion control.
Pricing: $0.12/s at 720p or $0.17/s at 1080p on fal.ai.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringdurationnumberresolutionstringaspect_ratiostringfpsnumbergenerate_audiobooleancamera_motionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=lightricks%2Fltx-2.5%2Ftext-to-video%2Fpro",
"title": "LTX 2.5 Pro (Text to Video) generation request",
"description": "Request body accepted by POST /api/v1/generate for lightricks/ltx-2.5/text-to-video/pro.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "lightricks/ltx-2.5/text-to-video/pro",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"duration": {
"type": "number",
"enum": [
6,
8,
10
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16"
]
},
"fps": {
"title": "Frame Rate",
"description": "Output frames per second.",
"default": 25,
"type": "number",
"enum": [
24,
25,
50
]
},
"generate_audio": {
"title": "Generate Audio",
"description": "Generate synchronized native audio with the video.",
"default": true,
"type": "boolean"
},
"camera_motion": {
"title": "Camera Motion",
"description": "Optional camera movement preset.",
"type": "string",
"enum": [
"dolly_in",
"dolly_out",
"dolly_left",
"dolly_right",
"jib_up",
"jib_down",
"static",
"focus_shift"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
LTX-2 19B image-to-video — animate a start image into ultra-high-resolution clips up to 4K with optional end-frame interpolation and native audio.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_inference_stepsnumbernegative_promptstringvideo_output_typestringcamera_lora_scalenumberinterpolation_directionstringgenerate_audiobooleanguidance_scalenumberaccelerationstringimage_strengthnumbernum_framesnumberenable_prompt_expansionbooleanenable_safety_checkerbooleancamera_lorastringend_image_strengthnumberfpsnumbervideo_write_modestringseedintegervideo_qualitystringuse_multiscalebooleanaspect_ratiostringresolutionstringdurationnumberimage_urlstringend_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fltx-2-19b%2Fimage-to-video",
"title": "LTX-2 19B (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ltx-2-19b/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ltx-2-19b/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to use.",
"default": 40,
"type": "number",
"minimum": 8,
"maximum": 50,
"multipleOf": 1
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to generate the video from.",
"default": "blurry, out of focus, overexposed, underexposed, low contrast, washed out colors, excessive noise, grainy texture, poor lighting, flickering, motion blur, distorted proportions, unnatural skin tones, deformed facial features, asymmetrical face, missing facial features, extra limbs, disfigured hands, wrong hand count, artifacts around text, inconsistent perspective, camera shake, incorrect depth of field, background too sharp, background clutter, distracting reflections, harsh shadows, inconsistent lighting direction, color banding, cartoonish rendering, 3D CGI look, unrealistic materials, uncanny valley effect, incorrect ethnicity, wrong gender, exaggerated expressions, wrong gaze direction, mismatched lip sync, silent or muted audio, distorted voice, robotic voice, echo, background noise, off-sync audio,incorrect dialogue, added dialogue, repetitive speech, jittery movement, awkward pauses, incorrect timing, unnatural transitions, inconsistent framing, tilted camera, flat lighting, inconsistent tone, cinematic oversaturation, stylized filters, or AI artifacts.",
"type": "string"
},
"video_output_type": {
"title": "Video Output Type",
"description": "The output type of the generated video.",
"default": "X264 (.mp4)",
"type": "string",
"enum": [
"X264 (.mp4)",
"VP9 (.webm)",
"PRORES4444 (.mov)",
"GIF (.gif)"
]
},
"camera_lora_scale": {
"title": "Camera LoRA Scale",
"description": "The scale of the camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the mod",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"interpolation_direction": {
"title": "Interpolation Direction",
"description": "The direction to interpolate the image sequence in. 'Forward' goes from the start image to the end image, 'Backward' goes from the end image to the st",
"default": "forward",
"type": "string",
"enum": [
"forward",
"backward"
]
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate audio for the video.",
"default": true,
"type": "boolean"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The guidance scale to use.",
"default": 3,
"type": "number",
"minimum": 1,
"maximum": 10
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular",
"high",
"full"
]
},
"image_strength": {
"title": "Image Strength",
"description": "The strength of the image to use for the video generation.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"num_frames": {
"title": "Num Frames",
"description": "The number of frames to generate.",
"default": 121,
"type": "number",
"minimum": 9,
"maximum": 481,
"multipleOf": 1
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Whether to enable prompt expansion.",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the safety checker to block unsafe content.",
"default": true,
"type": "boolean"
},
"camera_lora": {
"title": "Camera LoRA",
"description": "The camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move th",
"default": "none",
"type": "string",
"enum": [
"dolly_in",
"dolly_out",
"dolly_left",
"dolly_right",
"jib_up",
"jib_down",
"static",
"none"
]
},
"end_image_strength": {
"title": "End Image Strength",
"description": "The strength of the end image to use for the video generation.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"fps": {
"title": "Fps",
"description": "The frames per second of the generated video.",
"default": 25,
"type": "number",
"minimum": 1,
"maximum": 60
},
"video_write_mode": {
"title": "Video Write Mode",
"description": "The write mode of the generated video.",
"default": "balanced",
"type": "string",
"enum": [
"fast",
"balanced",
"small"
]
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"video_quality": {
"title": "Video Quality",
"description": "The quality of the generated video.",
"default": "high",
"type": "string",
"enum": [
"low",
"medium",
"high",
"maximum"
]
},
"use_multiscale": {
"title": "Use Multiscale",
"description": "Whether to use multi-scale generation. If True, the model will generate the video at a smaller scale first, then use the smaller video to guide the ge",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1080p",
"1440p",
"2160p"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
10
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
LTX-2 19B text-to-video — ultra-high-resolution generation up to 4K with camera LoRA controls and native audio synthesis.
Pricing: $0.0018/MP — same rate as LTX-2 19B I2V.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_inference_stepsnumbernegative_promptstringvideo_output_typestringcamera_lora_scalenumbergenerate_audiobooleanguidance_scalenumberaccelerationstringnum_framesnumbercamera_lorastringenable_prompt_expansionbooleanenable_safety_checkerbooleanfpsnumbervideo_write_modestringseedintegervideo_qualitystringuse_multiscalebooleanaspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fltx-2-19b%2Ftext-to-video",
"title": "LTX-2 19B (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ltx-2-19b/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ltx-2-19b/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to use.",
"default": 40,
"type": "number",
"minimum": 8,
"maximum": 50,
"multipleOf": 1
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to generate the video from.",
"default": "blurry, out of focus, overexposed, underexposed, low contrast, washed out colors, excessive noise, grainy texture, poor lighting, flickering, motion blur, distorted proportions, unnatural skin tones, deformed facial features, asymmetrical face, missing facial features, extra limbs, disfigured hands, wrong hand count, artifacts around text, inconsistent perspective, camera shake, incorrect depth of field, background too sharp, background clutter, distracting reflections, harsh shadows, inconsistent lighting direction, color banding, cartoonish rendering, 3D CGI look, unrealistic materials, uncanny valley effect, incorrect ethnicity, wrong gender, exaggerated expressions, wrong gaze direction, mismatched lip sync, silent or muted audio, distorted voice, robotic voice, echo, background noise, off-sync audio,incorrect dialogue, added dialogue, repetitive speech, jittery movement, awkward pauses, incorrect timing, unnatural transitions, inconsistent framing, tilted camera, flat lighting, inconsistent tone, cinematic oversaturation, stylized filters, or AI artifacts.",
"type": "string"
},
"video_output_type": {
"title": "Video Output Type",
"description": "The output type of the generated video.",
"default": "X264 (.mp4)",
"type": "string",
"enum": [
"X264 (.mp4)",
"VP9 (.webm)",
"PRORES4444 (.mov)",
"GIF (.gif)"
]
},
"camera_lora_scale": {
"title": "Camera LoRA Scale",
"description": "The scale of the camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the mod",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate audio for the video.",
"default": true,
"type": "boolean"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The guidance scale to use.",
"default": 3,
"type": "number",
"minimum": 1,
"maximum": 10
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular",
"high",
"full"
]
},
"num_frames": {
"title": "Num Frames",
"description": "The number of frames to generate.",
"default": 121,
"type": "number",
"minimum": 9,
"maximum": 481,
"multipleOf": 1
},
"camera_lora": {
"title": "Camera LoRA",
"description": "The camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move th",
"default": "none",
"type": "string",
"enum": [
"dolly_in",
"dolly_out",
"dolly_left",
"dolly_right",
"jib_up",
"jib_down",
"static",
"none"
]
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Whether to enable prompt expansion.",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the safety checker to block unsafe content.",
"default": true,
"type": "boolean"
},
"fps": {
"title": "Fps",
"description": "The frames per second of the generated video.",
"default": 25,
"type": "number",
"minimum": 1,
"maximum": 60
},
"video_write_mode": {
"title": "Video Write Mode",
"description": "The write mode of the generated video.",
"default": "balanced",
"type": "string",
"enum": [
"fast",
"balanced",
"small"
]
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"video_quality": {
"title": "Video Quality",
"description": "The quality of the generated video.",
"default": "high",
"type": "string",
"enum": [
"low",
"medium",
"high",
"maximum"
]
},
"use_multiscale": {
"title": "Use Multiscale",
"description": "Whether to use multi-scale generation. If True, the model will generate the video at a smaller scale first, then use the smaller video to guide the ge",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1080p",
"1440p",
"2160p"
]
},
"duration": {
"type": "number",
"enum": [
3,
5,
8,
10
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
LTX-2.3 22B image-to-video with LoRA — animate a start image using a custom fine-tune for stylized motion, with optional end-frame support.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaudio_cfg_scalenumbergenerate_audiobooleanaudio_stg_scalenumberseedintegeruse_multiscalebooleanaudio_modality_scalenumberuse_restart_samplingbooleanend_image_strengthnumberschedulerstringdistill_lora_first_pass_scalenumbergradient_estimation_gammanumberdistill_lora_second_pass_scalenumbernum_framesnumberaccelerationstringvideo_output_typestringvideo_rescaling_scalenumbervideo_qualitystringcamera_lora_scalenumberaudio_rescaling_scalenumbervideo_modality_scalenumbervideo_write_modestringcamera_lorastringimage_strengthnumbervideo_stg_scalenumbervideo_cfg_scalenumbernum_inference_stepsnumbernegative_promptstringenable_prompt_expansionbooleanenable_safety_checkerbooleanfpsnumberinterpolation_directionstringlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberaspect_ratiostringresolutionstringdurationnumberimage_urlstringend_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fltx-2.3-22b%2Fimage-to-video%2Flora",
"title": "LTX-2.3 (I2V LoRA) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ltx-2.3-22b/image-to-video/lora.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ltx-2.3-22b/image-to-video/lora",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"audio_cfg_scale": {
"title": "Audio Cfg Scale",
"description": "The Classifier-Free Guidance (CFG) scale for the audio. Higher values result in more consistent and focused audio content.",
"default": 7,
"type": "number",
"minimum": 1,
"maximum": 20
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate audio for the video.",
"default": true,
"type": "boolean"
},
"audio_stg_scale": {
"title": "Audio Stg Scale",
"description": "The Spatiotemporal Guidance (STG) scale for the audio. Higher values result in more consistent and focused audio content.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 20
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"use_multiscale": {
"title": "Use Multiscale",
"description": "Whether to use multi-scale generation. If True, the model will generate the video at a smaller scale first, then use the smaller video to guide the ge",
"default": true,
"type": "boolean"
},
"audio_modality_scale": {
"title": "Audio Modality Scale",
"description": "The modality scale for the audio. Controls the ratio between video and audio modalities.",
"default": 3,
"type": "number",
"minimum": 0,
"maximum": 10
},
"use_restart_sampling": {
"title": "Use Restart Sampling",
"description": "Whether to use restart sampling. This will inject a small amount of noise during each denoising step, which can help improve the quality of the genera",
"default": false,
"type": "boolean"
},
"end_image_strength": {
"title": "End Image Strength",
"description": "The strength of the end image to use for the video generation.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"scheduler": {
"title": "Scheduler",
"description": "The scheduler to use.",
"default": "ltx2",
"type": "string",
"enum": [
"ltx2",
"linear_quadratic",
"beta"
]
},
"distill_lora_first_pass_scale": {
"title": "Distill Lora First Pass Scale",
"description": "The scale of the distill LoRA to use for the first pass. Set to 0 to disable.",
"default": 0.2,
"type": "number",
"minimum": 0,
"maximum": 1
},
"gradient_estimation_gamma": {
"title": "Gradient Estimation Gamma",
"description": "The gamma of gradient estimation during denoising. Set to 0 to disable.",
"default": 2,
"type": "number",
"minimum": 0,
"maximum": 10
},
"distill_lora_second_pass_scale": {
"title": "Distill Lora Second Pass Scale",
"description": "The scale of the distill LoRA to use for the second and subsequent passes.",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1
},
"num_frames": {
"title": "Num Frames",
"description": "The number of frames to generate.",
"default": 121,
"type": "number",
"minimum": 9,
"maximum": 481,
"multipleOf": 1
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular",
"high",
"full"
]
},
"video_output_type": {
"title": "Video Output Type",
"description": "The output type of the generated video.",
"default": "X264 (.mp4)",
"type": "string",
"enum": [
"X264 (.mp4)",
"VP9 (.webm)",
"PRORES4444 (.mov)",
"GIF (.gif)"
]
},
"video_rescaling_scale": {
"title": "Video Rescaling Scale",
"description": "The rescaling scale for the video. Controls the ratio between classifier-free guidance and spatiotemporal guidance.",
"default": 0.7,
"type": "number",
"minimum": 0,
"maximum": 1
},
"video_quality": {
"title": "Video Quality",
"description": "The quality of the generated video.",
"default": "high",
"type": "string",
"enum": [
"low",
"medium",
"high",
"maximum"
]
},
"camera_lora_scale": {
"title": "Camera LoRA Scale",
"description": "The scale of the camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the mod",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"audio_rescaling_scale": {
"title": "Audio Rescaling Scale",
"description": "The rescaling scale for the audio. Controls the ratio between classifier-free guidance and spatiotemporal guidance.",
"default": 0.7,
"type": "number",
"minimum": 0,
"maximum": 1
},
"video_modality_scale": {
"title": "Video Modality Scale",
"description": "The modality scale for the video. Controls the ratio between video and audio modalities.",
"default": 3,
"type": "number",
"minimum": 0,
"maximum": 10
},
"video_write_mode": {
"title": "Video Write Mode",
"description": "The write mode of the generated video.",
"default": "balanced",
"type": "string",
"enum": [
"fast",
"balanced",
"small"
]
},
"camera_lora": {
"title": "Camera LoRA",
"description": "The camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move th",
"default": "none",
"type": "string",
"enum": [
"dolly_in",
"dolly_out",
"dolly_left",
"dolly_right",
"jib_up",
"jib_down",
"static",
"none"
]
},
"image_strength": {
"title": "Image Strength",
"description": "The strength of the image to use for the video generation.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"video_stg_scale": {
"title": "Video Stg Scale",
"description": "The Spatiotemporal Guidance (STG) scale for the video. Higher values result in more consistent and focused video content.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 20
},
"video_cfg_scale": {
"title": "Video Cfg Scale",
"description": "The Classifier-Free Guidance (CFG) scale for the video. Higher values result in more consistent and focused video content.",
"default": 3,
"type": "number",
"minimum": 1,
"maximum": 20
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to use.",
"default": 40,
"type": "number",
"minimum": 8,
"maximum": 50,
"multipleOf": 1
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to generate the video from.",
"default": "news broadcast, 3d animation, computer graphics, pc game, console game, video game, cartoon, childish, watermark, logo, text, on screen text, subtitles, titles, signature, slowmo, static",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Whether to enable prompt expansion.",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the safety checker to block unsafe content.",
"default": true,
"type": "boolean"
},
"fps": {
"title": "Fps",
"description": "The frames per second of the generated video.",
"default": 24,
"type": "number",
"minimum": 1,
"maximum": 60
},
"interpolation_direction": {
"title": "Interpolation Direction",
"description": "The direction to interpolate the image sequence in. 'Forward' goes from the start image to the end image, 'Backward' goes from the end image to the st",
"default": "forward",
"type": "string",
"enum": [
"forward",
"backward"
]
},
"lora_path": {
"title": "LoRA Path",
"description": "URL or Hugging Face path to LoRA weights. Required for this model.",
"type": "string"
},
"lora_scale": {
"title": "LoRA Scale",
"description": "Strength of the LoRA effect.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_2": {
"title": "LoRA Path 2",
"description": "URL or Hugging Face path to a second LoRA.",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA Scale 2",
"description": "Strength of the second LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_3": {
"title": "LoRA Path 3",
"description": "URL or Hugging Face path to a third LoRA.",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA Scale 3",
"description": "Strength of the third LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1080p",
"1440p",
"2160p"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
10
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"lora_path",
"image_url"
],
"additionalProperties": false
}
LTX-2.3 22B text-to-video with LoRA — apply custom fine-tune weights from Hugging Face to steer the visual style of generated videos.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanaudio_stg_scalenumberseedintegeruse_multiscalebooleanaudio_modality_scalenumberuse_restart_samplingbooleanschedulerstringdistill_lora_first_pass_scalenumbergradient_estimation_gammanumberdistill_lora_second_pass_scalenumbernum_framesnumberaccelerationstringvideo_output_typestringvideo_rescaling_scalenumbervideo_write_modestringvideo_modality_scalenumberaudio_rescaling_scalenumbercamera_lorastringvideo_qualitystringcamera_lora_scalenumbervideo_stg_scalenumbervideo_cfg_scalenumbernum_inference_stepsnumbernegative_promptstringenable_prompt_expansionbooleanenable_safety_checkerbooleanfpsnumberaudio_cfg_scalenumberlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberaspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fltx-2.3-22b%2Ftext-to-video%2Flora",
"title": "LTX-2.3 (T2V LoRA) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ltx-2.3-22b/text-to-video/lora.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ltx-2.3-22b/text-to-video/lora",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate audio for the video.",
"default": true,
"type": "boolean"
},
"audio_stg_scale": {
"title": "Audio Stg Scale",
"description": "The Spatiotemporal Guidance (STG) scale for the audio. Higher values result in more consistent and focused audio content.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 20
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"use_multiscale": {
"title": "Use Multiscale",
"description": "Whether to use multi-scale generation. If True, the model will generate the video at a smaller scale first, then use the smaller video to guide the ge",
"default": true,
"type": "boolean"
},
"audio_modality_scale": {
"title": "Audio Modality Scale",
"description": "The modality scale for the audio. Controls the ratio between video and audio modalities.",
"default": 3,
"type": "number",
"minimum": 0,
"maximum": 10
},
"use_restart_sampling": {
"title": "Use Restart Sampling",
"description": "Whether to use restart sampling. This will inject a small amount of noise during each denoising step, which can help improve the quality of the genera",
"default": false,
"type": "boolean"
},
"scheduler": {
"title": "Scheduler",
"description": "The scheduler to use.",
"default": "ltx2",
"type": "string",
"enum": [
"ltx2",
"linear_quadratic",
"beta"
]
},
"distill_lora_first_pass_scale": {
"title": "Distill Lora First Pass Scale",
"description": "The scale of the distill LoRA to use for the first pass. Set to 0 to disable.",
"default": 0.2,
"type": "number",
"minimum": 0,
"maximum": 1
},
"gradient_estimation_gamma": {
"title": "Gradient Estimation Gamma",
"description": "The gamma of gradient estimation during denoising. Set to 0 to disable.",
"default": 2,
"type": "number",
"minimum": 0,
"maximum": 10
},
"distill_lora_second_pass_scale": {
"title": "Distill Lora Second Pass Scale",
"description": "The scale of the distill LoRA to use for the second and subsequent passes.",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1
},
"num_frames": {
"title": "Num Frames",
"description": "The number of frames to generate.",
"default": 121,
"type": "number",
"minimum": 9,
"maximum": 481,
"multipleOf": 1
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular",
"high",
"full"
]
},
"video_output_type": {
"title": "Video Output Type",
"description": "The output type of the generated video.",
"default": "X264 (.mp4)",
"type": "string",
"enum": [
"X264 (.mp4)",
"VP9 (.webm)",
"PRORES4444 (.mov)",
"GIF (.gif)"
]
},
"video_rescaling_scale": {
"title": "Video Rescaling Scale",
"description": "The rescaling scale for the video. Controls the ratio between classifier-free guidance and spatiotemporal guidance.",
"default": 0.7,
"type": "number",
"minimum": 0,
"maximum": 1
},
"video_write_mode": {
"title": "Video Write Mode",
"description": "The write mode of the generated video.",
"default": "balanced",
"type": "string",
"enum": [
"fast",
"balanced",
"small"
]
},
"video_modality_scale": {
"title": "Video Modality Scale",
"description": "The modality scale for the video. Controls the ratio between video and audio modalities.",
"default": 3,
"type": "number",
"minimum": 0,
"maximum": 10
},
"audio_rescaling_scale": {
"title": "Audio Rescaling Scale",
"description": "The rescaling scale for the audio. Controls the ratio between classifier-free guidance and spatiotemporal guidance.",
"default": 0.7,
"type": "number",
"minimum": 0,
"maximum": 1
},
"camera_lora": {
"title": "Camera LoRA",
"description": "The camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move th",
"default": "none",
"type": "string",
"enum": [
"dolly_in",
"dolly_out",
"dolly_left",
"dolly_right",
"jib_up",
"jib_down",
"static",
"none"
]
},
"video_quality": {
"title": "Video Quality",
"description": "The quality of the generated video.",
"default": "high",
"type": "string",
"enum": [
"low",
"medium",
"high",
"maximum"
]
},
"camera_lora_scale": {
"title": "Camera LoRA Scale",
"description": "The scale of the camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the mod",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"video_stg_scale": {
"title": "Video Stg Scale",
"description": "The Spatiotemporal Guidance (STG) scale for the video. Higher values result in more consistent and focused video content.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 20
},
"video_cfg_scale": {
"title": "Video Cfg Scale",
"description": "The Classifier-Free Guidance (CFG) scale for the video. Higher values result in more consistent and focused video content.",
"default": 3,
"type": "number",
"minimum": 1,
"maximum": 20
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to use.",
"default": 40,
"type": "number",
"minimum": 8,
"maximum": 50,
"multipleOf": 1
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to generate the video from.",
"default": "news broadcast, 3d animation, computer graphics, pc game, console game, video game, cartoon, childish, watermark, logo, text, on screen text, subtitles, titles, signature, slowmo, static",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Whether to enable prompt expansion.",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the safety checker to block unsafe content.",
"default": true,
"type": "boolean"
},
"fps": {
"title": "Fps",
"description": "The frames per second of the generated video.",
"default": 24,
"type": "number",
"minimum": 1,
"maximum": 60
},
"audio_cfg_scale": {
"title": "Audio Cfg Scale",
"description": "The Classifier-Free Guidance (CFG) scale for the audio. Higher values result in more consistent and focused audio content.",
"default": 7,
"type": "number",
"minimum": 1,
"maximum": 20
},
"lora_path": {
"title": "LoRA Path",
"description": "URL or Hugging Face path to LoRA weights. Required for this model.",
"type": "string"
},
"lora_scale": {
"title": "LoRA Scale",
"description": "Strength of the LoRA effect.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_2": {
"title": "LoRA Path 2",
"description": "URL or Hugging Face path to a second LoRA.",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA Scale 2",
"description": "Strength of the second LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_3": {
"title": "LoRA Path 3",
"description": "URL or Hugging Face path to a third LoRA.",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA Scale 3",
"description": "Strength of the third LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1080p",
"1440p",
"2160p"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
10
]
}
},
"required": [
"model_id",
"prompt",
"lora_path"
],
"additionalProperties": false
}
LTX-2.3 22B reference-video-to-video with LoRA — restyle a reference video with a custom fine-tune using depth, canny, or pose preprocessing.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringfpsnumberpreprocessorstringaudio_stg_scalenumbergenerate_audiobooleanic_lora_typestringuse_multiscalebooleanseedintegervideo_strengthnumberuse_restart_samplingbooleanaudio_modality_scalenumberschedulerstringmatch_video_lengthbooleanaudio_strengthnumberdistill_lora_first_pass_scalenumbergradient_estimation_gammanumberdistill_lora_second_pass_scalenumbernum_framesnumberaccelerationstringvideo_output_typestringvideo_rescaling_scalenumbervideo_write_modestringvideo_modality_scalenumberaudio_rescaling_scalenumbercamera_lora_scalenumbercamera_lorastringvideo_qualitystringmatch_input_fpsbooleanvideo_stg_scalenumbervideo_cfg_scalenumbernum_inference_stepsnumbernegative_promptstringenable_prompt_expansionbooleanenable_safety_checkerbooleanaudio_cfg_scalenumberlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberaspect_ratiostringresolutionstringdurationnumberimage_urlstringend_image_urlstringvideo_urlstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fltx-2.3-22b%2Freference-video-to-video%2Flora",
"title": "LTX-2.3 (V2V LoRA) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ltx-2.3-22b/reference-video-to-video/lora.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ltx-2.3-22b/reference-video-to-video/lora",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"fps": {
"title": "Fps",
"description": "The frames per second of the generated video.",
"default": 24,
"type": "number",
"minimum": 1,
"maximum": 60
},
"preprocessor": {
"title": "Preprocessor",
"description": "The preprocessor to use for the generation.",
"default": "none",
"type": "string",
"enum": [
"depth",
"canny",
"pose",
"none"
]
},
"audio_stg_scale": {
"title": "Audio Stg Scale",
"description": "The Spatiotemporal Guidance (STG) scale for the audio. Higher values result in more consistent and focused audio content.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 20
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate audio for the video.",
"default": true,
"type": "boolean"
},
"ic_lora_type": {
"title": "IC-LoRA Type",
"description": "The IC LoRA type to use for the generation.",
"default": "union",
"type": "string",
"enum": [
"match_preprocessor",
"union",
"detailer",
"none"
]
},
"use_multiscale": {
"title": "Use Multiscale",
"description": "Whether to use multi-scale generation. If True, the model will generate the video at a smaller scale first, then use the smaller video to guide the ge",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"video_strength": {
"title": "Video Strength",
"description": "Video conditioning strength. Lower values represent more freedom given to the model to change the video content.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"use_restart_sampling": {
"title": "Use Restart Sampling",
"description": "Whether to use restart sampling. This will inject a small amount of noise during each denoising step, which can help improve the quality of the genera",
"default": false,
"type": "boolean"
},
"audio_modality_scale": {
"title": "Audio Modality Scale",
"description": "The modality scale for the audio. Controls the ratio between video and audio modalities.",
"default": 3,
"type": "number",
"minimum": 0,
"maximum": 10
},
"scheduler": {
"title": "Scheduler",
"description": "The scheduler to use.",
"default": "ltx2",
"type": "string",
"enum": [
"ltx2",
"linear_quadratic",
"beta"
]
},
"match_video_length": {
"title": "Match Video Length",
"description": "When enabled, the number of frames will be calculated based on the video duration and FPS. When disabled, use the specified num_frames.",
"default": true,
"type": "boolean"
},
"audio_strength": {
"title": "Audio Strength",
"description": "Audio conditioning strength. Lower values represent more freedom given to the model to change the audio content.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"distill_lora_first_pass_scale": {
"title": "Distill Lora First Pass Scale",
"description": "The scale of the distill LoRA to use for the first pass. Set to 0 to disable.",
"default": 0.2,
"type": "number",
"minimum": 0,
"maximum": 1
},
"gradient_estimation_gamma": {
"title": "Gradient Estimation Gamma",
"description": "The gamma of gradient estimation during denoising. Set to 0 to disable.",
"default": 2,
"type": "number",
"minimum": 0,
"maximum": 10
},
"distill_lora_second_pass_scale": {
"title": "Distill Lora Second Pass Scale",
"description": "The scale of the distill LoRA to use for the second and subsequent passes.",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1
},
"num_frames": {
"title": "Num Frames",
"description": "The number of frames to generate.",
"default": 121,
"type": "number",
"minimum": 9,
"maximum": 481,
"multipleOf": 1
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular",
"high",
"full"
]
},
"video_output_type": {
"title": "Video Output Type",
"description": "The output type of the generated video.",
"default": "X264 (.mp4)",
"type": "string",
"enum": [
"X264 (.mp4)",
"VP9 (.webm)",
"PRORES4444 (.mov)",
"GIF (.gif)"
]
},
"video_rescaling_scale": {
"title": "Video Rescaling Scale",
"description": "The rescaling scale for the video. Controls the ratio between classifier-free guidance and spatiotemporal guidance.",
"default": 0.7,
"type": "number",
"minimum": 0,
"maximum": 1
},
"video_write_mode": {
"title": "Video Write Mode",
"description": "The write mode of the generated video.",
"default": "balanced",
"type": "string",
"enum": [
"fast",
"balanced",
"small"
]
},
"video_modality_scale": {
"title": "Video Modality Scale",
"description": "The modality scale for the video. Controls the ratio between video and audio modalities.",
"default": 3,
"type": "number",
"minimum": 0,
"maximum": 10
},
"audio_rescaling_scale": {
"title": "Audio Rescaling Scale",
"description": "The rescaling scale for the audio. Controls the ratio between classifier-free guidance and spatiotemporal guidance.",
"default": 0.7,
"type": "number",
"minimum": 0,
"maximum": 1
},
"camera_lora_scale": {
"title": "Camera LoRA Scale",
"description": "The scale of the camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the mod",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"camera_lora": {
"title": "Camera LoRA",
"description": "The camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move th",
"default": "none",
"type": "string",
"enum": [
"dolly_in",
"dolly_out",
"dolly_left",
"dolly_right",
"jib_up",
"jib_down",
"static",
"none"
]
},
"video_quality": {
"title": "Video Quality",
"description": "The quality of the generated video.",
"default": "high",
"type": "string",
"enum": [
"low",
"medium",
"high",
"maximum"
]
},
"match_input_fps": {
"title": "Match Input Fps",
"description": "When true, match the output FPS to the input video's FPS instead of using the default target FPS.",
"default": true,
"type": "boolean"
},
"video_stg_scale": {
"title": "Video Stg Scale",
"description": "The Spatiotemporal Guidance (STG) scale for the video. Higher values result in more consistent and focused video content.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 20
},
"video_cfg_scale": {
"title": "Video Cfg Scale",
"description": "The Classifier-Free Guidance (CFG) scale for the video. Higher values result in more consistent and focused video content.",
"default": 3,
"type": "number",
"minimum": 1,
"maximum": 20
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to use.",
"default": 40,
"type": "number",
"minimum": 8,
"maximum": 50,
"multipleOf": 1
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to generate the video from.",
"default": "news broadcast, 3d animation, computer graphics, pc game, console game, video game, cartoon, childish, watermark, logo, text, on screen text, subtitles, titles, signature, slowmo, static",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Whether to enable prompt expansion.",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the safety checker to block unsafe content.",
"default": true,
"type": "boolean"
},
"audio_cfg_scale": {
"title": "Audio Cfg Scale",
"description": "The Classifier-Free Guidance (CFG) scale for the audio. Higher values result in more consistent and focused audio content.",
"default": 7,
"type": "number",
"minimum": 1,
"maximum": 20
},
"lora_path": {
"title": "LoRA Path",
"description": "URL or Hugging Face path to LoRA weights. Required for this model.",
"type": "string"
},
"lora_scale": {
"title": "LoRA Scale",
"description": "Strength of the LoRA effect.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_2": {
"title": "LoRA Path 2",
"description": "URL or Hugging Face path to a second LoRA.",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA Scale 2",
"description": "Strength of the second LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_3": {
"title": "LoRA Path 3",
"description": "URL or Hugging Face path to a third LoRA.",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA Scale 3",
"description": "Strength of the third LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1080p",
"1440p",
"2160p"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
10
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
},
"video_url": {
"type": "string",
"format": "uri"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"lora_path",
"video_url"
],
"additionalProperties": false
}
LTX-2.3 22B reference-video-to-video — restyle or transform an existing video using depth, canny, or pose preprocessing with native audio generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringfpsnumberpreprocessorstringaudio_stg_scalenumbergenerate_audiobooleanic_lora_typestringuse_multiscalebooleanseedintegervideo_strengthnumberuse_restart_samplingbooleanaudio_modality_scalenumberaudio_strengthnumberschedulerstringmatch_video_lengthbooleandistill_lora_first_pass_scalenumbergradient_estimation_gammanumberdistill_lora_second_pass_scalenumbernum_framesnumberaccelerationstringvideo_output_typestringvideo_rescaling_scalenumbervideo_write_modestringvideo_modality_scalenumberaudio_rescaling_scalenumbercamera_lora_scalenumbercamera_lorastringvideo_qualitystringmatch_input_fpsbooleanvideo_stg_scalenumbervideo_cfg_scalenumbernum_inference_stepsnumbernegative_promptstringenable_prompt_expansionbooleanenable_safety_checkerbooleanaudio_cfg_scalenumberaspect_ratiostringresolutionstringdurationnumberimage_urlstringend_image_urlstringvideo_urlstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fltx-2.3-22b%2Freference-video-to-video",
"title": "LTX-2.3 (V2V Reference) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ltx-2.3-22b/reference-video-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ltx-2.3-22b/reference-video-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"fps": {
"title": "Fps",
"description": "The frames per second of the generated video.",
"default": 24,
"type": "number",
"minimum": 1,
"maximum": 60
},
"preprocessor": {
"title": "Preprocessor",
"description": "The preprocessor to use for the generation.",
"default": "none",
"type": "string",
"enum": [
"depth",
"canny",
"pose",
"none"
]
},
"audio_stg_scale": {
"title": "Audio Stg Scale",
"description": "The Spatiotemporal Guidance (STG) scale for the audio. Higher values result in more consistent and focused audio content.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 20
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate audio for the video.",
"default": true,
"type": "boolean"
},
"ic_lora_type": {
"title": "IC-LoRA Type",
"description": "The IC LoRA type to use for the generation.",
"default": "union",
"type": "string",
"enum": [
"match_preprocessor",
"union",
"detailer",
"none"
]
},
"use_multiscale": {
"title": "Use Multiscale",
"description": "Whether to use multi-scale generation. If True, the model will generate the video at a smaller scale first, then use the smaller video to guide the ge",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"video_strength": {
"title": "Video Strength",
"description": "Video conditioning strength. Lower values represent more freedom given to the model to change the video content.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"use_restart_sampling": {
"title": "Use Restart Sampling",
"description": "Whether to use restart sampling. This will inject a small amount of noise during each denoising step, which can help improve the quality of the genera",
"default": false,
"type": "boolean"
},
"audio_modality_scale": {
"title": "Audio Modality Scale",
"description": "The modality scale for the audio. Controls the ratio between video and audio modalities.",
"default": 3,
"type": "number",
"minimum": 0,
"maximum": 10
},
"audio_strength": {
"title": "Audio Strength",
"description": "Audio conditioning strength. Lower values represent more freedom given to the model to change the audio content.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"scheduler": {
"title": "Scheduler",
"description": "The scheduler to use.",
"default": "ltx2",
"type": "string",
"enum": [
"ltx2",
"linear_quadratic",
"beta"
]
},
"match_video_length": {
"title": "Match Video Length",
"description": "When enabled, the number of frames will be calculated based on the video duration and FPS. When disabled, use the specified num_frames.",
"default": true,
"type": "boolean"
},
"distill_lora_first_pass_scale": {
"title": "Distill Lora First Pass Scale",
"description": "The scale of the distill LoRA to use for the first pass. Set to 0 to disable.",
"default": 0.2,
"type": "number",
"minimum": 0,
"maximum": 1
},
"gradient_estimation_gamma": {
"title": "Gradient Estimation Gamma",
"description": "The gamma of gradient estimation during denoising. Set to 0 to disable.",
"default": 2,
"type": "number",
"minimum": 0,
"maximum": 10
},
"distill_lora_second_pass_scale": {
"title": "Distill Lora Second Pass Scale",
"description": "The scale of the distill LoRA to use for the second and subsequent passes.",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1
},
"num_frames": {
"title": "Num Frames",
"description": "The number of frames to generate.",
"default": 121,
"type": "number",
"minimum": 9,
"maximum": 481,
"multipleOf": 1
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular",
"high",
"full"
]
},
"video_output_type": {
"title": "Video Output Type",
"description": "The output type of the generated video.",
"default": "X264 (.mp4)",
"type": "string",
"enum": [
"X264 (.mp4)",
"VP9 (.webm)",
"PRORES4444 (.mov)",
"GIF (.gif)"
]
},
"video_rescaling_scale": {
"title": "Video Rescaling Scale",
"description": "The rescaling scale for the video. Controls the ratio between classifier-free guidance and spatiotemporal guidance.",
"default": 0.7,
"type": "number",
"minimum": 0,
"maximum": 1
},
"video_write_mode": {
"title": "Video Write Mode",
"description": "The write mode of the generated video.",
"default": "balanced",
"type": "string",
"enum": [
"fast",
"balanced",
"small"
]
},
"video_modality_scale": {
"title": "Video Modality Scale",
"description": "The modality scale for the video. Controls the ratio between video and audio modalities.",
"default": 3,
"type": "number",
"minimum": 0,
"maximum": 10
},
"audio_rescaling_scale": {
"title": "Audio Rescaling Scale",
"description": "The rescaling scale for the audio. Controls the ratio between classifier-free guidance and spatiotemporal guidance.",
"default": 0.7,
"type": "number",
"minimum": 0,
"maximum": 1
},
"camera_lora_scale": {
"title": "Camera LoRA Scale",
"description": "The scale of the camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the mod",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"camera_lora": {
"title": "Camera LoRA",
"description": "The camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move th",
"default": "none",
"type": "string",
"enum": [
"dolly_in",
"dolly_out",
"dolly_left",
"dolly_right",
"jib_up",
"jib_down",
"static",
"none"
]
},
"video_quality": {
"title": "Video Quality",
"description": "The quality of the generated video.",
"default": "high",
"type": "string",
"enum": [
"low",
"medium",
"high",
"maximum"
]
},
"match_input_fps": {
"title": "Match Input Fps",
"description": "When true, match the output FPS to the input video's FPS instead of using the default target FPS.",
"default": true,
"type": "boolean"
},
"video_stg_scale": {
"title": "Video Stg Scale",
"description": "The Spatiotemporal Guidance (STG) scale for the video. Higher values result in more consistent and focused video content.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 20
},
"video_cfg_scale": {
"title": "Video Cfg Scale",
"description": "The Classifier-Free Guidance (CFG) scale for the video. Higher values result in more consistent and focused video content.",
"default": 3,
"type": "number",
"minimum": 1,
"maximum": 20
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to use.",
"default": 40,
"type": "number",
"minimum": 8,
"maximum": 50,
"multipleOf": 1
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to generate the video from.",
"default": "news broadcast, 3d animation, computer graphics, pc game, console game, video game, cartoon, childish, watermark, logo, text, on screen text, subtitles, titles, signature, slowmo, static",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Whether to enable prompt expansion.",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the safety checker to block unsafe content.",
"default": true,
"type": "boolean"
},
"audio_cfg_scale": {
"title": "Audio Cfg Scale",
"description": "The Classifier-Free Guidance (CFG) scale for the audio. Higher values result in more consistent and focused audio content.",
"default": 7,
"type": "number",
"minimum": 1,
"maximum": 20
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1080p",
"1440p",
"2160p"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
10
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
},
"video_url": {
"type": "string",
"format": "uri"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"video_url"
],
"additionalProperties": false
}
LTX-2.3 22B image-to-video — animate a start image with optional end-frame using the full 22B model, with native audio and advanced scheduler controls.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaudio_cfg_scalenumbergenerate_audiobooleanaudio_stg_scalenumberseedintegeruse_multiscalebooleanaudio_modality_scalenumberuse_restart_samplingbooleanend_image_strengthnumberschedulerstringdistill_lora_first_pass_scalenumbergradient_estimation_gammanumberdistill_lora_second_pass_scalenumbernum_framesnumberaccelerationstringvideo_output_typestringvideo_rescaling_scalenumbervideo_qualitystringcamera_lora_scalenumberaudio_rescaling_scalenumbervideo_modality_scalenumbervideo_write_modestringcamera_lorastringimage_strengthnumbervideo_stg_scalenumbervideo_cfg_scalenumbernum_inference_stepsnumbernegative_promptstringenable_prompt_expansionbooleanenable_safety_checkerbooleanfpsnumberinterpolation_directionstringaspect_ratiostringresolutionstringdurationnumberimage_urlstringend_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fltx-2.3-22b%2Fimage-to-video",
"title": "LTX-2.3 22B (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ltx-2.3-22b/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ltx-2.3-22b/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"audio_cfg_scale": {
"title": "Audio Cfg Scale",
"description": "The Classifier-Free Guidance (CFG) scale for the audio. Higher values result in more consistent and focused audio content.",
"default": 7,
"type": "number",
"minimum": 1,
"maximum": 20
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate audio for the video.",
"default": true,
"type": "boolean"
},
"audio_stg_scale": {
"title": "Audio Stg Scale",
"description": "The Spatiotemporal Guidance (STG) scale for the audio. Higher values result in more consistent and focused audio content.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 20
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"use_multiscale": {
"title": "Use Multiscale",
"description": "Whether to use multi-scale generation. If True, the model will generate the video at a smaller scale first, then use the smaller video to guide the ge",
"default": true,
"type": "boolean"
},
"audio_modality_scale": {
"title": "Audio Modality Scale",
"description": "The modality scale for the audio. Controls the ratio between video and audio modalities.",
"default": 3,
"type": "number",
"minimum": 0,
"maximum": 10
},
"use_restart_sampling": {
"title": "Use Restart Sampling",
"description": "Whether to use restart sampling. This will inject a small amount of noise during each denoising step, which can help improve the quality of the genera",
"default": false,
"type": "boolean"
},
"end_image_strength": {
"title": "End Image Strength",
"description": "The strength of the end image to use for the video generation.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"scheduler": {
"title": "Scheduler",
"description": "The scheduler to use.",
"default": "ltx2",
"type": "string",
"enum": [
"ltx2",
"linear_quadratic",
"beta"
]
},
"distill_lora_first_pass_scale": {
"title": "Distill Lora First Pass Scale",
"description": "The scale of the distill LoRA to use for the first pass. Set to 0 to disable.",
"default": 0.2,
"type": "number",
"minimum": 0,
"maximum": 1
},
"gradient_estimation_gamma": {
"title": "Gradient Estimation Gamma",
"description": "The gamma of gradient estimation during denoising. Set to 0 to disable.",
"default": 2,
"type": "number",
"minimum": 0,
"maximum": 10
},
"distill_lora_second_pass_scale": {
"title": "Distill Lora Second Pass Scale",
"description": "The scale of the distill LoRA to use for the second and subsequent passes.",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1
},
"num_frames": {
"title": "Num Frames",
"description": "The number of frames to generate.",
"default": 121,
"type": "number",
"minimum": 9,
"maximum": 481,
"multipleOf": 1
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular",
"high",
"full"
]
},
"video_output_type": {
"title": "Video Output Type",
"description": "The output type of the generated video.",
"default": "X264 (.mp4)",
"type": "string",
"enum": [
"X264 (.mp4)",
"VP9 (.webm)",
"PRORES4444 (.mov)",
"GIF (.gif)"
]
},
"video_rescaling_scale": {
"title": "Video Rescaling Scale",
"description": "The rescaling scale for the video. Controls the ratio between classifier-free guidance and spatiotemporal guidance.",
"default": 0.7,
"type": "number",
"minimum": 0,
"maximum": 1
},
"video_quality": {
"title": "Video Quality",
"description": "The quality of the generated video.",
"default": "high",
"type": "string",
"enum": [
"low",
"medium",
"high",
"maximum"
]
},
"camera_lora_scale": {
"title": "Camera LoRA Scale",
"description": "The scale of the camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the mod",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"audio_rescaling_scale": {
"title": "Audio Rescaling Scale",
"description": "The rescaling scale for the audio. Controls the ratio between classifier-free guidance and spatiotemporal guidance.",
"default": 0.7,
"type": "number",
"minimum": 0,
"maximum": 1
},
"video_modality_scale": {
"title": "Video Modality Scale",
"description": "The modality scale for the video. Controls the ratio between video and audio modalities.",
"default": 3,
"type": "number",
"minimum": 0,
"maximum": 10
},
"video_write_mode": {
"title": "Video Write Mode",
"description": "The write mode of the generated video.",
"default": "balanced",
"type": "string",
"enum": [
"fast",
"balanced",
"small"
]
},
"camera_lora": {
"title": "Camera LoRA",
"description": "The camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move th",
"default": "none",
"type": "string",
"enum": [
"dolly_in",
"dolly_out",
"dolly_left",
"dolly_right",
"jib_up",
"jib_down",
"static",
"none"
]
},
"image_strength": {
"title": "Image Strength",
"description": "The strength of the image to use for the video generation.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"video_stg_scale": {
"title": "Video Stg Scale",
"description": "The Spatiotemporal Guidance (STG) scale for the video. Higher values result in more consistent and focused video content.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 20
},
"video_cfg_scale": {
"title": "Video Cfg Scale",
"description": "The Classifier-Free Guidance (CFG) scale for the video. Higher values result in more consistent and focused video content.",
"default": 3,
"type": "number",
"minimum": 1,
"maximum": 20
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to use.",
"default": 40,
"type": "number",
"minimum": 8,
"maximum": 50,
"multipleOf": 1
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to generate the video from.",
"default": "news broadcast, 3d animation, computer graphics, pc game, console game, video game, cartoon, childish, watermark, logo, text, on screen text, subtitles, titles, signature, slowmo, static",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Whether to enable prompt expansion.",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the safety checker to block unsafe content.",
"default": true,
"type": "boolean"
},
"fps": {
"title": "Fps",
"description": "The frames per second of the generated video.",
"default": 24,
"type": "number",
"minimum": 1,
"maximum": 60
},
"interpolation_direction": {
"title": "Interpolation Direction",
"description": "The direction to interpolate the image sequence in. 'Forward' goes from the start image to the end image, 'Backward' goes from the end image to the st",
"default": "forward",
"type": "string",
"enum": [
"forward",
"backward"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1080p",
"1440p",
"2160p"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
10
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
LTX-2.3 22B text-to-video — flagship Lightricks model with multi-scale generation, advanced scheduler options, and native audio synthesis.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanaudio_stg_scalenumberseedintegeruse_multiscalebooleanaudio_modality_scalenumberuse_restart_samplingbooleanschedulerstringdistill_lora_first_pass_scalenumbergradient_estimation_gammanumberdistill_lora_second_pass_scalenumbernum_framesnumberaccelerationstringvideo_output_typestringvideo_rescaling_scalenumbercamera_lora_scalenumbercamera_lorastringaudio_rescaling_scalenumbervideo_modality_scalenumbervideo_qualitystringvideo_write_modestringvideo_stg_scalenumbervideo_cfg_scalenumbernum_inference_stepsnumbernegative_promptstringenable_prompt_expansionbooleanenable_safety_checkerbooleanfpsnumberaudio_cfg_scalenumberaspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fltx-2.3-22b%2Ftext-to-video",
"title": "LTX-2.3 22B (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ltx-2.3-22b/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ltx-2.3-22b/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate audio for the video.",
"default": true,
"type": "boolean"
},
"audio_stg_scale": {
"title": "Audio Stg Scale",
"description": "The Spatiotemporal Guidance (STG) scale for the audio. Higher values result in more consistent and focused audio content.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 20
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"use_multiscale": {
"title": "Use Multiscale",
"description": "Whether to use multi-scale generation. If True, the model will generate the video at a smaller scale first, then use the smaller video to guide the ge",
"default": true,
"type": "boolean"
},
"audio_modality_scale": {
"title": "Audio Modality Scale",
"description": "The modality scale for the audio. Controls the ratio between video and audio modalities.",
"default": 3,
"type": "number",
"minimum": 0,
"maximum": 10
},
"use_restart_sampling": {
"title": "Use Restart Sampling",
"description": "Whether to use restart sampling. This will inject a small amount of noise during each denoising step, which can help improve the quality of the genera",
"default": false,
"type": "boolean"
},
"scheduler": {
"title": "Scheduler",
"description": "The scheduler to use.",
"default": "ltx2",
"type": "string",
"enum": [
"ltx2",
"linear_quadratic",
"beta"
]
},
"distill_lora_first_pass_scale": {
"title": "Distill Lora First Pass Scale",
"description": "The scale of the distill LoRA to use for the first pass. Set to 0 to disable.",
"default": 0.2,
"type": "number",
"minimum": 0,
"maximum": 1
},
"gradient_estimation_gamma": {
"title": "Gradient Estimation Gamma",
"description": "The gamma of gradient estimation during denoising. Set to 0 to disable.",
"default": 2,
"type": "number",
"minimum": 0,
"maximum": 10
},
"distill_lora_second_pass_scale": {
"title": "Distill Lora Second Pass Scale",
"description": "The scale of the distill LoRA to use for the second and subsequent passes.",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1
},
"num_frames": {
"title": "Num Frames",
"description": "The number of frames to generate.",
"default": 121,
"type": "number",
"minimum": 9,
"maximum": 481,
"multipleOf": 1
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular",
"high",
"full"
]
},
"video_output_type": {
"title": "Video Output Type",
"description": "The output type of the generated video.",
"default": "X264 (.mp4)",
"type": "string",
"enum": [
"X264 (.mp4)",
"VP9 (.webm)",
"PRORES4444 (.mov)",
"GIF (.gif)"
]
},
"video_rescaling_scale": {
"title": "Video Rescaling Scale",
"description": "The rescaling scale for the video. Controls the ratio between classifier-free guidance and spatiotemporal guidance.",
"default": 0.7,
"type": "number",
"minimum": 0,
"maximum": 1
},
"camera_lora_scale": {
"title": "Camera LoRA Scale",
"description": "The scale of the camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the mod",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"camera_lora": {
"title": "Camera LoRA",
"description": "The camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move th",
"default": "none",
"type": "string",
"enum": [
"dolly_in",
"dolly_out",
"dolly_left",
"dolly_right",
"jib_up",
"jib_down",
"static",
"none"
]
},
"audio_rescaling_scale": {
"title": "Audio Rescaling Scale",
"description": "The rescaling scale for the audio. Controls the ratio between classifier-free guidance and spatiotemporal guidance.",
"default": 0.7,
"type": "number",
"minimum": 0,
"maximum": 1
},
"video_modality_scale": {
"title": "Video Modality Scale",
"description": "The modality scale for the video. Controls the ratio between video and audio modalities.",
"default": 3,
"type": "number",
"minimum": 0,
"maximum": 10
},
"video_quality": {
"title": "Video Quality",
"description": "The quality of the generated video.",
"default": "high",
"type": "string",
"enum": [
"low",
"medium",
"high",
"maximum"
]
},
"video_write_mode": {
"title": "Video Write Mode",
"description": "The write mode of the generated video.",
"default": "balanced",
"type": "string",
"enum": [
"fast",
"balanced",
"small"
]
},
"video_stg_scale": {
"title": "Video Stg Scale",
"description": "The Spatiotemporal Guidance (STG) scale for the video. Higher values result in more consistent and focused video content.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 20
},
"video_cfg_scale": {
"title": "Video Cfg Scale",
"description": "The Classifier-Free Guidance (CFG) scale for the video. Higher values result in more consistent and focused video content.",
"default": 3,
"type": "number",
"minimum": 1,
"maximum": 20
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to use.",
"default": 40,
"type": "number",
"minimum": 8,
"maximum": 50,
"multipleOf": 1
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to generate the video from.",
"default": "news broadcast, 3d animation, computer graphics, pc game, console game, video game, cartoon, childish, watermark, logo, text, on screen text, subtitles, titles, signature, slowmo, static",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Whether to enable prompt expansion.",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the safety checker to block unsafe content.",
"default": true,
"type": "boolean"
},
"fps": {
"title": "Fps",
"description": "The frames per second of the generated video.",
"default": 24,
"type": "number",
"minimum": 1,
"maximum": 60
},
"audio_cfg_scale": {
"title": "Audio Cfg Scale",
"description": "The Classifier-Free Guidance (CFG) scale for the audio. Higher values result in more consistent and focused audio content.",
"default": 7,
"type": "number",
"minimum": 1,
"maximum": 20
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1080p",
"1440p",
"2160p"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
10
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Distilled LTX-2.3 22B image-to-video with LoRA support — animate a start image using a custom fine-tune with fast distilled generation and audio synthesis.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleancamera_lorastringnum_framesnumbervideo_qualitystringcamera_lora_scalenumberaccelerationstringvideo_output_typestringseedintegeruse_multiscalebooleanvideo_write_modestringdistill_lora_second_pass_scalenumberend_image_strengthnumberimage_strengthnumberschedulerstringnegative_promptstringenable_prompt_expansionbooleanenable_safety_checkerbooleanfpsnumberinterpolation_directionstringlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberaspect_ratiostringresolutionstringdurationnumberimage_urlstringend_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fltx-2.3-22b%2Fdistilled%2Fimage-to-video%2Flora",
"title": "LTX-2.3 Distilled (I2V LoRA) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ltx-2.3-22b/distilled/image-to-video/lora.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ltx-2.3-22b/distilled/image-to-video/lora",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate audio for the video.",
"default": true,
"type": "boolean"
},
"camera_lora": {
"title": "Camera LoRA",
"description": "The camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move th",
"default": "none",
"type": "string",
"enum": [
"dolly_in",
"dolly_out",
"dolly_left",
"dolly_right",
"jib_up",
"jib_down",
"static",
"none"
]
},
"num_frames": {
"title": "Num Frames",
"description": "The number of frames to generate.",
"default": 121,
"type": "number",
"minimum": 9,
"maximum": 481,
"multipleOf": 1
},
"video_quality": {
"title": "Video Quality",
"description": "The quality of the generated video.",
"default": "high",
"type": "string",
"enum": [
"low",
"medium",
"high",
"maximum"
]
},
"camera_lora_scale": {
"title": "Camera LoRA Scale",
"description": "The scale of the camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the mod",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use.",
"default": "none",
"type": "string",
"enum": [
"none",
"regular",
"high",
"full"
]
},
"video_output_type": {
"title": "Video Output Type",
"description": "The output type of the generated video.",
"default": "X264 (.mp4)",
"type": "string",
"enum": [
"X264 (.mp4)",
"VP9 (.webm)",
"PRORES4444 (.mov)",
"GIF (.gif)"
]
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"use_multiscale": {
"title": "Use Multiscale",
"description": "Whether to use multi-scale generation. If True, the model will generate the video at a smaller scale first, then use the smaller video to guide the ge",
"default": true,
"type": "boolean"
},
"video_write_mode": {
"title": "Video Write Mode",
"description": "The write mode of the generated video.",
"default": "balanced",
"type": "string",
"enum": [
"fast",
"balanced",
"small"
]
},
"distill_lora_second_pass_scale": {
"title": "Distill Lora Second Pass Scale",
"description": "The scale of the distill LoRA to use for the second and subsequent passes.",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1
},
"end_image_strength": {
"title": "End Image Strength",
"description": "The strength of the end image to use for the video generation.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"image_strength": {
"title": "Image Strength",
"description": "The strength of the image to use for the video generation.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"scheduler": {
"title": "Scheduler",
"description": "The scheduler to use.",
"default": "ltx2",
"type": "string",
"enum": [
"ltx2",
"linear_quadratic",
"beta"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to generate the video from.",
"default": "news broadcast, 3d animation, computer graphics, pc game, console game, video game, cartoon, childish, watermark, logo, text, on screen text, subtitles, titles, signature, slowmo, static",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Whether to enable prompt expansion.",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the safety checker to block unsafe content.",
"default": true,
"type": "boolean"
},
"fps": {
"title": "Fps",
"description": "The frames per second of the generated video.",
"default": 24,
"type": "number",
"minimum": 1,
"maximum": 60
},
"interpolation_direction": {
"title": "Interpolation Direction",
"description": "The direction to interpolate the image sequence in. 'Forward' goes from the start image to the end image, 'Backward' goes from the end image to the st",
"default": "forward",
"type": "string",
"enum": [
"forward",
"backward"
]
},
"lora_path": {
"title": "LoRA Path",
"description": "URL or Hugging Face path to LoRA weights. Required for this model.",
"type": "string"
},
"lora_scale": {
"title": "LoRA Scale",
"description": "Strength of the LoRA effect.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_2": {
"title": "LoRA Path 2",
"description": "URL or Hugging Face path to a second LoRA.",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA Scale 2",
"description": "Strength of the second LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_3": {
"title": "LoRA Path 3",
"description": "URL or Hugging Face path to a third LoRA.",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA Scale 3",
"description": "Strength of the third LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1080p",
"1440p"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
10
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"lora_path",
"image_url"
],
"additionalProperties": false
}
Distilled LTX-2.3 22B image-to-video — animate a start image into a smooth clip up to 1440p with camera LoRA control and native audio.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringdistill_lora_second_pass_scalenumbercamera_lorastringnum_framesnumbervideo_qualitystringcamera_lora_scalenumberaccelerationstringgenerate_audiobooleanseedintegeruse_multiscalebooleanvideo_output_typestringvideo_write_modestringend_image_strengthnumberimage_strengthnumberschedulerstringnegative_promptstringenable_prompt_expansionbooleanenable_safety_checkerbooleanfpsnumberinterpolation_directionstringaspect_ratiostringresolutionstringdurationnumberimage_urlstringend_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fltx-2.3-22b%2Fdistilled%2Fimage-to-video",
"title": "LTX-2.3 Distilled (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ltx-2.3-22b/distilled/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ltx-2.3-22b/distilled/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"distill_lora_second_pass_scale": {
"title": "Distill Lora Second Pass Scale",
"description": "The scale of the distill LoRA to use for the second and subsequent passes.",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1
},
"camera_lora": {
"title": "Camera LoRA",
"description": "The camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move th",
"default": "none",
"type": "string",
"enum": [
"dolly_in",
"dolly_out",
"dolly_left",
"dolly_right",
"jib_up",
"jib_down",
"static",
"none"
]
},
"num_frames": {
"title": "Num Frames",
"description": "The number of frames to generate.",
"default": 121,
"type": "number",
"minimum": 9,
"maximum": 481,
"multipleOf": 1
},
"video_quality": {
"title": "Video Quality",
"description": "The quality of the generated video.",
"default": "high",
"type": "string",
"enum": [
"low",
"medium",
"high",
"maximum"
]
},
"camera_lora_scale": {
"title": "Camera LoRA Scale",
"description": "The scale of the camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the mod",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use.",
"default": "none",
"type": "string",
"enum": [
"none",
"regular",
"high",
"full"
]
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate audio for the video.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"use_multiscale": {
"title": "Use Multiscale",
"description": "Whether to use multi-scale generation. If True, the model will generate the video at a smaller scale first, then use the smaller video to guide the ge",
"default": true,
"type": "boolean"
},
"video_output_type": {
"title": "Video Output Type",
"description": "The output type of the generated video.",
"default": "X264 (.mp4)",
"type": "string",
"enum": [
"X264 (.mp4)",
"VP9 (.webm)",
"PRORES4444 (.mov)",
"GIF (.gif)"
]
},
"video_write_mode": {
"title": "Video Write Mode",
"description": "The write mode of the generated video.",
"default": "balanced",
"type": "string",
"enum": [
"fast",
"balanced",
"small"
]
},
"end_image_strength": {
"title": "End Image Strength",
"description": "The strength of the end image to use for the video generation.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"image_strength": {
"title": "Image Strength",
"description": "The strength of the image to use for the video generation.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"scheduler": {
"title": "Scheduler",
"description": "The scheduler to use.",
"default": "ltx2",
"type": "string",
"enum": [
"ltx2",
"linear_quadratic",
"beta"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to generate the video from.",
"default": "news broadcast, 3d animation, computer graphics, pc game, console game, video game, cartoon, childish, watermark, logo, text, on screen text, subtitles, titles, signature, slowmo, static",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Whether to enable prompt expansion.",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the safety checker to block unsafe content.",
"default": true,
"type": "boolean"
},
"fps": {
"title": "Fps",
"description": "The frames per second of the generated video.",
"default": 24,
"type": "number",
"minimum": 1,
"maximum": 60
},
"interpolation_direction": {
"title": "Interpolation Direction",
"description": "The direction to interpolate the image sequence in. 'Forward' goes from the start image to the end image, 'Backward' goes from the end image to the st",
"default": "forward",
"type": "string",
"enum": [
"forward",
"backward"
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1080p",
"1440p"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
10
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
Distilled LTX-2.3 22B text-to-video with LoRA support — combine a custom fine-tune with fast distilled generation and native audio synthesis.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringdistill_lora_second_pass_scalenumbercamera_lorastringnum_framesnumbervideo_qualitystringaccelerationstringcamera_lora_scalenumbergenerate_audiobooleanseedintegeruse_multiscalebooleanvideo_output_typestringvideo_write_modestringschedulerstringnegative_promptstringenable_prompt_expansionbooleanenable_safety_checkerbooleanfpsnumberlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberaspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fltx-2.3-22b%2Fdistilled%2Ftext-to-video%2Flora",
"title": "LTX-2.3 Distilled (T2V LoRA) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ltx-2.3-22b/distilled/text-to-video/lora.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ltx-2.3-22b/distilled/text-to-video/lora",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"distill_lora_second_pass_scale": {
"title": "Distill Lora Second Pass Scale",
"description": "The scale of the distill LoRA to use for the second and subsequent passes.",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1
},
"camera_lora": {
"title": "Camera LoRA",
"description": "The camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move th",
"default": "none",
"type": "string",
"enum": [
"dolly_in",
"dolly_out",
"dolly_left",
"dolly_right",
"jib_up",
"jib_down",
"static",
"none"
]
},
"num_frames": {
"title": "Num Frames",
"description": "The number of frames to generate.",
"default": 121,
"type": "number",
"minimum": 9,
"maximum": 481,
"multipleOf": 1
},
"video_quality": {
"title": "Video Quality",
"description": "The quality of the generated video.",
"default": "high",
"type": "string",
"enum": [
"low",
"medium",
"high",
"maximum"
]
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use.",
"default": "none",
"type": "string",
"enum": [
"none",
"regular",
"high",
"full"
]
},
"camera_lora_scale": {
"title": "Camera LoRA Scale",
"description": "The scale of the camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the mod",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate audio for the video.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"use_multiscale": {
"title": "Use Multiscale",
"description": "Whether to use multi-scale generation. If True, the model will generate the video at a smaller scale first, then use the smaller video to guide the ge",
"default": true,
"type": "boolean"
},
"video_output_type": {
"title": "Video Output Type",
"description": "The output type of the generated video.",
"default": "X264 (.mp4)",
"type": "string",
"enum": [
"X264 (.mp4)",
"VP9 (.webm)",
"PRORES4444 (.mov)",
"GIF (.gif)"
]
},
"video_write_mode": {
"title": "Video Write Mode",
"description": "The write mode of the generated video.",
"default": "balanced",
"type": "string",
"enum": [
"fast",
"balanced",
"small"
]
},
"scheduler": {
"title": "Scheduler",
"description": "The scheduler to use.",
"default": "ltx2",
"type": "string",
"enum": [
"ltx2",
"linear_quadratic",
"beta"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to generate the video from.",
"default": "news broadcast, 3d animation, computer graphics, pc game, console game, video game, cartoon, childish, watermark, logo, text, on screen text, subtitles, titles, signature, slowmo, static",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Whether to enable prompt expansion.",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the safety checker to block unsafe content.",
"default": true,
"type": "boolean"
},
"fps": {
"title": "Fps",
"description": "The frames per second of the generated video.",
"default": 24,
"type": "number",
"minimum": 1,
"maximum": 60
},
"lora_path": {
"title": "LoRA Path",
"description": "URL or Hugging Face path to LoRA weights. Required for this model.",
"type": "string"
},
"lora_scale": {
"title": "LoRA Scale",
"description": "Strength of the LoRA effect.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_2": {
"title": "LoRA Path 2",
"description": "URL or Hugging Face path to a second LoRA.",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA Scale 2",
"description": "Strength of the second LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_3": {
"title": "LoRA Path 3",
"description": "URL or Hugging Face path to a third LoRA.",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA Scale 3",
"description": "Strength of the third LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1080p",
"1440p"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
10
]
}
},
"required": [
"model_id",
"prompt",
"lora_path"
],
"additionalProperties": false
}
Distilled LTX-2.3 22B text-to-video — fast, high-fidelity generation up to 1440p with native audio synthesis.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanuse_multiscalebooleanschedulerstringdistill_lora_second_pass_scalenumbernum_framesnumberaccelerationstringcamera_lorastringcamera_lora_scalenumbervideo_output_typestringvideo_qualitystringvideo_write_modestringnegative_promptstringenable_prompt_expansionbooleanenable_safety_checkerbooleanfpsnumberseedintegeraspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fltx-2.3-22b%2Fdistilled%2Ftext-to-video",
"title": "LTX-2.3 Distilled (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ltx-2.3-22b/distilled/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ltx-2.3-22b/distilled/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate audio for the video.",
"default": true,
"type": "boolean"
},
"use_multiscale": {
"title": "Use Multiscale",
"description": "Whether to use multi-scale generation. If True, the model will generate the video at a smaller scale first, then use the smaller video to guide the ge",
"default": true,
"type": "boolean"
},
"scheduler": {
"title": "Scheduler",
"description": "The scheduler to use.",
"default": "ltx2",
"type": "string",
"enum": [
"ltx2",
"linear_quadratic",
"beta"
]
},
"distill_lora_second_pass_scale": {
"title": "Distill Lora Second Pass Scale",
"description": "The scale of the distill LoRA to use for the second and subsequent passes.",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1
},
"num_frames": {
"title": "Num Frames",
"description": "The number of frames to generate.",
"default": 121,
"type": "number",
"minimum": 9,
"maximum": 481,
"multipleOf": 1
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use.",
"default": "none",
"type": "string",
"enum": [
"none",
"regular",
"high",
"full"
]
},
"camera_lora": {
"title": "Camera LoRA",
"description": "The camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move th",
"default": "none",
"type": "string",
"enum": [
"dolly_in",
"dolly_out",
"dolly_left",
"dolly_right",
"jib_up",
"jib_down",
"static",
"none"
]
},
"camera_lora_scale": {
"title": "Camera LoRA Scale",
"description": "The scale of the camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the mod",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"video_output_type": {
"title": "Video Output Type",
"description": "The output type of the generated video.",
"default": "X264 (.mp4)",
"type": "string",
"enum": [
"X264 (.mp4)",
"VP9 (.webm)",
"PRORES4444 (.mov)",
"GIF (.gif)"
]
},
"video_quality": {
"title": "Video Quality",
"description": "The quality of the generated video.",
"default": "high",
"type": "string",
"enum": [
"low",
"medium",
"high",
"maximum"
]
},
"video_write_mode": {
"title": "Video Write Mode",
"description": "The write mode of the generated video.",
"default": "balanced",
"type": "string",
"enum": [
"fast",
"balanced",
"small"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to generate the video from.",
"default": "news broadcast, 3d animation, computer graphics, pc game, console game, video game, cartoon, childish, watermark, logo, text, on screen text, subtitles, titles, signature, slowmo, static",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Whether to enable prompt expansion.",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the safety checker to block unsafe content.",
"default": true,
"type": "boolean"
},
"fps": {
"title": "Fps",
"description": "The frames per second of the generated video.",
"default": 24,
"type": "number",
"minimum": 1,
"maximum": 60
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1080p",
"1440p"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
10
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Distilled LTX-2.3 22B video-to-video with LoRA support — apply a custom fine-tune style while restyling reference footage with audio generation.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringpreprocessorstringgenerate_audiobooleanic_lora_typestringuse_multiscalebooleanseedintegervideo_strengthnumberschedulerstringmatch_video_lengthbooleanaudio_strengthnumberdistill_lora_second_pass_scalenumbernum_framesnumberaccelerationstringvideo_write_modestringvideo_qualitystringvideo_output_typestringcamera_lora_scalenumbercamera_lorastringmatch_input_fpsbooleannegative_promptstringenable_prompt_expansionbooleanenable_safety_checkerbooleanfpsnumberlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberaspect_ratiostringresolutionstringdurationnumberimage_urlstringend_image_urlstringvideo_urlstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fltx-2.3-22b%2Fdistilled%2Freference-video-to-video%2Flora",
"title": "LTX-2.3 Distilled (V2V LoRA) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ltx-2.3-22b/distilled/reference-video-to-video/lora.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ltx-2.3-22b/distilled/reference-video-to-video/lora",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"preprocessor": {
"title": "Preprocessor",
"description": "The preprocessor to use for the generation.",
"default": "none",
"type": "string",
"enum": [
"depth",
"canny",
"pose",
"none"
]
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate audio for the video.",
"default": true,
"type": "boolean"
},
"ic_lora_type": {
"title": "IC-LoRA Type",
"description": "The IC LoRA type to use for the generation.",
"default": "union",
"type": "string",
"enum": [
"match_preprocessor",
"union",
"detailer",
"none"
]
},
"use_multiscale": {
"title": "Use Multiscale",
"description": "Whether to use multi-scale generation. If True, the model will generate the video at a smaller scale first, then use the smaller video to guide the ge",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"video_strength": {
"title": "Video Strength",
"description": "Video conditioning strength. Lower values represent more freedom given to the model to change the video content.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"scheduler": {
"title": "Scheduler",
"description": "The scheduler to use.",
"default": "ltx2",
"type": "string",
"enum": [
"ltx2",
"linear_quadratic",
"beta"
]
},
"match_video_length": {
"title": "Match Video Length",
"description": "When enabled, the number of frames will be calculated based on the video duration and FPS. When disabled, use the specified num_frames.",
"default": true,
"type": "boolean"
},
"audio_strength": {
"title": "Audio Strength",
"description": "Audio conditioning strength. Lower values represent more freedom given to the model to change the audio content.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"distill_lora_second_pass_scale": {
"title": "Distill Lora Second Pass Scale",
"description": "The scale of the distill LoRA to use for the second and subsequent passes.",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1
},
"num_frames": {
"title": "Num Frames",
"description": "The number of frames to generate.",
"default": 121,
"type": "number",
"minimum": 9,
"maximum": 481,
"multipleOf": 1
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use.",
"default": "none",
"type": "string",
"enum": [
"none",
"regular",
"high",
"full"
]
},
"video_write_mode": {
"title": "Video Write Mode",
"description": "The write mode of the generated video.",
"default": "balanced",
"type": "string",
"enum": [
"fast",
"balanced",
"small"
]
},
"video_quality": {
"title": "Video Quality",
"description": "The quality of the generated video.",
"default": "high",
"type": "string",
"enum": [
"low",
"medium",
"high",
"maximum"
]
},
"video_output_type": {
"title": "Video Output Type",
"description": "The output type of the generated video.",
"default": "X264 (.mp4)",
"type": "string",
"enum": [
"X264 (.mp4)",
"VP9 (.webm)",
"PRORES4444 (.mov)",
"GIF (.gif)"
]
},
"camera_lora_scale": {
"title": "Camera LoRA Scale",
"description": "The scale of the camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the mod",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"camera_lora": {
"title": "Camera LoRA",
"description": "The camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move th",
"default": "none",
"type": "string",
"enum": [
"dolly_in",
"dolly_out",
"dolly_left",
"dolly_right",
"jib_up",
"jib_down",
"static",
"none"
]
},
"match_input_fps": {
"title": "Match Input Fps",
"description": "When true, match the output FPS to the input video's FPS instead of using the default target FPS.",
"default": true,
"type": "boolean"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to generate the video from.",
"default": "news broadcast, 3d animation, computer graphics, pc game, console game, video game, cartoon, childish, watermark, logo, text, on screen text, subtitles, titles, signature, slowmo, static",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Whether to enable prompt expansion.",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the safety checker to block unsafe content.",
"default": true,
"type": "boolean"
},
"fps": {
"title": "Fps",
"description": "The frames per second of the generated video.",
"default": 24,
"type": "number",
"minimum": 1,
"maximum": 60
},
"lora_path": {
"title": "LoRA Path",
"description": "URL or Hugging Face path to LoRA weights. Required for this model.",
"type": "string"
},
"lora_scale": {
"title": "LoRA Scale",
"description": "Strength of the LoRA effect.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_2": {
"title": "LoRA Path 2",
"description": "URL or Hugging Face path to a second LoRA.",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA Scale 2",
"description": "Strength of the second LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"lora_path_3": {
"title": "LoRA Path 3",
"description": "URL or Hugging Face path to a third LoRA.",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA Scale 3",
"description": "Strength of the third LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 0.05
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1080p",
"1440p"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
10
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
},
"video_url": {
"type": "string",
"format": "uri"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"lora_path",
"video_url"
],
"additionalProperties": false
}
Distilled LTX-2.3 22B video-to-video — restyle reference footage faster and cheaper than full V2V, with depth/canny/pose preprocessors and audio output.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringpreprocessorstringgenerate_audiobooleanic_lora_typestringuse_multiscalebooleanseedintegervideo_strengthnumberaudio_strengthnumberschedulerstringmatch_video_lengthbooleandistill_lora_second_pass_scalenumbernum_framesnumberaccelerationstringvideo_write_modestringvideo_qualitystringvideo_output_typestringcamera_lora_scalenumbercamera_lorastringmatch_input_fpsbooleannegative_promptstringenable_prompt_expansionbooleanenable_safety_checkerbooleanfpsnumberaspect_ratiostringresolutionstringdurationnumberimage_urlstringend_image_urlstringvideo_urlstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fltx-2.3-22b%2Fdistilled%2Freference-video-to-video",
"title": "LTX-2.3 Distilled (V2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ltx-2.3-22b/distilled/reference-video-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ltx-2.3-22b/distilled/reference-video-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"preprocessor": {
"title": "Preprocessor",
"description": "The preprocessor to use for the generation.",
"default": "none",
"type": "string",
"enum": [
"depth",
"canny",
"pose",
"none"
]
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate audio for the video.",
"default": true,
"type": "boolean"
},
"ic_lora_type": {
"title": "IC-LoRA Type",
"description": "The IC LoRA type to use for the generation.",
"default": "union",
"type": "string",
"enum": [
"match_preprocessor",
"union",
"detailer",
"none"
]
},
"use_multiscale": {
"title": "Use Multiscale",
"description": "Whether to use multi-scale generation. If True, the model will generate the video at a smaller scale first, then use the smaller video to guide the ge",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"video_strength": {
"title": "Video Strength",
"description": "Video conditioning strength. Lower values represent more freedom given to the model to change the video content.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"audio_strength": {
"title": "Audio Strength",
"description": "Audio conditioning strength. Lower values represent more freedom given to the model to change the audio content.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"scheduler": {
"title": "Scheduler",
"description": "The scheduler to use.",
"default": "ltx2",
"type": "string",
"enum": [
"ltx2",
"linear_quadratic",
"beta"
]
},
"match_video_length": {
"title": "Match Video Length",
"description": "When enabled, the number of frames will be calculated based on the video duration and FPS. When disabled, use the specified num_frames.",
"default": true,
"type": "boolean"
},
"distill_lora_second_pass_scale": {
"title": "Distill Lora Second Pass Scale",
"description": "The scale of the distill LoRA to use for the second and subsequent passes.",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1
},
"num_frames": {
"title": "Num Frames",
"description": "The number of frames to generate.",
"default": 121,
"type": "number",
"minimum": 9,
"maximum": 481,
"multipleOf": 1
},
"acceleration": {
"title": "Acceleration",
"description": "The acceleration level to use.",
"default": "none",
"type": "string",
"enum": [
"none",
"regular",
"high",
"full"
]
},
"video_write_mode": {
"title": "Video Write Mode",
"description": "The write mode of the generated video.",
"default": "balanced",
"type": "string",
"enum": [
"fast",
"balanced",
"small"
]
},
"video_quality": {
"title": "Video Quality",
"description": "The quality of the generated video.",
"default": "high",
"type": "string",
"enum": [
"low",
"medium",
"high",
"maximum"
]
},
"video_output_type": {
"title": "Video Output Type",
"description": "The output type of the generated video.",
"default": "X264 (.mp4)",
"type": "string",
"enum": [
"X264 (.mp4)",
"VP9 (.webm)",
"PRORES4444 (.mov)",
"GIF (.gif)"
]
},
"camera_lora_scale": {
"title": "Camera LoRA Scale",
"description": "The scale of the camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the mod",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 1
},
"camera_lora": {
"title": "Camera LoRA",
"description": "The camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move th",
"default": "none",
"type": "string",
"enum": [
"dolly_in",
"dolly_out",
"dolly_left",
"dolly_right",
"jib_up",
"jib_down",
"static",
"none"
]
},
"match_input_fps": {
"title": "Match Input Fps",
"description": "When true, match the output FPS to the input video's FPS instead of using the default target FPS.",
"default": true,
"type": "boolean"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to generate the video from.",
"default": "news broadcast, 3d animation, computer graphics, pc game, console game, video game, cartoon, childish, watermark, logo, text, on screen text, subtitles, titles, signature, slowmo, static",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Whether to enable prompt expansion.",
"default": true,
"type": "boolean"
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the safety checker to block unsafe content.",
"default": true,
"type": "boolean"
},
"fps": {
"title": "Fps",
"description": "The frames per second of the generated video.",
"default": 24,
"type": "number",
"minimum": 1,
"maximum": 60
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1080p",
"1440p"
]
},
"duration": {
"type": "number",
"enum": [
3,
4,
5,
6,
7,
8,
10
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
},
"video_url": {
"type": "string",
"format": "uri"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"video_url"
],
"additionalProperties": false
}
LTX-2.3 image-to-video fast endpoint — animate a start image into a 6–20 second clip up to 4K with optional end frame and native audio.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringfpsnumbergenerate_audiobooleanaspect_ratiostringresolutionstringdurationnumberimage_urlstringend_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fltx-2.3%2Fimage-to-video%2Ffast",
"title": "LTX-2.3 I2V Fast generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ltx-2.3/image-to-video/fast.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ltx-2.3/image-to-video/fast",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"fps": {
"title": "Fps",
"description": "The frames per second of the generated video",
"default": 25,
"type": "number",
"enum": [
24,
25,
48,
50
]
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate audio for the generated video",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"16:9",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"1080p",
"1440p",
"2160p"
]
},
"duration": {
"type": "number",
"enum": [
6,
8,
10,
12,
14,
16,
18,
20
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
LTX-2.3 text-to-video fast endpoint — ultra-quick generation up to 4K with 6–20 second clips and native audio synthesis.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanfpsnumberaspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fltx-2.3%2Ftext-to-video%2Ffast",
"title": "LTX-2.3 T2V Fast generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ltx-2.3/text-to-video/fast.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ltx-2.3/text-to-video/fast",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate audio for the generated video",
"default": true,
"type": "boolean"
},
"fps": {
"title": "Fps",
"description": "The frames per second of the generated video",
"default": 25,
"type": "number",
"enum": [
24,
25,
48,
50
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"1080p",
"1440p",
"2160p"
]
},
"duration": {
"type": "number",
"enum": [
6,
8,
10,
12,
14,
16,
18,
20
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Luma Ray 3.2 — cinematic video generation on Luma's Agents API, with HDR output, looping, and 5 or 10 second clips.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringloopbooleanhdrbooleanexr_exportbooleanaspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=luma%2Fray-3.2",
"title": "Luma Ray 3.2 generation request",
"description": "Request body accepted by POST /api/v1/generate for luma/ray-3.2.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "luma/ray-3.2",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"loop": {
"title": "Loop",
"description": "Whether the video should loop (end of video is blended with the beginning)",
"default": false,
"type": "boolean"
},
"hdr": {
"title": "HDR",
"description": "HDR-encoded output (720p/1080p, 5s only). Doubles the cost.",
"default": false,
"type": "boolean"
},
"exr_export": {
"title": "EXR Export",
"description": "Export HDR frames as EXR — requires HDR. HDR + EXR costs 3× the SDR price.",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"540p",
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
5,
10
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Luma Ray 3.2 image-to-video — animate a start image into a cinematic clip, with optional end-frame control and HDR output.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringloopbooleanhdrbooleanexr_exportbooleanend_image_urlstringaspect_ratiostringresolutionstringdurationnumberimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=luma%2Fray-3.2%2Fimage-to-video",
"title": "Luma Ray 3.2 (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for luma/ray-3.2/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "luma/ray-3.2/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"loop": {
"title": "Loop",
"description": "Whether the video should loop (end of video is blended with the beginning)",
"default": false,
"type": "boolean"
},
"hdr": {
"title": "HDR",
"description": "HDR-encoded output (720p/1080p, 5s only). Doubles the cost.",
"default": false,
"type": "boolean"
},
"exr_export": {
"title": "EXR Export",
"description": "Export HDR frames as EXR — requires HDR. HDR + EXR costs 3× the SDR price.",
"default": false,
"type": "boolean"
},
"end_image_url": {
"title": "End Image Url",
"description": "Final image to end the video with. Handled by the End Frame canvas slot.",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"4:3",
"3:4",
"21:9",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"540p",
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
5
]
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
MiniMax H3 Max animates an optional first and last frame into a 5–15 second video at 480P or 768P.
Pricing: Launch pricing through September 7; standard rates apply automatically afterward.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringresolutionstringseedintegerenable_safety_checkerbooleanend_image_urlstringimage_urlstringdurationintegerprompt_expansion_modestring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=minimax%2Fh3-max%2Fimage-to-video",
"title": "MiniMax H3 Max (Image) generation request",
"description": "Request body accepted by POST /api/v1/generate for minimax/h3-max/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "minimax/h3-max/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"minLength": 1,
"maxLength": 50000
},
"resolution": {
"type": "string",
"enum": [
"480P",
"768P"
]
},
"seed": {
"title": "Seed",
"type": "integer"
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"end_image_url": {
"type": "string",
"format": "uri"
},
"image_url": {
"type": "string",
"format": "uri"
},
"duration": {
"type": "integer",
"title": "Duration",
"default": 5,
"minimum": 5,
"maximum": 15,
"multipleOf": 1,
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"prompt_expansion_mode": {
"title": "Prompt Expansion Mode",
"description": "MiniMax prompt-expansion strategy.",
"default": "balanced",
"type": "string"
}
},
"required": [
"model_id",
"prompt",
"prompt_expansion_mode"
],
"additionalProperties": false
}
MiniMax H3 Max reference-to-video combines image, video, and audio references into a consistent 5–15 second scene.
Pricing: Launch video pricing through September 7; reference inputs beyond the included 4,096-token allowance are billed separately.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringresolutionstringseedintegerreference_audio_urlsarrayreference_video_urlsarrayenable_safety_checkerbooleanreference_image_urlsarraydurationintegeraspect_ratiostringprompt_expansion_modestring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=minimax%2Fh3-max%2Freference-to-video",
"title": "MiniMax H3 Max (Reference) generation request",
"description": "Request body accepted by POST /api/v1/generate for minimax/h3-max/reference-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "minimax/h3-max/reference-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"minLength": 1,
"maxLength": 50000
},
"resolution": {
"type": "string",
"enum": [
"480P",
"768P"
]
},
"seed": {
"title": "Seed",
"type": "integer"
},
"reference_audio_urls": {
"title": "Reference Audio URLs",
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 3
},
"reference_video_urls": {
"title": "Reference Video URLs",
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 3
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 9
},
"duration": {
"type": "integer",
"title": "Duration",
"default": 5,
"minimum": 5,
"maximum": 15,
"multipleOf": 1,
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"adaptive",
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"prompt_expansion_mode": {
"title": "Prompt Expansion Mode",
"description": "MiniMax prompt-expansion strategy.",
"default": "balanced",
"type": "string"
}
},
"required": [
"model_id",
"prompt",
"prompt_expansion_mode"
],
"additionalProperties": false
}
MiniMax H3 Max text-to-video with 5–15 second clips, cinematic prompt expansion, and 480P or 768P output.
Pricing: Launch pricing through September 7; standard rates apply automatically afterward.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringresolutionstringseedintegerenable_safety_checkerbooleandurationintegeraspect_ratiostringprompt_expansion_modestring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=minimax%2Fh3-max%2Ftext-to-video",
"title": "MiniMax H3 Max (Text) generation request",
"description": "Request body accepted by POST /api/v1/generate for minimax/h3-max/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "minimax/h3-max/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"minLength": 1,
"maxLength": 50000
},
"resolution": {
"type": "string",
"enum": [
"480P",
"768P"
]
},
"seed": {
"title": "Seed",
"type": "integer"
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"duration": {
"type": "integer",
"title": "Duration",
"default": 5,
"minimum": 5,
"maximum": 15,
"multipleOf": 1,
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"prompt_expansion_mode": {
"title": "Prompt Expansion Mode",
"description": "MiniMax prompt-expansion strategy.",
"default": "balanced",
"type": "string"
}
},
"required": [
"model_id",
"prompt",
"prompt_expansion_mode"
],
"additionalProperties": false
}
MiniMax H3 Max image-to-video with optional first and last frames plus one to three custom LoRA adapters at 480P or 768P.
Pricing: Launch pricing through September 7; standard rates apply automatically afterward.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringresolutionstringseedintegerenable_safety_checkerbooleandurationintegerimage_urlstringend_image_urlstringprompt_expansion_modestringlorasarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=minimax%2Fh3-max%2Fimage-to-video%2Flora",
"title": "MiniMax H3 Max LoRA (Image) generation request",
"description": "Request body accepted by POST /api/v1/generate for minimax/h3-max/image-to-video/lora.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "minimax/h3-max/image-to-video/lora",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"minLength": 1,
"maxLength": 50000
},
"resolution": {
"type": "string",
"enum": [
"480P",
"768P"
]
},
"seed": {
"title": "Seed",
"type": "integer"
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"duration": {
"type": "integer",
"title": "Duration",
"default": 5,
"minimum": 5,
"maximum": 15,
"multipleOf": 1,
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
},
"prompt_expansion_mode": {
"title": "Prompt Expansion Mode",
"description": "MiniMax prompt-expansion strategy.",
"default": "balanced",
"type": "string"
},
"loras": {
"type": "array",
"maxItems": 3,
"items": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"weight_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"scale": {
"type": "number",
"minimum": 0,
"maximum": 4,
"default": 1
}
},
"required": [
"path"
],
"additionalProperties": false
},
"title": "LoRA Adapters (JSON)",
"description": "One to three LoRA adapters. Each entry requires path and may include weight_name and scale from 0 to 4.",
"minItems": 1
}
},
"required": [
"model_id",
"prompt",
"prompt_expansion_mode",
"loras"
],
"additionalProperties": false
}
MiniMax H3 Max text-to-video with one to three custom LoRA adapters, cinematic prompt expansion, and 5–15 second output at 480P or 768P.
Pricing: Launch pricing through September 7; standard rates apply automatically afterward.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringresolutionstringseedintegerenable_safety_checkerbooleandurationintegeraspect_ratiostringprompt_expansion_modestringlorasarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=minimax%2Fh3-max%2Ftext-to-video%2Flora",
"title": "MiniMax H3 Max LoRA (Text) generation request",
"description": "Request body accepted by POST /api/v1/generate for minimax/h3-max/text-to-video/lora.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "minimax/h3-max/text-to-video/lora",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"minLength": 1,
"maxLength": 50000
},
"resolution": {
"type": "string",
"enum": [
"480P",
"768P"
]
},
"seed": {
"title": "Seed",
"type": "integer"
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"duration": {
"type": "integer",
"title": "Duration",
"default": 5,
"minimum": 5,
"maximum": 15,
"multipleOf": 1,
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"prompt_expansion_mode": {
"title": "Prompt Expansion Mode",
"description": "MiniMax prompt-expansion strategy.",
"default": "balanced",
"type": "string"
},
"loras": {
"type": "array",
"maxItems": 3,
"items": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"weight_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"scale": {
"type": "number",
"minimum": 0,
"maximum": 4,
"default": 1
}
},
"required": [
"path"
],
"additionalProperties": false
},
"title": "LoRA Adapters (JSON)",
"description": "One to three LoRA adapters. Each entry requires path and may include weight_name and scale from 0 to 4.",
"minItems": 1
}
},
"required": [
"model_id",
"prompt",
"prompt_expansion_mode",
"loras"
],
"additionalProperties": false
}
Animate a still image with keyframed camera orbit, elevation, and distance. Preserve the scene while directing camera motion, including signed full turns and 1080P refinement.
Pricing: 75% launch discount through September 14 (UTC): $0.0125/480P, $0.02/768P, $0.04/1080P per second. Standard rates afterward: $0.05/$0.08/$0.16 per second. 1080P refines native 768P.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringdurationnumberresolutionstringseedintegerenable_safety_checkerbooleanprompt_expansion_modestringimage_urlstringcamera_trajectoryarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=minimax%2Fh3-max%2Fmulti-angle%2Fimage-to-video",
"title": "MiniMax H3 Max Multi Angle generation request",
"description": "Request body accepted by POST /api/v1/generate for minimax/h3-max/multi-angle/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "minimax/h3-max/multi-angle/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"maxLength": 50000
},
"duration": {
"type": "number",
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"resolution": {
"type": "string",
"enum": [
"480P",
"768P",
"1080P"
]
},
"seed": {
"title": "Seed",
"type": "integer"
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"prompt_expansion_mode": {
"title": "Prompt Expansion Mode",
"description": "MiniMax prompt-expansion strategy.",
"default": "balanced",
"type": "string"
},
"image_url": {
"type": "string",
"format": "uri"
},
"camera_trajectory": {
"type": "array",
"minItems": 2,
"maxItems": 12,
"description": "Ordered camera poses; times must strictly increase. Signed azimuth travel is limited to 32 total turns.",
"items": {
"type": "object",
"required": [
"time",
"azimuth",
"elevation",
"distance"
],
"additionalProperties": false,
"properties": {
"time": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"azimuth": {
"type": "number"
},
"elevation": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"distance": {
"type": "number",
"exclusiveMinimum": 0
}
}
}
}
},
"required": [
"model_id",
"prompt_expansion_mode",
"image_url"
],
"additionalProperties": false
}
MiniMax H3 Max Turbo animates an optional first and last frame with improved prompt adherence and faster 480P or 768P generation.
Pricing: 75% launch discount through September 7; standard rates apply automatically afterward.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringresolutionstringseedintegerenable_safety_checkerbooleandurationintegerimage_urlstringend_image_urlstringprompt_expansion_modestring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=minimax%2Fh3-max-turbo%2Fimage-to-video",
"title": "MiniMax H3 Max Turbo (Image) generation request",
"description": "Request body accepted by POST /api/v1/generate for minimax/h3-max-turbo/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "minimax/h3-max-turbo/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"minLength": 1,
"maxLength": 50000
},
"resolution": {
"type": "string",
"enum": [
"480P",
"768P"
]
},
"seed": {
"title": "Seed",
"type": "integer"
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"duration": {
"type": "integer",
"title": "Duration",
"default": 5,
"minimum": 5,
"maximum": 15,
"multipleOf": 1,
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
},
"prompt_expansion_mode": {
"title": "Prompt Expansion Mode",
"description": "MiniMax prompt-expansion strategy.",
"default": "balanced",
"type": "string"
}
},
"required": [
"model_id",
"prompt",
"prompt_expansion_mode"
],
"additionalProperties": false
}
MiniMax H3 Max Turbo text-to-video with stronger prompt adherence, high-throughput generation, and 5–15 second output at 480P or 768P.
Pricing: 75% launch discount through September 7; standard rates apply automatically afterward.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringresolutionstringseedintegerenable_safety_checkerbooleandurationintegeraspect_ratiostringprompt_expansion_modestring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=minimax%2Fh3-max-turbo%2Ftext-to-video",
"title": "MiniMax H3 Max Turbo (Text) generation request",
"description": "Request body accepted by POST /api/v1/generate for minimax/h3-max-turbo/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "minimax/h3-max-turbo/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"minLength": 1,
"maxLength": 50000
},
"resolution": {
"type": "string",
"enum": [
"480P",
"768P"
]
},
"seed": {
"title": "Seed",
"type": "integer"
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"duration": {
"type": "integer",
"title": "Duration",
"default": 5,
"minimum": 5,
"maximum": 15,
"multipleOf": 1,
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"aspect_ratio": {
"type": "string",
"enum": [
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"prompt_expansion_mode": {
"title": "Prompt Expansion Mode",
"description": "MiniMax prompt-expansion strategy.",
"default": "balanced",
"type": "string"
}
},
"required": [
"model_id",
"prompt",
"prompt_expansion_mode"
],
"additionalProperties": false
}
MiniMax Hailuo-02 Standard image-to-video — animate a start image to a 6 or 10 second cinematic clip.
Pricing: $0.045/s @768P · ~$0.017/s @512P
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringresolutionstringprompt_optimizerbooleanend_image_urlstringdurationnumberimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fminimax%2Fhailuo-02%2Fstandard%2Fimage-to-video",
"title": "MiniMax Hailuo-02 (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/minimax/hailuo-02/standard/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/minimax/hailuo-02/standard/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"resolution": {
"title": "Resolution",
"description": "The resolution of the generated video.",
"default": "768P",
"type": "string",
"enum": [
"512P",
"768P"
]
},
"prompt_optimizer": {
"title": "Prompt Optimizer",
"description": "Whether to use the model's prompt optimizer",
"default": true,
"type": "boolean"
},
"end_image_url": {
"title": "End Image Url",
"description": "Handled by the End Frame canvas slot.",
"type": "string"
},
"duration": {
"type": "number",
"enum": [
6,
10
]
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
MiniMax Hailuo-02 Standard text-to-video — 6 or 10 second cinematic clips with prompt optimizer.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringprompt_optimizerbooleandurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fminimax%2Fhailuo-02%2Fstandard%2Ftext-to-video",
"title": "MiniMax Hailuo-02 (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/minimax/hailuo-02/standard/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/minimax/hailuo-02/standard/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"prompt_optimizer": {
"title": "Prompt Optimizer",
"description": "Whether to use the model's prompt optimizer",
"default": true,
"type": "boolean"
},
"duration": {
"type": "number",
"enum": [
6,
10
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
MiniMax Hailuo-02 Pro image-to-video — high-quality 1080p image animation with optional end frame.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringprompt_optimizerbooleanend_image_urlstringimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fminimax%2Fhailuo-02%2Fpro%2Fimage-to-video",
"title": "MiniMax Hailuo-02 Pro (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/minimax/hailuo-02/pro/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/minimax/hailuo-02/pro/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"prompt_optimizer": {
"title": "Prompt Optimizer",
"description": "Whether to use the model's prompt optimizer",
"default": true,
"type": "boolean"
},
"end_image_url": {
"title": "End Image Url",
"description": "Handled by the End Frame canvas slot.",
"type": "string"
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
MiniMax Hailuo-02 Pro text-to-video — high-quality 1080p generation with prompt optimizer.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringprompt_optimizerboolean
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fminimax%2Fhailuo-02%2Fpro%2Ftext-to-video",
"title": "MiniMax Hailuo-02 Pro (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/minimax/hailuo-02/pro/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/minimax/hailuo-02/pro/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"prompt_optimizer": {
"title": "Prompt Optimizer",
"description": "Whether to use the model's prompt optimizer",
"default": true,
"type": "boolean"
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Mirelo SFX v1 video-to-audio — analyses visuals and returns a matching audio file you can layer onto the original video.
Pricing: $0.007 / second of output PER SAMPLE (fal-published) — 2 samples by default.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_samplesnumberdurationnumberseedintegertext_promptstringvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=mirelo-ai%2Fsfx-v1%2Fvideo-to-audio",
"title": "Mirelo SFX (Video → Audio) generation request",
"description": "Request body accepted by POST /api/v1/generate for mirelo-ai/sfx-v1/video-to-audio.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "mirelo-ai/sfx-v1/video-to-audio",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"num_samples": {
"title": "Num Samples",
"description": "Number of audio variations to generate.",
"default": 2,
"type": "number",
"minimum": 2,
"maximum": 8,
"multipleOf": 1
},
"duration": {
"title": "Duration",
"description": "Duration of the generated audio in seconds.",
"default": 10,
"type": "number",
"minimum": 1,
"maximum": 10
},
"seed": {
"title": "Seed",
"description": "Seed for reproducibility. If not provided, a random seed will be used.",
"default": 2105,
"type": "integer",
"minimum": 1
},
"text_prompt": {
"title": "Text Prompt",
"description": "Optional text description to guide the audio generation.",
"type": "string"
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"video_url"
],
"additionalProperties": false
}
Mirelo SFX v1 video-to-video — analyses the visuals and generates matching sound effects baked directly into the output video.
Pricing: $0.007 / second of output PER SAMPLE (fal-published) — 2 samples by default.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_samplesnumberdurationnumberseedintegertext_promptstringvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=mirelo-ai%2Fsfx-v1%2Fvideo-to-video",
"title": "Mirelo SFX (Video → Video) generation request",
"description": "Request body accepted by POST /api/v1/generate for mirelo-ai/sfx-v1/video-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "mirelo-ai/sfx-v1/video-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"num_samples": {
"title": "Num Samples",
"description": "Number of audio variations to generate.",
"default": 2,
"type": "number",
"minimum": 2,
"maximum": 8,
"multipleOf": 1
},
"duration": {
"title": "Duration",
"description": "Duration of the generated audio in seconds.",
"default": 10,
"type": "number",
"minimum": 1,
"maximum": 10
},
"seed": {
"title": "Seed",
"description": "Seed for reproducibility. If not provided, a random seed will be used.",
"default": 2105,
"type": "integer",
"minimum": 1
},
"text_prompt": {
"title": "Text Prompt",
"description": "Optional text description to guide the audio generation.",
"type": "string"
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"video_url"
],
"additionalProperties": false
}
Mirelo SFX v1.5 video-to-audio — improved generation quality with a start-offset option for precise audio timing control.
Pricing: $0.01 / second of output (fal-published; no per-sample clause).
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnum_samplesnumberdurationnumberstart_offsetnumberseedintegertext_promptstringvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=mirelo-ai%2Fsfx-v1.5%2Fvideo-to-audio",
"title": "Mirelo SFX v1.5 (Video → Audio) generation request",
"description": "Request body accepted by POST /api/v1/generate for mirelo-ai/sfx-v1.5/video-to-audio.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "mirelo-ai/sfx-v1.5/video-to-audio",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"num_samples": {
"title": "Num Samples",
"description": "Number of audio variations to generate.",
"default": 2,
"type": "number",
"minimum": 2,
"maximum": 8,
"multipleOf": 1
},
"duration": {
"title": "Duration",
"description": "Duration of the generated audio in seconds.",
"default": 10,
"type": "number",
"minimum": 1,
"maximum": 10
},
"start_offset": {
"title": "Start Offset",
"description": "Start offset in seconds for audio generation.",
"default": 0,
"type": "number",
"minimum": 0
},
"seed": {
"title": "Seed",
"description": "Seed for reproducibility. If not provided, a random seed will be used.",
"default": 8069,
"type": "integer",
"minimum": 1
},
"text_prompt": {
"title": "Text Prompt",
"description": "Optional text description to guide the audio generation.",
"type": "string"
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"video_url"
],
"additionalProperties": false
}
Mirelo SFX v1.6 video-to-video — richer, higher-fidelity sound effects baked into output video with extended duration support via sliding-window generation.
Pricing: $0.01 / second of output (fal-published; no per-sample clause).
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringseedintegernum_samplesnumberdurationnumbertext_promptstringvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=mirelo-ai%2Fsfx1.6%2Fvideo-to-video",
"title": "Mirelo SFX v1.6 (Video → Video) generation request",
"description": "Request body accepted by POST /api/v1/generate for mirelo-ai/sfx1.6/video-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "mirelo-ai/sfx1.6/video-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"seed": {
"title": "Seed",
"description": "Seed for generation. -1 or None for random.",
"type": "integer",
"minimum": -1
},
"num_samples": {
"title": "Num Samples",
"description": "Number of variations to generate.",
"default": 1,
"type": "number",
"minimum": 1,
"maximum": 4,
"multipleOf": 1
},
"duration": {
"title": "Duration",
"description": "Duration of the generated SFX in seconds. Values >10 use sliding-window extended generation.",
"default": 10,
"type": "number",
"minimum": 1,
"maximum": 60
},
"text_prompt": {
"title": "Text Prompt",
"description": "Optional text prompt guiding generation.",
"type": "string"
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"video_url"
],
"additionalProperties": false
}
MMAudio v2 — generates precisely synced sound effects and ambient audio that match every visual detail of an uploaded video.
Pricing: $0.001/s of generated audio.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringdurationnumbernum_stepsnumbercfg_strengthnumbernegative_promptstringmask_away_clipbooleanseedintegervideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fmmaudio-v2",
"title": "MMAudio v2 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/mmaudio-v2.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/mmaudio-v2",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"duration": {
"title": "Duration",
"description": "Duration of the audio to generate in seconds.",
"default": 8,
"type": "number",
"minimum": 1,
"maximum": 30
},
"num_steps": {
"title": "Num Steps",
"description": "Number of diffusion steps (more = higher quality but slower).",
"default": 25,
"type": "number",
"minimum": 4,
"maximum": 50,
"multipleOf": 1
},
"cfg_strength": {
"title": "CFG Strength",
"description": "Classifier-free guidance strength.",
"default": 4.5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Audio characteristics to avoid.",
"default": "",
"type": "string"
},
"mask_away_clip": {
"title": "Mask Away Clip",
"description": "Disable the CLIP visual stream (text-driven mode only).",
"default": false,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Seed for reproducibility.",
"type": "integer",
"minimum": 0,
"maximum": 65535
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"video_url"
],
"additionalProperties": false
}
Omnihuman 1.5 from ByteDance animates a portrait image driven by an audio clip, producing full-body talking video with natural facial motion.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringmask_urlstringturbo_modebooleanresolutionstringimage_urlstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fbytedance%2Fomnihuman%2Fv1.5",
"title": "Omnihuman 1.5 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/bytedance/omnihuman/v1.5.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/bytedance/omnihuman/v1.5",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"mask_url": {
"title": "Mask URL",
"description": "Optional mask image URL — only the person in the white area will speak.",
"type": "string"
},
"turbo_mode": {
"title": "Turbo Mode",
"description": "Generate faster with a slight quality trade-off.",
"default": false,
"type": "boolean"
},
"resolution": {
"type": "string",
"enum": [
"1080p",
"720p"
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"image_url",
"audio_url"
],
"additionalProperties": false
}
PixVerse Lipsync — sync a portrait video to provided audio or TTS-generated speech with natural head movement and cinematic lip sync.
Pricing: $0.04/s of output + $0.24 per 100 chars for TTS (only when no reference audio is attached). Output length follows the uploaded video; fal doesn't document a max, so 30s is an assumed cap.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringtextstringvoice_idstringvideo_urlstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fpixverse%2Flipsync",
"title": "PixVerse Lipsync generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/pixverse/lipsync.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/pixverse/lipsync",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"text": {
"title": "Text",
"description": "Text content for TTS when audio_url is not provided",
"type": "string"
},
"voice_id": {
"title": "Voice Id",
"description": "Voice to use for TTS when audio_url is not provided",
"default": "Auto",
"type": "string",
"enum": [
"Emily",
"James",
"Isabella",
"Liam",
"Chloe",
"Adrian",
"Harper",
"Ava",
"Sophia",
"Julia",
"Mason",
"Jack",
"Oliver",
"Ethan",
"Auto"
]
},
"video_url": {
"type": "string",
"format": "uri"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"video_url"
],
"additionalProperties": false
}
PixVerse Sound Effects — generate and bake matching sound effects into a silent video, with the option to preserve any existing audio.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringoriginal_sound_switchbooleanvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fpixverse%2Fsound-effects",
"title": "PixVerse Sound Effects generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/pixverse/sound-effects.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/pixverse/sound-effects",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"original_sound_switch": {
"title": "Original Sound Switch",
"description": "Whether to keep the original audio from the video",
"default": false,
"type": "boolean"
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"video_url"
],
"additionalProperties": false
}
PixVerse Swap — replace a person, object, or background in any video by uploading a reference image, with optional original audio preservation.
Pricing: $0.15 per clip at 360p/540p or $0.20 at 720p for up to 5 seconds; every tier costs exactly 2× when the source video is longer than 5 seconds.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringmodestringkeyframe_idnumberoriginal_sound_switchbooleanseedintegerresolutionstringimage_urlstringvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fpixverse%2Fswap",
"title": "PixVerse Swap generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/pixverse/swap.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/pixverse/swap",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"mode": {
"title": "Swap Target",
"description": "Choose whether the replacement image should swap a person, an object, or the video background.",
"default": "person",
"type": "string",
"enum": [
"person",
"object",
"background"
]
},
"keyframe_id": {
"title": "Mapping Keyframe",
"description": "Frame used to map the replacement. PixVerse normalizes the source to 24 FPS, so frame 24 is approximately one second into the video. The maximum is source duration × 24.",
"default": 1,
"type": "number",
"minimum": 1,
"multipleOf": 1
},
"original_sound_switch": {
"title": "Keep Original Sound",
"description": "Keep the audio track from the source video in the generated result.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Optional random seed for a repeatable swap.",
"type": "integer"
},
"resolution": {
"type": "string",
"enum": [
"360p",
"540p",
"720p"
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"image_url",
"video_url"
],
"additionalProperties": false
}
PixVerse v4 image-to-video — animate a start image with camera movement controls and style presets at an affordable rate.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringcamera_movementstringstylestringnegative_promptstringseedintegerresolutionstringdurationnumberimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fpixverse%2Fv4%2Fimage-to-video",
"title": "PixVerse v4 (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/pixverse/v4/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/pixverse/v4/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"camera_movement": {
"title": "Camera Movement",
"description": "The type of camera movement to apply to the video",
"type": "string",
"enum": [
"horizontal_left",
"horizontal_right",
"vertical_up",
"vertical_down",
"zoom_in",
"zoom_out",
"crane_up",
"quickly_zoom_in",
"quickly_zoom_out",
"smooth_zoom_in",
"camera_rotation",
"robo_arm",
"super_dolly_out",
"whip_pan",
"hitchcock",
"left_follow",
"right_follow",
"pan_left",
"pan_right",
"fix_bg"
]
},
"style": {
"title": "Style",
"description": "The style of the generated video",
"type": "string",
"enum": [
"anime",
"3d_animation",
"clay",
"comic",
"cyberpunk"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt to be used for the generation",
"default": "",
"type": "string"
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same video every time.",
"type": "integer"
},
"resolution": {
"type": "string",
"enum": [
"360p",
"540p",
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
5,
8
]
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
PixVerse v4 text-to-video — fast, affordable video generation with style presets and 5 or 8 second clip options.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringseedintegerstylestringnegative_promptstringaspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fpixverse%2Fv4%2Ftext-to-video",
"title": "PixVerse v4 (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/pixverse/v4/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/pixverse/v4/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same video every time.",
"type": "integer"
},
"style": {
"title": "Style",
"description": "The style of the generated video",
"type": "string",
"enum": [
"anime",
"3d_animation",
"clay",
"comic",
"cyberpunk"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt to be used for the generation",
"default": "",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"360p",
"540p",
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
5,
8
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
PixVerse v4.5 image-to-video — animate a start image with camera movement controls and style presets.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringcamera_movementstringstylestringnegative_promptstringseedintegerresolutionstringdurationnumberimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fpixverse%2Fv4.5%2Fimage-to-video",
"title": "PixVerse v4.5 (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/pixverse/v4.5/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/pixverse/v4.5/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"camera_movement": {
"title": "Camera Movement",
"description": "The type of camera movement to apply to the video",
"type": "string",
"enum": [
"horizontal_left",
"horizontal_right",
"vertical_up",
"vertical_down",
"zoom_in",
"zoom_out",
"crane_up",
"quickly_zoom_in",
"quickly_zoom_out",
"smooth_zoom_in",
"camera_rotation",
"robo_arm",
"super_dolly_out",
"whip_pan",
"hitchcock",
"left_follow",
"right_follow",
"pan_left",
"pan_right",
"fix_bg"
]
},
"style": {
"title": "Style",
"description": "The style of the generated video",
"type": "string",
"enum": [
"anime",
"3d_animation",
"clay",
"comic",
"cyberpunk"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt to be used for the generation",
"default": "",
"type": "string"
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same video every time.",
"type": "integer"
},
"resolution": {
"type": "string",
"enum": [
"360p",
"540p",
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
5,
8
]
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
PixVerse v4.5 text-to-video — improved PixVerse generation with style presets at a moderate price point.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringseedintegerstylestringnegative_promptstringaspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fpixverse%2Fv4.5%2Ftext-to-video",
"title": "PixVerse v4.5 (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/pixverse/v4.5/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/pixverse/v4.5/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same video every time.",
"type": "integer"
},
"style": {
"title": "Style",
"description": "The style of the generated video",
"type": "string",
"enum": [
"anime",
"3d_animation",
"clay",
"comic",
"cyberpunk"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt to be used for the generation",
"default": "",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"360p",
"540p",
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
5,
8
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
PixVerse v5.5 text-to-video — flat per-video pricing with style presets, thinking mode, and multi-clip support for 5, 8, or 10 second clips.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstylestringthinking_typestringnegative_promptstringseedintegergenerate_audio_switchbooleangenerate_multi_clip_switchbooleanaspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fpixverse%2Fv5.5%2Ftext-to-video",
"title": "PixVerse v5.5 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/pixverse/v5.5/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/pixverse/v5.5/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"style": {
"title": "Style",
"description": "The style of the generated video",
"type": "string",
"enum": [
"anime",
"3d_animation",
"clay",
"comic",
"cyberpunk"
]
},
"thinking_type": {
"title": "Thinking Type",
"description": "Prompt optimization mode: 'enabled' to optimize, 'disabled' to turn off, 'auto' for model decision",
"type": "string",
"enum": [
"enabled",
"disabled",
"auto"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt to be used for the generation",
"default": "",
"type": "string"
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same video every time.",
"type": "integer"
},
"generate_audio_switch": {
"title": "Generate Audio Switch",
"description": "Enable audio generation (BGM, SFX, dialogue)",
"default": false,
"type": "boolean"
},
"generate_multi_clip_switch": {
"title": "Generate Multi Clip Switch",
"description": "Enable multi-clip generation with dynamic camera changes",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"360p",
"540p",
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
5,
8,
10
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
PixVerse v5.5 image-to-video — animate a start image with style presets, thinking mode, multi-clip generation, and native audio.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstylestringthinking_typestringnegative_promptstringseedintegergenerate_audio_switchbooleangenerate_multi_clip_switchbooleanresolutionstringdurationnumberimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fpixverse%2Fv5.5%2Fimage-to-video",
"title": "PixVerse v5.5 (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/pixverse/v5.5/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/pixverse/v5.5/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"style": {
"title": "Style",
"description": "The style of the generated video",
"type": "string",
"enum": [
"anime",
"3d_animation",
"clay",
"comic",
"cyberpunk"
]
},
"thinking_type": {
"title": "Thinking Type",
"description": "Prompt optimization mode: 'enabled' to optimize, 'disabled' to turn off, 'auto' for model decision",
"type": "string",
"enum": [
"enabled",
"disabled",
"auto"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt to be used for the generation",
"default": "",
"type": "string"
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same video every time.",
"type": "integer"
},
"generate_audio_switch": {
"title": "Generate Audio Switch",
"description": "Enable audio generation (BGM, SFX, dialogue)",
"default": false,
"type": "boolean"
},
"generate_multi_clip_switch": {
"title": "Generate Multi Clip Switch",
"description": "Enable multi-clip generation with dynamic camera changes",
"default": false,
"type": "boolean"
},
"resolution": {
"type": "string",
"enum": [
"360p",
"540p",
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
5,
8,
10
]
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
PixVerse v6 image-to-video — animate a start image with style presets, thinking mode, multi-clip generation, and native audio.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstylestringthinking_typestringnegative_promptstringseedintegergenerate_audio_switchbooleangenerate_multi_clip_switchbooleanresolutionstringdurationnumberimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fpixverse%2Fv6%2Fimage-to-video",
"title": "PixVerse v6 (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/pixverse/v6/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/pixverse/v6/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"style": {
"title": "Style",
"description": "The style of the generated video",
"type": "string",
"enum": [
"anime",
"3d_animation",
"clay",
"comic",
"cyberpunk"
]
},
"thinking_type": {
"title": "Thinking Type",
"description": "Prompt optimization mode: 'enabled' to optimize, 'disabled' to turn off, 'auto' for model decision",
"type": "string",
"enum": [
"enabled",
"disabled",
"auto"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt to be used for the generation",
"default": "",
"type": "string"
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same video every time.",
"type": "integer"
},
"generate_audio_switch": {
"title": "Generate Audio Switch",
"description": "Enable audio generation (BGM, SFX, dialogue)",
"default": false,
"type": "boolean"
},
"generate_multi_clip_switch": {
"title": "Generate Multi Clip Switch",
"description": "Enable multi-clip generation with dynamic camera changes",
"default": false,
"type": "boolean"
},
"resolution": {
"type": "string",
"enum": [
"360p",
"540p",
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
PixVerse v6 text-to-video — cinematic generation with per-second pricing, style presets, thinking mode, and native audio synthesis.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstylestringthinking_typestringnegative_promptstringseedintegergenerate_audio_switchbooleangenerate_multi_clip_switchbooleanaspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fpixverse%2Fv6%2Ftext-to-video",
"title": "PixVerse v6 (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/pixverse/v6/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/pixverse/v6/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"style": {
"title": "Style",
"description": "The style of the generated video",
"type": "string",
"enum": [
"anime",
"3d_animation",
"clay",
"comic",
"cyberpunk"
]
},
"thinking_type": {
"title": "Thinking Type",
"description": "Prompt optimization mode: 'enabled' to optimize, 'disabled' to turn off, 'auto' for model decision",
"type": "string",
"enum": [
"enabled",
"disabled",
"auto"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt to be used for the generation",
"default": "",
"type": "string"
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same video every time.",
"type": "integer"
},
"generate_audio_switch": {
"title": "Generate Audio Switch",
"description": "Enable audio generation (BGM, SFX, dialogue)",
"default": false,
"type": "boolean"
},
"generate_multi_clip_switch": {
"title": "Generate Multi Clip Switch",
"description": "Enable multi-clip generation with dynamic camera changes",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4",
"2:3",
"3:2",
"21:9"
]
},
"resolution": {
"type": "string",
"enum": [
"360p",
"540p",
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
PixVerse v6 Extend — continue an existing video clip forward with a prompt, maintaining visual style and optionally generating native audio.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstylestringnegative_promptstringseedintegergenerate_audio_switchbooleanresolutionstringdurationnumbervideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fpixverse%2Fv6%2Fextend",
"title": "PixVerse v6 Extend generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/pixverse/v6/extend.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/pixverse/v6/extend",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"style": {
"title": "Style",
"description": "The style of the extended video",
"type": "string",
"enum": [
"anime",
"3d_animation",
"clay",
"comic",
"cyberpunk"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt to be used for the generation",
"default": "",
"type": "string"
},
"seed": {
"title": "Seed",
"description": "Random seed for generation",
"type": "integer"
},
"generate_audio_switch": {
"title": "Generate Audio Switch",
"description": "Enable audio generation (BGM, SFX, dialogue).",
"default": false,
"type": "boolean"
},
"resolution": {
"type": "string",
"enum": [
"360p",
"540p",
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"video_url"
],
"additionalProperties": false
}
PixVerse v6 Transition — generate a cinematic video that smoothly transitions from a start image to an end image, with optional audio and multi-clip support.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstylestringthinking_typestringnegative_promptstringseedintegergenerate_audio_switchbooleangenerate_multi_clip_switchbooleanaspect_ratiostringresolutionstringdurationnumberimage_urlstringend_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fpixverse%2Fv6%2Ftransition",
"title": "PixVerse v6 Transition generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/pixverse/v6/transition.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/pixverse/v6/transition",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"style": {
"title": "Style",
"description": "The style of the generated video",
"type": "string",
"enum": [
"anime",
"3d_animation",
"clay",
"comic",
"cyberpunk"
]
},
"thinking_type": {
"title": "Thinking Type",
"description": "Prompt optimization mode: 'enabled' to optimize, 'disabled' to turn off, 'auto' for model decision",
"type": "string",
"enum": [
"enabled",
"disabled",
"auto"
]
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt to be used for the generation",
"default": "",
"type": "string"
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of the model will output the same video every time.",
"type": "integer"
},
"generate_audio_switch": {
"title": "Generate Audio Switch",
"description": "Enable audio generation (BGM, SFX, dialogue)",
"default": false,
"type": "boolean"
},
"generate_multi_clip_switch": {
"title": "Generate Multi Clip Switch",
"description": "Enable multi-clip generation with dynamic camera changes",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"4:3",
"1:1",
"3:4",
"9:16",
"2:3",
"3:2",
"21:9"
]
},
"resolution": {
"type": "string",
"enum": [
"360p",
"540p",
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url",
"end_image_url"
],
"additionalProperties": false
}
RIFE fills in smooth interpolated frames between two keyframe images, multiplying frame rate for silky-smooth motion output.
Pricing: Flat ~2 credits/job (fal: $0.0013/compute-second).
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringstart_image_urlstringoutput_typestringnum_framesnumberfpsnumberoutput_formatstringinclude_startbooleaninclude_endbooleanend_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Frife",
"title": "RIFE Frame Interpolation generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/rife.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/rife",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"start_image_url": {
"type": "string",
"format": "uri",
"title": "Start Image URL",
"description": "Handled by the Start Image canvas slot."
},
"output_type": {
"title": "Output Type",
"description": "Output as individual interpolated frames or a video clip.",
"default": "images",
"type": "string",
"enum": [
"images",
"video"
]
},
"num_frames": {
"title": "Num Frames",
"description": "Number of interpolated frames to generate between start and end.",
"default": 1,
"type": "number",
"minimum": 1,
"maximum": 64,
"multipleOf": 1
},
"fps": {
"title": "FPS",
"description": "Frames per second for the output video (only when Output Type is 'video').",
"default": 8,
"type": "number",
"minimum": 1,
"maximum": 60,
"multipleOf": 1
},
"output_format": {
"title": "Output Format",
"description": "Image format (only when Output Type is 'images').",
"default": "jpeg",
"type": "string",
"enum": [
"jpeg",
"png"
]
},
"include_start": {
"title": "Include Start",
"description": "Include the start keyframe in the output.",
"default": false,
"type": "boolean"
},
"include_end": {
"title": "Include End",
"description": "Include the end keyframe in the output.",
"default": false,
"type": "boolean"
},
"end_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"start_image_url",
"end_image_url"
],
"additionalProperties": false
}
SAM Audio visual separation — isolates a specific sound source from background audio in a video, returning both tracks separately.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringmask_video_urlstringoutput_formatstringaccelerationstringreranking_candidatesnumbermax_chunk_durationnumberchunk_overlapnumbervideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fsam-audio%2Fvisual-separate",
"title": "SAM Audio (Isolation) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/sam-audio/visual-separate.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/sam-audio/visual-separate",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"mask_video_url": {
"title": "Mask Video URL",
"description": "Optional mask video URL — black = target sound source, white = background.",
"type": "string"
},
"output_format": {
"title": "Output Format",
"description": "Output audio format.",
"default": "wav",
"type": "string",
"enum": [
"wav",
"mp3"
]
},
"acceleration": {
"title": "Acceleration",
"description": "Speed/quality trade-off.",
"default": "balanced",
"type": "string",
"enum": [
"fast",
"balanced",
"quality"
]
},
"reranking_candidates": {
"title": "Reranking Candidates",
"description": "Number of candidates to generate and rank. Higher = better quality but more cost.",
"default": 1,
"type": "number",
"minimum": 1,
"maximum": 4,
"multipleOf": 1
},
"max_chunk_duration": {
"title": "Max Chunk Duration",
"description": "Max audio duration (seconds) per processing pass. Longer audio is chunked.",
"default": 60,
"type": "number",
"minimum": 10,
"maximum": 60,
"multipleOf": 1
},
"chunk_overlap": {
"title": "Chunk Overlap",
"description": "Overlap between chunks in seconds for crossfade blending.",
"default": 5,
"type": "number",
"minimum": 0,
"maximum": 30
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"video_url"
],
"additionalProperties": false
}
ByteDance Seedance 2.0 image-to-video — animate a start image into a cinematic clip with synchronized native audio and optional end-frame control.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanseedintegeraspect_ratiostringresolutionstringdurationnumberimage_urlstringend_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bytedance%2Fseedance-2.0%2Fimage-to-video",
"title": "Seedance 2.0 (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for bytedance/seedance-2.0/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bytedance/seedance-2.0/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. Note that results may still vary slightly even with the same seed.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p",
"1080p",
"4k"
]
},
"duration": {
"type": "number",
"enum": [
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
ByteDance Seedance 2.0 reference-to-video — maintain character identity from a portrait photo across any scene, with native audio generation.
Pricing: Reference videos are billed as input: +15s allowance per attached video
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanseedintegervideo_urlsarrayaudio_urlsarrayaspect_ratiostringresolutionstringdurationnumberreference_image_urlsarrayaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bytedance%2Fseedance-2.0%2Freference-to-video",
"title": "Seedance 2.0 (Reference) generation request",
"description": "Request body accepted by POST /api/v1/generate for bytedance/seedance-2.0/reference-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bytedance/seedance-2.0/reference-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. Note that results may still vary slightly even with the same seed.",
"type": "integer"
},
"video_urls": {
"title": "Video Urls",
"description": "Reference videos to guide generation. Refer in prompt as @Video1, @Video2. Supported: MP4, MOV. Up to 3 videos.",
"type": "array",
"items": {
"type": "string"
}
},
"audio_urls": {
"title": "Audio Urls",
"description": "Reference audio to guide generation. Refer in prompt as @Audio1, @Audio2. Supported: MP3, WAV. Up to 3 files.",
"type": "array",
"items": {
"type": "string"
}
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p",
"1080p",
"4k"
]
},
"duration": {
"type": "number",
"enum": [
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 9
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
ByteDance Seedance 2.0 text-to-video — premium cinematic video generation with native audio synthesis and support for a wide range of durations and resolutions.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanseedintegeraspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bytedance%2Fseedance-2.0%2Ftext-to-video",
"title": "Seedance 2.0 (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for bytedance/seedance-2.0/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bytedance/seedance-2.0/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. Note that results may still vary slightly even with the same seed.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p",
"1080p",
"4k"
]
},
"duration": {
"type": "number",
"enum": [
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
ByteDance Seedance 2.0 video-to-video — edit or extend an existing video clip with a text prompt. Repaint style, continue the scene, or remix motion at full 1080p quality.
Pricing: Input video duration is also billed as tokens — longer source clips increase cost
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanseedintegeraspect_ratiostringresolutionstringdurationnumbervideo_urlstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bytedance%2Fseedance-2.0%2Fvideo-to-video",
"title": "Seedance 2.0 (V2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for bytedance/seedance-2.0/video-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bytedance/seedance-2.0/video-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. Note that results may still vary slightly even with the same seed.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p",
"1080p",
"4k"
]
},
"duration": {
"type": "number",
"enum": [
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"video_url": {
"type": "string",
"format": "uri"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"video_url"
],
"additionalProperties": false
}
ByteDance Seedance 2.0 Fast image-to-video — quickly animate a start image with optional end-frame guidance and native audio at reduced cost.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanseedintegeraspect_ratiostringresolutionstringdurationnumberimage_urlstringend_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bytedance%2Fseedance-2.0%2Ffast%2Fimage-to-video",
"title": "Seedance 2.0 Fast (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for bytedance/seedance-2.0/fast/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bytedance/seedance-2.0/fast/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. Note that results may still vary slightly even with the same seed.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p"
]
},
"duration": {
"type": "number",
"enum": [
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
ByteDance Seedance 2.0 Fast reference-to-video — maintain character identity from a portrait photo across any scene at lower cost and faster speed.
Pricing: Reference videos are billed as input: +15s allowance per attached video
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanseedintegervideo_urlsarrayaudio_urlsarrayaspect_ratiostringresolutionstringdurationnumberreference_image_urlsarrayaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bytedance%2Fseedance-2.0%2Ffast%2Freference-to-video",
"title": "Seedance 2.0 Fast (Reference) generation request",
"description": "Request body accepted by POST /api/v1/generate for bytedance/seedance-2.0/fast/reference-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bytedance/seedance-2.0/fast/reference-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. Note that results may still vary slightly even with the same seed.",
"type": "integer"
},
"video_urls": {
"title": "Video Urls",
"description": "Reference videos to guide generation. Refer in prompt as @Video1, @Video2. Supported: MP4, MOV. Up to 3 videos.",
"type": "array",
"items": {
"type": "string"
}
},
"audio_urls": {
"title": "Audio Urls",
"description": "Reference audio to guide generation. Refer in prompt as @Audio1, @Audio2. Supported: MP3, WAV. Up to 3 files.",
"type": "array",
"items": {
"type": "string"
}
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p"
]
},
"duration": {
"type": "number",
"enum": [
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 9
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
ByteDance Seedance 2.0 Fast text-to-video — a faster, lower-cost tier of Seedance 2.0 for rapid prototyping with native audio and wide aspect ratio support.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanseedintegeraspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bytedance%2Fseedance-2.0%2Ffast%2Ftext-to-video",
"title": "Seedance 2.0 Fast (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for bytedance/seedance-2.0/fast/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bytedance/seedance-2.0/fast/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. Note that results may still vary slightly even with the same seed.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p"
]
},
"duration": {
"type": "number",
"enum": [
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
ByteDance Seedance 2.0 Fast video-to-video — edit or extend an existing video clip at lower cost and faster speed. Great for rapid iteration on style transfer and scene extension.
Pricing: Input video duration is also billed as tokens — longer source clips increase cost
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanseedintegeraspect_ratiostringresolutionstringdurationnumbervideo_urlstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bytedance%2Fseedance-2.0%2Ffast%2Fvideo-to-video",
"title": "Seedance 2.0 Fast (V2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for bytedance/seedance-2.0/fast/video-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bytedance/seedance-2.0/fast/video-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. Note that results may still vary slightly even with the same seed.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p"
]
},
"duration": {
"type": "number",
"enum": [
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"video_url": {
"type": "string",
"format": "uri"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"video_url"
],
"additionalProperties": false
}
ByteDance Seedance 2.0 Mini image-to-video — animate a start image into a short cinematic clip with native audio at the lowest cost in the Seedance 2.0 family.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanseedintegeraspect_ratiostringresolutionstringdurationnumberimage_urlstringend_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bytedance%2Fseedance-2.0-mini%2Fimage-to-video",
"title": "Seedance 2.0 Mini (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for bytedance/seedance-2.0-mini/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bytedance/seedance-2.0-mini/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. Note that results may still vary slightly even with the same seed.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p"
]
},
"duration": {
"type": "number",
"enum": [
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
ByteDance Seedance 2.0 Mini reference-to-video — character-consistent generation from a portrait reference at the lowest cost in the Seedance 2.0 series.
Pricing: Reference videos are billed as input: +15s allowance per attached video
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanseedintegervideo_urlsarrayaudio_urlsarrayaspect_ratiostringresolutionstringdurationnumberreference_image_urlsarrayaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bytedance%2Fseedance-2.0-mini%2Freference-to-video",
"title": "Seedance 2.0 Mini (Reference) generation request",
"description": "Request body accepted by POST /api/v1/generate for bytedance/seedance-2.0-mini/reference-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bytedance/seedance-2.0-mini/reference-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. Note that results may still vary slightly even with the same seed.",
"type": "integer"
},
"video_urls": {
"title": "Video Urls",
"description": "Reference videos to guide generation. Refer in prompt as @Video1, @Video2. Supported: MP4, MOV. Up to 3 videos.",
"type": "array",
"items": {
"type": "string"
}
},
"audio_urls": {
"title": "Audio Urls",
"description": "Reference audio to guide generation. Refer in prompt as @Audio1, @Audio2. Supported: MP3, WAV. Up to 3 files.",
"type": "array",
"items": {
"type": "string"
}
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p"
]
},
"duration": {
"type": "number",
"enum": [
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 9
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
ByteDance Seedance 2.0 Mini text-to-video — the most affordable tier of the Seedance 2.0 series. Supports 480p and 720p with native audio generation, ideal for rapid iteration and short-form content.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanseedintegeraspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bytedance%2Fseedance-2.0-mini%2Ftext-to-video",
"title": "Seedance 2.0 Mini (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for bytedance/seedance-2.0-mini/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bytedance/seedance-2.0-mini/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. Note that results may still vary slightly even with the same seed.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p"
]
},
"duration": {
"type": "number",
"enum": [
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
ByteDance Seedance 2.0 Mini video-to-video — edit or extend an existing video at the lowest cost in the Seedance 2.0 family. Ideal for high-volume batch editing workflows.
Pricing: Input video duration is also billed as tokens — longer source clips increase cost
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringgenerate_audiobooleanseedintegeraspect_ratiostringresolutionstringdurationnumbervideo_urlstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=bytedance%2Fseedance-2.0-mini%2Fvideo-to-video",
"title": "Seedance 2.0 Mini (V2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for bytedance/seedance-2.0-mini/video-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "bytedance/seedance-2.0-mini/video-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"generate_audio": {
"title": "Generate Audio",
"description": "Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. Note that results may still vary slightly even with the same seed.",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p"
]
},
"duration": {
"type": "number",
"enum": [
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"video_url": {
"type": "string",
"format": "uri"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"video_url"
],
"additionalProperties": false
}
SeedVR Video Upscale uses ByteDance's deep-learning model to upscale any video with cinematic 4K sharpness.
Pricing: $0.001 / output MP × frames — 5s of 1080p output ≈ $0.25
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringtarget_resolutionstringupscale_modestringupscale_factornumberoutput_formatstringseedintegeroutput_qualitystringnoise_scalenumberoutput_write_modestringvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fseedvr%2Fupscale%2Fvideo",
"title": "SeedVR Video Upscale generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/seedvr/upscale/video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/seedvr/upscale/video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"target_resolution": {
"title": "Target Resolution",
"description": "The target resolution to upscale to when `upscale_mode` is `target`.",
"default": "1080p",
"type": "string",
"enum": [
"720p",
"1080p",
"1440p",
"2160p"
]
},
"upscale_mode": {
"title": "Upscale Mode",
"description": "The mode to use for the upscale. If 'target', the upscale factor will be calculated based on the target resolution. If 'factor', the upscale factor wi",
"default": "factor",
"type": "string",
"enum": [
"target",
"factor"
]
},
"upscale_factor": {
"title": "Upscale Factor",
"description": "Upscaling factor to be used. Will multiply the dimensions with this factor when `upscale_mode` is `factor`.",
"default": 2,
"type": "number",
"minimum": 1,
"maximum": 10
},
"output_format": {
"title": "Output Format",
"description": "The format of the output video.",
"default": "X264 (.mp4)",
"type": "string",
"enum": [
"X264 (.mp4)",
"VP9 (.webm)",
"PRORES4444 (.mov)",
"GIF (.gif)"
]
},
"seed": {
"title": "Seed",
"description": "The random seed used for the generation process.",
"type": "integer"
},
"output_quality": {
"title": "Output Quality",
"description": "The quality of the output video.",
"default": "high",
"type": "string",
"enum": [
"low",
"medium",
"high",
"maximum"
]
},
"noise_scale": {
"title": "Noise Scale",
"description": "The noise scale to use for the generation process.",
"default": 0.1,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.001
},
"output_write_mode": {
"title": "Output Write Mode",
"description": "The write mode of the output video.",
"default": "balanced",
"type": "string",
"enum": [
"fast",
"balanced",
"small"
]
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"video_url"
],
"additionalProperties": false
}
Sync Lipsync 3.0 delivers the sharpest phoneme accuracy yet, with improved mouth-shape precision across all vocal ranges.
Pricing: ~$8/min of output video.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringsync_modestringmodel_modestringemotionstringtemperaturenumbervideo_urlstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fsync-lipsync%2Fv3",
"title": "Sync Lipsync 3.0 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/sync-lipsync/v3.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/sync-lipsync/v3",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"sync_mode": {
"title": "Sync Mode",
"description": "How to handle duration mismatch between audio and video.",
"default": "cut_off",
"type": "string",
"enum": [
"cut_off",
"loop",
"bounce",
"silence",
"remap"
]
},
"model_mode": {
"title": "Edit Region",
"description": "Which region of the face to animate. 'Lips only' for minimal edits; 'Talking Head' for full head movement.",
"default": "",
"type": "string",
"enum": [
"",
"lips",
"face",
"head",
"lipsync",
"emotion",
"talking_head"
]
},
"emotion": {
"title": "Emotion",
"description": "Drive an emotional expression on the face alongside the lipsync.",
"default": "",
"type": "string",
"enum": [
"",
"happy",
"sad",
"angry",
"disgusted",
"surprised",
"neutral"
]
},
"temperature": {
"title": "Expressiveness",
"description": "How expressive the lipsync can be — 0 is least, 1 is most. Sync 3.0 also tunes this automatically.",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1,
"multipleOf": 0.05
},
"video_url": {
"type": "string",
"format": "uri"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"video_url",
"audio_url"
],
"additionalProperties": false
}
ThinkSound — generates immersive ambient soundscapes and environmental audio from any video scene using chain-of-thought reasoning.
Pricing: ~$0.001/compute-second · flat $0.05 estimate (scales with video length and inference steps).
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringcfg_scalenumbernum_inference_stepsnumberseedintegervideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fthinksound%2Faudio",
"title": "ThinkSound generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/thinksound/audio.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/thinksound/audio",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"cfg_scale": {
"title": "CFG Scale",
"description": "Classifier-free guidance scale for audio generation.",
"default": 5,
"type": "number",
"minimum": 1,
"maximum": 20
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "Number of inference steps (more = higher quality but slower).",
"default": 24,
"type": "number",
"minimum": 2,
"maximum": 100,
"multipleOf": 1
},
"seed": {
"title": "Seed",
"description": "Seed for reproducibility.",
"type": "integer"
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"video_url"
],
"additionalProperties": false
}
Trim Video cuts any uploaded video to an exact start and end time, producing a precise clip with no quality loss.
Pricing: Flat 2 credits/job (fal: $0.001/compute-second — an ffmpeg trim is a few compute-seconds).
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringdurationnumberstart_timenumberend_timenumbervideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fworkflow-utilities%2Ftrim-video",
"title": "Trim Video generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/workflow-utilities/trim-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/workflow-utilities/trim-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"duration": {
"title": "Duration",
"description": "Duration in seconds from start_time. Ignored if end_time is provided.",
"default": 2,
"type": "number"
},
"start_time": {
"title": "Start Time",
"description": "Start time in seconds",
"default": 1,
"type": "number",
"minimum": 0
},
"end_time": {
"title": "End Time",
"description": "End time in seconds. If not provided, uses duration instead.",
"type": "number"
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"video_url"
],
"additionalProperties": false
}
VEED Fabric 1.0 produces precise AI lip sync from a portrait image and audio clip, perfectly matching every word of the audio track.
Pricing: $0.08/s at 480p · $0.15/s at 720p.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringresolutionstringimage_urlstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=veed%2Ffabric-1.0",
"title": "VEED Fabric 1.0 generation request",
"description": "Request body accepted by POST /api/v1/generate for veed/fabric-1.0.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "veed/fabric-1.0",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"resolution": {
"type": "string",
"enum": [
"720p",
"480p"
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"image_url",
"audio_url"
],
"additionalProperties": false
}
VEED Lipsync 2.0 replaces speech in an existing human video with production-quality lip sync, preserving the source resolution while transferring timing, emotion, and speaking style from the new audio.
Pricing: $0.07 per second of output video at any supported resolution.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvideo_urlstringaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=veed%2Flipsync%2Fv2",
"title": "VEED Lipsync 2.0 generation request",
"description": "Request body accepted by POST /api/v1/generate for veed/lipsync/v2.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "veed/lipsync/v2",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"video_url": {
"type": "string",
"format": "uri"
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"video_url",
"audio_url"
],
"additionalProperties": false
}
VEED Subtitles burns professional animated captions into any video with 28 style presets, 100+ languages, and 98%+ transcription accuracy.
Pricing: $0.10/min of input video · 2× for dynamic presets (glass, whisper, glide2, fusion, glide, terminal, handwritten, backdrop, backdrop2) · +$0.20/min with translation · fal adds 2× for inputs above 1080p (not pre-charged). Min 1 min.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringpresetstringtranslation_languagestringlanguagestringsrt_file_urlstringsrt_contentstringshadowstringpositionstringtext_customizationsobjectvocabularyobjectvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=veed%2Fsubtitles",
"title": "VEED Subtitles generation request",
"description": "Request body accepted by POST /api/v1/generate for veed/subtitles.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "veed/subtitles",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"preset": {
"title": "Preset",
"description": "Each style defines fonts, colors, layout, and animation. Two tiers with different pricing: - Dynamic presets (2x multiplier): glass, whisper, glide2,",
"type": "string",
"enum": [
"glass",
"whisper",
"glide2",
"fusion",
"glide",
"terminal",
"handwritten",
"backdrop",
"backdrop2",
"simple",
"plain",
"beans",
"corpo",
"boo",
"shadeplay",
"casper",
"capri",
"lowkey",
"vinta",
"diego",
"ali",
"slay",
"kitty",
"hustle",
"karl",
"sprout",
"flex",
"mint",
"rizz",
"vegas"
]
},
"translation_language": {
"title": "Translation Language",
"description": "Translate subtitles to this language (e.g. 'es-ES', 'fr-FR', 'ja-JP', 'zh-TW'). When set, output subtitles are translated from the source audio language. Leave blank to keep the source language.",
"type": "string"
},
"language": {
"title": "Language",
"description": "Improves transcription accuracy, and should match the source audio (not output subtitles).",
"type": "string",
"enum": [
"af-ZA",
"am-ET",
"ar-AE",
"ar-BH",
"ar-DZ",
"ar-EG",
"ar-IL",
"ar-IQ",
"ar-JO",
"ar-KW",
"ar-LB",
"ar-MA",
"ar-OM",
"ar-PS",
"ar-QA",
"ar-SA",
"ar-TN",
"ast-ES",
"az-AZ",
"ba",
"bas",
"be-BY",
"bg-BG",
"br",
"bs-BA",
"ca-ES",
"ceb-PH",
"ckb-IQ",
"cs-CZ",
"cy-GB",
"da-DK",
"de-DE",
"dyu",
"el-GR",
"en-AU",
"en-GB",
"en-IN",
"en-NZ",
"en-US",
"eo",
"es-AR",
"es-BO",
"es-CL",
"es-CO",
"es-CR",
"es-DO",
"es-EC",
"es-ES",
"es-GT",
"es-HN",
"es-MX",
"es-NI",
"es-PA",
"es-PE",
"es-PR",
"es-PY",
"es-SV",
"es-US",
"es-UY",
"es-VE",
"et-EE",
"eu-ES",
"fa-IR",
"ff",
"fi-FI",
"fil-PH",
"fo",
"fr-CA",
"fr-FR",
"fy",
"ga",
"gd",
"gl-ES",
"ha-NG",
"haw",
"he-IL",
"hr-HR",
"hsb",
"ht",
"hu-HU",
"hy-AM",
"id-ID",
"ig",
"is-IS",
"it-IT",
"ja-JP",
"ja-Latn-JP",
"jv-ID",
"ka-GE",
"kab",
"kam-KE",
"kea-CV",
"kk-KZ",
"ko-KR",
"ku",
"ky-KG",
"la",
"lb-LU",
"lg",
"lij",
"ln-CD",
"lo-LA",
"lt-LT",
"luo-KE",
"lv-LV",
"mg",
"mi-NZ",
"mk-MK",
"mn-MN",
"ms-MY",
"mt-MT",
"nb-NO",
"nl-NL",
"nn",
"nso-ZA",
"ny-MW",
"oc-FR",
"pl-PL",
"ps-AF",
"pt-BR",
"pt-PT",
"ro-RO",
"roh",
"ru-RU",
"rw-RW",
"sah",
"sk-SK",
"sl-SI",
"sm",
"sn-ZW",
"so-SO",
"sq-AL",
"sr-Latn-RS",
"sr-RS",
"srd",
"ss",
"su-ID",
"sv-SE",
"sw-KE",
"sw-TZ",
"tg-TJ",
"th-TH",
"tk",
"tn",
"tok",
"ton",
"tr-TR",
"ts-ZA",
"tt",
"uk-UA",
"umb-AO",
"ur-IN",
"ur-PK",
"uz-UZ",
"vi-VN",
"vro",
"wo-SN",
"xh-ZA",
"yi",
"yo-NG",
"yue-Hant-HK",
"zh",
"zh-HK",
"zh-TW",
"zu-ZA"
]
},
"srt_file_url": {
"title": "Srt File Url",
"description": "Upload or paste a URL to your .srt subtitles file. When provided, transcription is skipped.",
"type": "string"
},
"srt_content": {
"title": "Srt Content",
"description": "Paste raw SRT subtitle text. Alternative to srt_file_url. When provided, transcription is skipped.",
"type": "string"
},
"shadow": {
"title": "Shadow",
"description": "Improves readability over bright or busy backgrounds.",
"type": "string",
"enum": [
"none",
"min",
"mid",
"max"
]
},
"position": {
"title": "Position",
"description": "Vertical placement of static subtitles on screen.",
"type": "string",
"enum": [
"top",
"center",
"bottom"
]
},
"text_customizations": {
"title": "Text Customizations",
"description": "Override the preset's text styling — JSON object with optional 'baseline' (all words) and 'highlighted' (key words) entries, each accepting 'font' (Google Font name), 'weight' (100-900, ≥700 renders bold) and 'color' (hex). E.g. {\"baseline\":{\"font\":\"Montserrat\",\"weight\":700,\"color\":\"#FFFFFF\"},\"highlighted\":{\"color\":\"#FFD700\"}}",
"type": "object",
"additionalProperties": true
},
"vocabulary": {
"title": "Vocabulary",
"description": "Custom vocabulary to fix transcription of brand names, products or jargon — JSON array of up to 100 entries, each with 'word' (correct spelling) and 'replaces' (1-20 common misspellings, matched case-insensitively). E.g. [{\"word\":\"VEED\",\"replaces\":[\"veed\",\"V E E D\"]}]. Ignored when an SRT source is provided.",
"type": "object",
"additionalProperties": true
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"preset",
"video_url"
],
"additionalProperties": false
}
Google Veo 3.1 first-and-last-frame-to-video — provide a start and end image, the model interpolates cinematic motion between them.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringauto_fixbooleanfirst_frame_urlstringsafety_tolerancenumberseedintegernegative_promptstringlast_frame_urlstringaspect_ratiostringresolutionstringdurationnumberimage_urlstringend_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fveo3.1%2Ffirst-last-frame-to-video",
"title": "Veo 3.1 (First+Last Frame) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/veo3.1/first-last-frame-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/veo3.1/first-last-frame-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"auto_fix": {
"title": "Auto Fix",
"description": "Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.",
"default": false,
"type": "boolean"
},
"first_frame_url": {
"title": "First Frame Url",
"description": "URL of the first frame of the video. Overrides the uploaded start frame.",
"type": "string"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.",
"default": "4",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "A negative prompt to guide the video generation.",
"type": "string"
},
"last_frame_url": {
"title": "Last Frame Url",
"description": "URL of the last frame of the video. Overrides the uploaded end frame.",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"16:9",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p",
"4k"
]
},
"duration": {
"type": "number",
"enum": [
4,
6,
8
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url",
"end_image_url"
],
"additionalProperties": false
}
Google Veo 3.1 image-to-video — premium cinematic animation up to 4K with native audio.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringauto_fixbooleansafety_tolerancenumberseedintegernegative_promptstringaspect_ratiostringresolutionstringdurationnumberimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fveo3.1%2Fimage-to-video",
"title": "Veo 3.1 (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/veo3.1/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/veo3.1/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"auto_fix": {
"title": "Auto Fix",
"description": "Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.",
"default": false,
"type": "boolean"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.",
"default": "4",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "A negative prompt to guide the video generation.",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"16:9",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p",
"4k"
]
},
"duration": {
"type": "number",
"enum": [
4,
6,
8
]
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
Google Veo 3.1 reference-to-video — maintain character identity across shots using a reference portrait image.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringauto_fixbooleansafety_tolerancenumberseedintegernegative_promptstringaspect_ratiostringresolutionstringdurationnumberreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fveo3.1%2Freference-to-video",
"title": "Veo 3.1 (Reference) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/veo3.1/reference-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/veo3.1/reference-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"auto_fix": {
"title": "Auto Fix",
"description": "Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.",
"default": false,
"type": "boolean"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.",
"default": "4",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "A negative prompt to guide the video generation.",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p",
"4k"
]
},
"duration": {
"type": "number",
"enum": [
8
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 3
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Google Veo 3.1 text-to-video — the latest standard tier with 4K support, native audio, and cinematic quality.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringauto_fixbooleansafety_tolerancenumberseedintegernegative_promptstringaspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fveo3.1",
"title": "Veo 3.1 (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/veo3.1.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/veo3.1",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"auto_fix": {
"title": "Auto Fix",
"description": "Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.",
"default": true,
"type": "boolean"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.",
"default": "4",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "A negative prompt to guide the video generation.",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p",
"4k"
]
},
"duration": {
"type": "number",
"enum": [
4,
6,
8
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Google Veo 3.1 Fast first-and-last-frame-to-video — rapid interpolation between a start and end image with native audio.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringauto_fixbooleanfirst_frame_urlstringsafety_tolerancenumberseedintegernegative_promptstringlast_frame_urlstringaspect_ratiostringresolutionstringdurationnumberimage_urlstringend_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fveo3.1%2Ffast%2Ffirst-last-frame-to-video",
"title": "Veo 3.1 Fast (First+Last frame) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/veo3.1/fast/first-last-frame-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/veo3.1/fast/first-last-frame-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"auto_fix": {
"title": "Auto Fix",
"description": "Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.",
"default": false,
"type": "boolean"
},
"first_frame_url": {
"title": "First Frame Url",
"description": "URL of the first frame of the video. Overrides the uploaded start frame.",
"type": "string"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.",
"default": "4",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "A negative prompt to guide the video generation.",
"type": "string"
},
"last_frame_url": {
"title": "Last Frame Url",
"description": "URL of the last frame of the video. Overrides the uploaded end frame.",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"16:9",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p",
"4k"
]
},
"duration": {
"type": "number",
"enum": [
4,
6,
8
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url",
"end_image_url"
],
"additionalProperties": false
}
Google Veo 3.1 Fast image-to-video — rapid image animation up to 4K with native audio (720p, audio included).
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringauto_fixbooleansafety_tolerancenumberseedintegernegative_promptstringaspect_ratiostringresolutionstringdurationnumberimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fveo3.1%2Ffast%2Fimage-to-video",
"title": "Veo 3.1 Fast (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/veo3.1/fast/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/veo3.1/fast/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"auto_fix": {
"title": "Auto Fix",
"description": "Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.",
"default": false,
"type": "boolean"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.",
"default": "4",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "A negative prompt to guide the video generation.",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"16:9",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p",
"4k"
]
},
"duration": {
"type": "number",
"enum": [
4,
6,
8
]
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
Google Veo 3.1 Fast reference-to-video — drop a character into any cinematic world at half the standard tier cost.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringauto_fixbooleansafety_tolerancenumberseedintegernegative_promptstringaspect_ratiostringresolutionstringdurationnumberreference_image_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fveo3.1%2Ffast%2Freference-to-video",
"title": "Veo 3.1 Fast (Reference) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/veo3.1/fast/reference-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/veo3.1/fast/reference-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"auto_fix": {
"title": "Auto Fix",
"description": "Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.",
"default": false,
"type": "boolean"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.",
"default": "4",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "A negative prompt to guide the video generation.",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p",
"4k"
]
},
"duration": {
"type": "number",
"enum": [
8
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 3
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
Google Veo 3.1 Fast text-to-video — rapid generation up to 4K with native audio (720p, audio included).
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringauto_fixbooleansafety_tolerancenumberseedintegernegative_promptstringaspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fveo3.1%2Ffast",
"title": "Veo 3.1 Fast (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/veo3.1/fast.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/veo3.1/fast",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"auto_fix": {
"title": "Auto Fix",
"description": "Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.",
"default": true,
"type": "boolean"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.",
"default": "4",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "A negative prompt to guide the video generation.",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p",
"4k"
]
},
"duration": {
"type": "number",
"enum": [
4,
6,
8
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Google Veo 3.1 Lite first-and-last-frame-to-video — affordable interpolation between start and end images with native audio.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringauto_fixbooleanfirst_frame_urlstringsafety_tolerancenumberseedintegernegative_promptstringlast_frame_urlstringaspect_ratiostringresolutionstringdurationnumberimage_urlstringend_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fveo3.1%2Flite%2Ffirst-last-frame-to-video",
"title": "Veo 3.1 Lite (First+Last frame) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/veo3.1/lite/first-last-frame-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/veo3.1/lite/first-last-frame-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"auto_fix": {
"title": "Auto Fix",
"description": "Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.",
"default": false,
"type": "boolean"
},
"first_frame_url": {
"title": "First Frame Url",
"description": "URL of the first frame of the video. Overrides the uploaded start frame.",
"type": "string"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.",
"default": "4",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "A negative prompt to guide the video generation.",
"type": "string"
},
"last_frame_url": {
"title": "Last Frame Url",
"description": "URL of the last frame of the video. Overrides the uploaded end frame.",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"16:9",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
8
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url",
"end_image_url"
],
"additionalProperties": false
}
Google Veo 3.1 Lite image-to-video — affordable image animation with native audio (720p, audio included).
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringauto_fixbooleansafety_tolerancenumberseedintegernegative_promptstringaspect_ratiostringresolutionstringdurationnumberimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fveo3.1%2Flite%2Fimage-to-video",
"title": "Veo 3.1 Lite (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/veo3.1/lite/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/veo3.1/lite/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"auto_fix": {
"title": "Auto Fix",
"description": "Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.",
"default": false,
"type": "boolean"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.",
"default": "4",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "A negative prompt to guide the video generation.",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"16:9",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
4,
6,
8
]
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
Google Veo 3.1 Lite text-to-video — affordable tier with native audio (720p, audio included).
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringauto_fixbooleansafety_tolerancenumberseedintegernegative_promptstringaspect_ratiostringresolutionstringdurationnumber
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fveo3.1%2Flite",
"title": "Veo 3.1 Lite (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/veo3.1/lite.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/veo3.1/lite",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"auto_fix": {
"title": "Auto Fix",
"description": "Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.",
"default": true,
"type": "boolean"
},
"safety_tolerance": {
"title": "Safety Tolerance",
"description": "The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.",
"default": "4",
"type": "number",
"enum": [
1,
2,
3,
4,
5,
6
]
},
"seed": {
"title": "Seed",
"description": "The seed for the random number generator.",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "A negative prompt to guide the video generation.",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
4,
6,
8
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
WAN 2.2 A14B image-to-video with LoRA — animate a start image with a custom fine-tune for stylized motion, including optional end-frame control.
Pricing: $0.10 per output second (num_frames ÷ fps)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvideo_write_modestringenable_output_safety_checkerbooleanseedintegeradjust_fps_for_interpolationbooleanguidance_scale_2numbernegative_promptstringaccelerationstringguidance_scalenumberinterpolator_modelstringreverse_videobooleanend_image_urlstringnum_inference_stepsnumbernum_interpolated_framesnumbershiftnumberframes_per_secondnumbernum_framesnumberenable_prompt_expansionbooleanvideo_qualitystringenable_safety_checkerbooleanlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberaspect_ratiostringresolutionstringimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fwan%2Fv2.2-a14b%2Fimage-to-video%2Flora",
"title": "Wan 2.2 (I2V LoRA) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/wan/v2.2-a14b/image-to-video/lora.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/wan/v2.2-a14b/image-to-video/lora",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"video_write_mode": {
"title": "Video Write Mode",
"description": "The write mode of the output video. Faster write mode means faster results but larger file size, balanced write mode is a good compromise between spee",
"default": "balanced",
"type": "string",
"enum": [
"fast",
"balanced",
"small"
]
},
"enable_output_safety_checker": {
"title": "Enable Output Safety Checker",
"description": "If set to true, output video will be checked for safety after generation.",
"default": false,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. If None, a random seed is chosen.",
"type": "integer"
},
"adjust_fps_for_interpolation": {
"title": "Adjust Fps For Interpolation",
"description": "If true, the number of frames per second will be multiplied by the number of interpolated frames plus one. For example, if the generated frames per se",
"default": true,
"type": "boolean"
},
"guidance_scale_2": {
"title": "Guidance Scale 2",
"description": "Guidance scale for the second stage of the model. This is used to control the adherence to the prompt in the second stage of the model.",
"default": 4,
"type": "number",
"minimum": 1,
"maximum": 10
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt for video generation.",
"default": "",
"type": "string"
},
"acceleration": {
"title": "Acceleration",
"description": "Acceleration level to use. The more acceleration, the faster the generation, but with lower quality. The recommended value is 'regular'.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular"
]
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Classifier-free guidance scale. Higher values give better adherence to the prompt but may decrease quality.",
"default": 3.5,
"type": "number",
"minimum": 1,
"maximum": 10
},
"interpolator_model": {
"title": "Interpolator Model",
"description": "The model to use for frame interpolation. If None, no interpolation is applied.",
"default": "film",
"type": "string",
"enum": [
"none",
"film",
"rife"
]
},
"reverse_video": {
"title": "Reverse Video",
"description": "If true, the video will be reversed.",
"default": false,
"type": "boolean"
},
"end_image_url": {
"title": "End Image Url",
"description": "Handled by the End Frame canvas slot.",
"type": "string"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "Number of inference steps for sampling. Higher values give better quality but take longer.",
"default": 27,
"type": "number",
"minimum": 2,
"maximum": 40,
"multipleOf": 1
},
"num_interpolated_frames": {
"title": "Num Interpolated Frames",
"description": "Number of frames to interpolate between each pair of generated frames. Must be between 0 and 4.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 1
},
"shift": {
"title": "Shift",
"description": "Shift value for the video. Must be between 1.0 and 10.0.",
"default": 5,
"type": "number",
"minimum": 1,
"maximum": 10
},
"frames_per_second": {
"title": "Frames Per Second",
"description": "Frames per second of the generated video. Must be between 4 to 60. When using interpolation and `adjust_fps_for_interpolation` is set to true (default",
"default": 16,
"type": "number",
"minimum": 4,
"maximum": 60,
"multipleOf": 1
},
"num_frames": {
"title": "Num Frames",
"description": "Number of frames to generate. Must be between 17 to 161 (inclusive).",
"default": 81,
"type": "number",
"minimum": 17,
"maximum": 161,
"multipleOf": 1
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Whether to enable prompt expansion. This will use a large language model to expand the prompt with additional details while maintaining the original m",
"default": false,
"type": "boolean"
},
"video_quality": {
"title": "Video Quality",
"description": "The quality of the output video. Higher quality means better visual quality but larger file size.",
"default": "high",
"type": "string",
"enum": [
"low",
"medium",
"high",
"maximum"
]
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the input safety checker before generation.",
"default": false,
"type": "boolean"
},
"lora_path": {
"title": "LoRA Path",
"description": "URL or Hugging Face path to LoRA weights (e.g. username/repo or https://…).",
"type": "string"
},
"lora_scale": {
"title": "LoRA Scale",
"description": "Strength of the LoRA effect. 1 = default weight, higher = stronger influence.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4
},
"lora_path_2": {
"title": "LoRA Path 2",
"description": "URL or Hugging Face path to a second set of LoRA weights.",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA Scale 2",
"description": "Strength of the second LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4
},
"lora_path_3": {
"title": "LoRA Path 3",
"description": "URL or Hugging Face path to a third set of LoRA weights.",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA Scale 3",
"description": "Strength of the third LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"580p",
"720p"
]
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
WAN 2.2 A14B text-to-video with LoRA — apply custom fine-tune weights to steer the visual style of generated videos.
Pricing: $0.10 per output second (num_frames ÷ fps)
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvideo_write_modestringenable_output_safety_checkerbooleanseedintegeradjust_fps_for_interpolationbooleanguidance_scale_2numbernegative_promptstringaccelerationstringguidance_scalenumberinterpolator_modelstringreverse_videobooleannum_inference_stepsnumbershiftnumbernum_interpolated_framesnumberframes_per_secondnumbernum_framesnumberenable_prompt_expansionbooleanvideo_qualitystringenable_safety_checkerbooleanlora_pathstringlora_scalenumberlora_path_2stringlora_scale_2numberlora_path_3stringlora_scale_3numberaspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fwan%2Fv2.2-a14b%2Ftext-to-video%2Flora",
"title": "Wan 2.2 (T2V LoRA) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/wan/v2.2-a14b/text-to-video/lora.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/wan/v2.2-a14b/text-to-video/lora",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"video_write_mode": {
"title": "Video Write Mode",
"description": "The write mode of the output video. Faster write mode means faster results but larger file size, balanced write mode is a good compromise between spee",
"default": "balanced",
"type": "string",
"enum": [
"fast",
"balanced",
"small"
]
},
"enable_output_safety_checker": {
"title": "Enable Output Safety Checker",
"description": "If set to true, output video will be checked for safety after generation.",
"default": false,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. If None, a random seed is chosen.",
"type": "integer"
},
"adjust_fps_for_interpolation": {
"title": "Adjust Fps For Interpolation",
"description": "If true, the number of frames per second will be multiplied by the number of interpolated frames plus one. For example, if the generated frames per se",
"default": true,
"type": "boolean"
},
"guidance_scale_2": {
"title": "Guidance Scale 2",
"description": "Guidance scale for the second stage of the model. This is used to control the adherence to the prompt in the second stage of the model.",
"default": 4,
"type": "number",
"minimum": 1,
"maximum": 10
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Negative prompt for video generation.",
"default": "",
"type": "string"
},
"acceleration": {
"title": "Acceleration",
"description": "Acceleration level to use. The more acceleration, the faster the generation, but with lower quality. The recommended value is 'regular'.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular"
]
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "Classifier-free guidance scale. Higher values give better adherence to the prompt but may decrease quality.",
"default": 3.5,
"type": "number",
"minimum": 1,
"maximum": 10
},
"interpolator_model": {
"title": "Interpolator Model",
"description": "The model to use for frame interpolation. If None, no interpolation is applied.",
"default": "film",
"type": "string",
"enum": [
"none",
"film",
"rife"
]
},
"reverse_video": {
"title": "Reverse Video",
"description": "If true, the video will be reversed.",
"default": false,
"type": "boolean"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "Number of inference steps for sampling. Higher values give better quality but take longer.",
"default": 27,
"type": "number",
"minimum": 2,
"maximum": 40,
"multipleOf": 1
},
"shift": {
"title": "Shift",
"description": "Shift value for the video. Must be between 1.0 and 10.0.",
"default": 5,
"type": "number",
"minimum": 1,
"maximum": 10
},
"num_interpolated_frames": {
"title": "Num Interpolated Frames",
"description": "Number of frames to interpolate between each pair of generated frames. Must be between 0 and 4.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4,
"multipleOf": 1
},
"frames_per_second": {
"title": "Frames Per Second",
"description": "Frames per second of the generated video. Must be between 4 to 60. When using interpolation and `adjust_fps_for_interpolation` is set to true (default",
"default": 16,
"type": "number",
"minimum": 4,
"maximum": 60,
"multipleOf": 1
},
"num_frames": {
"title": "Num Frames",
"description": "Number of frames to generate. Must be between 17 to 161 (inclusive).",
"default": 81,
"type": "number",
"minimum": 17,
"maximum": 161,
"multipleOf": 1
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Whether to enable prompt expansion. This will use a large language model to expand the prompt with additional details while maintaining the original m",
"default": false,
"type": "boolean"
},
"video_quality": {
"title": "Video Quality",
"description": "The quality of the output video. Higher quality means better visual quality but larger file size.",
"default": "high",
"type": "string",
"enum": [
"low",
"medium",
"high",
"maximum"
]
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the input safety checker before generation.",
"default": false,
"type": "boolean"
},
"lora_path": {
"title": "LoRA Path",
"description": "URL or Hugging Face path to LoRA weights (e.g. username/repo or https://…).",
"type": "string"
},
"lora_scale": {
"title": "LoRA Scale",
"description": "Strength of the LoRA effect. 1 = default weight, higher = stronger influence.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4
},
"lora_path_2": {
"title": "LoRA Path 2",
"description": "URL or Hugging Face path to a second set of LoRA weights.",
"type": "string"
},
"lora_scale_2": {
"title": "LoRA Scale 2",
"description": "Strength of the second LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4
},
"lora_path_3": {
"title": "LoRA Path 3",
"description": "URL or Hugging Face path to a third set of LoRA weights.",
"type": "string"
},
"lora_scale_3": {
"title": "LoRA Scale 3",
"description": "Strength of the third LoRA.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 4
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"580p",
"720p"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
WAN 2.2 A14B Turbo image-to-video — flat-rate accelerated i2v with optional end-frame support across three resolution tiers.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvideo_write_modestringenable_output_safety_checkerbooleanseedintegerend_image_urlstringaccelerationstringenable_prompt_expansionbooleanvideo_qualitystringenable_safety_checkerbooleanaspect_ratiostringresolutionstringimage_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fwan%2Fv2.2-a14b%2Fimage-to-video%2Fturbo",
"title": "WAN 2.2 A14B Turbo (i2v) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/wan/v2.2-a14b/image-to-video/turbo.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/wan/v2.2-a14b/image-to-video/turbo",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"video_write_mode": {
"title": "Video Write Mode",
"description": "The write mode of the output video. Faster write mode means faster results but larger file size, balanced write mode is a good compromise between spee",
"default": "balanced",
"type": "string",
"enum": [
"fast",
"balanced",
"small"
]
},
"enable_output_safety_checker": {
"title": "Enable Output Safety Checker",
"description": "If set to true, output video will be checked for safety after generation.",
"default": false,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. If None, a random seed is chosen.",
"type": "integer"
},
"end_image_url": {
"title": "End Image Url",
"description": "Handled by the End Frame canvas slot.",
"type": "string"
},
"acceleration": {
"title": "Acceleration",
"description": "Acceleration level to use. The more acceleration, the faster the generation, but with lower quality. The recommended value is 'regular'.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular"
]
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Whether to enable prompt expansion. This will use a large language model to expand the prompt with additional details while maintaining the original m",
"default": false,
"type": "boolean"
},
"video_quality": {
"title": "Video Quality",
"description": "The quality of the output video. Higher quality means better visual quality but larger file size.",
"default": "high",
"type": "string",
"enum": [
"low",
"medium",
"high",
"maximum"
]
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the input safety checker before generation.",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"580p",
"720p"
]
},
"image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
WAN 2.2 Animate Mix — replace the performer in a source video with a character from a reference image, keeping the original motion, scene, and camera.
Pricing: $0.18/s in Standard mode or $0.26/s in Professional mode; billed by driving-video length (2-30s).
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringmodestringwatermarkbooleancheck_imagebooleanresolutionstringreference_image_urlstringvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=wan%2Fv2.2%2Fanimate-mix",
"title": "WAN 2.2 Animate (Mix) generation request",
"description": "Request body accepted by POST /api/v1/generate for wan/v2.2/animate-mix.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "wan/v2.2/animate-mix",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"mode": {
"title": "Quality mode",
"description": "Professional mode improves identity transfer and costs more per second.",
"default": "wan-pro",
"type": "string",
"enum": [
"wan-pro",
"wan-std"
]
},
"watermark": {
"title": "Provider watermark",
"description": "Add the provider watermark to the rendered video.",
"default": false,
"type": "boolean"
},
"check_image": {
"title": "Validate identity image",
"description": "Validate the identity image before starting the render.",
"default": true,
"type": "boolean"
},
"resolution": {
"type": "string",
"enum": [
"720p"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"mode",
"reference_image_url",
"video_url"
],
"additionalProperties": false
}
WAN 2.2 Animate Move — transfer the motion of a source video onto a static character image, animating the character with the driving performance.
Pricing: $0.12/s in Standard mode or $0.18/s in Professional mode; billed by driving-video length (2-30s).
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringmodestringwatermarkbooleancheck_imagebooleanresolutionstringreference_image_urlstringvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=wan%2Fv2.2%2Fanimate-move",
"title": "WAN 2.2 Animate (Move) generation request",
"description": "Request body accepted by POST /api/v1/generate for wan/v2.2/animate-move.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "wan/v2.2/animate-move",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"mode": {
"title": "Quality mode",
"description": "Professional mode improves transfer quality and costs more per second.",
"default": "wan-std",
"type": "string",
"enum": [
"wan-std",
"wan-pro"
]
},
"watermark": {
"title": "Provider watermark",
"description": "Add the provider watermark to the rendered video.",
"default": false,
"type": "boolean"
},
"check_image": {
"title": "Validate identity image",
"description": "Validate the identity image before starting the render.",
"default": true,
"type": "boolean"
},
"resolution": {
"type": "string",
"enum": [
"720p"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"mode",
"reference_image_url",
"video_url"
],
"additionalProperties": false
}
WAN 2.2 A14B Turbo text-to-video — accelerated generation with quality and write-mode controls for fast iteration at lower cost.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringvideo_write_modestringenable_output_safety_checkerbooleanseedintegeraccelerationstringenable_prompt_expansionbooleanvideo_qualitystringenable_safety_checkerbooleanaspect_ratiostringresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fwan%2Fv2.2-a14b%2Ftext-to-video%2Fturbo",
"title": "Wan 2.2 Turbo (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/wan/v2.2-a14b/text-to-video/turbo.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/wan/v2.2-a14b/text-to-video/turbo",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"video_write_mode": {
"title": "Video Write Mode",
"description": "The write mode of the output video. Faster write mode means faster results but larger file size, balanced write mode is a good compromise between spee",
"default": "balanced",
"type": "string",
"enum": [
"fast",
"balanced",
"small"
]
},
"enable_output_safety_checker": {
"title": "Enable Output Safety Checker",
"description": "If set to true, output video will be checked for safety after generation.",
"default": false,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. If None, a random seed is chosen.",
"type": "integer"
},
"acceleration": {
"title": "Acceleration",
"description": "Acceleration level to use. The more acceleration, the faster the generation, but with lower quality. The recommended value is 'regular'.",
"default": "regular",
"type": "string",
"enum": [
"none",
"regular"
]
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Whether to enable prompt expansion. This will use a large language model to expand the prompt with additional details while maintaining the original m",
"default": false,
"type": "boolean"
},
"video_quality": {
"title": "Video Quality",
"description": "The quality of the output video. Higher quality means better visual quality but larger file size.",
"default": "high",
"type": "string",
"enum": [
"low",
"medium",
"high",
"maximum"
]
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the input safety checker before generation.",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"580p",
"720p"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
WAN 2.7 video editing — transform an input video by style, effect, or camera replication while preserving the original motion, with full resolution and duration controls.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringenable_prompt_expansionbooleanseedintegeraspect_ratiostringresolutionstringdurationnumbervideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=wan%2Fv2.7%2Fvideo-edit",
"title": "WAN 2.7 (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for wan/v2.7/video-edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "wan/v2.7/video-edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Content to avoid in the video. Max 500 characters.",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Enable intelligent prompt rewriting.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility (0-2147483647).",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
2,
3,
4,
5,
6,
7,
8,
9,
10
]
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"video_url"
],
"additionalProperties": false
}
WAN 2.7 image-to-video — animate a start frame, or first-and-last frames, or continue from a video, into a smooth cinematic clip with full resolution and duration controls.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringenable_prompt_expansionbooleanseedintegernegative_promptstringaspect_ratiostringresolutionstringdurationnumberimage_urlstringend_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=wan%2Fv2.7%2Fimage-to-video",
"title": "WAN 2.7 (I2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for wan/v2.7/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "wan/v2.7/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Enable intelligent prompt rewriting.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility (0-2147483647).",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Content to avoid in the video. Max 500 characters.",
"type": "string"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"16:9",
"9:16",
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
WAN 2.7 reference-to-video — place reference characters into a prompted scene, or drive a video-to-video transformation, with identity consistency and full resolution/duration controls.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringenable_prompt_expansionbooleanseedintegeraspect_ratiostringresolutionstringdurationnumberreference_image_urlsarrayvideo_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=wan%2Fv2.7%2Freference-to-video",
"title": "WAN 2.7 (Reference) generation request",
"description": "Request body accepted by POST /api/v1/generate for wan/v2.7/reference-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "wan/v2.7/reference-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Content to avoid in the video. Max 500 characters.",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Enable intelligent prompt rewriting.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility (0-2147483647).",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
2,
3,
4,
5,
6,
7,
8,
9,
10
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 5
},
"video_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}
WAN 2.7 text-to-video — Alibaba's latest generation video model with aspect ratio, resolution, and duration controls plus optional custom audio.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringnegative_promptstringenable_prompt_expansionbooleanseedintegeraspect_ratiostringresolutionstringdurationnumberaudio_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=wan%2Fv2.7%2Ftext-to-video",
"title": "WAN 2.7 (T2V) generation request",
"description": "Request body accepted by POST /api/v1/generate for wan/v2.7/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "wan/v2.7/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "Content to avoid in the video. Max 500 characters.",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"description": "Enable intelligent prompt rewriting.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility (0-2147483647).",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
]
},
"audio_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
WAN 3.0 image-to-video using a first frame and optional last frame, with native audio and up to 30 seconds of motion.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaudiobooleanseedintegerwatermarkbooleanaspect_ratiostringresolutionstringdurationnumberoutput_formatstringimage_urlstringend_image_urlstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=wan%2Fv3.0%2Fimage-to-video",
"title": "WAN 3.0 (Image to Video) generation request",
"description": "Request body accepted by POST /api/v1/generate for wan/v3.0/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "wan/v3.0/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"maxLength": 20000
},
"audio": {
"title": "Generate Audio",
"description": "Generate a synchronized native audio track.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Reuse a seed to reproduce the result more closely.",
"type": "integer",
"minimum": 0,
"maximum": 2147483647
},
"watermark": {
"title": "Provider Watermark",
"description": "Add the provider's AI-generated watermark.",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26,
27,
28,
29,
30
]
},
"output_format": {
"type": "string",
"enum": [
"mp4"
]
},
"image_url": {
"type": "string",
"format": "uri"
},
"end_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"image_url"
],
"additionalProperties": false
}
WAN 3.0 multimodal reference generation using images, video, and audio for consistent characters, objects, motion, and sound.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaudiobooleanseedintegerwatermarkbooleanaspect_ratiostringresolutionstringdurationnumberoutput_formatstringreference_image_urlsarrayreference_video_urlsarrayreference_audio_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=wan%2Fv3.0%2Freference-to-video",
"title": "WAN 3.0 (Reference to Video) generation request",
"description": "Request body accepted by POST /api/v1/generate for wan/v3.0/reference-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "wan/v3.0/reference-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"maxLength": 20000
},
"audio": {
"title": "Generate Audio",
"description": "Generate a synchronized native audio track.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Reuse a seed to reproduce the result more closely.",
"type": "integer",
"minimum": 0,
"maximum": 2147483647
},
"watermark": {
"title": "Provider Watermark",
"description": "Add the provider's AI-generated watermark.",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26,
27,
28,
29,
30
]
},
"output_format": {
"type": "string",
"enum": [
"mp4"
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 10
},
"reference_video_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 5
},
"reference_audio_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 5
}
},
"required": [
"model_id",
"prompt"
],
"anyOf": [
{
"required": [
"reference_image_urls"
]
},
{
"required": [
"reference_video_urls"
]
},
{
"required": [
"reference_audio_urls"
]
}
],
"additionalProperties": false
}
WAN 3.0 text-to-video with native audio, adaptive duration, cinematic motion, and clips up to 30 seconds.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaudiobooleanseedintegerwatermarkbooleanaspect_ratiostringresolutionstringdurationnumberoutput_formatstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=wan%2Fv3.0%2Ftext-to-video",
"title": "WAN 3.0 (Text to Video) generation request",
"description": "Request body accepted by POST /api/v1/generate for wan/v3.0/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "wan/v3.0/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"maxLength": 20000
},
"audio": {
"title": "Generate Audio",
"description": "Generate a synchronized native audio track.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Reuse a seed to reproduce the result more closely.",
"type": "integer",
"minimum": 0,
"maximum": 2147483647
},
"watermark": {
"title": "Provider Watermark",
"description": "Add the provider's AI-generated watermark.",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26,
27,
28,
29,
30
]
},
"output_format": {
"type": "string",
"enum": [
"mp4"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
WAN 3.0 video editing and replication with optional image and audio references while preserving temporal consistency.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaudiobooleanseedintegerwatermarkbooleanaspect_ratiostringresolutionstringdurationnumberoutput_formatstringreference_image_urlsarrayreference_video_urlsarrayreference_audio_urlsarray
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=wan%2Fv3.0%2Fvideo-edit",
"title": "WAN 3.0 (Video Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for wan/v3.0/video-edit.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "wan/v3.0/video-edit",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"maxLength": 20000
},
"audio": {
"title": "Generate Audio",
"description": "Generate a synchronized native audio track.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Reuse a seed to reproduce the result more closely.",
"type": "integer",
"minimum": 0,
"maximum": 2147483647
},
"watermark": {
"title": "Provider Watermark",
"description": "Add the provider's AI-generated watermark.",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"auto",
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p",
"1080p"
]
},
"duration": {
"type": "number",
"enum": [
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26,
27,
28,
29,
30
]
},
"output_format": {
"type": "string",
"enum": [
"mp4"
]
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 10
},
"reference_video_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 5
},
"reference_audio_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 5
}
},
"required": [
"model_id",
"prompt",
"reference_video_urls"
],
"additionalProperties": false
}
WAN 3.0 Prime animates a required start frame and optional end frame into a 2–30 second video with native audio.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaudiobooleandurationintegerstart_image_urlstringseedintegerend_image_urlstringenable_safety_checkerbooleanenable_prompt_expansionbooleanaspect_ratiostringenable_thinkingbooleanresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=alibaba%2Fwan-3.0-prime%2Fimage-to-video",
"title": "WAN 3.0 Prime (Image) generation request",
"description": "Request body accepted by POST /api/v1/generate for alibaba/wan-3.0-prime/image-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "alibaba/wan-3.0-prime/image-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"maxLength": 5000
},
"audio": {
"title": "Generate Audio",
"default": true,
"type": "boolean"
},
"duration": {
"type": "integer",
"title": "Duration",
"default": 5,
"minimum": 2,
"maximum": 30,
"multipleOf": 1,
"enum": [
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26,
27,
28,
29,
30
]
},
"start_image_url": {
"type": "string",
"format": "uri"
},
"seed": {
"title": "Seed",
"type": "integer",
"minimum": 0,
"maximum": 2147483647
},
"end_image_url": {
"type": "string",
"format": "uri"
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"enable_prompt_expansion": {
"title": "Prompt Expansion",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"adaptive",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"enable_thinking": {
"title": "Thinking Mode",
"default": false,
"type": "boolean"
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p",
"1080p"
]
}
},
"required": [
"model_id",
"start_image_url"
],
"additionalProperties": false
}
WAN 3.0 Prime combines up to ten images, five videos, and five audio references into a controlled 2–30 second video.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaudiobooleandurationintegerweb_urlstringreference_image_urlsarrayfile_urlstringseedintegerreference_video_urlsarrayreference_audio_urlsarrayenable_safety_checkerbooleanenable_prompt_expansionbooleanaspect_ratiostringenable_thinkingbooleanresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=alibaba%2Fwan-3.0-prime%2Freference-to-video",
"title": "WAN 3.0 Prime (Reference) generation request",
"description": "Request body accepted by POST /api/v1/generate for alibaba/wan-3.0-prime/reference-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "alibaba/wan-3.0-prime/reference-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"maxLength": 5000
},
"audio": {
"title": "Generate Audio",
"default": true,
"type": "boolean"
},
"duration": {
"type": "integer",
"title": "Duration",
"default": 5,
"minimum": 2,
"maximum": 30,
"multipleOf": 1,
"enum": [
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26,
27,
28,
29,
30
]
},
"web_url": {
"title": "Reference Web URL",
"type": "string"
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 10
},
"file_url": {
"title": "Reference File URL",
"type": "string"
},
"seed": {
"title": "Seed",
"type": "integer",
"minimum": 0,
"maximum": 2147483647
},
"reference_video_urls": {
"title": "Reference Video URLs",
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 5
},
"reference_audio_urls": {
"title": "Reference Audio URLs",
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 5
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"enable_prompt_expansion": {
"title": "Prompt Expansion",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"adaptive",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"enable_thinking": {
"title": "Thinking Mode",
"default": false,
"type": "boolean"
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p",
"1080p"
]
}
},
"required": [
"model_id"
],
"additionalProperties": false
}
WAN 3.0 Prime creates 2–30 second videos from text with native audio, prompt expansion, and output up to 1080p.
model_idstringextraobjectmax_creditsnumberwebhook_urlstringwebhook_secretstringfolder_idstringpromptstringaudiobooleandurationintegerseedintegerenable_safety_checkerbooleanenable_prompt_expansionbooleanaspect_ratiostringenable_thinkingbooleanresolutionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=alibaba%2Fwan-3.0-prime%2Ftext-to-video",
"title": "WAN 3.0 Prime (Text) generation request",
"description": "Request body accepted by POST /api/v1/generate for alibaba/wan-3.0-prime/text-to-video.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "alibaba/wan-3.0-prime/text-to-video",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"minLength": 1,
"maxLength": 5000
},
"audio": {
"title": "Generate Audio",
"default": true,
"type": "boolean"
},
"duration": {
"type": "integer",
"title": "Duration",
"default": 5,
"minimum": 2,
"maximum": 30,
"multipleOf": 1,
"enum": [
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26,
27,
28,
29,
30
]
},
"seed": {
"title": "Seed",
"type": "integer",
"minimum": 0,
"maximum": 2147483647
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"enable_prompt_expansion": {
"title": "Prompt Expansion",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"adaptive",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
]
},
"enable_thinking": {
"title": "Thinking Mode",
"default": false,
"type": "boolean"
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p",
"1080p"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}
Frontier captioning model. Auto-generates a long-form, detailed caption for any image — no prompt required.
Pricing: Fixed price per analysis call.
model_idstringwebhook_urlstringwebhook_secretstringimage_urlstringlengthstringquestionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/vision?model_id=caption-detailed",
"title": "Caption Detailed request",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "caption-detailed"
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"image_url": {
"type": "string",
"format": "uri"
},
"length": {
"type": "string",
"enum": [
"short",
"normal",
"long"
]
},
"question": {
"type": "string"
}
},
"required": [
"model_id",
"image_url"
],
"additionalProperties": false
}
Lightweight captioning + visual question-answering. Sub-second responses, ideal for high-volume pipelines.
Pricing: Fixed price per analysis call.
model_idstringwebhook_urlstringwebhook_secretstringimage_urlstringquestionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/vision?model_id=caption-fast",
"title": "Caption Fast request",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "caption-fast"
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"image_url": {
"type": "string",
"format": "uri"
},
"question": {
"type": "string"
}
},
"required": [
"model_id",
"image_url"
],
"additionalProperties": false
}
Larger vision-language model. Accurate VQA, OCR, and detailed image analysis when fidelity matters more than speed.
Pricing: Fixed price per analysis call.
model_idstringwebhook_urlstringwebhook_secretstringimage_urlstringpromptstringquestionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/vision?model_id=caption-pro",
"title": "Caption Pro request",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "caption-pro"
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"image_url": {
"type": "string",
"format": "uri"
},
"prompt": {
"type": "string"
},
"question": {
"type": "string"
}
},
"required": [
"model_id",
"image_url"
],
"anyOf": [
{
"required": [
"prompt"
]
},
{
"required": [
"question"
]
}
],
"additionalProperties": false
}
Vision foundation detector. Returns bounding boxes + labels for every object in the image — no prompt needed.
Pricing: Fixed price per analysis call.
model_idstringwebhook_urlstringwebhook_secretstringimage_urlstringquestionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/vision?model_id=detect",
"title": "Detect request",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "detect"
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"image_url": {
"type": "string",
"format": "uri"
},
"question": {
"type": "string"
}
},
"required": [
"model_id",
"image_url"
],
"additionalProperties": false
}
Frontier detection model. Returns structured bounding boxes (x_min, y_min, x_max, y_max) plus a visualised output image.
Pricing: Fixed price per analysis call.
model_idstringwebhook_urlstringwebhook_secretstringimage_urlstringpromptstringquestionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/vision?model_id=detect-pro",
"title": "Detect Pro request",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "detect-pro"
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"image_url": {
"type": "string",
"format": "uri"
},
"prompt": {
"type": "string"
},
"question": {
"type": "string"
}
},
"required": [
"model_id",
"image_url"
],
"anyOf": [
{
"required": [
"prompt"
]
},
{
"required": [
"question"
]
}
],
"additionalProperties": false
}
Targeted detector. Provide a text label and it returns an annotated image with bounding boxes for that specific object.
Pricing: Fixed price per analysis call.
model_idstringwebhook_urlstringwebhook_secretstringimage_urlstringobjectstringquestionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/vision?model_id=detect-targeted",
"title": "Detect Targeted request",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "detect-targeted"
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"image_url": {
"type": "string",
"format": "uri"
},
"object": {
"type": "string"
},
"question": {
"type": "string"
}
},
"required": [
"model_id",
"image_url"
],
"anyOf": [
{
"required": [
"object"
]
},
{
"required": [
"prompt"
]
},
{
"required": [
"question"
]
}
],
"additionalProperties": false
}
NVIDIA Nemotron Omni for audio understanding. Pair an audio clip with a prompt and get a reasoned answer about its contents.
Pricing: Fixed price per analysis call.
model_idstringwebhook_urlstringwebhook_secretstringaudio_urlstringpromptstringquestionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/vision?model_id=multimodal-audio",
"title": "Multimodal Audio request",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "multimodal-audio"
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"audio_url": {
"type": "string",
"format": "uri"
},
"prompt": {
"type": "string"
},
"question": {
"type": "string"
}
},
"required": [
"model_id",
"audio_url"
],
"anyOf": [
{
"required": [
"prompt"
]
},
{
"required": [
"question"
]
}
],
"additionalProperties": false
}
Full multimodal model — accepts image, audio, and video input simultaneously with strong reasoning.
Pricing: Fixed price per analysis call.
model_idstringwebhook_urlstringwebhook_secretstringimage_urlstringpromptstringquestionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/vision?model_id=multimodal-omni",
"title": "Multimodal Omni request",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "multimodal-omni"
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"image_url": {
"type": "string",
"format": "uri"
},
"prompt": {
"type": "string"
},
"question": {
"type": "string"
}
},
"required": [
"model_id",
"image_url"
],
"anyOf": [
{
"required": [
"prompt"
]
},
{
"required": [
"question"
]
}
],
"additionalProperties": false
}
NVIDIA Nemotron Omni for video understanding. Pair a video clip with a prompt and get a reasoned answer about its contents.
Pricing: Fixed price per analysis call.
model_idstringwebhook_urlstringwebhook_secretstringvideo_urlstringpromptstringquestionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/vision?model_id=multimodal-video",
"title": "Multimodal Video request",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "multimodal-video"
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"video_url": {
"type": "string",
"format": "uri"
},
"prompt": {
"type": "string"
},
"question": {
"type": "string"
}
},
"required": [
"model_id",
"video_url"
],
"anyOf": [
{
"required": [
"prompt"
]
},
{
"required": [
"question"
]
}
],
"additionalProperties": false
}
Frontier visual question-answering. Ask any question about an image and get a reasoned answer.
Pricing: Fixed price per analysis call.
model_idstringwebhook_urlstringwebhook_secretstringimage_urlstringpromptstringquestionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/vision?model_id=query-pro",
"title": "Query Pro request",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "query-pro"
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"image_url": {
"type": "string",
"format": "uri"
},
"prompt": {
"type": "string"
},
"question": {
"type": "string"
}
},
"required": [
"model_id",
"image_url"
],
"anyOf": [
{
"required": [
"prompt"
]
},
{
"required": [
"question"
]
}
],
"additionalProperties": false
}
Fast binary safety classifier. Returns a boolean flag — safe or unsafe. Checks up to 10 images at once.
Pricing: Fixed price per analysis call.
model_idstringwebhook_urlstringwebhook_secretstringimage_urlstringquestionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/vision?model_id=safety-classifier",
"title": "Safety Classifier request",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "safety-classifier"
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"image_url": {
"type": "string",
"format": "uri"
},
"question": {
"type": "string"
}
},
"required": [
"model_id",
"image_url"
],
"additionalProperties": false
}
Fine-grained safety probability scorer. Returns a 0–1 float instead of a binary flag — useful for threshold-based moderation pipelines.
Pricing: Fixed price per analysis call.
model_idstringwebhook_urlstringwebhook_secretstringimage_urlstringquestionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/vision?model_id=safety-probability",
"title": "Safety Probability request",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "safety-probability"
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"image_url": {
"type": "string",
"format": "uri"
},
"question": {
"type": "string"
}
},
"required": [
"model_id",
"image_url"
],
"additionalProperties": false
}
Next-generation vision model. Supports both auto-captioning and visual Q&A via task_type.
Pricing: Fixed price per analysis call.
model_idstringwebhook_urlstringwebhook_secretstringimage_urlstringtask_typestringpromptstringquestionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/vision?model_id=vision-next",
"title": "Vision Next request",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "vision-next"
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"image_url": {
"type": "string",
"format": "uri"
},
"task_type": {
"type": "string",
"enum": [
"caption",
"query"
]
},
"prompt": {
"type": "string"
},
"question": {
"type": "string"
}
},
"required": [
"model_id",
"image_url"
],
"additionalProperties": false
}
Multimodal model with strong reasoning and structured-output support. Pair an image with a prompt and get a reasoned answer.
Pricing: Fixed price per analysis call.
model_idstringwebhook_urlstringwebhook_secretstringimage_urlstringpromptstringquestionstring
Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/vision?model_id=vision-omni",
"title": "Vision Omni request",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "vision-omni"
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"image_url": {
"type": "string",
"format": "uri"
},
"prompt": {
"type": "string"
},
"question": {
"type": "string"
}
},
"required": [
"model_id",
"image_url"
],
"anyOf": [
{
"required": [
"prompt"
]
},
{
"required": [
"question"
]
}
],
"additionalProperties": false
}