Recraft: Recraft V4 Styles Vector
Recraft V4 Styles Vector vytváří upravitelnou grafiku SVG z textového zadání a povinného vizuálního stylu. Hodí se pro sladěné ikony, loga a ilustrace, jejichž práce s čarou, paleta a vykreslení mají sledovat stejnou referenční podobu.
O modelu
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
Recraft V4 Styles Vector je model vytvářející SVG ve specializované řadě Recraft pro generování s konzistentním stylem. Převádí textové zadání na novou vektorovou grafiku a dodaným referenčním stylem řídí vykreslení, barevnou logiku a celkový vzhled. Hodí se pro sladěné sady ikon, značkové ilustrace a grafické systémy, kde se mění objekty, ale vizuální zpracování má zůstat rozpoznatelné. Edice Vector vrací upravitelnou grafiku místo rastrové fotografie.
Výrobce tuto edici označuje recraftv4_styles_vector. Jejím výstupem je vždy SVG; rastrová nastavení image_format jej nepřevádějí do WebP ani PNG. Každá vektorová varianta přijímá čtrnáct zdokumentovaných poměrů stran jako poměry šířky k výšce, nikoli přesné pixelové rozměry. SVG nemá pevné rozlišení v pixelech, takže výstup 1K standardního rastrového modelu neurčuje rozměry této edice. Při přípravě zadání zvolte požadovaný tvar grafického prvku a zamýšlené zobrazení v malé nebo velké velikosti.
Pro každé generování je povinný styl. Použijte jeden až deset referenčních obrázků PNG, JPG či WebP nebo místo nových referencí kompatibilní uložený styl. Výrobce odmítá požadavek kombinující identifikátor uloženého stylu s referenčními stylovými obrázky. Zdokumentovaný limit referencí je celkem 64 MB a méně než 20 MB na soubor. Jedna jasná ikona nebo ilustrace může určit zpracování; více referencí je užitečných, pokud jejich tloušťka čar, rohy, logika výplní a paleta již patří do stejného vizuálního systému. Každá reference musí mít nejkratší stranu alespoň 256 pixelů, nejdelší stranu nejvýše 4,096 pixelů a celkové rozlišení nejvýše 16 megapixelů.
Výchozí flexible matching interpretuje referenci volněji, zatímco precise matching těsněji sleduje její vykreslení, barvu, kompozici a osvětlení. U vektorového systému definujte promptem typ grafiky, siluetu, počet objektů a rozvržení. U sady navigačních ikon použijte silné zaoblené obrysy, jeden středově umístěný objekt na obrázek a dvoubarevnou paletu. Ponechte stejný referenční styl a v každém zadání změňte pojmenovaný objekt, místo abyste pro rozmanitost míchali nesouvisející reference.
Dokumentace generování dovoluje prompty až do 10,000 znaků, jeden až šest výstupů, náhodný seed, preferované barvy a požadovanou barvu pozadí. Negativní prompty, kurátorované názvy stylů a starší parametr text_layout nejsou podporovány. Tato edice Styles také neposkytuje image-to-image ani inpainting: obrazová reference dodává vizuální jazyk, nikoli oblast k vymazání nebo existující grafiku k nezměněnému zachování. Strukturální pokyny v pozitivním zadání mají popisovat zamýšlený hotový výstup.
SVG prozkoumejte v zamýšlené velikosti použití, zejména pokud návrh obsahuje nápisy, úzké mezery nebo drobné detaily. Shoda barev s referencí není zaručena a nesouvisející reference mohou soupeřit. Pokud se sada ikon začne opakovat, změňte v promptu objekt, pózu nebo uspořádání a zachovejte soudržný styl. Užitečným výstupem je konzistentní vektorový prvek, který lze v designovém postupu přetvarovat a přebarvit a jehož geometrie a čitelnost jsou vyhodnoceny podle zadání.
Prostřednictvím Ailoot vyberte toto přesné ID modelu v /v1/images/generations a zadejte kreativní prompt. Uchovejte každou vrácenou položku data, ať odpověď obsahuje URL, nebo zakódovaný obrazový obsah, a uložte skutečné bajty s vráceným typem obsahu. S výstupem uchovejte usage a případné mediální task_id a poté v zamýšleném návrhu zkontrolujte tvary, nápisy a barevné oblasti.
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áří upravitelnou grafiku SVG z textového zadání a povinného vizuálního stylu. Hodí se pro sladěné ikony, loga a ilustrace, jejichž práce s čarou, paleta a vykreslení mají sledovat stejnou referenční podobu.
- Přijímané vstupy
- Text · Obrázky
- Výsledky
- Obrázky
Dostupné v Ailoot · vstupy a metody
Ailoot Ultra · Images POST /v1/images/generations
- Vstup
text,image- Výstup
image- Výstupní formát
- Soubor obrázku
| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity recraft/recraft-v4-styles-vector Podmínky: Použijte přesně tento směrovací selektor Ailoot. | Výchozí— |
Poleprompt | Typstring | PožadavekPovinné | Hodnoty a limity Podmínky: | Výchozí— |
Polen | Typinteger | PožadavekVolitelné | Hodnoty a limity Minimum: 1 Maximum: 6 Podmínky: | Výchozí— |
Poleaspect_ratio | Typstring | PožadavekVolitelné | 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 Podmínky: | Výchozí— |
Poleoutput_format | Typstring | PožadavekVolitelné | Hodnoty a limity svg Podmínky: | Výchozí— |
Poleinput_references | Typarray | PožadavekPovinné | Hodnoty a limity Podmínky: | Výchozí— |
Polequality | Typstring | PožadavekVolitelné | Hodnoty a limity auto, low, medium, high, xhigh, max Podmínky: | Výchozí— |
Kombinace vstupních materiálů
reference_guided_image
Parametry a životní cyklus metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt, input_references |
Parametroptional | Kontraktn, aspect_ratio, output_format, quality |
Parametrmaterial_types | Kontrakttext, image |
Parametrconditions | KontraktPoužijte přesně tento směrovací selektor Ailoot., Parametr quality je běžný dokumentovaný parametr; poskytovatelé bez možnosti nastavení kvality jej ignorují. Zlepšení kvality u jednotlivých modelů není přislíbeno. |
Životní cyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Skutečně vrácené task_id nebo vybraný záznam knihovny; operation_id je samostatný identifikátor.
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarify
Jak se vypočítá konečný poplatek
Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
- Rychlý režim
- Neuvedeno Při výběru rychlého režimu
- Režim flex
- Neuvedeno Při výběru režimu flex
- Maximální intenzita uvažování
- Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)
Odhadované sazby pro srovnání
Ceny podle konfigurace
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Tabulka sazeb | Předpokládané množství | Účtovací jednotka | Podmínky účtování | Poplatek |
|---|---|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Předpokládané množství— | Účtovací jednotka— | Podmínky účtování— | Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů |
| KonfiguraceVstupní reference | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza požadavek | Podmínky účtováníVytvoření stylu při generování se stylovými referencemi; jednou za požadavek, navíc k ceně výstupního obrázku. | Poplatek Vstup · Vstupní reference · Odhad pouze pro srovnání $0.01 za požadavek Pouze orientační odhad; konečná účtovaná částka vychází ze zaznamenané původní faktury. |
| Konfiguracevýstupní obrázek | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza výstupní obrázek | Podmínky účtování— | Poplatek Výstup · výstupní obrázek · Odhad pouze pro srovnání $0.1 za výstupní obrázek |
| KonfiguraceOdhadovaná cena generování | Tabulka sazeb— | Předpokládané množstvíodhad pro jedno generování | Účtovací jednotka— | Podmínky účtování— | Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.1 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování. |
Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
Příklady požadavků
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.
Přijímání a ukládání výsledků
Ailoot Ultra · Images
Stáhněte každý vrácený obrázek nebo uložte jeho obsah Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Uchovejte všechny dokončené výsledky
Uložte každý dokončený obrázek; stáhněte obsah každé vrácené URL nebo dekódujte obsah Base64.
Uchovejte celou odpověď a hlavičky, původní identifikátory, každý skutečný výstup a všechna pole využití a účtování. Uložte každý jedinečný soubor spravovaný službou a zachovejte každou roli, která na něj odkazuje.
Pokud je nutné ověřit původní odpověď
Zachovejte původní X-Client-Request-ID, odpověď a hlavičky. Neznámý výsledek ani výsledek result_pending_check neopravňují k druhému vytvoření.
Pole odpovědi
| Pole | Typ |
|---|---|
Poledata[].url | Typstring |
Poledata[].b64_json | Typstring |
Poleusage | Typobject |
Chyby a další kroky
| Odpověď | Podmínka | Další krok |
|---|---|---|
Odpověď400 · invalid_request_error | PodmínkaPovinné pole, selektor modelu, typ nebo podoba vstupu jsou neplatné. | Další krokPřed přípravou samostatného požadavku si prohlédněte vrácené podrobnosti validace. |
Odpověď | PodmínkaPůvodní požadavek nebo výsledek je neznámý nebo vyžaduje kontrolu. | Další krokZachovejte původní identifikátory a hlavičky; čtěte pouze podporované záznamy o stavu nebo záznamy knihovny. Požadavek na vytvoření znovu neodesílejte. |
Aliasy
Aliasy modelu
Ailoot Ultra recraft/recraft-v4-styles-vector
Aliasy cest metod
Použijte cesty metod uvedené výše.
Související ID modelů
FAQ · Recraft: Recraft V4 Styles Vector
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:text,image→image- Jaká pole požadavek používá?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- Jaké limity platí?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:n.minimum:1;n.maximum:6