Flux Dev Image to Image

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "blackforestlabs/flux/dev/image-to-image",
  "input": {
    "prompt": "Reimagine this same reading room as a warm and inviting evening interior. Retain the principal perspective, the large window on the left, the central rectangular table and chairs, and the low shelves on the right. Replace the cold concrete wall finish with warm light-oak paneling and the floor with natural oak planks; give the chairs comfortable muted rust-colored upholstery. Add subtle warm reading light above the table and a gentle glow along the shelves. Through the existing window, show the soft blue light of dusk. Realistic architectural photography with convincing wood grain, fabric texture and balanced warm interior light against cool outdoor light. The room remains simple, unoccupied and clearly related to the original layout. No text, logos, commercial styling or watermark.",
    "n": 1,
    "output_format": "png",
    "image_urls": [
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux/dev/image-to-image/v1/01/input.png"
    ]
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "I0RYI5JVOJC6CR8I",
    "status": "running",
    "created_time": "2026-09-25T11:22:15"
  }
}

POST

api

generate

submit

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "blackforestlabs/flux/dev/image-to-image",
  "input": {
    "prompt": "Reimagine this same reading room as a warm and inviting evening interior. Retain the principal perspective, the large window on the left, the central rectangular table and chairs, and the low shelves on the right. Replace the cold concrete wall finish with warm light-oak paneling and the floor with natural oak planks; give the chairs comfortable muted rust-colored upholstery. Add subtle warm reading light above the table and a gentle glow along the shelves. Through the existing window, show the soft blue light of dusk. Realistic architectural photography with convincing wood grain, fabric texture and balanced warm interior light against cool outdoor light. The room remains simple, unoccupied and clearly related to the original layout. No text, logos, commercial styling or watermark.",
    "n": 1,
    "output_format": "png",
    "image_urls": [
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux/dev/image-to-image/v1/01/input.png"
    ]
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "I0RYI5JVOJC6CR8I",
    "status": "running",
    "created_time": "2026-09-25T11:22:15"
  }
}

Submit a Task

Send model: "blackforestlabs/flux/dev/image-to-image" and an input object to POST /api/generate/submit. Authenticate with Authorization: Bearer VIDGO_API_KEY.

prompt: Required string. Describe the image or editing instructions using at least one character after trimming.
image_urls: Required array containing one public HTTP(S) source-image URL. The source image guides the edited output.
n: Positive integer specifying the output image count, default 1.
output_format: png or jpeg, default png.

Canvas Parameter

size defines the text-to-image canvas and defaults to 1:1. Image-to-image generation uses the source image to guide the output. The request example supplies the source image, prompt, image count, and output format.

Retrieve Images

The submission response returns data.task_id. Use Query Task Status to follow the task through not_started, running, finished, or failed. Read image URLs from data.files[].file_url when the status is finished. For failed, read data.error_message. You can provide a top-level callback_url to receive the terminal result through a webhook.

Verified Example

This example was generated through the Vidgo test API. The source and result images are hosted on the Vidgo CDN. Source image

{
  "code": 200,
  "data": {
    "task_id": "I0RYI5JVOJC6CR8I",
    "status": "finished",
    "files": [
      {
        "file_url": "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux/dev/image-to-image/v1/01/output.png",
        "file_type": "image"
      }
    ],
    "created_time": "2026-09-25T11:22:15",
    "error_message": null,
    "progress": 100
  }
}

Authorizations

Authorization

string

header

required

Use Authorization: Bearer VIDGO_API_KEY.

Body

application/json

model

enum<string>

required

Available options:

blackforestlabs/flux/dev/image-to-image

input

object

required

Parameters for single-image editing.

Show child attributes

callback_url

string<uri>

Optional webhook callback URL.

Response

Task submitted successfully

code

integer

required

Example:

200

data

object

required

Show child attributes

Overview

Chat Series

Image Series

Video Series

Music Series

3D Series

File Management

Task Management

Account Management

Flux Dev Image to Image

Submit a Task

Canvas Parameter

Retrieve Images

Verified Example

Authorizations

Body

Response

​Submit a Task

​Canvas Parameter

​Retrieve Images

​Verified Example

Authorizations

Body

Response

Submit a Task

Canvas Parameter

Retrieve Images

Verified Example