Recraft: Recraft V4 Vector
Recraft V4 Vector vytvára upraviteľné logá SVG, ilustrácie a grafické prvky z kreatívneho zadania. Je to štandardná vektorová edícia V4 so škálovateľnou geometriou, voliteľnými referenciami štýlu a samostatne dokumentovaným prevodom obrázka na obrázok.
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 Vector je štandardná edícia Recraft V4 vytvárajúca SVG. Je navrhnutá na grafiku závislú od jasných tvarov, farebných plôch a kompozície vrátane log, systémov ikon a ilustrácií. Výrobca opisuje V4 ako rodinu zameranú na dizajn so silnou interpretáciou promptov v rastrovej aj vektorovej práci. Výstupom tejto edície je upraviteľná grafika SVG, ktorú možno upraviť v dizajnovom postupe, nie bitmapa PNG alebo WebP.
Presný model je recraftv4_vector, oddelený od V4 Pro Vector a rastrových variantov V4. Návod výrobcu k veľkostiam povoľuje štrnásť pomerov šírky k výške pre vektorový výstup a výslovne uvádza, že SVG nemá pevné pixelové rozmery. Pomocou pomeru strán vyberte tvar grafiky a potom určte jej umiestnenie a veľkosť zobrazenia vo výslednom dizajne. Označenie 1K rastrového modelu V4 neurčuje rozlíšenie tohto variantu SVG.
Vektorové pokyny V4 odporúčajú definovať typ grafiky, logiku tvarov, farebný systém, pravidlá línií a rozloženie. Pri malej ikone pomenujte objekt a siluetu, vďaka ktorej je rozpoznateľný. Pri systéme ilustrácií zachovajte medzi zadaniami stabilné pravidlá línií a výplní. Pri ikone doručenia žiadajte obrysovú dodávku so zaoblenými rohmi, jedným veľkým tvarom balíka a striedmou paletou, vycentrovanú v štvorcovej kompozícii. Ak je zamýšľaným výsledkom plošná grafika, opíšte geometriu namiesto pridávania fotografických detailov povrchu.
Generovanie podporuje prompty s dĺžkou najviac 10,000 znakov, náhodný seed, jeden až šesť obrázkov a ovládanie preferovaných farieb a farby pozadia. Voliteľné kompatibilné štýly alebo referenčné obrázky môžu viesť vizuálny jazyk pomocou flexible alebo precise matching. Referencia nenahrádza pokyny k novému predmetu alebo rozloženiu. Použite jednu jasnú grafiku alebo súdržnú sadu referencií; presná zhoda farieb s referenciou nie je zaručená. Pri generovaní s referenčným štýlom použite jeden až desať obrázkov PNG, JPG alebo WebP s celkovou veľkosťou najviac 64 MB a veľkosťou každého súboru pod 20 MB. Každá referencia potrebuje najkratšiu stranu aspoň 256 pixelov, najdlhšiu stranu najviac 4,096 pixelov a rozlíšenie najviac 16 megapixelov. Použite buď tieto referencie, alebo kompatibilný uložený štýl, nie oboje.
Samostatný postup prevodu obrázka na obrázok môže použiť vektorový model V4 na vytvorenie SVG z existujúceho obrázka a textovej požiadavky na zmenu. Povinné nastavenie strength sa pohybuje od 0 do 1: nižšie hodnoty zostávajú bližšie k zdroju, zatiaľ čo vyššie povoľujú väčšiu zmenu. Operácia prijíma PNG, JPG, WebP alebo SVG v rámci dokumentovaných limitov veľkosti a rozlíšenia a neprijíma nastavenia štýlu V4. Toto rozlíšenie je dôležité pri výbere, či má obrázok dodávať obsah na transformáciu alebo iba vizuálne spracovanie novej grafiky. Pri prevode obrázka na obrázok dodajte PNG, JPG, WebP alebo SVG pod 20 MB, s najviac 16 megapixelmi a oboma stranami od 256 do 4,096 pixelov.
Aktuálna referencia generovania V4 vylučuje názvy kurátorovaných štýlov, negative_prompt, text_layout, artistic_level a no_text. Zamýšľanú štruktúru a znenie vložte do pozitívneho zadania. Pri výsledku s logom alebo písmom preskúmajte SVG v malých aj veľkých veľkostiach z hľadiska rozostupov, čitateľnosti a nechcených detailov. Výslovne určte typografickú hierarchiu a geometrické tvary a potom vektorovú grafiku dokončite a umiestnite podľa dizajnového 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-vector
recraft/recraft-v4-vectorÚvod
Recraft V4 Vector vytvára upraviteľné logá SVG, ilustrácie a grafické prvky z kreatívneho zadania. Je to štandardná vektorová edícia V4 so škálovateľnou geometriou, voliteľnými referenciami štýlu a samostatne dokumentovaným prevodom obrázka na obrázok.
- 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-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, 4:3, 3:4, 16:9, 9:16, auto Podmienky: | Predvolené— |
Poleoutput_format | Typstring | PožiadavkaVoliteľné | Hodnoty a limity svg Podmienky: | Predvolené— |
Poleinput_references | Typarray | PožiadavkaVoliteľné | 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
Z textu na obrázok
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt |
Parameteroptional | Špecifikácian, aspect_ratio, output_format, input_references, 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 | Poplatok |
|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Účtovacia jednotka— | 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áciavýstupný obrázok | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza výstupný obrázok | Poplatok Výstup · výstupný obrázok · Odhad iba na porovnanie $0.16 za výstupný obrázok |
| KonfiguráciaOdhadované náklady na generovanie | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Účtovacia jednotka— | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.16 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
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.
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-vector
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · Recraft: Recraft V4 Vector
- Aké vstupy a výsledky sú dostupné?
POST /v1/images/generations·recraft/recraft-v4-vector:text,image→image- Aké polia používa požiadavka?
POST /v1/images/generations·recraft/recraft-v4-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- Aké limity platia?
POST /v1/images/generations·recraft/recraft-v4-vector:n.minimum:1;n.maximum:6