Recraft: Recraft V4 Vector
A Recraft V4 Vector kreatív leírásból szerkeszthető SVG-logókat, illusztrációkat és grafikai elemeket készít. A V4 szabványos vektoros kiadása skálázható geometriával, opcionális stílusreferenciákkal és külön dokumentált képből képet készítő munkafolyamattal.
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 Vector a Recraft V4 szabványos, SVG-t készítő kiadása. Olyan grafikákhoz készült, amelyek világos alakzatokra, színterületekre és kompozícióra épülnek, beleértve a logókat, ikonrendszereket és illusztrációkat. A gyártó a V4-et tervezésközpontú családként írja le, erős promptértelmezéssel raszteres és vektoros munkában egyaránt. Ennek a kiadásnak az eredménye tervezési munkafolyamatban módosítható, szerkeszthető SVG-grafika, nem PNG- vagy WebP-bitkép.
A pontos modell recraftv4_vector, külön a V4 Pro Vector modelltől és a raszteres V4 változatoktól. A gyártó méretútmutatója tizennégy szélesség–magasság arányt enged vektoros kimenethez, és kifejezetten kimondja, hogy az SVG-nek nincs rögzített pixelmérete. Az elem alakját képaránnyal válaszd ki, majd a végső tervben határozd meg az elhelyezését és megjelenítési méretét. A raszteres V4 modell 1K jelölése nem határozza meg ennek az SVG-változatnak a felbontását.
A V4 vektoros útmutatója a grafikatípus, a formalogika, a színrendszer, a vonalvezetési szabályok és az elrendezés meghatározását javasolja. Kis ikonhoz nevezd meg az objektumot és az azt felismerhetővé tevő sziluettet. Illusztrációs rendszerben a vonal- és kitöltési szabályok legyenek állandók a feladatleírások között. Kiszállítási ikonhoz kérj körvonalas furgont lekerekített sarkokkal, egy nagy csomagformával és visszafogott palettával, négyzetes kompozíció közepén. Ha síkbeli grafika a kívánt eredmény, fényképes felületi részletek hozzáadása helyett a geometriát írd le.
A generálás legfeljebb 10,000 karakteres promptokat, véletlen magot, egy–hat képet és előnyben részesített színre, illetve háttérszínre vonatkozó vezérlőket támogat. Opcionális kompatibilis stílusok vagy referenciaképek flexible vagy precise illesztéssel irányíthatják a vizuális nyelvet. A referencia nem helyettesíti az új témáról vagy elrendezésről szóló utasításokat. Használj egyetlen tiszta elemet vagy összefüggő referenciakészletet; a referencia pontos színeinek egyezése nem garantált. Referenciastílus alapján történő generáláshoz használj egy–tíz PNG-, JPG- vagy WebP-képet, összesen legfeljebb 64 MB méretben és egyenként 20 MB alatt. Minden referencia legrövidebb oldala legalább 256 pixel, leghosszabb oldala legfeljebb 4,096 pixel, felbontása pedig legfeljebb 16 megapixel legyen. Ezeket a referenciákat vagy egy kompatibilis mentett stílust használd, ne mindkettőt.
Egy külön képből képet készítő munkafolyamat V4 vektoros modellel SVG-t állíthat elő meglévő képből és szöveges módosításkérésből. A kötelező strength beállítás 0 és 1 közötti: az alacsonyabb értékek közelebb maradnak a forráshoz, a magasabbak nagyobb változtatást engednek. A művelet PNG, JPG, WebP vagy SVG formátumot fogad el a dokumentált méret- és felbontáskorlátokon belül, és nem fogadja el a V4 stílusvezérlőit. Ez a különbség fontos annak eldöntésekor, hogy a kép az átalakítandó tartalmat adja-e, vagy csak egy új elem vizuális megjelenítését. Képből képet készítő művelethez 20 MB alatti, legfeljebb 16 megapixeles PNG-, JPG-, WebP- vagy SVG-fájlt adj meg, mindkét oldalán 256–4,096 pixeles mérettel.
Az aktuális V4 generálási referencia kizárja a válogatott stílusneveket, a negative_prompt, text_layout, artistic_level és no_text vezérlőket. A kívánt szerkezetet és szöveget a pozitív feladatleírásba írd. Logó- vagy felirateredménynél kis és nagy méretben is ellenőrizd az SVG térközeit, olvashatóságát és nem kívánt részleteit. Kifejezetten határozd meg a tipográfiai hierarchiát és a geometriai alakzatokat, majd a tervezési leírás szerint véglegesítsd és helyezd el a vektoros elemet.
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-vector
recraft/recraft-v4-vectorKezdő lépések
A Recraft V4 Vector kreatív leírásból szerkeszthető SVG-logókat, illusztrációkat és grafikai elemeket készít. A V4 szabványos vektoros kiadása skálázható geometriával, opcionális stílusreferenciákkal és külön dokumentált képből képet készítő munkafolyamattal.
- 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-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, 4:3, 3:4, 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ényOpcionális | É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
Szövegből kép
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt |
Paraméteroptional | Szerződésn, aspect_ratio, output_format, input_references, 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 | Díj |
|---|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | Elszámolási egység— | 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áskimeneti kép | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egységkimeneti képenként | Díj Kimenet · kimeneti kép · Becslés, csak összehasonlításra $0.16 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— | Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $0.16 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
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "recraft/recraft-v4-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.
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-vector
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · Recraft: Recraft V4 Vector
- Milyen bemenetek és eredmények érhetők el?
POST /v1/images/generations·recraft/recraft-v4-vector:text,image→image- Mely mezőket használja a kérés?
POST /v1/images/generations·recraft/recraft-v4-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- Milyen korlátok érvényesek?
POST /v1/images/generations·recraft/recraft-v4-vector:n.minimum:1;n.maximum:6