ByteDance Seedream v4 Edit

https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit
Admin
ByteDance Seedream v4 Edit is an image-to-image generation and editing model that integrates image...
Tokens:6,505
Snippets:26
Trust Score:10
Update:1 year ago
Show doc for...
Tokens:
Raw
### Install Fal AI Client

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/api

Installs the Fal AI client package using npm, yarn, or pnpm. This client simplifies interaction with the model API.

```bash
npm install --save @fal-ai/client
```

--------------------------------

### ByteDance Seedream v4 Edit API - Full Example

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/llms

A comprehensive JSON example for the ByteDance Seedream v4 Edit API, including optional parameters like 'image_size', 'num_images', 'max_images', and 'enable_safety_checker'.

```json
{
  "prompt": "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building.",
  "image_size": {
    "height": 2160,
    "width": 3840
  },
  "num_images": 1,
  "max_images": 1,
  "enable_safety_checker": true,
  "image_urls": [
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_1.png",
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_2.png",
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_3.png",
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_4.png"
  ]
}
```

--------------------------------

### ByteDance Seedream v4 Edit API - Required Parameters

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/llms

Example JSON payload for the ByteDance Seedream v4 Edit API, demonstrating the essential 'prompt' and 'image_urls' parameters.

```json
{
  "prompt": "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building.",
  "image_urls": [
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_1.png",
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_2.png",
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_3.png",
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_4.png"
  ]
}
```

--------------------------------

### Subscribe to seedream v4 edit model updates using Python

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/llms

This Python snippet demonstrates how to use the fal-client library to subscribe to the seedream v4 edit model. It includes installing the client, defining a callback for log updates, and making the subscription with a prompt and image URLs.

```bash
pip install fal-client
```

```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/bytedance/seedream/v4/edit",
    arguments={
        "prompt": "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building.",
        "image_urls": ["https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_1.png", "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_2.png", "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_3.png", "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_4.png"]
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)
```

--------------------------------

### Subscribe to seedream v4 edit model updates using JavaScript

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/llms

This JavaScript snippet shows how to use the @fal-ai/client library to interact with the seedream v4 edit model. It covers installing the client, subscribing to the model, handling log updates, and logging the final result and request ID.

```bash
npm install --save @fal-ai/client
```

```javascript
import { fal } from "@fal-ai/client";

const result = await fal.subscribe("fal-ai/bytedance/seedream/v4/edit", {
  input: {
    prompt: "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building.",
    image_urls: ["https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_1.png", "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_2.png", "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_3.png", "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_4.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);
```

--------------------------------

### Seedream 4.0 Edit API Response Example

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/playground

This JSON object represents a typical successful response from the Seedream 4.0 Edit API, detailing the generated images and the seed used for generation.

```json
{
  "images": [
    {
      "url": "https://storage.googleapis.com/falserverless/example_outputs/seedream4_edit_output.png"
    }
  ],
  "seed": 746406749
}
```

--------------------------------

### Get Request Result (JavaScript)

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/api

Retrieves the result of a completed request using its request ID. This is typically called after confirming the request status is 'COMPLETED'.

```javascript
import { fal } from "@fal-ai/client";

const result = await fal.queue.result("fal-ai/bytedance/seedream/v4/edit", {
  requestId: "764cabcf-b745-4b3e-ae38-1200304cf45b"
});
console.log(result.data);
console.log(result.requestId);
```

--------------------------------

### Upload File using Fal Client

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/api

Demonstrates how to upload a file using the fal client's storage utility. The uploaded file can then be used in subsequent requests. This requires the '@fal-ai/client' package.

```javascript
import { fal } from "@fal-ai/client";

const file = new File(["Hello, World!"], "hello.txt", { type: "text/plain" });
const url = await fal.storage.upload(file);
```

--------------------------------

### POST /fal-ai/bytedance/seedream/v4/edit

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/playground

Generate and edit images using the Seedream 4.0 model. This endpoint allows for text-guided image manipulation and editing based on provided images and prompts.

```APIDOC
## POST /fal-ai/bytedance/seedream/v4/edit

### Description
This endpoint allows you to generate and edit images using the Seedream 4.0 model. You can provide a prompt to guide the image creation or editing process, along with image URLs.

### Method
POST

### Endpoint
/fal-ai/bytedance/seedream/v4/edit

### Parameters
#### Request Body
- **prompt** (string) - Required - A text description to guide the image generation or editing.
- **image_urls** (array of strings) - Required - A list of URLs for the input images.

### Request Example
```json
{
  "prompt": "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building.",
  "image_urls": [
    "https://example.com/image1.png",
    "https://example.com/image2.png"
  ]
}
```

### Response
#### Success Response (200)
- **images** (array of objects) - A list of generated images, each with a 'url' field.
  - **url** (string) - The URL of the generated image.
- **seed** (integer) - The seed used for generating the image, useful for reproducibility.

#### Response Example
```json
{
  "images": [
    {
      "url": "https://storage.googleapis.com/falserverless/example_outputs/seedream4_edit_output.png"
    }
  ],
  "seed": 746406749
}
```
```

--------------------------------

### Configure API Key Manually (JavaScript)

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/api

Configures the Fal AI client with an API key manually if environment variables cannot be set. This is useful for client-side applications, but requires protecting the API key.

```javascript
import { fal } from "@fal-ai/client";

fal.config({
  credentials: "YOUR_FAL_KEY"
});
```

--------------------------------

### Authentication API

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/api

Details on how to authenticate API requests using an API key.

```APIDOC
## Authentication API

### API Key

Authentication is performed using an API key. It is recommended to set the `FAL_KEY` environment variable.

For environments where environment variables cannot be set (e.g., client-side applications), the API key can be configured manually.

```javascript
import { fal } from "@fal-ai/client";

fal.config({
  credentials: "YOUR_FAL_KEY"
});
```

**Security Note:** For client-side applications, use a server-side proxy to protect your API key.
```

--------------------------------

### POST /fal-ai/bytedance/seedream/v4/edit

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/llms

This endpoint allows you to edit images based on a provided prompt and a list of image URLs. It supports various client integrations like cURL, Python, and JavaScript.

```APIDOC
## POST /fal-ai/bytedance/seedream/v4/edit

### Description
Edits images based on a text prompt and multiple image URLs.

### Method
POST

### Endpoint
https://fal.run/fal-ai/bytedance/seedream/v4/edit

### Parameters
#### Request Body
- **prompt** (string) - Required - The text prompt describing the desired edits.
- **image_urls** (array of strings) - Required - A list of URLs pointing to the images to be edited.

### Request Example
```json
{
  "prompt": "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building.",
  "image_urls": [
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_1.png",
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_2.png",
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_3.png",
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_4.png"
  ]
}
```

### Response
#### Success Response (200)
- **output** (object) - The result of the image editing process.
- **logs** (array of objects) - Logs generated during the process.

#### Response Example
```json
{
  "output": { ... },
  "logs": [ ... ]
}
```
```

--------------------------------

### Set API Key Environment Variable

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/api

Sets the FAL_KEY environment variable with your API key. This is the recommended way to authenticate API requests.

```bash
export FAL_KEY="YOUR_API_KEY"
```

--------------------------------

### Send POST request with prompt and image URLs using cURL

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/llms

This snippet shows how to make a POST request to the seedream v4 edit API endpoint using cURL. It includes setting the Authorization header, Content-Type, and providing a JSON payload with a prompt and multiple image URLs.

```bash
curl --request POST \
  --url https://fal.run/fal-ai/bytedance/seedream/v4/edit \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{ \
     "prompt": "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building.", \
     "image_urls": [ \
       "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_1.png", \
       "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_2.png", \
       "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_3.png", \
       "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_4.png" \
     ] \
   }'
```

--------------------------------

### Seedream v4 Edit API

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/api

This endpoint allows you to edit images using the Seedream v4 model. You can provide a text prompt, specify image sizes, control the number of generated images, and use image URLs or uploaded files as input.

```APIDOC
## POST /websites/fal_ai_models_fal-ai_bytedance_seedream_v4_edit

### Description
Edits an image based on a text prompt and provided image inputs.

### Method
POST

### Endpoint
/websites/fal_ai_models_fal-ai_bytedance_seedream_v4_edit

### Parameters
#### Query Parameters
- **prompt** (string) - Required - The text prompt used to edit the image.
- **image_size** (ImageSize | Enum) - Optional - The size of the generated image. Width and height must be between 1024 and 4096. Possible enum values: `square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9`. Can also be an object with `width` and `height`.
- **num_images** (integer) - Optional - Number of separate model generations to be run. Default value: `1`.
- **max_images** (integer) - Optional - If set to a number greater than one, enables multi-image generation. The model will potentially return up to `max_images` images every generation. Default value: `1`.
- **seed** (integer) - Optional - Random seed to control the stochasticity of image generation.
- **sync_mode** (boolean) - Optional - If set to true, the function will wait for the image to be generated and uploaded before returning the response.
- **enable_safety_checker** (boolean) - Optional - If set to true, the safety checker will be enabled. Default value: `true`.
- **image_urls** (list<string>) - Required - List of URLs of input images for editing. Presently, up to 10 image inputs are allowed.

#### Request Body
(Not applicable, parameters are sent as query parameters or handled via client upload)

### Request Example
```json
{
  "prompt": "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building.",
  "image_size": {
    "height": 2160,
    "width": 3840
  },
  "num_images": 1,
  "max_images": 1,
  "enable_safety_checker": true,
  "image_urls": [
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_1.png",
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_2.png",
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_3.png",
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_4.png"
  ]
}
```

### Response
#### Success Response (200)
- **images** (list<Image>) - Required - Generated images.
- **seed** (integer) - Required - Seed used for generation.

#### Response Example
```json
{
  "images": [
    {
      "url": "https://storage.googleapis.com/falserverless/example_outputs/seedream4_edit_output.png"
    }
  ],
  "seed": 746406749
}
```

### Other Types
#### File
- **url** (string) - Required - The URL where the file can be downloaded from.
- **content_type** (string) - Optional - The mime type of the file.
- **file_name** (string) - Optional - The name of the file. It will be auto-generated if not provided.
- **file_size** (integer) - Optional - The size of the file in bytes.
- **file_data** (string) - Optional - File data.

#### Image
- **url** (string) - Required - The URL where the file can be downloaded from.
- **content_type** (string) - Optional - The mime type of the file.
- **file_name** (string) - Optional - The name of the file. It will be auto-generated if not provided.
- **file_size** (integer) - Optional - The size of the file in bytes.
- **file_data** (string) - Optional - File data.
- **width** (integer) - Optional - The width of the image in pixels.
- **height** (integer) - Optional - The height of the image in pixels.

#### ImageSize
- **width** (integer) - Optional - The width of the generated image. Default value: `512`.
- **height** (integer) - Optional - The height of the generated image. Default value: `512`.
```

--------------------------------

### Submit Image Editing Request (JavaScript)

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/api

Submits an image editing request to the Seedream v4 model using the Fal AI client. It includes a prompt and multiple image URLs as input. The client handles queue updates and returns the result upon completion.

```javascript
import { fal } from "@fal-ai/client";

const result = await fal.subscribe("fal-ai/bytedance/seedream/v4/edit", {
  input: {
    prompt: "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building.",
    image_urls: ["https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_1.png", "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_2.png", "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_3.png", "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_4.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);
```

--------------------------------

### Seedream v4 Edit API

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/llms

The Seedream v4 Edit API allows users to edit existing images based on text prompts and provided image URLs. It supports various parameters to control the image generation process, including size, number of images, and safety features.

```APIDOC
## POST /websites/fal_ai_models_fal-ai_bytedance_seedream_v4_edit

### Description
This endpoint allows for image editing using the Seedream v4 model. You provide a text prompt and one or more image URLs to guide the editing process.

### Method
POST

### Endpoint
https://fal.run/fal-ai/bytedance/seedream/v4/edit

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **`prompt`** (string) - Required - The text prompt used to edit the image.
- **`image_size`** (object) - Optional - The size of the generated image. Width and height must be between 1024 and 4096. Defaults to `{"height":2048,"width":2048}`.
  - **`height`** (integer) - Required - Height of the image.
  - **`width`** (integer) - Required - Width of the image.
- **`num_images`** (integer) - Optional - Number of separate model generations to be run with the prompt. Defaults to `1`. Range: `1` to `6`.
- **`max_images`** (integer) - Optional - If set to a number greater than one, enables multi-image generation. The model will potentially return up to `max_images` images every generation. Defaults to `1`. Range: `1` to `6`.
- **`seed`** (integer) - Optional - Random seed to control the stochasticity of image generation.
- **`sync_mode`** (boolean) - Optional - If set to true, the function will wait for the image to be generated and uploaded before returning the response. Defaults to `false`.
- **`enable_safety_checker`** (boolean) - Optional - If set to true, the safety checker will be enabled. Defaults to `true`.
- **`image_urls`** (list<string>) - Required - List of URLs of input images for editing. Presently, up to 10 image inputs are allowed.

### Request Example
```json
{
  "prompt": "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building.",
  "image_urls": [
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_1.png",
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_2.png",
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_3.png",
    "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_4.png"
  ]
}
```

### Response
#### Success Response (200)
- **`images`** (list<Image>) - Required - Generated images.
  - **`url`** (string) - URL of the generated image.
- **`seed`** (integer) - Required - Seed used for generation.

#### Response Example
```json
{
  "images": [
    {
      "url": "https://storage.googleapis.com/falserverless/example_outputs/seedream4_edit_output.png"
    }
  ],
  "seed": 746406749
}
```
```

--------------------------------

### Submit Request to Queue (JavaScript)

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/api

Submits a request to the Fal AI queue for the Seedream v4 model. This method is suitable for long-running requests and allows specifying a webhook URL for asynchronous results.

```javascript
import { fal } from "@fal-ai/client";

const { request_id } = await fal.queue.submit("fal-ai/bytedance/seedream/v4/edit", {
  input: {
    prompt: "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building.",
    image_urls: ["https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_1.png", "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_2.png", "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_3.png", "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_4.png"]
  },
  webhookUrl: "https://optional.webhook.url/for/results",
});
```

--------------------------------

### Bytedance Seedream v4 Edit API

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/index

This API endpoint allows users to perform image editing and generation using the Seedream 4.0 model. You can provide a text prompt and image URLs to modify existing images or create new ones.

```APIDOC
## POST /fal-ai/bytedance/seedream/v4/edit

### Description
This endpoint allows for image generation and editing using the Seedream 4.0 model. Users can provide a text prompt and image URLs to modify existing images or create new ones.

### Method
POST

### Endpoint
/fal-ai/bytedance/seedream/v4/edit

### Parameters
#### Request Body
- **prompt** (string) - Required - The text prompt describing the desired image modifications or generation.
- **image_urls** (array of strings) - Required - A list of URLs pointing to the images to be edited or used as a base for generation.

### Request Example
```json
{
  "prompt": "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building.",
  "image_urls": [
    "https://example.com/image1.jpg",
    "https://example.com/image2.png"
  ]
}
```

### Response
#### Success Response (200)
- **images** (array of objects) - A list of generated or edited images, each with a URL.
  - **url** (string) - The URL of the resulting image.
- **seed** (integer) - A seed value used for the generation process.

#### Response Example
```json
{
  "images": [
    {
      "url": "https://storage.googleapis.com/falserverless/example_outputs/seedream4_edit_output.png"
    }
  ],
  "seed": 746406749
}
```
```

--------------------------------

### Queue Management API

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/api

APIs for managing long-running requests, including submitting jobs, fetching their status, and retrieving results.

```APIDOC
## Queue Management API

### Submit a request to the queue

Submits a request to the model and returns a `request_id`. Optionally accepts a `webhookUrl` for asynchronous result notification.

```javascript
import { fal } from "@fal-ai/client";

const { request_id } = await fal.queue.submit("fal-ai/bytedance/seedream/v4/edit", {
  input: {
    prompt: "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building.",
    image_urls: ["https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_1.png", "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_2.png", "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_3.png", "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_4.png"]
  },
  webhookUrl: "https://optional.webhook.url/for/results",
});
```

### Fetch request status

Retrieves the current status of a submitted request using its `requestId`. Can optionally include logs.

```javascript
import { fal } from "@fal-ai/client";

const status = await fal.queue.status("fal-ai/bytedance/seedream/v4/edit", {
  requestId: "764cabcf-b745-4b3e-ae38-1200304cf45b",
  logs: true,
});
```

### Get the result

Fetches the final result of a completed request using its `requestId`.

```javascript
import { fal } from "@fal-ai/client";

const result = await fal.queue.result("fal-ai/bytedance/seedream/v4/edit", {
  requestId: "764cabcf-b745-4b3e-ae38-1200304cf45b"
});
console.log(result.data);
console.log(result.requestId);
```
```

--------------------------------

### POST /fal-ai/bytedance/seedream/v4/edit

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/api

Submits a request to the Seedream 4.0 Edit model for image manipulation. This method handles the API submission protocol, including status updates, and returns the result upon completion.

```APIDOC
## POST fal-ai/bytedance/seedream/v4/edit

### Description
This endpoint allows users to interact with the Seedream 4.0 Edit model for image editing tasks. It supports providing a text prompt and multiple image URLs for editing.

### Method
POST

### Endpoint
/fal-ai/bytedance/seedream/v4/edit

### Parameters
#### Request Body
- **input** (object) - Required - Input parameters for the model.
  - **prompt** (string) - Required - A text description of the desired edits.
  - **image_urls** (array of strings) - Required - A list of URLs pointing to the images to be edited.
- **logs** (boolean) - Optional - Whether to stream logs during processing.
- **onQueueUpdate** (function) - Optional - A callback function to handle status updates.

### Request Example
```javascript
import { fal } from "@fal-ai/client";

const result = await fal.subscribe("fal-ai/bytedance/seedream/v4/edit", {
  input: {
    prompt: "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building.",
    image_urls: ["https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_1.png", "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_2.png", "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_3.png", "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_4.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);
```

### Response
#### Success Response (200)
- **data** (object) - The result of the image editing process.
- **requestId** (string) - The unique identifier for the request.

#### Response Example
```json
{
  "data": { ... },
  "requestId": "764cabcf-b745-4b3e-ae38-1200304cf45b"
}
```
```

--------------------------------

### Fetch Request Status (JavaScript)

Source: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit/api

Fetches the status of a submitted request using its request ID. This allows checking if a long-running job is still in progress or has completed. Logs can also be retrieved.

```javascript
import { fal } from "@fal-ai/client";

const status = await fal.queue.status("fal-ai/bytedance/seedream/v4/edit", {
  requestId: "764cabcf-b745-4b3e-ae38-1200304cf45b",
  logs: true,
});
```
Tokens:
Raw