Recraft: Recraft V4 Styles Vector
Recraft V4 Styles Vector vytvára upraviteľnú grafiku SVG z textového zadania a povinného vizuálneho štýlu. Hodí sa na zladené ikony, logá a ilustrácie, ktorých línie, paleta a vykreslenie majú sledovať rovnaké referenčné smerovanie.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Recraft V4 Styles Vector je model vytvárajúci SVG v samostatnej línii generovania Recraft s konzistentným štýlom. Prevádza textové zadanie na novú vektorovú grafiku a pritom používa dodaný referenčný štýl na vedenie vykreslenia, farebnej logiky a celkového vzhľadu. Je užitočný pre zladené sady ikon, značkové ilustrácie a grafické systémy, v ktorých sa predmety menia, ale vizuálne spracovanie má zostať rozpoznateľné. Edícia Vector vracia upraviteľnú grafiku namiesto rastrovej fotografie.
Výrobca túto edíciu označuje ako recraftv4_styles_vector. Jej výstupom je vždy SVG; rastrové nastavenia image_format ho neprevádzajú na WebP alebo PNG. Každý vektorový variant prijíma štrnásť dokumentovaných pomerov strán ako pomery šírky k výške namiesto presných pixelových rozmerov. SVG nemá pevné pixelové rozlíšenie, takže výstup 1K štandardného rastrového modelu nie je architektonickou veľkosťou tejto edície. Pri príprave zadania vyberte požadovaný tvar grafiky a zamýšľané malé alebo veľké zobrazenie.
Štýl je povinný pri každom generovaní. Použite jednu až desať referencií PNG, JPG alebo WebP alebo namiesto nových referencií kompatibilný uložený štýl. Výrobca odmieta požiadavku, ktorá kombinuje identifikátor uloženého štýlu s referenčnými obrázkami štýlu. Dokumentovaný limit referencií je spolu 64 MB a menej než 20 MB na súbor. Jedna jasná ikona alebo ilustrácia môže určiť spracovanie; viac referencií je užitočných, keď ich hrúbka čiar, rohy, logika výplní a paleta už patria do rovnakého vizuálneho systému. Každá referencia musí mať najkratšiu stranu aspoň 256 pixelov, najdlhšiu stranu najviac 4,096 pixelov a celkové rozlíšenie najviac 16 megapixelov.
Flexible matching je predvolené a číta referenciu voľnejšie, zatiaľ čo precise matching tesnejšie sleduje jej vykreslenie, farby, kompozíciu a osvetlenie. Pri vektorovom systéme použite prompt na definovanie typu grafiky, siluety, počtu objektov a rozloženia. Pri sade navigačných ikon použite výrazné zaoblené obrysy, jeden vycentrovaný objekt na obrázok a dvojfarebnú paletu. Ponechajte rovnaký referenčný štýl a v každom zadaní meňte pomenovaný objekt namiesto miešania nesúvisiacich referencií na získanie rozmanitosti.
Referencia generovania povoľuje prompty s dĺžkou najviac 10,000 znakov, jeden až šesť výstupov, náhodný seed, preferované farby a požadovanú farbu pozadia. Negatívne prompty, názvy kurátorovaných štýlov a staršie nastavenie text_layout nie sú podporované. Táto edícia Styles neposkytuje ani prevod obrázka na obrázok či inpainting: obrazová referencia dodáva vizuálny jazyk, nie oblasť na vymazanie alebo existujúcu grafiku na zachovanie bez zmeny. Štrukturálne pokyny v pozitívnom zadaní majú opisovať zamýšľanú hotovú grafiku.
SVG preskúmajte vo veľkosti, v akej sa bude používať, najmä keď dizajn obsahuje písmo, úzke medzery alebo drobné detaily. Zhoda farieb s referenciou nie je zaručená a nesúvisiace referencie môžu súperiť. Pri sade ikon, ktorá sa začne opakovať, zmeňte v prompte objekt, pózu alebo usporiadanie a zároveň zachovajte súdržný štýl. Užitočným výstupom je konzistentná vektorová grafika, ktorú možno v dizajnovom postupe pretvarovať a prefarbiť, pričom jej geometria a čitateľnosť sa posudzujú podľa zadania.
Prostredníctvom Ailoot vyberte toto presné ID modelu v /v1/images/generations a zadajte kreatívny prompt. Uchovajte každú vrátenú položku data, či odpoveď obsahuje URL alebo zakódovaný obrazový obsah, a uložte skutočné bajty s vráteným typom obsahu. S výstupom uchovajte usage a prípadné mediálne task_id a potom v zamýšľanom dizajne posúďte jeho tvary, písmo a farebné plochy.
Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-styles-vector
recraft/recraft-v4-styles-vector
recraft/recraft-v4-styles-vectorÚvod
Recraft V4 Styles Vector vytvára upraviteľnú grafiku SVG z textového zadania a povinného vizuálneho štýlu. Hodí sa na zladené ikony, logá a ilustrácie, ktorých línie, paleta a vykreslenie majú sledovať rovnaké referenčné smerovanie.
- Povolené vstupy
- Text · Obrázky
- Výsledky
- Obrázky
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Images POST /v1/images/generations
- Vstup
text,image- Výstup
image- Výstupný formát
- Súbor obrázka
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity recraft/recraft-v4-styles-vector Podmienky: Použite presne tento smerovací selektor Ailoot. | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Podmienky: | Predvolené— |
Polen | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 1 Maximum: 6 Podmienky: | Predvolené— |
Poleaspect_ratio | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto Podmienky: | Predvolené— |
Poleoutput_format | Typstring | PožiadavkaVoliteľné | Hodnoty a limity svg Podmienky: | Predvolené— |
Poleinput_references | Typarray | PožiadavkaPovinné | Hodnoty a limity Podmienky: | Predvolené— |
Polequality | Typstring | PožiadavkaVoliteľné | Hodnoty a limity auto, low, medium, high, xhigh, max Podmienky: | Predvolené— |
Kombinácie vstupných podkladov
reference_guided_image
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt, input_references |
Parameteroptional | Špecifikácian, aspect_ratio, output_format, quality |
Parametermaterial_types | Špecifikáciatext, image |
Parameterconditions | ŠpecifikáciaPoužite presne tento smerovací selektor Ailoot., quality je bežný zdokumentovaný parameter; poskytovatelia bez možnosti nastavenia kvality ho ignorujú. Zlepšenie kvality pri jednotlivých modeloch nie je prisľúbené. |
Životný cyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Skutočne vrátené task_id alebo vybraný záznam knižnice; operation_id je samostatný identifikátor.
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Cenník
Ako sa vypočíta konečný poplatok
Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Odhadované sadzby na porovnanie
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Odhadované množstvo | Účtovacia jednotka | Podmienky účtovania | Poplatok |
|---|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Účtovacia jednotka— | Podmienky účtovania— | Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov |
| KonfiguráciaVstupná referencia | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza požiadavku | Podmienky účtovaniaVytvorenie štýlu pri generovaní s referenciami štýlu; raz za požiadavku, navyše k cene výstupného obrázka. | Poplatok Vstup · Vstupná referencia · Odhad iba na porovnanie $0.01 za požiadavku Iba orientačný odhad; konečná účtovaná suma vychádza zo zaznamenanej pôvodnej faktúry. |
| Konfiguráciavýstupný obrázok | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza výstupný obrázok | Podmienky účtovania— | Poplatok Výstup · výstupný obrázok · Odhad iba na porovnanie $0.1 za výstupný obrázok |
| KonfiguráciaOdhadované náklady na generovanie | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Účtovacia jednotka— | Podmienky účtovania— | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.1 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie. |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Príklady požiadaviek
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.
Prijať a uložiť výsledky
Ailoot Ultra · Images
Stiahnite každý vrátený obrázok alebo uložte jeho obsah Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Uchovať všetky dokončené výsledky
Uložte každý dokončený obrázok; stiahnite obsah z každej vrátenej URL alebo dekódujte jeho obsah Base64.
Zachovajte celú odpoveď a hlavičky, pôvodné identifikátory, každý skutočný výstup a všetky polia spotreby a účtovania. Uložte každý jedinečný súbor vo vašom vlastníctve a zachovajte každú rolu, ktorá naň odkazuje.
Ak treba overiť pôvodnú odpoveď
Zachovajte pôvodné X-Client-Request-ID, odpoveď a hlavičky. Neznámy výsledok ani výsledok result_pending_check neoprávňujú na druhé vytvorenie.
Polia odpovede
| Pole | Typ |
|---|---|
Poledata[].url | Typstring |
Poledata[].b64_json | Typstring |
Poleusage | Typobject |
Chyby a ďalšie kroky
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaPovinné pole, selektor modelu, typ alebo podoba vstupu sú neplatné. | Ďalší krokPred prípravou samostatnej požiadavky si pozrite vrátené podrobnosti validácie. |
Odpoveď | PodmienkaPôvodná požiadavka alebo výsledok je neznámy alebo vyžaduje kontrolu. | Ďalší krokZachovajte pôvodné identifikátory a hlavičky; čítajte iba podporované záznamy o stave alebo záznamy knižnice. Požiadavku na vytvorenie znova neodosielajte. |
Aliasy
Aliasy modelov
Ailoot Ultra recraft/recraft-v4-styles-vector
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · Recraft: Recraft V4 Styles Vector
- Aké vstupy a výsledky sú dostupné?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:text,image→image- Aké polia používa požiadavka?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- Aké limity platia?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:n.minimum:1;n.maximum:6