Recraft: Recraft V4 Styles Vector
Recraft V4 Styles Vector tworzy edytowalną grafikę SVG z opisu tekstowego i wymaganego stylu wizualnego. Pasuje do skoordynowanych ikon, logo i ilustracji, których prowadzenie linii, paleta i sposób przedstawienia powinny podążać za tym samym kierunkiem referencji.
O modelu
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 Vector to model tworzący SVG w dedykowanej linii generowania Recraft o spójnym stylu. Przekształca opis tekstowy w nową grafikę wektorową, korzystając z dostarczonego stylu referencyjnego do prowadzenia sposobu przedstawienia, logiki kolorów i ogólnego wyglądu. Przydaje się do skoordynowanych zestawów ikon, ilustracji marki i systemów graficznych, w których tematy się zmieniają, ale sposób przedstawienia powinien pozostać rozpoznawalny. Edycja Vector zwraca edytowalną grafikę zamiast rastrowej fotografii.
Producent identyfikuje tę edycję jako recraftv4_styles_vector. Jej wyjście to zawsze SVG; rastrowe ustawienia image_format nie przekształcają go w WebP ani PNG. Każdy wariant wektorowy przyjmuje czternaście udokumentowanych proporcji jako stosunki szerokości do wysokości zamiast dokładnych rozmiarów w pikselach. SVG nie ma stałej rozdzielczości pikselowej, więc wynik 1K standardowego modelu rastrowego nie jest rozmiarem architektonicznym tej edycji. Przy przygotowywaniu opisu wybierz żądany kształt materiału i jego zamierzone wyświetlanie w małym lub dużym rozmiarze.
Styl jest wymagany dla każdego generowania. Użyj od jednego do dziesięciu referencji PNG, JPG lub WebP albo zgodnego zapisanego stylu zamiast nowych referencji. Producent odrzuca żądanie łączące identyfikator zapisanego stylu z obrazami referencyjnymi stylu. Udokumentowany limit referencji wynosi łącznie 64 MB i poniżej 20 MB na plik. Pojedyncza wyraźna ikona lub ilustracja może ustalić sposób przedstawienia; kilka referencji przydaje się, gdy ich grubość linii, narożniki, logika wypełnień i paleta już należą do tego samego systemu wizualnego. Każda referencja musi mieć krótszy bok co najmniej 256 pikseli, dłuższy nie większy niż 4 096 pikseli i łączną rozdzielczość nie większą niż 16 megapikseli.
Dopasowanie flexible jest domyślne i swobodniej interpretuje referencję, natomiast precise ściślej podąża za jej sposobem przedstawienia, kolorem, kompozycją i oświetleniem. Przy systemie wektorowym użyj promptu do określenia rodzaju grafiki, sylwetki, liczby obiektów i układu. Dla zestawu ikon nawigacyjnych użyj mocnych zaokrąglonych konturów, jednego wyśrodkowanego obiektu na obraz i palety dwóch kolorów. Zachowaj ten sam styl referencyjny i zmieniaj nazwany obiekt w każdym opisie zamiast mieszać niezwiązane referencje dla uzyskania różnorodności.
Dokumentacja generowania dopuszcza prompty do 10 000 znaków, od jednego do sześciu wyników, losowy seed, preferowane kolory i żądany kolor tła. Prompty negatywne, nazwy wyselekcjonowanych stylów i starsze ustawienie text_layout nie są obsługiwane. Ta edycja Styles również nie udostępnia image-to-image ani inpaintingu: obraz referencyjny dostarcza język wizualny, a nie obszar do wymazania czy istniejącą grafikę do zachowania bez zmian. Instrukcje strukturalne w opisie pozytywnym powinny przedstawiać zamierzony gotowy materiał.
Sprawdź SVG w rozmiarze, w którym będzie używany, szczególnie gdy projekt zawiera liternictwo, wąskie odstępy lub małe szczegóły. Dopasowanie kolorów do referencji nie jest gwarantowane, a niezwiązane referencje mogą ze sobą konkurować. Gdy zestaw ikon staje się powtarzalny, zmień obiekt, pozę lub układ w prompcie, zachowując spójny styl. Użyteczny rezultat to spójny materiał wektorowy, którego kształty i kolory można zmieniać w procesie projektowym, z geometrią i czytelnością ocenionymi względem opisu.
W Ailoot wybierz ten dokładny identyfikator modelu w /v1/images/generations i podaj kreatywny prompt. Zachowaj każdy zwrócony wpis data, niezależnie od tego, czy odpowiedź zawiera URL, czy zakodowaną treść obrazu, i zapisz rzeczywiste bajty z ich zwróconym typem treści. Zachowaj usage i ewentualny task_id multimediów wraz z materiałem, a następnie sprawdź jego kształty, liternictwo i obszary kolorów w zamierzonym projekcie.
Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-styles-vector
recraft/recraft-v4-styles-vector
recraft/recraft-v4-styles-vectorStart
Recraft V4 Styles Vector tworzy edytowalną grafikę SVG z opisu tekstowego i wymaganego stylu wizualnego. Pasuje do skoordynowanych ikon, logo i ilustracji, których prowadzenie linii, paleta i sposób przedstawienia powinny podążać za tym samym kierunkiem referencji.
- Akceptowane dane wejściowe
- Tekst · Obrazy
- Wyniki
- Obrazy
Dostępne w Ailoot · dane wejściowe i metody
Ailoot Ultra · Images POST /v1/images/generations
- Wejście
text,image- Wyjście
image- Format wyjściowy
- Plik obrazu
| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity recraft/recraft-v4-styles-vector Warunki: Użyj dokładnie tego selektora trasowania Ailoot. | Domyślnie— |
Poleprompt | Typstring | WymaganieWymagane | Wartości i limity Warunki: | Domyślnie— |
Polen | Typinteger | WymaganieOpcjonalne | Wartości i limity Minimum: 1 Maksimum: 6 Warunki: | 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 Warunki: | Domyślnie— |
Poleoutput_format | Typstring | WymaganieOpcjonalne | Wartości i limity svg Warunki: | Domyślnie— |
Poleinput_references | Typarray | WymaganieWymagane | Wartości i limity Warunki: | Domyślnie— |
Polequality | Typstring | WymaganieOpcjonalne | Wartości i limity auto, low, medium, high, xhigh, max Warunki: | Domyślnie— |
Kombinacje materiałów wejściowych
reference_guided_image
Parametry i cykl życia metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt, input_references |
Parametroptional | Kontraktn, aspect_ratio, output_format, quality |
Parametrmaterial_types | Kontrakttext, image |
Parametrconditions | KontraktUżyj dokładnie tego selektora trasowania Ailoot., quality jest powszechnym udokumentowanym parametrem; dostawcy bez możliwości regulacji jakości go ignorują. Nie obiecuje się poprawy jakości dla poszczególnych modeli. |
Cykl życia: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Faktycznie zwrócony task_id lub wybrany rekord biblioteki; operation_id jest osobnym identyfikatorem.
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Cennik
Jak obliczana jest ostateczna opłata
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.
- Tryb szybki
- Nie określono Gdy wybrany jest tryb szybki
- Tryb flex
- Nie określono Gdy wybrany jest tryb flex
- Maksymalna intensywność rozumowania
- Nie określono Gdy dla maksymalnej intensywności rozumowania stosowana jest domyślna korekta (default)
Szacunkowe stawki do porównania
Ceny według konfiguracji
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 Wyłącznie orientacyjny szacunek; ostateczna opłata wynika z zapisanej oryginalnej faktury. |
| 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.1 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.1 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 →
Przykładowe żądania
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
: "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "recraft/recraft-v4-styles-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field.", "input_references": [{"type": "image_url", "image_url": {"url": "YOUR_ACCESSIBLE_IMAGE_URL"}}]}')
p['input_references'][0]['image_url']['url']=os.environ['AILOOT_IMAGE_URL']
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Odbieranie i zapisywanie wyników
Ailoot Ultra · Images
Pobierz każdy zwrócony obraz lub zapisz jego zawartość Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Zachowaj wszystkie ukończone wyniki
Zapisz każdy ukończony obraz; pobierz każdy zwrócony URL lub zdekoduj zawartość Base64.
Zachowaj kompletną odpowiedź i nagłówki, pierwotne identyfikatory, wszystkie rzeczywiste wyniki oraz wszystkie pola użycia i rozliczeń. Zapisz każdy unikalny zasób należący do użytkownika i zachowaj wszystkie role, które na niego wskazują.
Jeśli trzeba sprawdzić pierwotną odpowiedź
Zachowaj oryginalne X-Client-Request-ID, odpowiedź i nagłówki. Nieznany wynik ani wynik result_pending_check nie upoważniają do ponownego utworzenia.
Pola odpowiedzi
| Pole | Typ |
|---|---|
Poledata[].url | Typstring |
Poledata[].b64_json | Typstring |
Poleusage | Typobject |
Błędy i dalsze kroki
| Odpowiedź | Warunek | Następny krok |
|---|---|---|
Odpowiedź400 · invalid_request_error | WarunekWymagane pole, selektor modelu, typ lub postać danych wejściowych są nieprawidłowe. | Następny krokPrzed przygotowaniem osobnego żądania sprawdź zwrócone szczegóły walidacji. |
Odpowiedź | WarunekOryginalne żądanie lub wynik są nieznane albo wymagają sprawdzenia. | Następny krokZachowaj oryginalne identyfikatory i nagłówki; odczytuj tylko obsługiwane rekordy statusu lub biblioteki. Nie wysyłaj ponownie żądania utworzenia. |
Aliasy
Aliasy modelu
Ailoot Ultra recraft/recraft-v4-styles-vector
Aliasy ścieżek metod
Użyj ścieżek metod podanych powyżej.
Powiązane ID modeli
FAQ · Recraft: Recraft V4 Styles Vector
- Jakie dane wejściowe i wyniki są dostępne?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:text,image→image- Jakich pól używa żądanie?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- Jakie limity obowiązują?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:n.minimum:1;n.maximum:6