Parametri flessibili
Configura 8 parametri documentati, tra cui aspect_ratio, enable_prompt_expansion, enable_translation, output_format, prompt.
Equilibrio tra velocità e qualità per l'editing in contesto
curl -X POST https://runapi.ai/api/v1/flux_kontext/text_to_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-kontext-pro",
"prompt": "Modifica questa foto prodotto: cambia lo sfondo con una spiaggia tropicale lasciando il prodotto esattamente com'è."
}'
import { FluxKontextClient } from "@runapi.ai/flux-kontext";
const client = new FluxKontextClient();
const result = await client.textToImage.run({
model: "flux-kontext-pro",
prompt: "Modifica questa foto prodotto: cambia lo sfondo con una spiaggia tropicale lasciando il prodotto esattamente com'è.",
});
import os
import requests
response = requests.post(
"https://runapi.ai/api/v1/flux_kontext/text_to_image",
headers={"Authorization": f"Bearer {os.environ['RUNAPI_API_KEY']}"},
json={"model":"flux-kontext-pro","prompt":"Modifica questa foto prodotto: cambia lo sfondo con una spiaggia tropicale lasciando il prodotto esattamente com'è."}
)
response.raise_for_status()
<?php
$client = curl_init("https://runapi.ai/api/v1/flux_kontext/text_to_image");
curl_setopt_array($client, [
CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("RUNAPI_API_KEY"), "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode([
'model' => 'flux-kontext-pro',
'prompt' => 'Modifica questa foto prodotto: cambia lo sfondo con una spiaggia tropicale lasciando il prodotto esattamente com\'è.',
])
]);
$response = curl_exec($client);
RunApi client = new RunApi(System.getenv("RUNAPI_API_KEY"));
Task task = client.textToImage().run({"model":"flux-kontext-pro","prompt":"Modifica questa foto prodotto: cambia lo sfondo con una spiaggia tropicale lasciando il prodotto esattamente com'è."});
task.waitForResult();
require "runapi/flux_kontext"
client = RunApi::FluxKontext::Client.new
result = client.text_to_image.run(
model: "flux-kontext-pro",
prompt: "Modifica questa foto prodotto: cambia lo sfondo con una spiaggia tropicale lasciando il prodotto esattamente com'è."
)
client := runapi.NewClient(os.Getenv("RUNAPI_API_KEY"))
task, err := client.textToImage.Run({"model":"flux-kontext-pro","prompt":"Modifica questa foto prodotto: cambia lo sfondo con una spiaggia tropicale lasciando il prodotto esattamente com'è."})
if err != nil { log.Fatal(err) }
task.Wait()
$ runapi generate \
--model flux-kontext-pro \
--endpoint text_to_image \
--wait
2 versioni disponibili
Scegli un modello e genera in pochi secondi.
| Provider | Black Forest Labs |
| ID modello | flux-kontext-pro |
| Modalità | Immagini |
| Tipi di attività | Asynchronous |
| Endpoint API | /api/v1/flux_kontext/text_to_image |
| Unità di fatturazione | chiamata |
| Parametri di input | aspect_ratio, callback_url, enable_prompt_expansion, enable_translation, model, output_format, prompt, safety_tolerance, source_image_url, watermark |
| Rapporti d'aspetto | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 |
| Formato di output | jpeg, png |
| Stato del catalogo | Operativo |
Registrati gratuitamente e crea una chiave API per flux-kontext-pro dalla dashboard.
Invia una richiesta POST a /api/v1/flux_kontext/text_to_image con l’identificatore del modello flux-kontext-pro e i tuoi parametri.
Interroga il task o segui il callback per recuperare il risultato completato di flux-kontext-pro.
Configura 8 parametri documentati, tra cui aspect_ratio, enable_prompt_expansion, enable_translation, output_format, prompt.
Espone 1 endpoint pubblici: text_to_image.
I task asincroni accettano un URL di callback per le notifiche di completamento.
Misurata in base a chiamata, senza requisito di abbonamento.
promptImage description (English only).
watermarkWatermark identifier.
aspect_ratioOutput aspect ratio. Default: 16:9. (21:9, 16:9, 4:3, 1:1, 3:4, 9:16)
callback_urlWebhook URL for async notifications.
output_formatOutput format. Default: jpeg. (jpeg, png)
safety_toleranceContent safety threshold. 0-6 for generation, 0-2 for editing. Default: 2.
source_image_urlSource image URL for editing mode.
enable_translationAuto-translate non-English prompts. Default: true.
enable_prompt_expansionExpand the prompt with more detail. Default: false.
Genera automaticamente foto lifestyle di prodotto per cataloghi e-commerce privi di servizi fotografici in studio.
Progetta rapidamente ambienti e personaggi prima di passare all'art finale.
Genera cover art e illustrazioni uniche per post del blog e articoli su larga scala.
Passa l'ID del modello mostrato nel quickstart.
I limiti per chiave scalano in base al tier di utilizzo. Consulta la pagina prezzi per i limiti attuali.
Sì — la variante è un flag. Puoi cambiarla modificando il parametro model.
Dove lo streaming è disponibile, RunAPI esegue lo streaming end-to-end.
Apri un issue nel repository GitHub pubblico oppure scrivi all’assistenza.
No. La chiave API RunAPI è sufficiente per accedere a questa variante e a tutti gli altri modelli del catalogo. Non servono account presso il provider sottostante.
Ti aiutiamo con la configurazione enterprise, le integrazioni e le domande tecniche.
Contattaci