# Telestyle V2 Style Transfer > Restyle any image with TeleStyle v2 — provide an original image and a styling reference, and the model re-renders the original in the reference's visual style while preserving its content and composition. ## Overview - **Endpoint**: `https://fal.run/fal-ai/telestyle-v2` - **Model ID**: `fal-ai/telestyle-v2` - **Category**: image-to-image - **Kind**: inference **Tags**: stylized, transform, editing ## Pricing - **Price**: $0.035 per megapixels For more details, see [fal.ai pricing](https://fal.ai/pricing). ## API Information This model can be used via our HTTP API or more conveniently via our client libraries. See the input and output schema below, as well as the usage examples. ### Input Schema The API accepts the following input parameters: - **`content_image_url`** (`string`, _required_): URL of the content image — the image whose subject and structure are preserved while the style is applied. - Examples: "https://v3.fal.media/files/monkey/i3saq4bAPXSIl08nZtq9P_ec535747aefc4e31943136a6d8587075.png" - **`style_image_url`** (`string`, _required_): URL of the style reference image — the artistic style, material, lighting and color of this image are transferred onto the content image. - Examples: "https://v3.fal.media/files/penguin/BCOZp6teRhSQFuOXpbBOa_da8ef9b4982347a2a62a516b737d4f21.png" - **`lora_scale`** (`float`, _optional_): Strength of the TeleStyleV2 style adapter. 1.0 matches the reference implementation; lower values apply the style more subtly. Default value: `1` - Default: `1` - Range: `0` to `4` - **`use_lightning_lora`** (`boolean`, _optional_): If true, use the Lightning LoRA in addition to the default LoRA. Default value: `true` - Default: `true` - **`lightning_lora_scale`** (`float`, _optional_): Strength of the Lightning LoRA. 1.0 matches the reference implementation; lower values apply the style more subtly. Default value: `1` - Default: `1` - Range: `0` to `4` - **`use_content_description`** (`boolean`, _optional_): If true, describe the content image with a VLM and add the description to the prompt. Default value: `true` - Default: `true` - **`use_style_description`** (`boolean`, _optional_): If true, describe the style image with a VLM and add the description to the prompt. Default value: `true` - Default: `true` - **`image_size`** (`ImageSize | Enum`, _optional_): The size of the generated image. If not provided, the size of the content image is used. - One of: ImageSize | Enum - **`negative_prompt`** (`string`, _optional_): The negative prompt for the generation. Default value: `""` - Default: `""` - Examples: "" - **`num_inference_steps`** (`integer`, _optional_): The number of inference steps to perform. Default value: `4` - Default: `4` - Range: `2` to `50` - **`guidance_scale`** (`float`, _optional_): The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt. Default value: `1` - Default: `1` - Range: `0` to `20` - **`acceleration`** (`AccelerationEnum`, _optional_): Acceleration level for image generation. 'none' (the default) honors the requested num_inference_steps, so the default 4-step Lightning configuration runs in 4 steps. 'regular' engages the downstream accelerated path, which runs a fixed 10 steps regardless of num_inference_steps. Default value: `"none"` - Default: `"none"` - Options: `"none"`, `"regular"` - Examples: "none" - **`num_images`** (`integer`, _optional_): The number of images to generate. Default value: `1` - Default: `1` - Range: `1` to `4` - **`seed`** (`integer`, _optional_): The same seed and the same inputs given to the same version of the model will output the same image every time. - **`sync_mode`** (`boolean`, _optional_): If `True`, the media will be returned as a data URI and the output data won't be available in the request history. - Default: `false` - **`enable_safety_checker`** (`boolean`, _optional_): If set to true, the safety checker will be enabled. Default value: `true` - Default: `true` - **`output_format`** (`OutputFormatEnum`, _optional_): The format of the generated image. Default value: `"png"` - Default: `"png"` - Options: `"jpeg"`, `"png"` **Required Parameters Example**: ```json { "content_image_url": "https://v3.fal.media/files/monkey/i3saq4bAPXSIl08nZtq9P_ec535747aefc4e31943136a6d8587075.png", "style_image_url": "https://v3.fal.media/files/penguin/BCOZp6teRhSQFuOXpbBOa_da8ef9b4982347a2a62a516b737d4f21.png" } ``` **Full Example**: ```json { "content_image_url": "https://v3.fal.media/files/monkey/i3saq4bAPXSIl08nZtq9P_ec535747aefc4e31943136a6d8587075.png", "style_image_url": "https://v3.fal.media/files/penguin/BCOZp6teRhSQFuOXpbBOa_da8ef9b4982347a2a62a516b737d4f21.png", "lora_scale": 1, "use_lightning_lora": true, "lightning_lora_scale": 1, "use_content_description": true, "use_style_description": true, "negative_prompt": "", "num_inference_steps": 4, "guidance_scale": 1, "acceleration": "none", "num_images": 1, "enable_safety_checker": true, "output_format": "png" } ``` ### Output Schema The API returns the following output format: - **`images`** (`list`, _required_): The stylized image(s). - Array of ImageFile - Examples: [{"height":1024,"content_type":"image/png","url":"https://v3.fal.media/files/zebra/mMW8_S5PeGuDXLTfIKCpG.png","width":1024}] - **`has_nsfw_concepts`** (`list`, _optional_): Whether the generated image contains NSFW concepts. - Array of boolean - Examples: [false] - **`prompt`** (`string`, _optional_): The prompt derived from the content and style images. Default value: `""` - Default: `""` - **`seed`** (`integer`, _required_): The seed used for generation. **Example Response**: ```json { "images": [ { "height": 1024, "content_type": "image/png", "url": "https://v3.fal.media/files/zebra/mMW8_S5PeGuDXLTfIKCpG.png", "width": 1024 } ], "has_nsfw_concepts": [ false ] } ``` ## Usage Examples ### cURL ```bash curl --request POST \ --url https://fal.run/fal-ai/telestyle-v2 \ --header "Authorization: Key $FAL_KEY" \ --header "Content-Type: application/json" \ --data '{ "content_image_url": "https://v3.fal.media/files/monkey/i3saq4bAPXSIl08nZtq9P_ec535747aefc4e31943136a6d8587075.png", "style_image_url": "https://v3.fal.media/files/penguin/BCOZp6teRhSQFuOXpbBOa_da8ef9b4982347a2a62a516b737d4f21.png" }' ``` ### Python Ensure you have the Python client installed: ```bash pip install fal-client ``` Then use the API client to make requests: ```python import fal_client def on_queue_update(update): if isinstance(update, fal_client.InProgress): for log in update.logs: print(log["message"]) result = fal_client.subscribe( "fal-ai/telestyle-v2", arguments={ "content_image_url": "https://v3.fal.media/files/monkey/i3saq4bAPXSIl08nZtq9P_ec535747aefc4e31943136a6d8587075.png", "style_image_url": "https://v3.fal.media/files/penguin/BCOZp6teRhSQFuOXpbBOa_da8ef9b4982347a2a62a516b737d4f21.png" }, with_logs=True, on_queue_update=on_queue_update, ) print(result) ``` ### JavaScript Ensure you have the JavaScript client installed: ```bash npm install --save @fal-ai/client ``` Then use the API client to make requests: ```javascript import { fal } from "@fal-ai/client"; const result = await fal.subscribe("fal-ai/telestyle-v2", { input: { content_image_url: "https://v3.fal.media/files/monkey/i3saq4bAPXSIl08nZtq9P_ec535747aefc4e31943136a6d8587075.png", style_image_url: "https://v3.fal.media/files/penguin/BCOZp6teRhSQFuOXpbBOa_da8ef9b4982347a2a62a516b737d4f21.png" }, logs: true, onQueueUpdate: (update) => { if (update.status === "IN_PROGRESS") { update.logs.map((log) => log.message).forEach(console.log); } }, }); console.log(result.data); console.log(result.requestId); ``` ## Additional Resources ### Documentation - [Model Playground](https://fal.ai/models/fal-ai/telestyle-v2) - [API Documentation](https://fal.ai/models/fal-ai/telestyle-v2/api) - [OpenAPI Schema](https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=fal-ai/telestyle-v2) ### fal.ai Platform - [Platform Documentation](https://docs.fal.ai) - [Python Client](https://docs.fal.ai/clients/python) - [JavaScript Client](https://docs.fal.ai/clients/javascript)