Recraft: Recraft V4 Styles Vector
A Recraft V4 Styles Vector szöveges leírásból és kötelező vizuális stílusból szerkeszthető SVG-grafikákat készít. Összehangolt ikonokhoz, logókhoz és illusztrációkhoz illik, amelyek vonalvezetésének, palettájának és megjelenítésének ugyanazt a referenciairányt kell követnie.
A modellről
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A Recraft V4 Styles Vector a Recraft különálló, stílustartó generálási vonalának SVG-t készítő modellje. Szöveges leírásból új vektorgrafikát hoz létre, miközben a megadott referenciastílus irányítja a megjelenítést, a színlogikát és az összhatást. Hasznos összehangolt ikonkészletekhez, márkaillusztrációkhoz és grafikai rendszerekhez, amelyekben változik a téma, de a vizuális megjelenítésnek felismerhetőnek kell maradnia. A Vector kiadás szerkeszthető grafikát ad vissza raszteres fénykép helyett.
A gyártó ezt a kiadást recraftv4_styles_vector néven azonosítja. Kimenete mindig SVG; a raszteres image_format beállítások nem alakítják WebP- vagy PNG-formátumra. Minden vektoros változat a tizennégy dokumentált képarányt fogadja el szélesség–magasság arányként, pontos pixelméretek helyett. Az SVG-nek nincs rögzített pixelfelbontása, így a szabványos raszteres modell 1K kimenete nem ennek a kiadásnak az architekturális mérete. A feladatleírás előkészítésekor válaszd ki az elem kívánt alakját és tervezett kis vagy nagy méretű megjelenítését.
Minden generáláshoz stílus szükséges. Használj egy–tíz PNG-, JPG- vagy WebP-referenciát, vagy új referenciák helyett egy kompatibilis mentett stílust. A gyártó elutasítja az olyan kérést, amely mentett stílusazonosítót és stílusreferencia-képeket kombinál. A dokumentált referenciakeret összesen 64 MB, fájlonként pedig 20 MB alatti méret. Egyetlen tiszta ikon vagy illusztráció is meghatározhatja a megjelenítést; több referencia akkor hasznos, ha vonalvastagságuk, sarkaik, kitöltési logikájuk és palettájuk már ugyanahhoz a vizuális rendszerhez tartozik. Minden referencia legrövidebb oldala legalább 256 pixel, leghosszabb oldala legfeljebb 4,096 pixel, teljes felbontása pedig legfeljebb 16 megapixel legyen.
Az alapértelmezett flexible illesztés szabadabban értelmezi a referenciát, míg a precise illesztés szorosabban követi annak megjelenítését, színeit, kompozícióját és megvilágítását. Vektoros rendszerhez a promptban határozd meg a grafika típusát, sziluettjét, az objektumok számát és az elrendezést. Navigációs ikonkészlethez használj vastag, lekerekített körvonalakat, képenként egy középre helyezett objektumot és kétszínű palettát. Tartsd meg ugyanazt a referenciastílust, és minden leírásban a megnevezett objektumot változtasd, ahelyett, hogy változatosságért egymástól független referenciákat kevernél.
A generálási referencia legfeljebb 10,000 karakteres promptokat, egy–hat kimenetet, véletlen magot, előnyben részesített színeket és kívánt háttérszínt enged. A negatív promptok, a válogatott stílusnevek és a korábbi text_layout vezérlő nem támogatottak. Ez a Styles kiadás képből képet készítő munkafolyamatot és inpaintinget sem biztosít: egy képreferencia vizuális nyelvet ad, nem törlendő területet vagy változatlanul megőrzendő meglévő grafikát. A pozitív feladatleírás szerkezeti utasításai a kívánt kész elemet írják le.
Az SVG-t a tényleges használati méretben vizsgáld meg, különösen, ha a terv feliratokat, szűk hézagokat vagy apró részleteket tartalmaz. A referenciaszínek egyezése nem garantált, és az egymástól független referenciák versenghetnek egymással. Ismétlődővé váló ikonkészletnél a promptban az objektumot, pózt vagy elrendezést változtasd, az összefüggő stílus megőrzésével. A hasznos eredmény egységes vektoros elem, amely egy tervezési munkafolyamatban átformálható és újraszínezhető, geometriáját és olvashatóságát pedig a feladatleíráshoz képest értékelik.
Az Ailoot használatakor válaszd ezt a pontos modellazonosítót a /v1/images/generations végponton, és add meg a kreatív promptot. Őrizz meg minden visszaadott data elemet, akár URL-t, akár kódolt képtartalmat tartalmaz a válasz, és mentsd el a tényleges bájtokat a visszaadott tartalomtípusukkal együtt. Tartsd a usage adatokat és minden médiához tartozó task_id értéket a fájl mellett, majd ellenőrizd az alakzatokat, feliratokat és színterületeket a tervezett kompozícióban.
Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-styles-vector
recraft/recraft-v4-styles-vector
recraft/recraft-v4-styles-vectorKezdő lépések
A Recraft V4 Styles Vector szöveges leírásból és kötelező vizuális stílusból szerkeszthető SVG-grafikákat készít. Összehangolt ikonokhoz, logókhoz és illusztrációkhoz illik, amelyek vonalvezetésének, palettájának és megjelenítésének ugyanazt a referenciairányt kell követnie.
- Elfogadott bemenetek
- Szöveg · Képek
- Eredmények
- Képek
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Images POST /v1/images/generations
- Bemenet
text,image- Kimenet
image- Kimeneti formátum
- Képfájl
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok recraft/recraft-v4-styles-vector Feltételek: Pontosan ezt az Ailoot-útválasztási azonosítót használja. | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok Feltételek: | Alapértelmezett— |
Mezőn | Típusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: 1 Maximum: 6 Feltételek: | Alapértelmezett— |
Mezőaspect_ratio | Típusstring | KövetelményOpcionális | Értékek és korlátok 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto Feltételek: | Alapértelmezett— |
Mezőoutput_format | Típusstring | KövetelményOpcionális | Értékek és korlátok svg Feltételek: | Alapértelmezett— |
Mezőinput_references | Típusarray | KövetelményKötelező | Értékek és korlátok Feltételek: | Alapértelmezett— |
Mezőquality | Típusstring | KövetelményOpcionális | Értékek és korlátok auto, low, medium, high, xhigh, max Feltételek: | Alapértelmezett— |
Bemeneti anyagok kombinációi
reference_guided_image
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt, input_references |
Paraméteroptional | Szerződésn, aspect_ratio, output_format, quality |
Paramétermaterial_types | Szerződéstext, image |
Paraméterconditions | SzerződésPontosan ezt az Ailoot-útválasztási azonosítót használja., A quality egy általános, dokumentált vezérlőparaméter; a minőségi beállítást nem kínáló szolgáltatók figyelmen kívül hagyják. Modellenkénti minőségjavulást nem ígérünk. |
Életciklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · A ténylegesen visszaadott task_id vagy a kiválasztott médiatárbejegyzés; az operation_id külön azonosító.
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Díjcsomagok
A végső díj számítása
A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
- Gyors mód
- Nincs megadva Ha a gyors mód van kiválasztva
- Flex mód
- Nincs megadva Ha a flex mód van kiválasztva
- Maximális gondolkodási ráfordítás
- Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik
Becsült díjak összehasonlításhoz
Árak beállításonként
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Előre jelzett mennyiség | Elszámolási egység | Elszámolási feltételek | Díj |
|---|---|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | Elszámolási egység— | Elszámolási feltételek— | Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token |
| BeállításBemeneti referenciaanyag | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egységkérésenként | Elszámolási feltételekStílus létrehozása stílusreferenciákkal végzett generáláskor; kérésenként egyszer számítandó fel, a kimeneti kép árán felül. | Díj Bemenet · Bemeneti referencia · Becslés, csak összehasonlításra $0.01 kérésenként Csak tájékoztató becslés; a végleges díj a rögzített eredeti számlán alapul. |
| Beállításkimeneti kép | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egységkimeneti képenként | Elszámolási feltételek— | Díj Kimenet · kimeneti kép · Becslés, csak összehasonlításra $0.1 kimeneti képenként |
| BeállításA generálás becsült költsége | Díjtáblázat— | Előre jelzett mennyiségbecslés egy generálásra | Elszámolási egység— | Elszámolási feltételek— | Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $0.1 becslés a generálás előtt Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra. |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
Példakérések
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.
Eredmények fogadása és mentése
Ailoot Ultra · Images
Töltsön le minden visszaadott képet, vagy mentse a Base64-tartalmat
GET /v1/media/tasks/{task_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Őrizzen meg minden elkészült eredményt
Mentsen minden elkészült képet; töltse le az összes visszaadott URL tartalmát, vagy dekódolja a Base64-tartalmat.
Őrizze meg a teljes választ és fejléceit, az eredeti azonosítókat, az összes tényleges kimenetet és minden felhasználási, illetve elszámolási mezőt. Mentsen el minden egyedi saját médiaállományt, és őrizzen meg minden rá mutató szerepet.
Ha az eredeti választ ellenőrizni kell
Őrizze meg az eredeti X-Client-Request-ID értéket, választ és fejléceket. Az ismeretlen vagy result_pending_check eredmény nem jogosít második létrehozásra.
Válaszmezők
| Mező | Típus |
|---|---|
Meződata[].url | Típusstring |
Meződata[].b64_json | Típusstring |
Mezőusage | Típusobject |
Hibák és következő lépések
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételEgy kötelező mező, modellválasztó, típus vagy bemeneti ábrázolási forma érvénytelen. | Következő lépésKülön kérés előkészítése előtt vizsgálja meg a visszaadott érvényesítési részleteket. |
Válasz | FeltételAz eredeti kérés vagy eredmény ismeretlen, vagy ellenőrzést igényel. | Következő lépésŐrizze meg az eredeti azonosítókat és fejléceket; csak a támogatott állapot- és médiatárbejegyzéseket olvassa le. Ne küldje el újra a létrehozási kérelmet. |
Álnevek
Modell álnevei
Ailoot Ultra recraft/recraft-v4-styles-vector
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · Recraft: Recraft V4 Styles Vector
- Milyen bemenetek és eredmények érhetők el?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:text,image→image- Mely mezőket használja a kérés?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- Milyen korlátok érvényesek?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:n.minimum:1;n.maximum:6