Recraft V4.1 Utility Pro to rastrowy wariant o wyższej rozdzielczości z gałęzi Utility w Recraft V4.1. Producent odróżnia prostą prezentację Utility od bardziej ekspresyjnych wyborów kąta, światła i kompozycji w głównym modelu V4.1. Utility preferuje proste sceny, płaskie światło i obiekty widziane od przodu. Nadaje się więc do wizualizacji ofert produktowych, makiet i innych prac, w których obiekt powinien być łatwy do odczytania, a spokojna kompozycja służy zadaniu.
Dokładny kod modelu to recraftv4_1_utility_pro. Dokumentacja producenta podaje wyjście rastrowe 2K z drobniejszymi szczegółami, w bezstratnym WebP lub PNG. Tabela rozmiarów wskazuje 2048 × 2048 pikseli dla kwadratów i 2432 × 1792 dla 4:3, a pozostałe obsługiwane proporcje mają własne wymiary. Odróżnia to Utility Pro od standardowego Utility z wyjściem 1K. Nie zmienia to obrazu w edytowalny plik wektorowy; w tym celu edycja Vector dostarcza SVG.
Zacznij od opisu wskazującego obiekt, materiał, kąt widzenia, tło i kilka szczegółów, które muszą być widoczne. Dla oferty produktu poproś o ceramiczny pojemnik widziany od przodu na jasnej neutralnej powierzchni, równomierne oświetlenie, zamkniętą pokrywkę i wyraźną przestrzeń wokół sylwetki. Jeśli scena ma pozostać prosta, powiedz to wprost, zamiast polegać na nazwie Utility jako nośniku wszystkich wyborów prezentacyjnych. W serii obrazów ofertowych zachowaj spójne wymagania kadru i tła, zmieniając opis produktu.
Dokumentacja generowania V4.1 obsługuje prompty do 10 000 znaków, ustawienia preferowanych kolorów i koloru tła, ziarno losowe oraz od jednego do sześciu wyników. Zgodny zapisany styl lub opcjonalne obrazy referencyjne mogą kierować wyglądem; dedykowana rodzina V4 Styles jest osobną linią, w której styl jest zawsze obowiązkowy. Przy opcjonalnych referencjach używaj wyraźnych materiałów o zgodnym kierunku wizualnym. Dokładne odtworzenie koloru z referencji nie jest gwarantowane, więc wymagany kolor marki nadal potrzebuje jawnego opisu i kontroli wyniku. Do generowania stylu na podstawie referencji użyj od jednego do dziesięciu obrazów PNG, JPG lub WebP, łącznie nie więcej niż 64 MB i poniżej 20 MB każdy. Najkrótszy bok każdej referencji musi mieć co najmniej 256 pikseli, najdłuższy nie więcej niż 4096 pikseli, a rozdzielczość nie więcej niż 16 megapikseli. Użyj albo tych referencji, albo zgodnego zapisanego stylu, zamiast obu naraz. Przy generowaniu stylu na podstawie referencji elastyczne dopasowanie pozwala na luźniejszą interpretację, a precyzyjne dopasowanie ściślej odwzorowuje sposób renderowania, paletę, kompozycję i światło.
Recraft dokumentuje również image-to-image dla linii V4.1, łączące istniejący obraz z promptem i siłą od 0 do 1. Niższa siła pozostaje bliżej źródła, a wyższa pozwala na większą zmianę. Przydaje się to, gdy początkowa kompozycja lub obiekt mają kształtować nową wersję. Operacja tego przekształcenia nie przyjmuje jednocześnie ustawień własnych stylów V4.1. Limity obrazu wejściowego producenta to rozmiar poniżej 20 MB, do 16 MP i boki od 256 do 4096 pikseli.
Utility Pro dzieli ograniczenia V4.1 dotyczące ustawień negative_prompt, gotowych nazw stylów, text_layout, artistic_level i no_text. Podaj pozytywny opis zamierzonej sceny, a precyzyjne napisy lub układ w razie potrzeby pozostaw odpowiedniemu etapowi wykończenia. Sprawdź wizualizację produktu pod kątem dostarczonego materiału, kształtu i niezbędnych szczegółów, zanim uznasz ją za wierny materiał ofertowy. Przydatnym wynikiem jest większa kompozycja rastrowa przygotowana według czytelnych założeń produktu lub makiety, a dokładne fakty o produkcie pozostają tymi podanymi w zadaniu.
", "aboutText": "Recraft V4.1 Utility Pro to rastrowy wariant o wyższej rozdzielczości z gałęzi Utility w Recraft V4.1. Producent odróżnia prostą prezentację Utility od bardziej ekspresyjnych wyborów kąta, światła i kompozycji w głównym modelu V4.1. Utility preferuje proste sceny, płaskie światło i obiekty widziane od przodu. Nadaje się więc do wizualizacji ofert produktowych, makiet i innych prac, w których obiekt powinien być łatwy do odczytania, a spokojna kompozycja służy zadaniu.\n\nDokładny kod modelu to recraftv4_1_utility_pro. Dokumentacja producenta podaje wyjście rastrowe 2K z drobniejszymi szczegółami, w bezstratnym WebP lub PNG. Tabela rozmiarów wskazuje 2048 × 2048 pikseli dla kwadratów i 2432 × 1792 dla 4:3, a pozostałe obsługiwane proporcje mają własne wymiary. Odróżnia to Utility Pro od standardowego Utility z wyjściem 1K. Nie zmienia to obrazu w edytowalny plik wektorowy; w tym celu edycja Vector dostarcza SVG.\n\nZacznij od opisu wskazującego obiekt, materiał, kąt widzenia, tło i kilka szczegółów, które muszą być widoczne. Dla oferty produktu poproś o ceramiczny pojemnik widziany od przodu na jasnej neutralnej powierzchni, równomierne oświetlenie, zamkniętą pokrywkę i wyraźną przestrzeń wokół sylwetki. Jeśli scena ma pozostać prosta, powiedz to wprost, zamiast polegać na nazwie Utility jako nośniku wszystkich wyborów prezentacyjnych. W serii obrazów ofertowych zachowaj spójne wymagania kadru i tła, zmieniając opis produktu.\n\nDokumentacja generowania V4.1 obsługuje prompty do 10 000 znaków, ustawienia preferowanych kolorów i koloru tła, ziarno losowe oraz od jednego do sześciu wyników. Zgodny zapisany styl lub opcjonalne obrazy referencyjne mogą kierować wyglądem; dedykowana rodzina V4 Styles jest osobną linią, w której styl jest zawsze obowiązkowy. Przy opcjonalnych referencjach używaj wyraźnych materiałów o zgodnym kierunku wizualnym. Dokładne odtworzenie koloru z referencji nie jest gwarantowane, więc wymagany kolor marki nadal potrzebuje jawnego opisu i kontroli wyniku. Do generowania stylu na podstawie referencji użyj od jednego do dziesięciu obrazów PNG, JPG lub WebP, łącznie nie więcej niż 64 MB i poniżej 20 MB każdy. Najkrótszy bok każdej referencji musi mieć co najmniej 256 pikseli, najdłuższy nie więcej niż 4096 pikseli, a rozdzielczość nie więcej niż 16 megapikseli. Użyj albo tych referencji, albo zgodnego zapisanego stylu, zamiast obu naraz. Przy generowaniu stylu na podstawie referencji elastyczne dopasowanie pozwala na luźniejszą interpretację, a precyzyjne dopasowanie ściślej odwzorowuje sposób renderowania, paletę, kompozycję i światło.\n\nRecraft dokumentuje również image-to-image dla linii V4.1, łączące istniejący obraz z promptem i siłą od 0 do 1. Niższa siła pozostaje bliżej źródła, a wyższa pozwala na większą zmianę. Przydaje się to, gdy początkowa kompozycja lub obiekt mają kształtować nową wersję. Operacja tego przekształcenia nie przyjmuje jednocześnie ustawień własnych stylów V4.1. Limity obrazu wejściowego producenta to rozmiar poniżej 20 MB, do 16 MP i boki od 256 do 4096 pikseli.\n\nUtility Pro dzieli ograniczenia V4.1 dotyczące ustawień negative_prompt, gotowych nazw stylów, text_layout, artistic_level i no_text. Podaj pozytywny opis zamierzonej sceny, a precyzyjne napisy lub układ w razie potrzeby pozostaw odpowiedniemu etapowi wykończenia. Sprawdź wizualizację produktu pod kątem dostarczonego materiału, kształtu i niezbędnych szczegółów, zanim uznasz ją za wierny materiał ofertowy. Przydatnym wynikiem jest większa kompozycja rastrowa przygotowana według czytelnych założeń produktu lub makiety, a dokładne fakty o produkcie pozostają tymi podanymi w zadaniu.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "45927106365db10388b679d616de3cbd0624af3cba1c54f89bcfc1c56240e564", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "pl", "methods": [ { "html": "recraft/recraft-v4.1-utility-proRecraft V4.1 Utility Pro generuje obrazy rastrowe 2K, skupiając się na prostych, przewidywalnych scenach, płaskim oświetleniu i kompozycji z widokiem od przodu. Nadaje się do szczegółowych ujęć produktów i makiet wymagających czytelnej prezentacji zamiast ekspresyjnego kierunku artystycznego.
Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.
Recraft V4.1 Utility Pro to rastrowy wariant o wyższej rozdzielczości z gałęzi Utility w Recraft V4.1. Producent odróżnia prostą prezentację Utility od bardziej ekspresyjnych wyborów kąta, światła i kompozycji w głównym modelu V4.1. Utility preferuje proste sceny, płaskie światło i obiekty widziane od przodu. Nadaje się więc do wizualizacji ofert produktowych, makiet i innych prac, w których obiekt powinien być łatwy do odczytania, a spokojna kompozycja służy zadaniu.
Dokładny kod modelu to recraftv4_1_utility_pro. Dokumentacja producenta podaje wyjście rastrowe 2K z drobniejszymi szczegółami, w bezstratnym WebP lub PNG. Tabela rozmiarów wskazuje 2048 × 2048 pikseli dla kwadratów i 2432 × 1792 dla 4:3, a pozostałe obsługiwane proporcje mają własne wymiary. Odróżnia to Utility Pro od standardowego Utility z wyjściem 1K. Nie zmienia to obrazu w edytowalny plik wektorowy; w tym celu edycja Vector dostarcza SVG.
Zacznij od opisu wskazującego obiekt, materiał, kąt widzenia, tło i kilka szczegółów, które muszą być widoczne. Dla oferty produktu poproś o ceramiczny pojemnik widziany od przodu na jasnej neutralnej powierzchni, równomierne oświetlenie, zamkniętą pokrywkę i wyraźną przestrzeń wokół sylwetki. Jeśli scena ma pozostać prosta, powiedz to wprost, zamiast polegać na nazwie Utility jako nośniku wszystkich wyborów prezentacyjnych. W serii obrazów ofertowych zachowaj spójne wymagania kadru i tła, zmieniając opis produktu.
Dokumentacja generowania V4.1 obsługuje prompty do 10 000 znaków, ustawienia preferowanych kolorów i koloru tła, ziarno losowe oraz od jednego do sześciu wyników. Zgodny zapisany styl lub opcjonalne obrazy referencyjne mogą kierować wyglądem; dedykowana rodzina V4 Styles jest osobną linią, w której styl jest zawsze obowiązkowy. Przy opcjonalnych referencjach używaj wyraźnych materiałów o zgodnym kierunku wizualnym. Dokładne odtworzenie koloru z referencji nie jest gwarantowane, więc wymagany kolor marki nadal potrzebuje jawnego opisu i kontroli wyniku. Do generowania stylu na podstawie referencji użyj od jednego do dziesięciu obrazów PNG, JPG lub WebP, łącznie nie więcej niż 64 MB i poniżej 20 MB każdy. Najkrótszy bok każdej referencji musi mieć co najmniej 256 pikseli, najdłuższy nie więcej niż 4096 pikseli, a rozdzielczość nie więcej niż 16 megapikseli. Użyj albo tych referencji, albo zgodnego zapisanego stylu, zamiast obu naraz. Przy generowaniu stylu na podstawie referencji elastyczne dopasowanie pozwala na luźniejszą interpretację, a precyzyjne dopasowanie ściślej odwzorowuje sposób renderowania, paletę, kompozycję i światło.
Recraft dokumentuje również image-to-image dla linii V4.1, łączące istniejący obraz z promptem i siłą od 0 do 1. Niższa siła pozostaje bliżej źródła, a wyższa pozwala na większą zmianę. Przydaje się to, gdy początkowa kompozycja lub obiekt mają kształtować nową wersję. Operacja tego przekształcenia nie przyjmuje jednocześnie ustawień własnych stylów V4.1. Limity obrazu wejściowego producenta to rozmiar poniżej 20 MB, do 16 MP i boki od 256 do 4096 pikseli.
Utility Pro dzieli ograniczenia V4.1 dotyczące ustawień negative_prompt, gotowych nazw stylów, text_layout, artistic_level i no_text. Podaj pozytywny opis zamierzonej sceny, a precyzyjne napisy lub układ w razie potrzeby pozostaw odpowiedniemu etapowi wykończenia. Sprawdź wizualizację produktu pod kątem dostarczonego materiału, kształtu i niezbędnych szczegółów, zanim uznasz ją za wierny materiał ofertowy. Przydatnym wynikiem jest większa kompozycja rastrowa przygotowana według czytelnych założeń produktu lub makiety, a dokładne fakty o produkcie pozostają tymi podanymi w zadaniu.
POST /v1/images/generationstext, imageimage| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity recraft/recraft-v4.1-utility-pro | 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, 4:3, 3:4, 16:9, 9:16, auto | Domyślnie— |
Polen | Typinteger | WymaganieOpcjonalne | Wartości i limity Minimum: 1 Maksimum: 6 | Domyślnie— |
Poleinput_references | Typarray | WymaganieOpcjonalne | Wartości i limity Minimalna liczba elementów: 0 Maksymalna liczba elementów: 1 | 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ść | Jednostka rozliczeniowa | Opłata |
|---|---|---|---|---|
| KonfiguracjaBazowe stawki za tokeny | Tabela stawekStawka podstawowa | Przewidywana ilość— | Jednostka rozliczeniowa— | 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 |
| Konfiguracjaobraz wyjściowy | Tabela stawek— | Przewidywana ilość— | Jednostka rozliczeniowaza obraz wyjściowy | Opłata Wyjście · obraz wyjściowy · Szacunek tylko do porównania $0.42 za obraz wyjściowy |
| KonfiguracjaSzacowany koszt generowania | Tabela stawek— | Przewidywana ilośćszacunek dla jednego generowania | Jednostka rozliczeniowa— | Opłata Wyjście · Szacowany koszt generowania · Szacunek tylko do porównania $0.42 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': 'recraft/recraft-v4.1-utility-pro', '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 Ultra recraft/recraft-v4.1-utility-pro
/v1/images