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"
  }
}

After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.

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

​Submit a Task

​Canvas Parameter

​Retrieve Images

​Verified Example

Authorizations

Body

Response

Submit a Task

Canvas Parameter

Retrieve Images

Verified Example