FLUX 3 Image er Black Forest Labs' model til billedgenerering og redigering med udtrykkelig kontrol over kompositionen. En tekstbeskrivelse kan skabe en ny scene; medsendte billeder kan fastlægge et motiv, en scene, der skal revideres, eller flere elementer, der skal kombineres. Afgrænsningsbokse lader en beskrivelse angive, hvor hvert element hører til, og hvilke dele af et eksisterende billede der skal ændres. Resultatet er et billede med den ønskede scene, tekst og opsætning, som kan kontrolleres.
Til et nyt billede skal du beskrive motiv, handling eller positur, omgivelser, lys og indramning. Sæt præcis ordlyd inde i billedet i anførselstegn, og angiv, hvor den skal vises. En original produktbeskrivelse kan vise et rødt campingkrus på en lys stenoverflade med en stor overskrift ovenover og blødt morgenlys, der fremhæver hanken. Definér forholdet mellem overskrift, produkt og baggrund frem for at angive løsrevne stilord.
Ved redigering skal du identificere den bestemte genstand og ændringen: omfarv kruset, udskift en etiket, flyt en figur, eller giv scenen en anden stil. En enkelt redigering kræver ikke en manuelt tegnet boks. Den dokumenterede arbejdsgang udvider instruktionen før generering og kan finde det navngivne element og tilføje en boks automatisk. Den returnerede udvidede prompt registrerer denne fortolkning, hvilket er nyttigt, når en instruktion vælger den forkerte genstand eller indfører en uønsket detalje.
Den konkrete producentprofil accepterer ét til ti referencebilleder, medsendt som billed-URL'er eller kodede billeddata. Hvert billede skal være mindst 256×256 pixels og højst 16 megapixels. Navngiv en reference efter dens position eller synlige indhold, og forklar derefter dens rolle: personen fra Image 1, jakken fra Image 2 og rummet fra Image 3. En billedreference er en kilde til visuel information, ikke en instruktion om at kopiere hver uvedkommende detalje, den indeholder.
Indstillingen for billedformat har auto som standard. I anmodningsspecifikationen har et format, der ønskes i prompten, forrang; ellers fastlægger den første reference indramningen med kvadratisk output som reservevalg, når hverken en reference eller en ønsket form angiver den. Ved en sammenkomponering skal du placere den ønskede scenereference først eller vælge formatet udtrykkeligt. Gem kildebillederne og deres rækkefølge sammen med resultatet, så en senere revision bruger samme visuelle udgangspunkt.
En layoutprompt kombinerer en beskrivende tekst med et JSON-array af elementrækker. Teksten navngiver et element gennem en markør som <cup_1>; rækken indeholder id, bbox og desc. Koordinater er heltal fra 0 til 1000 i rækkefølgen [top, left, bottom, right], målt fra øverste venstre hjørne. For eksempel beskriver [0, 0, 500, 500] den øverste venstre fjerdedel uanset billedets pixeldimensioner. Brug det billedformat, som layoutet er udformet til, fordi koordinatgitteret strækkes med rammen.
En redigeringsrække bruger i stedet from, src_bbox og tgt_bbox sammen med identifikatoren og beskrivelsen. ref_image_0 betyder det første medsendte billede. Ens kilde- og målbokse forankrer et element; forskellige bokse flytter det eller ændrer dets størrelse. En ny række uden kilde genererer sin beskrivelse på målplaceringen, hvilket muliggør tilføjelser, udskiftninger eller omfarvning. En kilderække uden mål fjerner elementet. Angiv tilføjelser og fjernelser i både den skrevne instruktion og rækkerne, og behold forankringsrækker til detaljer, der skal blive på plads.
Giv tekst sin egen boks, og citér den præcise ordlyd i desc. Bokse styrer placering og størrelse; de er ikke beskæringsmasker, så et element kan strække sig ud over rektanglet. Producenten oplyser, at nye genstande i bokse på omkring 40×25 pixels ofte ikke kom frem i dens eksempler. Giv tilstrækkelig synlig plads, og undersøg de redigerede grænser. Pixels uden for målområdet forbliver som regel stabile, men skygger, refleksioner og nærliggende belysning kan stadig ændre sig.
Den dokumenterede profil aktiverer kildeforankring som standard, så web- og billedsøgning kan bidrage til genereringen. Det kan slås fra ved en beskrivelse, der kun skal bruge sin medsendte tekst og referencer. Ved et motiv fra virkeligheden skal du identificere sted, begivenhed eller genstand tydeligt og holde faktuelt indhold adskilt fra kunstnerisk behandling. Billeder med information fra søgning skal stadig sammenlignes med autoritativt materiale, når en etiket, genstand eller afbildet begivenhed skal være korrekt.
De fem opløsningsklasser er 768sq, 1k, 1.5k, 2k og 4k med 1k som standard. De repræsenterer niveauer med samme pixelareal, så den præcise bredde og højde afhænger af det valgte billedformat. Femten faste billedformater spænder fra 21:9 gennem kvadratiske og stående formater til 9:21. Denne models profil styrer størrelsen gennem billedformat og opløsning; den giver ikke adgang til felterne seed, width eller height, som bruges i FLUX.2-anmodningsprofilerne. Dens dokumenterede versionsvælger angiver aktuelt en løbende udgivelse frem for at fastlægge et dateret match med leverandørens vægte.
Producentens arbejdsgang returnerer et billede efter asynkron behandling sammen med den udvidede prompt. Det signerede downloadlink til billedet er gyldigt i én time. Gem selve billedet, den endelige prompt og referencerne frem for at stole på et midlertidigt link. Ved et gennemgået visuelt materiale skal du sammenligne den ønskede tekst, genstandsplacering, referenceidentitet og det ændrede område i den tilsigtede visningsstørrelse. En afsluttet generering er udgangspunktet for at kontrollere disse visuelle krav.
", "aboutText": "FLUX 3 Image er Black Forest Labs' model til billedgenerering og redigering med udtrykkelig kontrol over kompositionen. En tekstbeskrivelse kan skabe en ny scene; medsendte billeder kan fastlægge et motiv, en scene, der skal revideres, eller flere elementer, der skal kombineres. Afgrænsningsbokse lader en beskrivelse angive, hvor hvert element hører til, og hvilke dele af et eksisterende billede der skal ændres. Resultatet er et billede med den ønskede scene, tekst og opsætning, som kan kontrolleres.\n\n### Skab en scene, eller giv en redigeringsinstruktion\n\nTil et nyt billede skal du beskrive motiv, handling eller positur, omgivelser, lys og indramning. Sæt præcis ordlyd inde i billedet i anførselstegn, og angiv, hvor den skal vises. En original produktbeskrivelse kan vise et rødt campingkrus på en lys stenoverflade med en stor overskrift ovenover og blødt morgenlys, der fremhæver hanken. Definér forholdet mellem overskrift, produkt og baggrund frem for at angive løsrevne stilord.\n\nVed redigering skal du identificere den bestemte genstand og ændringen: omfarv kruset, udskift en etiket, flyt en figur, eller giv scenen en anden stil. En enkelt redigering kræver ikke en manuelt tegnet boks. Den dokumenterede arbejdsgang udvider instruktionen før generering og kan finde det navngivne element og tilføje en boks automatisk. Den returnerede udvidede prompt registrerer denne fortolkning, hvilket er nyttigt, når en instruktion vælger den forkerte genstand eller indfører en uønsket detalje.\n\n### Kombinér og forbered referencebilleder\n\nDen konkrete producentprofil accepterer ét til ti referencebilleder, medsendt som billed-URL'er eller kodede billeddata. Hvert billede skal være mindst 256×256 pixels og højst 16 megapixels. Navngiv en reference efter dens position eller synlige indhold, og forklar derefter dens rolle: personen fra Image 1, jakken fra Image 2 og rummet fra Image 3. En billedreference er en kilde til visuel information, ikke en instruktion om at kopiere hver uvedkommende detalje, den indeholder.\n\nIndstillingen for billedformat har auto som standard. I anmodningsspecifikationen har et format, der ønskes i prompten, forrang; ellers fastlægger den første reference indramningen med kvadratisk output som reservevalg, når hverken en reference eller en ønsket form angiver den. Ved en sammenkomponering skal du placere den ønskede scenereference først eller vælge formatet udtrykkeligt. Gem kildebillederne og deres rækkefølge sammen med resultatet, så en senere revision bruger samme visuelle udgangspunkt.\n\n### Placér elementer med afgrænsningsbokse\n\nEn layoutprompt kombinerer en beskrivende tekst med et JSON-array af elementrækker. Teksten navngiver et element gennem en markør somblack-forest-labs/flux-3-imageFLUX 3 Image skaber og redigerer billeder fra en skrevet beskrivelse og op til ti referencer. Den tilføjer promptbaserede afgrænsningsbokse til komposition og lokale ændringer, web- og billedbaseret kildeforankring samt fem opløsningsklasser.
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
FLUX 3 Image er Black Forest Labs' model til billedgenerering og redigering med udtrykkelig kontrol over kompositionen. En tekstbeskrivelse kan skabe en ny scene; medsendte billeder kan fastlægge et motiv, en scene, der skal revideres, eller flere elementer, der skal kombineres. Afgrænsningsbokse lader en beskrivelse angive, hvor hvert element hører til, og hvilke dele af et eksisterende billede der skal ændres. Resultatet er et billede med den ønskede scene, tekst og opsætning, som kan kontrolleres.
Til et nyt billede skal du beskrive motiv, handling eller positur, omgivelser, lys og indramning. Sæt præcis ordlyd inde i billedet i anførselstegn, og angiv, hvor den skal vises. En original produktbeskrivelse kan vise et rødt campingkrus på en lys stenoverflade med en stor overskrift ovenover og blødt morgenlys, der fremhæver hanken. Definér forholdet mellem overskrift, produkt og baggrund frem for at angive løsrevne stilord.
Ved redigering skal du identificere den bestemte genstand og ændringen: omfarv kruset, udskift en etiket, flyt en figur, eller giv scenen en anden stil. En enkelt redigering kræver ikke en manuelt tegnet boks. Den dokumenterede arbejdsgang udvider instruktionen før generering og kan finde det navngivne element og tilføje en boks automatisk. Den returnerede udvidede prompt registrerer denne fortolkning, hvilket er nyttigt, når en instruktion vælger den forkerte genstand eller indfører en uønsket detalje.
Den konkrete producentprofil accepterer ét til ti referencebilleder, medsendt som billed-URL'er eller kodede billeddata. Hvert billede skal være mindst 256×256 pixels og højst 16 megapixels. Navngiv en reference efter dens position eller synlige indhold, og forklar derefter dens rolle: personen fra Image 1, jakken fra Image 2 og rummet fra Image 3. En billedreference er en kilde til visuel information, ikke en instruktion om at kopiere hver uvedkommende detalje, den indeholder.
Indstillingen for billedformat har auto som standard. I anmodningsspecifikationen har et format, der ønskes i prompten, forrang; ellers fastlægger den første reference indramningen med kvadratisk output som reservevalg, når hverken en reference eller en ønsket form angiver den. Ved en sammenkomponering skal du placere den ønskede scenereference først eller vælge formatet udtrykkeligt. Gem kildebillederne og deres rækkefølge sammen med resultatet, så en senere revision bruger samme visuelle udgangspunkt.
En layoutprompt kombinerer en beskrivende tekst med et JSON-array af elementrækker. Teksten navngiver et element gennem en markør som <cup_1>; rækken indeholder id, bbox og desc. Koordinater er heltal fra 0 til 1000 i rækkefølgen [top, left, bottom, right], målt fra øverste venstre hjørne. For eksempel beskriver [0, 0, 500, 500] den øverste venstre fjerdedel uanset billedets pixeldimensioner. Brug det billedformat, som layoutet er udformet til, fordi koordinatgitteret strækkes med rammen.
En redigeringsrække bruger i stedet from, src_bbox og tgt_bbox sammen med identifikatoren og beskrivelsen. ref_image_0 betyder det første medsendte billede. Ens kilde- og målbokse forankrer et element; forskellige bokse flytter det eller ændrer dets størrelse. En ny række uden kilde genererer sin beskrivelse på målplaceringen, hvilket muliggør tilføjelser, udskiftninger eller omfarvning. En kilderække uden mål fjerner elementet. Angiv tilføjelser og fjernelser i både den skrevne instruktion og rækkerne, og behold forankringsrækker til detaljer, der skal blive på plads.
Giv tekst sin egen boks, og citér den præcise ordlyd i desc. Bokse styrer placering og størrelse; de er ikke beskæringsmasker, så et element kan strække sig ud over rektanglet. Producenten oplyser, at nye genstande i bokse på omkring 40×25 pixels ofte ikke kom frem i dens eksempler. Giv tilstrækkelig synlig plads, og undersøg de redigerede grænser. Pixels uden for målområdet forbliver som regel stabile, men skygger, refleksioner og nærliggende belysning kan stadig ændre sig.
Den dokumenterede profil aktiverer kildeforankring som standard, så web- og billedsøgning kan bidrage til genereringen. Det kan slås fra ved en beskrivelse, der kun skal bruge sin medsendte tekst og referencer. Ved et motiv fra virkeligheden skal du identificere sted, begivenhed eller genstand tydeligt og holde faktuelt indhold adskilt fra kunstnerisk behandling. Billeder med information fra søgning skal stadig sammenlignes med autoritativt materiale, når en etiket, genstand eller afbildet begivenhed skal være korrekt.
De fem opløsningsklasser er 768sq, 1k, 1.5k, 2k og 4k med 1k som standard. De repræsenterer niveauer med samme pixelareal, så den præcise bredde og højde afhænger af det valgte billedformat. Femten faste billedformater spænder fra 21:9 gennem kvadratiske og stående formater til 9:21. Denne models profil styrer størrelsen gennem billedformat og opløsning; den giver ikke adgang til felterne seed, width eller height, som bruges i FLUX.2-anmodningsprofilerne. Dens dokumenterede versionsvælger angiver aktuelt en løbende udgivelse frem for at fastlægge et dateret match med leverandørens vægte.
Producentens arbejdsgang returnerer et billede efter asynkron behandling sammen med den udvidede prompt. Det signerede downloadlink til billedet er gyldigt i én time. Gem selve billedet, den endelige prompt og referencerne frem for at stole på et midlertidigt link. Ved et gennemgået visuelt materiale skal du sammenligne den ønskede tekst, genstandsplacering, referenceidentitet og det ændrede område i den tilsigtede visningsstørrelse. En afsluttet generering er udgangspunktet for at kontrollere disse visuelle krav.
POST /v1/images/generationstext, imageimage| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser black-forest-labs/flux-3-image | Standard— |
Feltprompt | Typestring | KravPåkrævet | Værdier og grænser Minimumslængde: 1 | Standard— |
Feltresolution | Typestring | KravValgfrit | Værdier og grænser 768, 1K, 1.5K, 2K, 4K | Standard— |
Feltaspect_ratio | Typestring | KravValgfrit | Værdier og grænser 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21, auto | Standard— |
Feltn | Typeinteger | KravValgfrit | Værdier og grænser Minimum: 1 Maksimum: 1 | Standard— |
Feltinput_references | Typearray | KravValgfrit | Værdier og grænser Minimumsantal elementer: 0 Maksimalt antal elementer: 10 | Standard— |
Feltprovider | Typeobject | KravValgfrit | Værdier og grænser | Standard— |
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, prompt |
Parametermaterial_types | Kontrakttext, image |
Livscyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · det faktisk returnerede task_id eller posten i mediebiblioteket
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
De viste satser bruges til at anslå omkostningen før genereringen. Det endelige beløb beregnes ud fra den registrerede omkostning for den oprindelige generering. Den målte varighed af outputtet og de anslåede mængder er ikke den endelige fakturerbare mængde.
Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Takstplan | Forventet mængde | Beløb |
|---|---|---|---|
| KonfigurationGrundpriser for tokens | TakstplanGrundtakst | Forventet mængde— | Beløb Input · Inputtokens · Estimat kun til sammenligning — / 1K tokens Output · Outputtokens · Estimat kun til sammenligning — / 1K tokens Input · Cachelæsning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning, 1 time · Estimat kun til sammenligning — / 1K tokens |
| KonfigurationAnslået genereringsomkostning | Takstplan— | Forventet mængdeestimat for én generering | Beløb Output · Anslået genereringsomkostning · Estimat kun til sammenligning $0.082 estimat før generering Dette estimat er hverken et ekstra gebyr eller en fast pris for den færdige generering. |
Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'black-forest-labs/flux-3-image', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nHent hvert returneret billede, eller gem dets Base64-indhold
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nGem hvert færdigt billede; hent hver returneret URL eller afkod dets Base64-indhold.
Gem hele svaret og alle headere, alle faktisk returnerede output, de oprindeligt returnerede identifikatorer og alle felter med forbrugsdata. Gendan den oprindelige operation uden at sende oprettelsesanmodningen igen.
Gem det returnerede X-Client-Request-ID til afstemning. Brug kun faktisk returnerede task_id/asset_id-værdier eller dit eget mediebibliotek til læseanmodninger; opbyg aldrig en opgave-URL ud fra operations-ID’et, og send aldrig oprettelsesanmodningen igen.
| Felt | Type |
|---|---|
Feltcreated | Type |
Feltdata[].url | Type |
Feltdata[].b64_json | Type |
Feltusage | Type |
Ailoot Ultra black-forest-labs/flux-3-image
/v1/images