Recraft: Recraft V4.1 Vector
Recraft V4.1 Vector generuje z tekstu edytowalne logo, liternictwo i ilustracje SVG, z opcjonalnymi wejściami obrazowymi i stylami. To standardowa edycja wektorowa V4.1 do grafik wymagających skalowalnej geometrii i późniejszych korekt projektowych.
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.1 Vector to standardowy model SVG w rodzinie V4.1 firmy Recraft. Jego rolą jest tworzenie ilustracji, logo i liternictwa, których kształty i kolory można zmieniać i które można wykorzystywać jako materiały wektorowe. Przyjmuje opis tekstowy i może pracować z wejściami obrazowymi przez udokumentowane przebiegi producenta dotyczące stylu lub image-to-image. Uzyskany SVG jest innym rezultatem niż rastrowy obraz WebP lub PNG V4.1; tę edycję należy identyfikować przez format wektorowy, a nie etykietę rozdzielczości rastrowej.
Dokładny wariant to recraftv4_1_vector, odrębny od recraftv4_1_pro_vector i modeli Utility Vector. Przewodnik rozmiarów podaje, że wszystkie warianty wektorowe przyjmują czternaście proporcji jako stosunki szerokości do wysokości i tworzą SVG bez stałych wymiarów w pikselach. Użyj proporcji do ustalenia żądanej kompozycji, na przykład kwadratowej ikony lub szerokiego logo. Docelowy rozmiar wyświetlania można następnie wybrać w procesie projektowym zamiast ustalać go przez rastrowe wyjście 1K.
Producent pozycjonuje V4.1 Vector do ekspresyjnej typografii i czystej ilustracji. Użyteczny opis określa obiekt lub słowo, charakter geometryczny, grubość linii, sposób wypełnienia i system kolorów. Dla symbolu piekarni poproś o małą grafikę z jednym wygiętym kłosem, mocną sylwetką i ciepłymi wypełnieniami w dwóch kolorach. Wyraźnie nazwij ważne relacje przestrzenne zamiast polegać na ogólnej frazie, takiej jak nowoczesne logo. W rodzinie ikon zachowuj stabilne zasady strukturalne i zmieniaj nazwany obiekt.
Opcjonalne style własne mogą prowadzić ten sam sposób przedstawienia przez zgodne zapisane style lub obrazy referencyjne. V4.1 obsługuje preferowane kolory, żądany kolor tła, losowy seed i prompty do 10 000 znaków; przebieg generowania może zwrócić od jednego do sześciu wyników. Styl referencyjny jest opcjonalny dla tego modelu głównej linii i musi być zgodny z modelem użytym do jego stworzenia. Używaj czystych referencji z tego samego świata wizualnego; dokładne dopasowanie kolorów między referencją a wynikiem nie jest gwarantowane. Przy generowaniu w stylu 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. Każda referencja wymaga krótszego boku o długości co najmniej 256 pikseli, dłuższego boku nie większego niż 4 096 pikseli i rozdzielczości nie większej niż 16 megapikseli. Używaj albo tych referencji, albo zgodnego zapisanego stylu, a nie obu naraz. Przy generowaniu w stylu referencji dopasowanie flexible pozwala na swobodniejszą interpretację, natomiast precise ściślej podąża za sposobem przedstawienia, paletą, kompozycją i oświetleniem.
Osobna operacja image-to-image może zwrócić SVG po wybraniu wektorowego modelu V4.1. Dostarcz istniejący obraz i opisz żądaną zmianę; strength od 0 do 1 wskazuje, jak daleko wynik może odejść od źródła. Operacja obsługuje wejścia PNG, JPG, WebP lub SVG poniżej 20 MB, do 16 MP, z bokami o długości od 256 do 4096 pikseli. Ustawienia dopasowania stylu V4.1 nie są obsługiwane w tej operacji transformacji; referencja stylu dla generowania i obraz do przekształcenia pełnią różne role.
Aktualna dokumentacja V4.1 wyklucza nazwy wyselekcjonowanych stylów, negative_prompt, text_layout, artistic_level i no_text. Opisz zamierzony pozytywny układ i tekst zamiast przenosić ustawienia z V3. Sprawdzaj wygenerowane logo lub ilustrację jako SVG: liternictwo, sylwetki, obszary kolorów i małe szczegóły muszą działać w rzeczywistej kompozycji. Praktyczną zaletą jest edytowalny wektorowy punkt wyjścia zgodny z konkretnym opisem projektu, a nie założenie, że każda zwrócona grafika nie wymaga wykończenia.
W Ailoot wybierz ten dokładny identyfikator modelu w /v1/images/generations i podaj kreatywny prompt. Wymieniony profil obrazów referencyjnych Ailoot przyjmuje opcjonalną tablicę input_references zawierającą najwyżej jeden wpis image_url. 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.1-vector
recraft/recraft-v4.1-vectorStart
Recraft V4.1 Vector generuje z tekstu edytowalne logo, liternictwo i ilustracje SVG, z opcjonalnymi wejściami obrazowymi i stylami. To standardowa edycja wektorowa V4.1 do grafik wymagających skalowalnej geometrii i późniejszych korekt projektowych.
- 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.1-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, 4:3, 3:4, 16:9, 9:16, auto Warunki: | Domyślnie— |
Poleoutput_format | Typstring | WymaganieOpcjonalne | Wartości i limity svg Warunki: | Domyślnie— |
Poleinput_references | Typarray | WymaganieOpcjonalne | 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
Tekst na obraz
Parametry i cykl życia metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt |
Parametroptional | Kontraktn, aspect_ratio, output_format, input_references, 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 | 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.16 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.16 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
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "recraft/recraft-v4.1-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field."}')
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.1-vector
Aliasy ścieżek metod
Użyj ścieżek metod podanych powyżej.
Powiązane ID modeli
FAQ · Recraft: Recraft V4.1 Vector
- Jakie dane wejściowe i wyniki są dostępne?
POST /v1/images/generations·recraft/recraft-v4.1-vector:text,image→image- Jakich pól używa żądanie?
POST /v1/images/generations·recraft/recraft-v4.1-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- Jakie limity obowiązują?
POST /v1/images/generations·recraft/recraft-v4.1-vector:n.minimum:1;n.maximum:6