text-to-image
FLUX.2 [pro] Edit
FLUX.2 [pro] Edit delivers production-grade image-to-image editing from Black Forest Labs—apply natural-language instructions and exact hex color control for consistent, studio-quality results. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Use one of our client libraries to get started quickly.
FLUX.2 [pro] Edit
FLUX.2 [pro] Edit delivers production-grade image-to-image editing from Black Forest Labs—apply natural-language instructions and exact hex color control for consistent, studio-quality results. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
1. Calling the API
Submit a request
Send a POST request to start generation. The API returns immediately with a prediction ID for polling.
curl -X POST "https://api.vibedream.ai/api/v1/models/flux-2-pro-edit/generate" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $VIBEDREAM_API_KEY" \
-d '{
"prompt": "A beautiful sunset over mountains with golden light",
"images": [
"https://example.com/image1.jpg"
],
"size": "small",
"seed": 0,
"enable_sync_mode": false,
"enable_base64_output": false,
"enable_safety_checker": false
}'2. Authentication
The API uses an API Key for authentication.
Get your API Key
Get your API key from vibedream.ai/models/api-keys.
Environment variable
export VIBEDREAM_API_KEY="your-api-key"
3. Queue & Results
Generation requests are queued and processed asynchronously. Poll the prediction endpoint until status is completed or failed.
Submit request
curl -X POST "https://api.vibedream.ai/api/v1/models/flux-2-pro-edit/generate" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $VIBEDREAM_API_KEY" \
-d '{
"prompt": "A beautiful sunset over mountains with golden light",
"images": [
"https://example.com/image1.jpg"
],
"size": "small",
"seed": 0,
"enable_sync_mode": false,
"enable_base64_output": false,
"enable_safety_checker": false
}'Response
Returns immediately with a prediction ID. Use id to poll for results.
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "processing",
"statusUrl": "https://api.vibedream.ai/api/v1/predictions/550e8400-e29b-41d4-a716-446655440000",
"estimatedTime": "Variable, depending on task",
"costCents": 7,
"createdAt": "2025-01-15T12:00:00.000Z"
}Get the result
Polling
# Replace YOUR_PREDICTION_ID with the id from the submit response curl "https://api.vibedream.ai/api/v1/predictions/YOUR_PREDICTION_ID" \ -H "Authorization: Bearer $VIBEDREAM_API_KEY" # Poll every 1-2s until status is "completed" or "failed"
Completed response
outputs is string[] — an array of direct download URLs hosted on assets.vibedream.ai.
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"modelId": "flux-2-pro-edit",
"modelName": "FLUX.2 [pro] Edit",
"status": "completed",
"outputs": [
"https://assets.vibedream.ai/outputs/550e8400-e29b-41d4-a716-446655440000/1736942400000-0.png"
],
"error": null,
"createdAt": "2025-01-15T12:00:00.000Z",
"completedAt": "2025-01-15T12:00:30.000Z"
}Failed response
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"modelId": "flux-2-pro-edit",
"modelName": "FLUX.2 [pro] Edit",
"status": "failed",
"outputs": null,
"error": "Your request was flagged by content moderation. Please modify your prompt.",
"createdAt": "2025-01-15T12:00:00.000Z",
"completedAt": "2025-01-15T12:00:05.000Z"
}| Field | Type | Description |
|---|---|---|
| id | string | Unique prediction ID (UUID). |
| modelId | string | ID of the model used for generation. |
| modelName | string | Human-readable model name. |
| status | string | Current status. One of: processing, completed, failed. |
| outputs | string[] | null | Array of output URLs. Each URL is a direct download link to the generated file on assets.vibedream.ai. null when still processing or failed. |
| error | string | null | Error message if the generation failed. null on success. |
| createdAt | string | ISO 8601 timestamp when the request was submitted. |
| completedAt | string | null | ISO 8601 timestamp when generation finished. null while processing. |
4. Schema
Input
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| prompt | string | Yes | -- | -- | Detailed instructions on how to edit the image. |
| images | string | string[] | Yes | -- | -- | Upload the image(s) to be edited. You can drag and drop a file or click to upload.Pass a single image URL (string) or multiple image URLs (string[]). Accepted formats: JPEG, PNG, GIF, WebP. |
| size | string | No | -- | small, medium, large | Select the desired output size for the edited image. |
| seed | number | No | -- | -- – 10000 (step 1) | Set a seed for the random number generator to ensure reproducibility. |
| enable_sync_mode | boolean | No | -- | -- | If set to true, the function will wait for the result to be generated and uploaded before returning the response. |
| enable_base64_output | boolean | No | -- | -- | If enabled, the output will be encoded into a BASE64 string instead of a URL. |
| enable_safety_checker | boolean | No | -- | -- | Enable additional checks to ensure content safety and compliance. |
Example request
{
"prompt": "A beautiful sunset over mountains with golden light",
"images": [
"https://example.com/image1.jpg"
],
"size": "small",
"seed": 0,
"enable_sync_mode": false,
"enable_base64_output": false,
"enable_safety_checker": false
}Output
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"modelId": "flux-2-pro-edit",
"modelName": "FLUX.2 [pro] Edit",
"status": "completed",
"outputs": [
"https://assets.vibedream.ai/outputs/550e8400-e29b-41d4-a716-446655440000/1736942400000-0.png"
],
"error": null,
"createdAt": "2025-01-15T12:00:00.000Z",
"completedAt": "2025-01-15T12:00:30.000Z"
}