Recraft V4 Styles Pro to rastrowy model o wyższej rozdzielczości w dedykowanej rodzinie V4 Styles Recraft. Tworzy nowy obraz z opisu tekstowego i stylu wizualnego dostarczonego przez obrazy referencyjne lub zapisany styl. Model jest przeznaczony do kampanii, ilustracji marek i innych zestawów obrazów, w których renderowanie, tekstura i charakter kompozycji muszą przenosić się z jednego materiału na następny. Jest odrębny od Recraft V4 Pro i V4.1 Pro, w których dane stylu są opcjonalne, a nie stanowią wymogu definiującego model.
Styles Pro tworzy rastrowy wynik 2K w formatach bezstratnego WebP lub PNG. Kwadratowy wynik w tabeli rozmiarów producenta ma 2048 × 2048 pikseli, a 16:9 — 2688 × 1536; pozostałe obsługiwane proporcje mają własne wymiary. Większy wynik Pro może przydać się w szczegółowych grafikach kampanii i większych układach. Warianty wektorowe tworzą natomiast SVG i nie mają stałego rozmiaru w pikselach, dlatego tej rastrowej wersji Pro nie należy wybierać, gdy zamierzonym rezultatem jest edytowalny plik wektorowy.
Każde generowanie w rodzinie Styles wymaga stylu. Dostarcz od jednego do dziesięciu obrazów referencyjnych PNG, JPG lub WebP albo ponownie użyj zgodnego zapisanego stylu; identyfikator stylu i nowe referencje są alternatywnymi wejściami, a nie parą do łączenia. Proces producenta dopuszcza do 64 MB łącznie dla referencji, z każdym plikiem poniżej 20 MB. Tworzenie stylu nie wymaga etapu treningu uruchamianego przez użytkownika. Jedna czytelna referencja może ustanowić spójny kierunek, a kilka pomaga, gdy już współdzielą ten sam język wizualny zamiast konkurujących wyglądów. Każda referencja musi mieć najkrótszy bok co najmniej 256 pikseli, najdłuższy nie większy niż 4096 pikseli i całkowitą rozdzielczość nie większą niż 16 megapikseli.
Elastyczne dopasowanie stylu jest domyślne i pozwala na luźniejszą interpretację referencji. Precyzyjne dopasowanie ściślej podąża za renderowaniem, paletą, kompozycją i oświetleniem. Referencja określa język wizualny; opis tekstowy nadal musi opisywać nowy temat, akcję, scenę i kadr. W szczegółowej kampanii produktowej określ szklaną butelkę na jasnej kamiennej powierzchni, widok trzy czwarte, miękkie światło boczne i wolne miejsce na nagłówek, a dostarczona referencja niech niesie sposób fotograficznego przedstawienia.
Model przyjmuje prompty do 10 000 znaków, obsługuje preferowane kolory i pożądany kolor tła oraz może używać ziarna losowości. Udokumentowany proces generowania może zwracać od jednego do sześciu obrazów. Jego przydatne ustawienia różnią się od starszych wersji Recraft: nazwy stylów z biblioteki, negative_prompt i text_layout nie są obsługiwane, a rodzina Styles nie zapewnia obraz–obraz ani uzupełniania fragmentów obrazu. Referencja jest źródłem stylu, a nie maską ani instrukcją zachowania istniejącej fotografii piksel po pikselu.
Przygotuj czyste, wystarczająco szczegółowe materiały referencyjne i ponownie używaj tego samego stylu przy rozwijaniu zestawu. Jeśli wyniki stają się powtarzalne, zmień temat, pozę, kąt kamery lub scenę w opisie tekstowym, zamiast dodawać niepowiązaną referencję. Dokładne dopasowanie koloru referencji do wyniku nie jest gwarantowane; ustawienia preferowanych kolorów wyrażają kierunek, a nie wynik kontroli barw. Oceniaj końcowy materiał kampanii w docelowym rozmiarze wyświetlania lub druku i sprawdzaj, czy temat, przydatna pusta przestrzeń i sposób przedstawienia odpowiadają opisowi.
", "aboutText": "Recraft V4 Styles Pro to rastrowy model o wyższej rozdzielczości w dedykowanej rodzinie V4 Styles Recraft. Tworzy nowy obraz z opisu tekstowego i stylu wizualnego dostarczonego przez obrazy referencyjne lub zapisany styl. Model jest przeznaczony do kampanii, ilustracji marek i innych zestawów obrazów, w których renderowanie, tekstura i charakter kompozycji muszą przenosić się z jednego materiału na następny. Jest odrębny od Recraft V4 Pro i V4.1 Pro, w których dane stylu są opcjonalne, a nie stanowią wymogu definiującego model.\n\nStyles Pro tworzy rastrowy wynik 2K w formatach bezstratnego WebP lub PNG. Kwadratowy wynik w tabeli rozmiarów producenta ma 2048 × 2048 pikseli, a 16:9 — 2688 × 1536; pozostałe obsługiwane proporcje mają własne wymiary. Większy wynik Pro może przydać się w szczegółowych grafikach kampanii i większych układach. Warianty wektorowe tworzą natomiast SVG i nie mają stałego rozmiaru w pikselach, dlatego tej rastrowej wersji Pro nie należy wybierać, gdy zamierzonym rezultatem jest edytowalny plik wektorowy.\n\nKażde generowanie w rodzinie Styles wymaga stylu. Dostarcz od jednego do dziesięciu obrazów referencyjnych PNG, JPG lub WebP albo ponownie użyj zgodnego zapisanego stylu; identyfikator stylu i nowe referencje są alternatywnymi wejściami, a nie parą do łączenia. Proces producenta dopuszcza do 64 MB łącznie dla referencji, z każdym plikiem poniżej 20 MB. Tworzenie stylu nie wymaga etapu treningu uruchamianego przez użytkownika. Jedna czytelna referencja może ustanowić spójny kierunek, a kilka pomaga, gdy już współdzielą ten sam język wizualny zamiast konkurujących wyglądów. Każda referencja musi mieć najkrótszy bok co najmniej 256 pikseli, najdłuższy nie większy niż 4096 pikseli i całkowitą rozdzielczość nie większą niż 16 megapikseli.\n\nElastyczne dopasowanie stylu jest domyślne i pozwala na luźniejszą interpretację referencji. Precyzyjne dopasowanie ściślej podąża za renderowaniem, paletą, kompozycją i oświetleniem. Referencja określa język wizualny; opis tekstowy nadal musi opisywać nowy temat, akcję, scenę i kadr. W szczegółowej kampanii produktowej określ szklaną butelkę na jasnej kamiennej powierzchni, widok trzy czwarte, miękkie światło boczne i wolne miejsce na nagłówek, a dostarczona referencja niech niesie sposób fotograficznego przedstawienia.\n\nModel przyjmuje prompty do 10 000 znaków, obsługuje preferowane kolory i pożądany kolor tła oraz może używać ziarna losowości. Udokumentowany proces generowania może zwracać od jednego do sześciu obrazów. Jego przydatne ustawienia różnią się od starszych wersji Recraft: nazwy stylów z biblioteki, negative_prompt i text_layout nie są obsługiwane, a rodzina Styles nie zapewnia obraz–obraz ani uzupełniania fragmentów obrazu. Referencja jest źródłem stylu, a nie maską ani instrukcją zachowania istniejącej fotografii piksel po pikselu.\n\nPrzygotuj czyste, wystarczająco szczegółowe materiały referencyjne i ponownie używaj tego samego stylu przy rozwijaniu zestawu. Jeśli wyniki stają się powtarzalne, zmień temat, pozę, kąt kamery lub scenę w opisie tekstowym, zamiast dodawać niepowiązaną referencję. Dokładne dopasowanie koloru referencji do wyniku nie jest gwarantowane; ustawienia preferowanych kolorów wyrażają kierunek, a nie wynik kontroli barw. Oceniaj końcowy materiał kampanii w docelowym rozmiarze wyświetlania lub druku i sprawdzaj, czy temat, przydatna pusta przestrzeń i sposób przedstawienia odpowiadają opisowi.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "0f33df04cdeccca4f5a2f6cdd681da5c72107cdc63c6a95a64a34eec73bc4d1a", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "pl", "methods": [ { "html": "recraft/recraft-v4-styles-proRecraft V4 Styles Pro generuje rastrowe obrazy 2K w stylu wizualnym określonym przez referencje. Jest przeznaczony do szczegółowych materiałów kampanii i zestawów obrazów, których tekstura, renderowanie, paleta i ogólny wygląd mają pozostać spójne mimo zmiany tematu.
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 Styles Pro to rastrowy model o wyższej rozdzielczości w dedykowanej rodzinie V4 Styles Recraft. Tworzy nowy obraz z opisu tekstowego i stylu wizualnego dostarczonego przez obrazy referencyjne lub zapisany styl. Model jest przeznaczony do kampanii, ilustracji marek i innych zestawów obrazów, w których renderowanie, tekstura i charakter kompozycji muszą przenosić się z jednego materiału na następny. Jest odrębny od Recraft V4 Pro i V4.1 Pro, w których dane stylu są opcjonalne, a nie stanowią wymogu definiującego model.
Styles Pro tworzy rastrowy wynik 2K w formatach bezstratnego WebP lub PNG. Kwadratowy wynik w tabeli rozmiarów producenta ma 2048 × 2048 pikseli, a 16:9 — 2688 × 1536; pozostałe obsługiwane proporcje mają własne wymiary. Większy wynik Pro może przydać się w szczegółowych grafikach kampanii i większych układach. Warianty wektorowe tworzą natomiast SVG i nie mają stałego rozmiaru w pikselach, dlatego tej rastrowej wersji Pro nie należy wybierać, gdy zamierzonym rezultatem jest edytowalny plik wektorowy.
Każde generowanie w rodzinie Styles wymaga stylu. Dostarcz od jednego do dziesięciu obrazów referencyjnych PNG, JPG lub WebP albo ponownie użyj zgodnego zapisanego stylu; identyfikator stylu i nowe referencje są alternatywnymi wejściami, a nie parą do łączenia. Proces producenta dopuszcza do 64 MB łącznie dla referencji, z każdym plikiem poniżej 20 MB. Tworzenie stylu nie wymaga etapu treningu uruchamianego przez użytkownika. Jedna czytelna referencja może ustanowić spójny kierunek, a kilka pomaga, gdy już współdzielą ten sam język wizualny zamiast konkurujących wyglądów. Każda referencja musi mieć najkrótszy bok co najmniej 256 pikseli, najdłuższy nie większy niż 4096 pikseli i całkowitą rozdzielczość nie większą niż 16 megapikseli.
Elastyczne dopasowanie stylu jest domyślne i pozwala na luźniejszą interpretację referencji. Precyzyjne dopasowanie ściślej podąża za renderowaniem, paletą, kompozycją i oświetleniem. Referencja określa język wizualny; opis tekstowy nadal musi opisywać nowy temat, akcję, scenę i kadr. W szczegółowej kampanii produktowej określ szklaną butelkę na jasnej kamiennej powierzchni, widok trzy czwarte, miękkie światło boczne i wolne miejsce na nagłówek, a dostarczona referencja niech niesie sposób fotograficznego przedstawienia.
Model przyjmuje prompty do 10 000 znaków, obsługuje preferowane kolory i pożądany kolor tła oraz może używać ziarna losowości. Udokumentowany proces generowania może zwracać od jednego do sześciu obrazów. Jego przydatne ustawienia różnią się od starszych wersji Recraft: nazwy stylów z biblioteki, negative_prompt i text_layout nie są obsługiwane, a rodzina Styles nie zapewnia obraz–obraz ani uzupełniania fragmentów obrazu. Referencja jest źródłem stylu, a nie maską ani instrukcją zachowania istniejącej fotografii piksel po pikselu.
Przygotuj czyste, wystarczająco szczegółowe materiały referencyjne i ponownie używaj tego samego stylu przy rozwijaniu zestawu. Jeśli wyniki stają się powtarzalne, zmień temat, pozę, kąt kamery lub scenę w opisie tekstowym, zamiast dodawać niepowiązaną referencję. Dokładne dopasowanie koloru referencji do wyniku nie jest gwarantowane; ustawienia preferowanych kolorów wyrażają kierunek, a nie wynik kontroli barw. Oceniaj końcowy materiał kampanii w docelowym rozmiarze wyświetlania lub druku i sprawdzaj, czy temat, przydatna pusta przestrzeń i sposób przedstawienia odpowiadają opisowi.
POST /v1/images/generationstext, imageimage| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity recraft/recraft-v4-styles-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, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 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: 1 Maksymalna liczba elementów: 10 | 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 | Warunki rozliczania | Opłata |
|---|---|---|---|---|---|
| KonfiguracjaBazowe stawki za tokeny | Tabela stawekStawka podstawowa | Przewidywana ilość— | Jednostka rozliczeniowa— | Warunki rozliczania— | 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 |
| KonfiguracjaMateriał referencyjny wejściowy | Tabela stawek— | Przewidywana ilość— | Jednostka rozliczeniowaza żądanie | Warunki rozliczaniaUtworzenie stylu przy generowaniu z materiałami referencyjnymi stylu; raz na żądanie, dodatkowo do ceny obrazu wyjściowego. | Opłata Wejście · Materiał referencyjny wejściowy · Szacunek tylko do porównania $0.01 za żądanie |
| Konfiguracjaobraz wyjściowy | Tabela stawek— | Przewidywana ilość— | Jednostka rozliczeniowaza obraz wyjściowy | Warunki rozliczania— | Opłata Wyjście · obraz wyjściowy · Szacunek tylko do porównania $0.2 za obraz wyjściowy |
| KonfiguracjaSzacowany koszt generowania | Tabela stawek— | Przewidywana ilośćszacunek dla jednego generowania | Jednostka rozliczeniowa— | Warunki rozliczania— | Opłata Wyjście · Szacowany koszt generowania · Szacunek tylko do porównania $0.2 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-styles-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-styles-pro
/v1/images