Recraft V4.1 to główny model rastrowy w rodzinie V4.1 Recraft. Zbudowano go do ekspresyjnego tworzenia obrazów, w tym naturalnie wyglądających fotografii, ilustracji i przestrzennych koncepcji wizualnych. Producent przedstawia go jako model, który potrafi podejmować decyzje estetyczne z krótkiego promptu, a jednocześnie reagować na bardziej szczegółowy kierunek twórczy. Używaj go do eksploracji, koncepcji i obrazów, w których nastrój, światło i kompozycja są częścią wyniku, zamiast sprowadzać je do prostego widoku produktu od frontu.
Dokładny kod producenta to recraftv4_1. Zwraca rastrowe obrazy 1K w bezstratnym WebP lub PNG, z wynikiem kwadratowym 1024 × 1024 piksele i 16:9 o wymiarach 1344 × 768. Pozostałe obsługiwane proporcje używają własnych wymiarów. V4.1 Pro to osobna rastrowa wersja 2K, Vector zwraca edytowalne SVG, a Utility preferuje prostsze oświetlenie i sceny. Te gałęzie służą różnym rezultatom i nie należy łączyć ich w jeden zestaw właściwości wyjściowych.
Producent podkreśla bardziej naturalne sceny fotograficzne, spokojniejsze tło, płynniejsze gradienty i szeroki zakres ilustracji. Jego przykłady obejmują ekspresyjne liternictwo, płaską ilustrację postaci i rysunkową kartę referencyjną postaci. Krótki prompt może pozostawiać przestrzeń na interpretację modelu; szczegółowy opis może ustalać temat, pozę, materiał, tło i kompozycję. W grafice przestrzennej określ powierzchnię i sposób oświetlenia, pamiętając, że wynikiem jest obraz, a nie siatka ani edytowalny projekt 3D.
W koncepcji miejsca do czytania poproś o kameralną fotografię małego kącika czytelniczego, ciepłe światło dzienne, książki i jeden ceramiczny przedmiot, ze swobodną aranżacją zamiast układu przypominającego salon wystawowy. Kontrolowany opis ilustracji może zamiast tego nazywać temat graficzny, relacje kolorów i sposób prowadzenia linii. Określ zamierzone proporcje i najważniejsze decyzje wizualne. Ułatwia to rozstrzygnięcie, czy nieoczekiwany szczegół jest przydatną interpretacją twórczą, czy czymś do zmiany w następnym opisie.
Dokumentacja generowania dopuszcza prompty do 10 000 znaków, ziarno losowości, preferowane kolory i pożądany kolor tła oraz umożliwia otrzymanie od jednego do sześciu wyników. Opcjonalne obrazy referencyjne lub zgodne zapisane style mogą ustanawiać język wizualny z elastycznym lub precyzyjnym dopasowaniem. Nie są wymagane dla głównej wersji V4.1. Wybieraj czyste referencje zgodne ze sobą i używaj promptu do nowej treści; odtworzenie koloru referencji nie jest gwarantowane. Do generowania ze stylem referencyjnym użyj od jednego do dziesięciu obrazów PNG, JPG lub WebP, nie więcej niż 64 MB łącznie i poniżej 20 MB każdy. Każda referencja wymaga najkrótszego boku co najmniej 256 pikseli, najdłuższego nie większego niż 4096 pikseli i rozdzielczości nie większej niż 16 megapikseli. Używaj tych referencji albo zgodnego zapisanego stylu, zamiast obu naraz.
V4.1 obsługuje również osobny proces obraz–obraz z istniejącym obrazem, tekstem i siłą od 0 do 1. Operacja używa siły do kontrolowania, jak blisko źródła pozostaje nowy obraz, i nie przyjmuje ustawień niestandardowych stylów V4.1. Obecna dokumentacja generowania modelu wyklucza negative_prompt, style z biblioteki, text_layout, artistic_level i no_text. Opisuj zamierzoną scenę bezpośrednio i sprawdzaj wynikowy materiał w docelowym układzie, w tym szczegóły, kadr i napisy, przed wyborem kierunku wizualnego do zachowania. Do operacji obraz–obraz dostarcz PNG, JPG, WebP lub SVG poniżej 20 MB, nie więcej niż 16 megapikseli, z oboma bokami od 256 do 4096 pikseli.
", "aboutText": "Recraft V4.1 to główny model rastrowy w rodzinie V4.1 Recraft. Zbudowano go do ekspresyjnego tworzenia obrazów, w tym naturalnie wyglądających fotografii, ilustracji i przestrzennych koncepcji wizualnych. Producent przedstawia go jako model, który potrafi podejmować decyzje estetyczne z krótkiego promptu, a jednocześnie reagować na bardziej szczegółowy kierunek twórczy. Używaj go do eksploracji, koncepcji i obrazów, w których nastrój, światło i kompozycja są częścią wyniku, zamiast sprowadzać je do prostego widoku produktu od frontu.\n\nDokładny kod producenta to recraftv4_1. Zwraca rastrowe obrazy 1K w bezstratnym WebP lub PNG, z wynikiem kwadratowym 1024 × 1024 piksele i 16:9 o wymiarach 1344 × 768. Pozostałe obsługiwane proporcje używają własnych wymiarów. V4.1 Pro to osobna rastrowa wersja 2K, Vector zwraca edytowalne SVG, a Utility preferuje prostsze oświetlenie i sceny. Te gałęzie służą różnym rezultatom i nie należy łączyć ich w jeden zestaw właściwości wyjściowych.\n\nProducent podkreśla bardziej naturalne sceny fotograficzne, spokojniejsze tło, płynniejsze gradienty i szeroki zakres ilustracji. Jego przykłady obejmują ekspresyjne liternictwo, płaską ilustrację postaci i rysunkową kartę referencyjną postaci. Krótki prompt może pozostawiać przestrzeń na interpretację modelu; szczegółowy opis może ustalać temat, pozę, materiał, tło i kompozycję. W grafice przestrzennej określ powierzchnię i sposób oświetlenia, pamiętając, że wynikiem jest obraz, a nie siatka ani edytowalny projekt 3D.\n\nW koncepcji miejsca do czytania poproś o kameralną fotografię małego kącika czytelniczego, ciepłe światło dzienne, książki i jeden ceramiczny przedmiot, ze swobodną aranżacją zamiast układu przypominającego salon wystawowy. Kontrolowany opis ilustracji może zamiast tego nazywać temat graficzny, relacje kolorów i sposób prowadzenia linii. Określ zamierzone proporcje i najważniejsze decyzje wizualne. Ułatwia to rozstrzygnięcie, czy nieoczekiwany szczegół jest przydatną interpretacją twórczą, czy czymś do zmiany w następnym opisie.\n\nDokumentacja generowania dopuszcza prompty do 10 000 znaków, ziarno losowości, preferowane kolory i pożądany kolor tła oraz umożliwia otrzymanie od jednego do sześciu wyników. Opcjonalne obrazy referencyjne lub zgodne zapisane style mogą ustanawiać język wizualny z elastycznym lub precyzyjnym dopasowaniem. Nie są wymagane dla głównej wersji V4.1. Wybieraj czyste referencje zgodne ze sobą i używaj promptu do nowej treści; odtworzenie koloru referencji nie jest gwarantowane. Do generowania ze stylem referencyjnym użyj od jednego do dziesięciu obrazów PNG, JPG lub WebP, nie więcej niż 64 MB łącznie i poniżej 20 MB każdy. Każda referencja wymaga najkrótszego boku co najmniej 256 pikseli, najdłuższego nie większego niż 4096 pikseli i rozdzielczości nie większej niż 16 megapikseli. Używaj tych referencji albo zgodnego zapisanego stylu, zamiast obu naraz.\n\nV4.1 obsługuje również osobny proces obraz–obraz z istniejącym obrazem, tekstem i siłą od 0 do 1. Operacja używa siły do kontrolowania, jak blisko źródła pozostaje nowy obraz, i nie przyjmuje ustawień niestandardowych stylów V4.1. Obecna dokumentacja generowania modelu wyklucza negative_prompt, style z biblioteki, text_layout, artistic_level i no_text. Opisuj zamierzoną scenę bezpośrednio i sprawdzaj wynikowy materiał w docelowym układzie, w tym szczegóły, kadr i napisy, przed wyborem kierunku wizualnego do zachowania. Do operacji obraz–obraz dostarcz PNG, JPG, WebP lub SVG poniżej 20 MB, nie więcej niż 16 megapikseli, z oboma bokami od 256 do 4096 pikseli.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "d73e40d4693d1c005b0fe209cbef0847c560a44336f00109f28e65647c48099f", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "pl", "methods": [ { "html": "recraft/recraft-v4.1Recraft V4.1 tworzy rastrowe obrazy 1K z naturalnym fotorealizmem, ekspresyjną ilustracją i przemyślaną kompozycją. Może rozwijać krótkie wskazówki twórcze lub realizować szczegółowy opis, z opcjonalnymi obrazami i niestandardowymi stylami wejściowymi.
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 to główny model rastrowy w rodzinie V4.1 Recraft. Zbudowano go do ekspresyjnego tworzenia obrazów, w tym naturalnie wyglądających fotografii, ilustracji i przestrzennych koncepcji wizualnych. Producent przedstawia go jako model, który potrafi podejmować decyzje estetyczne z krótkiego promptu, a jednocześnie reagować na bardziej szczegółowy kierunek twórczy. Używaj go do eksploracji, koncepcji i obrazów, w których nastrój, światło i kompozycja są częścią wyniku, zamiast sprowadzać je do prostego widoku produktu od frontu.
Dokładny kod producenta to recraftv4_1. Zwraca rastrowe obrazy 1K w bezstratnym WebP lub PNG, z wynikiem kwadratowym 1024 × 1024 piksele i 16:9 o wymiarach 1344 × 768. Pozostałe obsługiwane proporcje używają własnych wymiarów. V4.1 Pro to osobna rastrowa wersja 2K, Vector zwraca edytowalne SVG, a Utility preferuje prostsze oświetlenie i sceny. Te gałęzie służą różnym rezultatom i nie należy łączyć ich w jeden zestaw właściwości wyjściowych.
Producent podkreśla bardziej naturalne sceny fotograficzne, spokojniejsze tło, płynniejsze gradienty i szeroki zakres ilustracji. Jego przykłady obejmują ekspresyjne liternictwo, płaską ilustrację postaci i rysunkową kartę referencyjną postaci. Krótki prompt może pozostawiać przestrzeń na interpretację modelu; szczegółowy opis może ustalać temat, pozę, materiał, tło i kompozycję. W grafice przestrzennej określ powierzchnię i sposób oświetlenia, pamiętając, że wynikiem jest obraz, a nie siatka ani edytowalny projekt 3D.
W koncepcji miejsca do czytania poproś o kameralną fotografię małego kącika czytelniczego, ciepłe światło dzienne, książki i jeden ceramiczny przedmiot, ze swobodną aranżacją zamiast układu przypominającego salon wystawowy. Kontrolowany opis ilustracji może zamiast tego nazywać temat graficzny, relacje kolorów i sposób prowadzenia linii. Określ zamierzone proporcje i najważniejsze decyzje wizualne. Ułatwia to rozstrzygnięcie, czy nieoczekiwany szczegół jest przydatną interpretacją twórczą, czy czymś do zmiany w następnym opisie.
Dokumentacja generowania dopuszcza prompty do 10 000 znaków, ziarno losowości, preferowane kolory i pożądany kolor tła oraz umożliwia otrzymanie od jednego do sześciu wyników. Opcjonalne obrazy referencyjne lub zgodne zapisane style mogą ustanawiać język wizualny z elastycznym lub precyzyjnym dopasowaniem. Nie są wymagane dla głównej wersji V4.1. Wybieraj czyste referencje zgodne ze sobą i używaj promptu do nowej treści; odtworzenie koloru referencji nie jest gwarantowane. Do generowania ze stylem referencyjnym użyj od jednego do dziesięciu obrazów PNG, JPG lub WebP, nie więcej niż 64 MB łącznie i poniżej 20 MB każdy. Każda referencja wymaga najkrótszego boku co najmniej 256 pikseli, najdłuższego nie większego niż 4096 pikseli i rozdzielczości nie większej niż 16 megapikseli. Używaj tych referencji albo zgodnego zapisanego stylu, zamiast obu naraz.
V4.1 obsługuje również osobny proces obraz–obraz z istniejącym obrazem, tekstem i siłą od 0 do 1. Operacja używa siły do kontrolowania, jak blisko źródła pozostaje nowy obraz, i nie przyjmuje ustawień niestandardowych stylów V4.1. Obecna dokumentacja generowania modelu wyklucza negative_prompt, style z biblioteki, text_layout, artistic_level i no_text. Opisuj zamierzoną scenę bezpośrednio i sprawdzaj wynikowy materiał w docelowym układzie, w tym szczegóły, kadr i napisy, przed wyborem kierunku wizualnego do zachowania. Do operacji obraz–obraz dostarcz PNG, JPG, WebP lub SVG poniżej 20 MB, nie więcej niż 16 megapikseli, z oboma bokami od 256 do 4096 pikseli.
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 | 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.07 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.07 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', '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
/v1/images