GPT Image 2.5 Flare to wersja OpenAI do generowania i edycji obrazów przeznaczona do szybkiej codziennej pracy w wysokiej jakości. Przyjmuje tekst i obrazy, a wyniki zwraca w postaci obrazów. Używaj jej do szkiców wizualnych, ilustracji, koncepcji produktowych i powtarzalnych zadań twórczych, w których opis ma szybko stać się użytecznym obrazem. Flare jest odrębny od Sunburst, którego przeznaczenie kładzie nacisk na precyzję edycji. Wybierz Flare do rutynowego tworzenia obrazów, a Sunburst, gdy priorytetem jest dokładna edycja.
Zacznij od głównego obiektu, akcji, otoczenia, kompozycji i sposobu przedstawienia. W ilustracji kampanii poproś o rowerzystę przejeżdżającego przez niewielki most w ciepłym wieczornym świetle, z wyrazistą sylwetką i otwartą przestrzenią nieba na późniejszy tekst. Zwięzły opis poszukiwawczy może pozostawiać decyzje estetyczne otwarte; opis produkcyjny powinien nazywać istotne szczegóły i ich rozmieszczenie. Bezpośrednie procesy generowania i edycji dopuszczają prompty do 32 000 znaków i od jednego do dziesięciu wyników, co pozwala porównać kilka wariantów względem tego samego celu.
Przy edycji można dostarczyć do szesnastu obrazów referencyjnych. Przypisz każdej referencji jasną rolę, zamiast oczekiwać, że model sam rozstrzygnie, czy obraz określa tożsamość obiektu, scenerię czy styl. Maska może ukierunkować zmianę danego obszaru; przy wielu obrazach dotyczy pierwszego. Obraz i maska muszą mieć zgodny format i wymiary, a maska musi zawierać kanał alfa. Przewodnik wymaga rozmiaru źródła i maski poniżej 50 MB. Maska stanowi wskazówkę, a nie obietnicę dokładnego zachowania granicy, dlatego określ zarówno żądaną modyfikację, jak i to, co powinno pozostać rozpoznawalne.
Flare obsługuje jakość low, medium, high, xhigh, max i automatyczną, z auto jako wartością domyślną. Niższa jakość może służyć do szybkiego szkicu wizualnego; wyższe ustawienia można porównać pod kątem szczegółów końcowego materiału. Jakość jest niezależna od rozmiaru i kompresji wyniku. Standardowe rozmiary obejmują 1024 × 1024, 1536 × 1024 i 1024 × 1536; dostępne są też wymiary automatyczne lub niestandardowe. Dobierz orientację do końcowego miejsca użycia i przestrzeni potrzebnej scenie.
Niestandardowa szerokość i wysokość muszą być wielokrotnościami szesnastu, a żaden bok nie może przekraczać 3840 pikseli. Dopuszczalne proporcje mieszczą się od 1:3 do 3:1, a całkowite pole obrazu musi wynosić co najmniej 655 360 i najwyżej 8 294 400 pikseli. Wszystkie cztery warunki obowiązują jednocześnie. Przewodnik określa rozdzielczości powyżej 2560 × 1440 jako eksperymentalne. Użyj poprawnego kadru pasującego do kompozycji i uwzględnij w opisie szczegóły wrażliwe na przycięcie, zamiast traktować większą rozdzielczość jako automatyczną poprawę układu.
Domyślnym formatem wyniku jest PNG, z alternatywami JPEG i WebP. JPEG i WebP pozwalają ustawić kompresję od 0 do 100. Dla przezroczystego tła wybierz PNG lub WebP; obsługiwane są również tła nieprzezroczyste i automatyczne. Przezroczysty element można umieścić w późniejszym układzie, podczas gdy nieprzezroczysty obraz ma własne tło. Dobierz format, tło i kompresję do rzeczywistych potrzeb dostarczenia materiału i zachowaj ukończony plik wraz z opisem i wybranymi ustawieniami.
Producent dokumentuje bezpośrednie generowanie i edycje obrazów oraz konwersacyjne narzędzie obrazowe, które może zachowywać wybrane wyniki do dalszych zmian. W tym procesie działanie może być automatyczne albo wymuszać generowanie lub edycję, gdy obraz znajduje się w kontekście. Strumieniowanie może pokazywać do trzech obrazów częściowych przed wynikiem końcowym. Podglądy te przedstawiają postęp, a nie dodatkowe gotowe rezultaty. Przy stopniowym dopracowywaniu kontynuuj od wybranego obrazu i opisz widoczną zmianę, taką jak przesunięcie jednego przedmiotu lub korekta kolorystyki. Interfejs producenta obsługuje również przetwarzanie wsadowe.
Sprawdź napisy, rozmieszczenie przedmiotów, szczegóły głównego obiektu i kompozycję w docelowym rozmiarze. GPT Image nadal może mieć trudności z dokładnym położeniem tekstu, uporządkowanymi układami i powtarzalną tożsamością wizualną między generowaniami. Zachowaj zaakceptowany wariant jako następną referencję i ogranicz kolejną edycję do istotnego problemu. Przeznaczenie Flare do codziennego generowania przydaje się w jasnej sekwencji: opis, warianty wizualne, wybór i dopracowanie, z oceną końcowego materiału względem rzeczywistego celu twórczego.
", "aboutText": "GPT Image 2.5 Flare to wersja OpenAI do generowania i edycji obrazów przeznaczona do szybkiej codziennej pracy w wysokiej jakości. Przyjmuje tekst i obrazy, a wyniki zwraca w postaci obrazów. Używaj jej do szkiców wizualnych, ilustracji, koncepcji produktowych i powtarzalnych zadań twórczych, w których opis ma szybko stać się użytecznym obrazem. Flare jest odrębny od Sunburst, którego przeznaczenie kładzie nacisk na precyzję edycji. Wybierz Flare do rutynowego tworzenia obrazów, a Sunburst, gdy priorytetem jest dokładna edycja.\n\nZacznij od głównego obiektu, akcji, otoczenia, kompozycji i sposobu przedstawienia. W ilustracji kampanii poproś o rowerzystę przejeżdżającego przez niewielki most w ciepłym wieczornym świetle, z wyrazistą sylwetką i otwartą przestrzenią nieba na późniejszy tekst. Zwięzły opis poszukiwawczy może pozostawiać decyzje estetyczne otwarte; opis produkcyjny powinien nazywać istotne szczegóły i ich rozmieszczenie. Bezpośrednie procesy generowania i edycji dopuszczają prompty do 32 000 znaków i od jednego do dziesięciu wyników, co pozwala porównać kilka wariantów względem tego samego celu.\n\nPrzy edycji można dostarczyć do szesnastu obrazów referencyjnych. Przypisz każdej referencji jasną rolę, zamiast oczekiwać, że model sam rozstrzygnie, czy obraz określa tożsamość obiektu, scenerię czy styl. Maska może ukierunkować zmianę danego obszaru; przy wielu obrazach dotyczy pierwszego. Obraz i maska muszą mieć zgodny format i wymiary, a maska musi zawierać kanał alfa. Przewodnik wymaga rozmiaru źródła i maski poniżej 50 MB. Maska stanowi wskazówkę, a nie obietnicę dokładnego zachowania granicy, dlatego określ zarówno żądaną modyfikację, jak i to, co powinno pozostać rozpoznawalne.\n\nFlare obsługuje jakość low, medium, high, xhigh, max i automatyczną, z auto jako wartością domyślną. Niższa jakość może służyć do szybkiego szkicu wizualnego; wyższe ustawienia można porównać pod kątem szczegółów końcowego materiału. Jakość jest niezależna od rozmiaru i kompresji wyniku. Standardowe rozmiary obejmują 1024 × 1024, 1536 × 1024 i 1024 × 1536; dostępne są też wymiary automatyczne lub niestandardowe. Dobierz orientację do końcowego miejsca użycia i przestrzeni potrzebnej scenie.\n\nNiestandardowa szerokość i wysokość muszą być wielokrotnościami szesnastu, a żaden bok nie może przekraczać 3840 pikseli. Dopuszczalne proporcje mieszczą się od 1:3 do 3:1, a całkowite pole obrazu musi wynosić co najmniej 655 360 i najwyżej 8 294 400 pikseli. Wszystkie cztery warunki obowiązują jednocześnie. Przewodnik określa rozdzielczości powyżej 2560 × 1440 jako eksperymentalne. Użyj poprawnego kadru pasującego do kompozycji i uwzględnij w opisie szczegóły wrażliwe na przycięcie, zamiast traktować większą rozdzielczość jako automatyczną poprawę układu.\n\nDomyślnym formatem wyniku jest PNG, z alternatywami JPEG i WebP. JPEG i WebP pozwalają ustawić kompresję od 0 do 100. Dla przezroczystego tła wybierz PNG lub WebP; obsługiwane są również tła nieprzezroczyste i automatyczne. Przezroczysty element można umieścić w późniejszym układzie, podczas gdy nieprzezroczysty obraz ma własne tło. Dobierz format, tło i kompresję do rzeczywistych potrzeb dostarczenia materiału i zachowaj ukończony plik wraz z opisem i wybranymi ustawieniami.\n\nProducent dokumentuje bezpośrednie generowanie i edycje obrazów oraz konwersacyjne narzędzie obrazowe, które może zachowywać wybrane wyniki do dalszych zmian. W tym procesie działanie może być automatyczne albo wymuszać generowanie lub edycję, gdy obraz znajduje się w kontekście. Strumieniowanie może pokazywać do trzech obrazów częściowych przed wynikiem końcowym. Podglądy te przedstawiają postęp, a nie dodatkowe gotowe rezultaty. Przy stopniowym dopracowywaniu kontynuuj od wybranego obrazu i opisz widoczną zmianę, taką jak przesunięcie jednego przedmiotu lub korekta kolorystyki. Interfejs producenta obsługuje również przetwarzanie wsadowe.\n\nSprawdź napisy, rozmieszczenie przedmiotów, szczegóły głównego obiektu i kompozycję w docelowym rozmiarze. GPT Image nadal może mieć trudności z dokładnym położeniem tekstu, uporządkowanymi układami i powtarzalną tożsamością wizualną między generowaniami. Zachowaj zaakceptowany wariant jako następną referencję i ogranicz kolejną edycję do istotnego problemu. Przeznaczenie Flare do codziennego generowania przydaje się w jasnej sekwencji: opis, warianty wizualne, wybór i dopracowanie, z oceną końcowego materiału względem rzeczywistego celu twórczego.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "8549803f12d708aab99a0ea904f9db47ad1c990f66b330104746d04014d99cc3", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "pl", "methods": [ { "html": "gpt-image-2.5-flareGPT Image 2.5 Flare generuje i edytuje obrazy na podstawie tekstu i referencji, koncentrując się na szybkim codziennym tworzeniu materiałów wizualnych. Obsługuje niestandardowe rozmiary, przezroczyste tła, maski i poziomy jakości do max do szkiców, ilustracji i materiałów kampanii.
Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.
GPT Image 2.5 Flare to wersja OpenAI do generowania i edycji obrazów przeznaczona do szybkiej codziennej pracy w wysokiej jakości. Przyjmuje tekst i obrazy, a wyniki zwraca w postaci obrazów. Używaj jej do szkiców wizualnych, ilustracji, koncepcji produktowych i powtarzalnych zadań twórczych, w których opis ma szybko stać się użytecznym obrazem. Flare jest odrębny od Sunburst, którego przeznaczenie kładzie nacisk na precyzję edycji. Wybierz Flare do rutynowego tworzenia obrazów, a Sunburst, gdy priorytetem jest dokładna edycja.
Zacznij od głównego obiektu, akcji, otoczenia, kompozycji i sposobu przedstawienia. W ilustracji kampanii poproś o rowerzystę przejeżdżającego przez niewielki most w ciepłym wieczornym świetle, z wyrazistą sylwetką i otwartą przestrzenią nieba na późniejszy tekst. Zwięzły opis poszukiwawczy może pozostawiać decyzje estetyczne otwarte; opis produkcyjny powinien nazywać istotne szczegóły i ich rozmieszczenie. Bezpośrednie procesy generowania i edycji dopuszczają prompty do 32 000 znaków i od jednego do dziesięciu wyników, co pozwala porównać kilka wariantów względem tego samego celu.
Przy edycji można dostarczyć do szesnastu obrazów referencyjnych. Przypisz każdej referencji jasną rolę, zamiast oczekiwać, że model sam rozstrzygnie, czy obraz określa tożsamość obiektu, scenerię czy styl. Maska może ukierunkować zmianę danego obszaru; przy wielu obrazach dotyczy pierwszego. Obraz i maska muszą mieć zgodny format i wymiary, a maska musi zawierać kanał alfa. Przewodnik wymaga rozmiaru źródła i maski poniżej 50 MB. Maska stanowi wskazówkę, a nie obietnicę dokładnego zachowania granicy, dlatego określ zarówno żądaną modyfikację, jak i to, co powinno pozostać rozpoznawalne.
Flare obsługuje jakość low, medium, high, xhigh, max i automatyczną, z auto jako wartością domyślną. Niższa jakość może służyć do szybkiego szkicu wizualnego; wyższe ustawienia można porównać pod kątem szczegółów końcowego materiału. Jakość jest niezależna od rozmiaru i kompresji wyniku. Standardowe rozmiary obejmują 1024 × 1024, 1536 × 1024 i 1024 × 1536; dostępne są też wymiary automatyczne lub niestandardowe. Dobierz orientację do końcowego miejsca użycia i przestrzeni potrzebnej scenie.
Niestandardowa szerokość i wysokość muszą być wielokrotnościami szesnastu, a żaden bok nie może przekraczać 3840 pikseli. Dopuszczalne proporcje mieszczą się od 1:3 do 3:1, a całkowite pole obrazu musi wynosić co najmniej 655 360 i najwyżej 8 294 400 pikseli. Wszystkie cztery warunki obowiązują jednocześnie. Przewodnik określa rozdzielczości powyżej 2560 × 1440 jako eksperymentalne. Użyj poprawnego kadru pasującego do kompozycji i uwzględnij w opisie szczegóły wrażliwe na przycięcie, zamiast traktować większą rozdzielczość jako automatyczną poprawę układu.
Domyślnym formatem wyniku jest PNG, z alternatywami JPEG i WebP. JPEG i WebP pozwalają ustawić kompresję od 0 do 100. Dla przezroczystego tła wybierz PNG lub WebP; obsługiwane są również tła nieprzezroczyste i automatyczne. Przezroczysty element można umieścić w późniejszym układzie, podczas gdy nieprzezroczysty obraz ma własne tło. Dobierz format, tło i kompresję do rzeczywistych potrzeb dostarczenia materiału i zachowaj ukończony plik wraz z opisem i wybranymi ustawieniami.
Producent dokumentuje bezpośrednie generowanie i edycje obrazów oraz konwersacyjne narzędzie obrazowe, które może zachowywać wybrane wyniki do dalszych zmian. W tym procesie działanie może być automatyczne albo wymuszać generowanie lub edycję, gdy obraz znajduje się w kontekście. Strumieniowanie może pokazywać do trzech obrazów częściowych przed wynikiem końcowym. Podglądy te przedstawiają postęp, a nie dodatkowe gotowe rezultaty. Przy stopniowym dopracowywaniu kontynuuj od wybranego obrazu i opisz widoczną zmianę, taką jak przesunięcie jednego przedmiotu lub korekta kolorystyki. Interfejs producenta obsługuje również przetwarzanie wsadowe.
Sprawdź napisy, rozmieszczenie przedmiotów, szczegóły głównego obiektu i kompozycję w docelowym rozmiarze. GPT Image nadal może mieć trudności z dokładnym położeniem tekstu, uporządkowanymi układami i powtarzalną tożsamością wizualną między generowaniami. Zachowaj zaakceptowany wariant jako następną referencję i ogranicz kolejną edycję do istotnego problemu. Przeznaczenie Flare do codziennego generowania przydaje się w jasnej sekwencji: opis, warianty wizualne, wybór i dopracowanie, z oceną końcowego materiału względem rzeczywistego celu twórczego.
POST /v1/images/generationstextimage| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity gpt-image-2.5-flare | Domyślnie— |
Poleprompt | Typstring | WymaganieWymagane | Wartości i limity Minimalna długość: 1 | Domyślnie— |
Polen | Typinteger | WymaganieOpcjonalne | Wartości i limity Minimum: 1 | Domyślnie1 |
Poleresponse_format | Typstring | WymaganieOpcjonalne | Wartości i limity url, b64_json | Domyślnie— |
Polestream | Typboolean | WymaganieOpcjonalne | Wartości i limity | Domyślniefalse |
Polesize | Typstring | WymaganieOpcjonalne | Wartości i limity Zależy od modelu | Domyślnie— |
Polequality | Typstring | WymaganieOpcjonalne | Wartości i limity Zależy od modelu | Domyślnie— |
Polebackground | Typstring | WymaganieOpcjonalne | Wartości i limity Zależy od modelu | Domyślnie— |
Poleoutput_format | Typstring | WymaganieOpcjonalne | Wartości i limity Zależy od modelu | Domyślnie— |
Poleoutput_compression | Typinteger | WymaganieOpcjonalne | Wartości i limity Zależy od modelu | Domyślnie— |
Polemoderation | Typstring | WymaganieOpcjonalne | Wartości i limity Zależy od modelu | Domyślnie— |
Poleinput_fidelity | Typstring | WymaganieOpcjonalne | Wartości i limity Zależy od modelu | Domyślnie— |
Polestyle | Typstring | WymaganieOpcjonalne | Wartości i limity Zależy od modelu | Domyślnie— |
Polepartial_images | Typinteger | WymaganieOpcjonalne | Wartości i limity Zależy od modelu | Domyślnie— |
Tekst na obraz · Wymagane: prompt
| Parametr | Kontrakt |
|---|---|
Parametrmaterial_types | Kontrakttext |
Parametrrequired | Kontraktmodel, prompt |
Parametroptional_controls | Kontraktnull |
Parametrcontent_type | Kontraktapplication/json |
Cykl życia: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Rzeczywiście zwrócony task_id lub wpis w bibliotece multimediów
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Struktury metod i ID są dokładne; możliwości dostawcy są odrębne od dopuszczenia żądania.
POST /v1/images/generationsAiloot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "gpt-image-2.5-flare", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\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\nfrom openai import OpenAI\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")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'gpt-image-2.5-flare', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "gpt-image-2.5-flare", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\nPobierz każdy zwrócony obraz lub zapisz jego zawartość Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Zapisz każdy ukończony obraz; pobierz każdy zwrócony URL lub zdekoduj zawartość Base64.
Zachowaj każdy element danych. Zdekoduj każdą wartość b64_json lub pobierz dane z każdego zwróconego podpisanego adresu URL. Dobierz rozszerzenie nazwy pliku na podstawie rzeczywistego typu MIME lub bajtów.
Jeśli wynik generowania lub edycji obrazu wymaga sprawdzenia, zachowaj pierwotny operation_id/X-Client-Request-ID oraz zwrócone informacje o wyniku. Odzyskaj istniejące własne wyniki z biblioteki multimediów, używając rzeczywistych wartości task_id lub asset_id. Nie wysyłaj ponownie żądania generowania lub edycji ani nie twórz adresu URL do sprawdzania stanu na podstawie operation_id.
| Pole | Typ |
|---|---|
Polecreated | Typinteger |
Poledata[].url | Typstring |
Poledata[].b64_json | Typbase64 string |
Poleusage | Typobject |
| Odpowiedź | Warunek | Następny krok |
|---|---|---|
Odpowiedź400 · invalid_request_error | WarunekNieprawidłowe wymagane pola, sposób reprezentacji materiału lub wartość parametru | Następny krokPopraw wskazane pola przed nowym żądaniem utworzenia. |
Odpowiedźserver_error | WarunekZwrócona odpowiedź wskazuje, że operacja lub wynik wymaga sprawdzenia | Następny krokZachowaj pierwotnie zwrócony identyfikator operacji lub zadania, nagłówki żądania i odpowiedź; kontynuuj obsługiwane odczyty tej pierwotnej operacji. Nie wysyłaj ponownie żądania utworzenia. |
Ailoot gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare
/v1/images
openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare
gpt-image-2.5-flareGPT Image 2.5 Flare generuje i edytuje obrazy na podstawie tekstu i referencji, koncentrując się na szybkim codziennym tworzeniu materiałów wizualnych. Obsługuje niestandardowe rozmiary, przezroczyste tła, maski i poziomy jakości do max do szkiców, ilustracji i materiałów kampanii.
Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.
GPT Image 2.5 Flare to wersja OpenAI do generowania i edycji obrazów przeznaczona do szybkiej codziennej pracy w wysokiej jakości. Przyjmuje tekst i obrazy, a wyniki zwraca w postaci obrazów. Używaj jej do szkiców wizualnych, ilustracji, koncepcji produktowych i powtarzalnych zadań twórczych, w których opis ma szybko stać się użytecznym obrazem. Flare jest odrębny od Sunburst, którego przeznaczenie kładzie nacisk na precyzję edycji. Wybierz Flare do rutynowego tworzenia obrazów, a Sunburst, gdy priorytetem jest dokładna edycja.
Zacznij od głównego obiektu, akcji, otoczenia, kompozycji i sposobu przedstawienia. W ilustracji kampanii poproś o rowerzystę przejeżdżającego przez niewielki most w ciepłym wieczornym świetle, z wyrazistą sylwetką i otwartą przestrzenią nieba na późniejszy tekst. Zwięzły opis poszukiwawczy może pozostawiać decyzje estetyczne otwarte; opis produkcyjny powinien nazywać istotne szczegóły i ich rozmieszczenie. Bezpośrednie procesy generowania i edycji dopuszczają prompty do 32 000 znaków i od jednego do dziesięciu wyników, co pozwala porównać kilka wariantów względem tego samego celu.
Przy edycji można dostarczyć do szesnastu obrazów referencyjnych. Przypisz każdej referencji jasną rolę, zamiast oczekiwać, że model sam rozstrzygnie, czy obraz określa tożsamość obiektu, scenerię czy styl. Maska może ukierunkować zmianę danego obszaru; przy wielu obrazach dotyczy pierwszego. Obraz i maska muszą mieć zgodny format i wymiary, a maska musi zawierać kanał alfa. Przewodnik wymaga rozmiaru źródła i maski poniżej 50 MB. Maska stanowi wskazówkę, a nie obietnicę dokładnego zachowania granicy, dlatego określ zarówno żądaną modyfikację, jak i to, co powinno pozostać rozpoznawalne.
Flare obsługuje jakość low, medium, high, xhigh, max i automatyczną, z auto jako wartością domyślną. Niższa jakość może służyć do szybkiego szkicu wizualnego; wyższe ustawienia można porównać pod kątem szczegółów końcowego materiału. Jakość jest niezależna od rozmiaru i kompresji wyniku. Standardowe rozmiary obejmują 1024 × 1024, 1536 × 1024 i 1024 × 1536; dostępne są też wymiary automatyczne lub niestandardowe. Dobierz orientację do końcowego miejsca użycia i przestrzeni potrzebnej scenie.
Niestandardowa szerokość i wysokość muszą być wielokrotnościami szesnastu, a żaden bok nie może przekraczać 3840 pikseli. Dopuszczalne proporcje mieszczą się od 1:3 do 3:1, a całkowite pole obrazu musi wynosić co najmniej 655 360 i najwyżej 8 294 400 pikseli. Wszystkie cztery warunki obowiązują jednocześnie. Przewodnik określa rozdzielczości powyżej 2560 × 1440 jako eksperymentalne. Użyj poprawnego kadru pasującego do kompozycji i uwzględnij w opisie szczegóły wrażliwe na przycięcie, zamiast traktować większą rozdzielczość jako automatyczną poprawę układu.
Domyślnym formatem wyniku jest PNG, z alternatywami JPEG i WebP. JPEG i WebP pozwalają ustawić kompresję od 0 do 100. Dla przezroczystego tła wybierz PNG lub WebP; obsługiwane są również tła nieprzezroczyste i automatyczne. Przezroczysty element można umieścić w późniejszym układzie, podczas gdy nieprzezroczysty obraz ma własne tło. Dobierz format, tło i kompresję do rzeczywistych potrzeb dostarczenia materiału i zachowaj ukończony plik wraz z opisem i wybranymi ustawieniami.
Producent dokumentuje bezpośrednie generowanie i edycje obrazów oraz konwersacyjne narzędzie obrazowe, które może zachowywać wybrane wyniki do dalszych zmian. W tym procesie działanie może być automatyczne albo wymuszać generowanie lub edycję, gdy obraz znajduje się w kontekście. Strumieniowanie może pokazywać do trzech obrazów częściowych przed wynikiem końcowym. Podglądy te przedstawiają postęp, a nie dodatkowe gotowe rezultaty. Przy stopniowym dopracowywaniu kontynuuj od wybranego obrazu i opisz widoczną zmianę, taką jak przesunięcie jednego przedmiotu lub korekta kolorystyki. Interfejs producenta obsługuje również przetwarzanie wsadowe.
Sprawdź napisy, rozmieszczenie przedmiotów, szczegóły głównego obiektu i kompozycję w docelowym rozmiarze. GPT Image nadal może mieć trudności z dokładnym położeniem tekstu, uporządkowanymi układami i powtarzalną tożsamością wizualną między generowaniami. Zachowaj zaakceptowany wariant jako następną referencję i ogranicz kolejną edycję do istotnego problemu. Przeznaczenie Flare do codziennego generowania przydaje się w jasnej sekwencji: opis, warianty wizualne, wybór i dopracowanie, z oceną końcowego materiału względem rzeczywistego celu twórczego.
POST /v1/images/generationstextimage| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity gpt-image-2.5-flare | Domyślnie— |
Poleprompt | Typstring | WymaganieWymagane | Wartości i limity Maksymalna długość: 32 000 | Domyślnie— |
Polesize | Typstring | WymaganieOpcjonalne | Wartości i limity Warunki: Użyj auto lub WIDTHxHEIGHT z oboma wymiarami podzielnymi przez 16. Najdłuższy bok może mieć najwyżej 3,840 pikseli, a łączny rozmiar najwyżej 8,300,000 pikseli. | Domyślnieauto |
Polebackground | Typstring | WymaganieOpcjonalne | Wartości i limity transparent, opaque, auto | Domyślnieauto |
Polemoderation | Typstring | WymaganieOpcjonalne | Wartości i limity low, auto Warunki: Użyj auto dla standardowej moderacji treści. | Domyślnie— |
Polen | Typinteger | WymaganieOpcjonalne | Wartości i limity Minimum: 1 Maksimum: 10 | Domyślnie1 |
Polequality | Typstring | WymaganieOpcjonalne | Wartości i limity auto, high, medium, low | Domyślnieauto |
Poleoutput_compression | Typinteger | WymaganieOpcjonalne | Wartości i limity Minimum: 0 Maksimum: 100 Warunki: Dotyczy wyjścia JPEG i WebP; wyślij udokumentowaną wartość całkowitą. | Domyślnie100 |
Poleoutput_format | Typstring | WymaganieOpcjonalne | Wartości i limity webp, png, jpeg | Domyślniepng |
Polestream | Typboolean | WymaganieOpcjonalne | Wartości i limity false Warunki: Ta ścieżka zwraca jedną kompletną odpowiedź JSON. | Domyślniefalse |
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktprompt, model |
Parametrmaterial_types | Kontrakttext |
Parametroptional | Kontraktsize, background, moderation, n, quality, output_compression, output_format, stream |
Parametrconditions | KontraktPrzezroczyste tło wymaga PNG lub WebP., Kompresja wyjścia dotyczy JPEG lub WebP., Wybrana metoda generuje na podstawie tekstu. Edycja i sterowanie strumieniowaniem opisane przez producenta są osobnymi funkcjami. |
Cykl życia: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Rzeczywiście zwrócony task_id lub wpis w bibliotece multimediów
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Wyświetlane stawki służą do oszacowania kosztu przed generowaniem. Ostateczna opłata jest obliczana na podstawie kosztu zarejestrowanego dla pierwotnego generowania. Zmierzony czas trwania wyniku i prognozowane ilości nie stanowią ostatecznej ilości podlegającej rozliczeniu.
Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.
Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.
| Konfiguracja | Tabela stawek | Przewidywana ilość | Opłata |
|---|---|---|---|
| KonfiguracjaBazowe stawki za tokeny | Tabela stawekStawka podstawowa | Przewidywana ilość— | Opłata Wejście · Tokeny wejściowe · Szacunek tylko do porównania — / 1K tokenów Wyjście · Tokeny wyjściowe · Szacunek tylko do porównania — / 1K tokenów Wejście · Odczyt cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache, 1 godz. · Szacunek tylko do porównania — / 1K tokenów |
| KonfiguracjaSzacowany koszt generowania | Tabela stawek— | Przewidywana ilośćszacunek dla jednego generowania | Opłata Wyjście · Szacowany koszt generowania · Szacunek tylko do porównania $0.24576 szacunek przed generowaniem Ten szacunek nie jest dodatkową opłatą ani stałą stawką za ukończone generowanie. |
Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →
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={'prompt': 'A cute baby sea otter', 'model': 'gpt-image-2.5-flare', 'size': '1024x1024', 'n': 1, 'background': 'auto', 'moderation': 'auto', 'output_format': 'png'}\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\nPobierz każdy zwrócony obraz lub zapisz jego zawartość Base64
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.\nZapisz każdy ukończony obraz; pobierz każdy zwrócony URL lub zdekoduj zawartość Base64.
Zachowaj pełną odpowiedź i nagłówki, wszystkie rzeczywiście uzyskane wyniki, pierwotnie zwrócone identyfikatory oraz wszystkie pola zużycia. Odzyskaj pierwotną operację bez ponownego wysyłania żądania utworzenia.
Zachowaj zwrócony X-Client-Request-ID do uzgodnienia danych. Odczytuj wyłącznie rzeczywiście zwrócone wartości task_id/asset_id lub własną bibliotekę multimediów; nigdy nie buduj adresu URL zadania na podstawie identyfikatora operacji i nigdy nie wysyłaj ponownie żądania utworzenia.
| Pole | Typ |
|---|---|
Polecreated | Typ |
Poledata[].url | Typ |
Poledata[].b64_json | Typ |
Poleusage | Typ |
Ailoot gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare
/v1/images
openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare
openai/gpt-image-2.5-flareGPT Image 2.5 Flare generuje i edytuje obrazy na podstawie tekstu i referencji, koncentrując się na szybkim codziennym tworzeniu materiałów wizualnych. Obsługuje niestandardowe rozmiary, przezroczyste tła, maski i poziomy jakości do max do szkiców, ilustracji i materiałów kampanii.
Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.
GPT Image 2.5 Flare to wersja OpenAI do generowania i edycji obrazów przeznaczona do szybkiej codziennej pracy w wysokiej jakości. Przyjmuje tekst i obrazy, a wyniki zwraca w postaci obrazów. Używaj jej do szkiców wizualnych, ilustracji, koncepcji produktowych i powtarzalnych zadań twórczych, w których opis ma szybko stać się użytecznym obrazem. Flare jest odrębny od Sunburst, którego przeznaczenie kładzie nacisk na precyzję edycji. Wybierz Flare do rutynowego tworzenia obrazów, a Sunburst, gdy priorytetem jest dokładna edycja.
Zacznij od głównego obiektu, akcji, otoczenia, kompozycji i sposobu przedstawienia. W ilustracji kampanii poproś o rowerzystę przejeżdżającego przez niewielki most w ciepłym wieczornym świetle, z wyrazistą sylwetką i otwartą przestrzenią nieba na późniejszy tekst. Zwięzły opis poszukiwawczy może pozostawiać decyzje estetyczne otwarte; opis produkcyjny powinien nazywać istotne szczegóły i ich rozmieszczenie. Bezpośrednie procesy generowania i edycji dopuszczają prompty do 32 000 znaków i od jednego do dziesięciu wyników, co pozwala porównać kilka wariantów względem tego samego celu.
Przy edycji można dostarczyć do szesnastu obrazów referencyjnych. Przypisz każdej referencji jasną rolę, zamiast oczekiwać, że model sam rozstrzygnie, czy obraz określa tożsamość obiektu, scenerię czy styl. Maska może ukierunkować zmianę danego obszaru; przy wielu obrazach dotyczy pierwszego. Obraz i maska muszą mieć zgodny format i wymiary, a maska musi zawierać kanał alfa. Przewodnik wymaga rozmiaru źródła i maski poniżej 50 MB. Maska stanowi wskazówkę, a nie obietnicę dokładnego zachowania granicy, dlatego określ zarówno żądaną modyfikację, jak i to, co powinno pozostać rozpoznawalne.
Flare obsługuje jakość low, medium, high, xhigh, max i automatyczną, z auto jako wartością domyślną. Niższa jakość może służyć do szybkiego szkicu wizualnego; wyższe ustawienia można porównać pod kątem szczegółów końcowego materiału. Jakość jest niezależna od rozmiaru i kompresji wyniku. Standardowe rozmiary obejmują 1024 × 1024, 1536 × 1024 i 1024 × 1536; dostępne są też wymiary automatyczne lub niestandardowe. Dobierz orientację do końcowego miejsca użycia i przestrzeni potrzebnej scenie.
Niestandardowa szerokość i wysokość muszą być wielokrotnościami szesnastu, a żaden bok nie może przekraczać 3840 pikseli. Dopuszczalne proporcje mieszczą się od 1:3 do 3:1, a całkowite pole obrazu musi wynosić co najmniej 655 360 i najwyżej 8 294 400 pikseli. Wszystkie cztery warunki obowiązują jednocześnie. Przewodnik określa rozdzielczości powyżej 2560 × 1440 jako eksperymentalne. Użyj poprawnego kadru pasującego do kompozycji i uwzględnij w opisie szczegóły wrażliwe na przycięcie, zamiast traktować większą rozdzielczość jako automatyczną poprawę układu.
Domyślnym formatem wyniku jest PNG, z alternatywami JPEG i WebP. JPEG i WebP pozwalają ustawić kompresję od 0 do 100. Dla przezroczystego tła wybierz PNG lub WebP; obsługiwane są również tła nieprzezroczyste i automatyczne. Przezroczysty element można umieścić w późniejszym układzie, podczas gdy nieprzezroczysty obraz ma własne tło. Dobierz format, tło i kompresję do rzeczywistych potrzeb dostarczenia materiału i zachowaj ukończony plik wraz z opisem i wybranymi ustawieniami.
Producent dokumentuje bezpośrednie generowanie i edycje obrazów oraz konwersacyjne narzędzie obrazowe, które może zachowywać wybrane wyniki do dalszych zmian. W tym procesie działanie może być automatyczne albo wymuszać generowanie lub edycję, gdy obraz znajduje się w kontekście. Strumieniowanie może pokazywać do trzech obrazów częściowych przed wynikiem końcowym. Podglądy te przedstawiają postęp, a nie dodatkowe gotowe rezultaty. Przy stopniowym dopracowywaniu kontynuuj od wybranego obrazu i opisz widoczną zmianę, taką jak przesunięcie jednego przedmiotu lub korekta kolorystyki. Interfejs producenta obsługuje również przetwarzanie wsadowe.
Sprawdź napisy, rozmieszczenie przedmiotów, szczegóły głównego obiektu i kompozycję w docelowym rozmiarze. GPT Image nadal może mieć trudności z dokładnym położeniem tekstu, uporządkowanymi układami i powtarzalną tożsamością wizualną między generowaniami. Zachowaj zaakceptowany wariant jako następną referencję i ogranicz kolejną edycję do istotnego problemu. Przeznaczenie Flare do codziennego generowania przydaje się w jasnej sekwencji: opis, warianty wizualne, wybór i dopracowanie, z oceną końcowego materiału względem rzeczywistego celu twórczego.
POST /v1/images/generationstext, imageimage| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity openai/gpt-image-2.5-flare | Domyślnie— |
Poleprompt | Typstring | WymaganieWymagane | Wartości i limity Minimalna długość: 1 | Domyślnie— |
Poleaspect_ratio | Typstring | WymaganieOpcjonalne | Wartości i limity 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, auto | Domyślnie— |
Polequality | Typstring | WymaganieOpcjonalne | Wartości i limity auto, low, medium, high, xhigh, max | Domyślnie— |
Polebackground | Typstring | WymaganieOpcjonalne | Wartości i limity auto, transparent, opaque | Domyślnie— |
Polen | Typinteger | WymaganieOpcjonalne | Wartości i limity Minimum: 1 Maksimum: 10 | Domyślnie— |
Poleinput_references | Typarray | WymaganieOpcjonalne | Wartości i limity Minimalna liczba elementów: 0 Maksymalna liczba elementów: 16 | Domyślnie— |
Poleoutput_compression | Typinteger | WymaganieOpcjonalne | Wartości i limity Minimum: 0 Maksimum: 100 | Domyślnie— |
Poleprovider | Typobject | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt |
Parametrmaterial_types | Kontrakttext, image |
Cykl życia: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Rzeczywiście zwrócony task_id lub wpis w bibliotece multimediów
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Wyświetlane stawki służą do oszacowania kosztu przed generowaniem. Ostateczna opłata jest obliczana na podstawie kosztu zarejestrowanego dla pierwotnego generowania. Zmierzony czas trwania wyniku i prognozowane ilości nie stanowią ostatecznej ilości podlegającej rozliczeniu.
Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.
Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.
| Konfiguracja | Tabela stawek | Przewidywana ilość | Opłata |
|---|---|---|---|
| KonfiguracjaBazowe stawki za tokeny | Tabela stawekStawka podstawowa | Przewidywana ilość— | Opłata Wejście · Tokeny wejściowe · Szacunek tylko do porównania — / 1K tokenów Wyjście · Tokeny wyjściowe · Szacunek tylko do porównania — / 1K tokenów Wejście · Odczyt cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache, 1 godz. · Szacunek tylko do porównania — / 1K tokenów |
| KonfiguracjaSzacowany koszt generowania | Tabela stawek— | Przewidywana ilośćszacunek dla jednego generowania | Opłata Wyjście · Szacowany koszt generowania · Szacunek tylko do porównania $0.24576 szacunek przed generowaniem Ten szacunek nie jest dodatkową opłatą ani stałą stawką za ukończone generowanie. |
Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →
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': 'openai/gpt-image-2.5-flare', '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\nPobierz każdy zwrócony obraz lub zapisz jego zawartość Base64
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.\nZapisz każdy ukończony obraz; pobierz każdy zwrócony URL lub zdekoduj zawartość Base64.
Zachowaj pełną odpowiedź i nagłówki, wszystkie rzeczywiście uzyskane wyniki, pierwotnie zwrócone identyfikatory oraz wszystkie pola zużycia. Odzyskaj pierwotną operację bez ponownego wysyłania żądania utworzenia.
Zachowaj zwrócony X-Client-Request-ID do uzgodnienia danych. Odczytuj wyłącznie rzeczywiście zwrócone wartości task_id/asset_id lub własną bibliotekę multimediów; nigdy nie buduj adresu URL zadania na podstawie identyfikatora operacji i nigdy nie wysyłaj ponownie żądania utworzenia.
| Pole | Typ |
|---|---|
Polecreated | Typ |
Poledata[].url | Typ |
Poledata[].b64_json | Typ |
Poleusage | Typ |
Ailoot gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare
/v1/images
openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare