Vai al contenuto

FLUX.3 Klein Image Editing

Integra

ID del modello blackforestlabs/flux-3/klein/edit-image
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/blackforestlabs/flux-3/klein/edit-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

File come nell'esempio: 0,009 $ 9 crediti API i tuoi file vengono misurati prima dell'esecuzione Esegui in questa pagina

Ottieni la chiave API
Black Forest Labs Modifica immagini #image-editing#image-to-image#reference-images#typography

Editor FLUX.3 Klein con fino a 10 riferimenti e posizionamento opzionale degli oggetti tramite riquadri

Black Forest Labs · Immagine

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

•obbligatorio

Scrivi una didascalia completa che descriva l'immagine desiderata dopo la modifica, identificando i riferimenti tramite la sequenza, ad esempio la prima o la seconda immagine.

•obbligatorio image_urls
Trascina un file oppure · fino a 10

Immagini di riferimento usate per la modifica o la composizione, fino a un massimo di 10.

image_size

Le dimensioni dell'output sono predefinite su quelle del primo riferimento, limitate a 1 megapixel per più riferimenti o ridimensionate a un massimo di 4 megapixel per un solo riferimento. Le dimensioni esplicite devono avere ciascun lato compreso tra 256 e 4096 pixel.

num_images predefinito 1

Numero di immagini richiesto per la generazione.

Avanzate output_format · seed · enable_prompt_expansion · enable_safety_checker · bounding_boxes
output_format predefinito png

Formato del file dell'immagine risultante.

Seed per immagini riproducibili: prompt e seed identici producono un'immagine identica quando la versione del modello non cambia.

Layout facoltativo degli oggetti per conservare, spostare, ridimensionare o rimuovere oggetti di riferimento oppure posizionare nuovi oggetti. Le coordinate iniziano da (0, 0) nell'angolo superiore sinistro di ogni immagine; fai riferimento ai riquadri usando etichette nel prompt, come `<dragon>`.

POST /run/blackforestlabs/flux-3/klein/edit-image?wait=20 preventivo → 0,009 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/blackforestlabs/flux-3/klein/edit-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su FLUX.3 Klein Image Editing

Modifica o compone immagini da un prompt e da 1 a 10 riferimenti in `image_urls`, che il prompt può citare in base all'ordine, ad esempio la prima immagine. Fino a 32 `bounding_boxes` consentono di mantenere, spostare, ridimensionare, rimuovere o aggiungere oggetti, indicati nel prompt tramite etichetta. L'espansione del prompt è attiva per impostazione predefinita. Restituisce da 1 a 4 immagini in jpeg, png o webp.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
promptobbligatorio
Tipostring
Scrivi una didascalia completa che descriva l'immagine desiderata dopo la modifica, identificando i riferimenti tramite la sequenza, ad esempio la prima o la seconda immagine.
enable_prompt_expansionfacoltativo
Tipoboolean
Predefinitotrue
Espansione del prompt in una didascalia dettagliata prima della generazione, abilitata quando true. Per la modifica, la didascalia si basa sulle immagini di riferimento.
seedfacoltativo
Tipointeger | null
Seed per immagini riproducibili: prompt e seed identici producono un'immagine identica quando la versione del modello non cambia.
num_imagesfacoltativo num_outputs
Tipointeger
Predefinito1
1 – 4
Numero di immagini richiesto per la generazione.
enable_safety_checkerfacoltativo
Tipoboolean
Predefinitotrue
Attivazione del controllo di sicurezza; true abilita il controllo.
output_formatfacoltativo
Tipoenum
Predefinitopng
jpegpngwebp
Formato del file dell'immagine risultante.
image_urlsobbligatorio images
Tipourl[] · image
≤ 10 elementi
Immagini di riferimento usate per la modifica o la composizione, fino a un massimo di 10.
image_sizefacoltativo
Tipoobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Le dimensioni dell'output sono predefinite su quelle del primo riferimento, limitate a 1 megapixel per più riferimenti o ridimensionate a un massimo di 4 megapixel per un solo riferimento. Le dimensioni esplicite devono avere ciascun lato compreso tra 256 e 4096 pixel.
bounding_boxesfacoltativo
Tipoobject[]
≤ 32 elementi
Layout facoltativo degli oggetti per conservare, spostare, ridimensionare o rimuovere oggetti di riferimento oppure posizionare nuovi oggetti. Le coordinate iniziano da (0, 0) nell'angolo superiore sinistro di ogni immagine; fai riferimento ai riquadri usando etichette nel prompt, come `<dragon>`.
bounding_boxes[].labelfacoltativo
Tipostring | null
≤ 64 characters
Etichetta breve dell'oggetto per il riquadro, come `dragon`; il valore predefinito è `obj_<n>`. Includi `<dragon>` nel prompt per associare le relative parole al riquadro; i riquadri non menzionati nel prompt vengono aggiunti alla scena.
bounding_boxes[].descriptionobbligatorio
Tipostring
≤ 500 characters
Oggetto da renderizzare nel riquadro, inclusone l'aspetto.
bounding_boxes[].boxfacoltativo
Tipoobject
Posizionamento dell'oggetto nell'output, in sostituzione di `source_box`/`target_box` e con lo stesso comportamento di posizionamento del text-to-image.
bounding_boxes[].box.x_minobbligatorio
Tiponumber
0 – 1
Limite sinistro espresso rispetto alla larghezza dell'immagine, da 0 a 1.
bounding_boxes[].box.y_minobbligatorio
Tiponumber
0 – 1
Limite superiore espresso rispetto all'altezza dell'immagine, da 0 a 1.
bounding_boxes[].box.x_maxobbligatorio
Tiponumber
0 – 1
Limite destro espresso rispetto alla larghezza dell'immagine, da 0 a 1.
bounding_boxes[].box.y_maxobbligatorio
Tiponumber
0 – 1
Limite inferiore espresso rispetto all'altezza dell'immagine, da 0 a 1.
bounding_boxes[].source_image_indexfacoltativo
Tipointeger | null
≥ 0
Selezione della sorgente dell'oggetto: ometti per un nuovo oggetto oppure identifica un riferimento esistente tramite il relativo indice in `image_urls`, contando da 0.
bounding_boxes[].source_boxfacoltativo
Tipoobject
Posizione dell'oggetto nell'immagine di riferimento; deve essere fornito anche `source_image_index`.
bounding_boxes[].source_box.x_minobbligatorio
Tiponumber
0 – 1
Limite sinistro espresso rispetto alla larghezza dell'immagine, da 0 a 1.
bounding_boxes[].source_box.y_minobbligatorio
Tiponumber
0 – 1
Limite superiore espresso rispetto all'altezza dell'immagine, da 0 a 1.
bounding_boxes[].source_box.x_maxobbligatorio
Tiponumber
0 – 1
Limite destro espresso rispetto alla larghezza dell'immagine, da 0 a 1.
bounding_boxes[].source_box.y_maxobbligatorio
Tiponumber
0 – 1
Limite inferiore espresso rispetto all'altezza dell'immagine, da 0 a 1.
bounding_boxes[].target_boxfacoltativo
Tipoobject
Riquadro di posizionamento dell'oggetto nell'output: per spostare o ridimensionare sono necessari entrambi i riquadri, mentre per rimuovere un oggetto di riferimento questo riquadro deve rimanere non impostato.
bounding_boxes[].target_box.x_minobbligatorio
Tiponumber
0 – 1
Limite sinistro espresso rispetto alla larghezza dell'immagine, da 0 a 1.
bounding_boxes[].target_box.y_minobbligatorio
Tiponumber
0 – 1
Limite superiore espresso rispetto all'altezza dell'immagine, da 0 a 1.
bounding_boxes[].target_box.x_maxobbligatorio
Tiponumber
0 – 1
Limite destro espresso rispetto alla larghezza dell'immagine, da 0 a 1.
bounding_boxes[].target_box.y_maxobbligatorio
Tiponumber
0 – 1
Limite inferiore espresso rispetto all'altezza dell'immagine, da 0 a 1.
obbligatorio Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "blackforestlabs/flux-3/klein/edit-image",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 9,
    "usd": "0.009",
    "charged": 9,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
images
array of object {url, content_type, file_name, file_size, width, height}Immagini prodotte dal modello.
timings
objectInformazioni temporali sul processo di generazione.
seed
integerSeed di generazione per la prima immagine.
has_nsfw_concepts
array of booleanIndica se nelle immagini generate compaiono concetti NSFW.
prompt
stringPrompt usato durante la generazione di immagini.

Altri modelli: Modifica immagini

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/blackforestlabs/flux-3/klein/edit-image.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt