Recraft: Recraft V4 Styles Vector

Recraft V4 Styles Vector мәтіндік тапсырма мен міндетті көрнекі стильден өңделетін SVG графикасын жасайды. Ол сызық тәсілі, палитрасы және бейнелеуі бір референс бағытына еруі тиіс үйлесімді белгішелерге, логотиптерге және иллюстрацияларға жарайды.

Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-styles-vector

Модель туралы

Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.

Recraft V4 Styles Vector — Recraft компаниясының арнайы стиль бірізділігін сақтайтын генерация тармағындағы SVG жасайтын модель. Ол берілген референс стилімен бейнелеуді, түс қисынын және жалпы көріністі бағыттай отырып, мәтіндік тапсырманы жаңа вектор туындысына айналдырады. Ол нысандар өзгерсе де, көркемдік тәсіл танылатын күйде қалуы тиіс үйлесімді белгіше жиынтықтарына, бренд иллюстрациясына және графикалық жүйелерге пайдалы. Vector нұсқасы растрлық фотосурет емес, өңделетін графика қайтарады.

Өндіруші бұл нұсқаны recraftv4_styles_vector деп белгілейді. Оның шығысы әрдайым SVG; растрлық image_format баптаулары оны WebP не PNG пішіміне айналдырмайды. Әр векторлық нұсқа нақты пиксель өлшемдерінің орнына құжатталған он төрт қатынасты еннің биіктікке қатынасы түрінде қабылдайды. SVG-де тұрақты пиксельдік ажыратымдылық жоқ, сондықтан стандартты растр моделінің 1K шығысы осы нұсқаның архитектуралық өлшемі емес. Тапсырманы дайындағанда файлдың қажетті пішінін және шағын не үлкен көрсетілімде қолданылуын таңдаңыз.

Әр генерацияға стиль қажет. Бірден онға дейін PNG, JPG не WebP референсін немесе жаңа референстердің орнына үйлесімді сақталған стильді қолданыңыз. Өндіруші сақталған стиль идентификаторын стиль референсі суреттерімен бірге беретін сұрауды қабылдамайды. Құжатталған референс көлемі жиынтығында 64 MB, әр файлға 20 MB-тан аз. Бір анық белгіше не иллюстрация көркемдік тәсілді анықтай алады; бірнеше референс олардың сызық қалыңдығы, бұрыштары, толтыру қисыны және палитрасы бір көрнекі жүйеге тиесілі болғанда пайдалы. Әр референстің қысқа жағы кемінде 256 пиксель, ұзын жағы ең көбі 4,096 пиксель және жалпы ажыратымдылығы ең көбі 16 мегапиксель болуы тиіс.

flexible сәйкестендіру әдепкі қолданылады және референсті еркіндеу түсіндіреді, ал precise сәйкестендіру оның бейнелеуіне, түсіне, композициясына және жарығына жақынырақ ереді. Векторлық жүйе үшін prompt арқылы графика түрін, сұлбаны, нысан санын және орналасуды анықтаңыз. Навигация белгішелері жиынтығына жуан жұмыр контурлар, әр суретте ортасында бір нысан және екі түсті палитра қолданыңыз. Әртүрлілік алу үшін байланыссыз референстерді араластырмай, бір референс стилін сақтап, әр тапсырмада аталған нысанды өзгертіңіз.

Генерация анықтамалығы 10,000 таңбаға дейінгі prompt-тарды, бірден алтыға дейін нәтижені, кездейсоқ seed, қалаулы түстерді және қажетті фон түсін қолдайды. Теріс prompt-тар, дайын стиль атаулары және ескі text_layout баптауы қолдау таппайды. Бұл Styles нұсқасы image-to-image немесе inpainting те бермейді: сурет референсі өшірілетін аймақты не өзгеріссіз сақталатын бар графиканы емес, көрнекі тілді береді. Позитивті тапсырмадағы құрылымдық нұсқаулар көзделген дайын файлды сипаттауы тиіс.

SVG-ді қолданылатын өлшемінде тексеріңіз, әсіресе дизайнда әріптер, тар аралықтар немесе ұсақ бөлшектер болса. Референс түсіне дәл сәйкестікке кепілдік жоқ, ал байланыссыз референстер бір-бірімен бәсекелесуі мүмкін. Белгіше жиынтығы қайталана берсе, үйлесімді стильді сақтап, prompt ішіндегі нысанды, қалыпты немесе орналасуды өзгертіңіз. Пайдалы нәтиже — дизайн үдерісінде пішіні мен түсін өзгертуге болатын, геометриясы мен оқылымдылығы тапсырмамен салыстырып бағаланған бірізді векторлық файл.

Ailoot арқылы /v1/images/generations ішінде дәл осы модель ID-ін таңдап, шығармашылық prompt беріңіз. Жауапта URL не кодталған сурет мазмұны болсын, қайтарылған әр data жазбасын сақтаңыз және нақты байттарды қайтарылған мазмұн түрімен бірге сақтаңыз. usage деректерін және кез келген медиа task_id мәнін файлмен бірге ұстап, кейін көзделген дизайнда оның пішіндерін, әріптерін және түс аймақтарын тексеріңіз.

Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-styles-vector

recraft/recraft-v4-styles-vector

Басқа /recraft/recraft-v4-styles-vector

Бастау

Қабылданатын кіріс деректері: Мәтін · Суреттер
Нәтижелер: Суреттер

Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер

Ailoot Ultra · Images POST /v1/images/generations

Кіріс: text, image
Шығыс: image
Шығыс пішімі: Сурет файлы

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер recraft/recraft-v4-styles-vector Шарттар: Ailoot жүйесінің дәл осы маршруттау селекторын пайдаланыңыз.	Әдепкі—
Өріс`prompt`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер Шарттар:	Әдепкі—
Өріс`n`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Ең азы: 1 Ең көбі: 6 Шарттар:	Әдепкі—
Өріс`aspect_ratio`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto Шарттар:	Әдепкі—
Өріс`output_format`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер svg Шарттар:	Әдепкі—
Өріс`input_references`	Түрі`array`	ТалапМіндетті	Мәндер мен шектеулер Шарттар:	Әдепкі—
Өріс`quality`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер auto, low, medium, high, xhigh, max Шарттар:	Әдепкі—

Кіріс материалдарының үйлесімдері

reference_guided_image

Әдіс параметрлері мен өмірлік циклі

Параметр	Параметр талаптары
Параметр`content_type`	Параметр талаптарыapplication/json
Параметр`required`	Параметр талаптарыmodel, prompt, input_references
Параметр`optional`	Параметр талаптарыn, aspect_ratio, output_format, quality
Параметр`material_types`	Параметр талаптарыtext, image
Параметр`conditions`	Параметр талаптарыAiloot жүйесінің дәл осы маршруттау селекторын пайдаланыңыз., Сапа — ортақ құжатталған басқару параметрі; сапаны реттеу мүмкіндігі жоқ жеткізушілер оны елемейді. Әр модельдің сапасы жақсарады деген уәде берілмейді.

Өмірлік цикл: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Нақты қайтарылған task_id немесе таңдалған кітапхана жазбасы; operation_id — бөлек идентификатор

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Тарифтер

Қорытынды төлем қалай есептеледі

Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.

Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.

Жылдам режим: Көрсетілмеген Жылдам режим таңдалғанда
Икемді режим: Көрсетілмеген flex режимі таңдалғанда
Ой қорытудың ең жоғары деңгейі: Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда

Салыстыруға арналған болжамды мөлшерлемелер

Баптаулар бойынша бағалар

Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.

Баптау	Мөлшерлемелер кестесі	Болжамды мөлшер	Есептеу бірлігі	Төлемді есептеу шарттары	Төлем
БаптауТокендердің базалық тарифтері	Мөлшерлемелер кестесіНегізгі мөлшерлеме	Болжамды мөлшер—	Есептеу бірлігі—	Төлемді есептеу шарттары—	Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен
БаптауКіріс үлгі материалы	Мөлшерлемелер кестесі—	Болжамды мөлшер—	Есептеу бірлігіәр сұрау үшін	Төлемді есептеу шарттарыСтиль үлгілерімен генерация жасағанда стиль құру; әр сұрауға бір рет, шығыс суретінің бағасына қосымша алынады.	Төлем Кіріс · Кіріс референсі · Тек салыстыруға арналған бағалау $0.01 әр сұрау үшін Тек анықтамалық бағалау; түпкілікті есептен шығару тіркелген бастапқы шотқа сәйкес анықталады.
Баптаушығыс кескін	Мөлшерлемелер кестесі—	Болжамды мөлшер—	Есептеу бірлігішығыс суреті үшін	Төлемді есептеу шарттары—	Төлем Шығыс · шығыс кескін · Тек салыстыруға арналған бағалау $0.1 шығыс суреті үшін
БаптауГенерацияның болжамды құны	Мөлшерлемелер кестесі—	Болжамды мөлшербір генерацияға арналған болжам	Есептеу бірлігі—	Төлемді есептеу шарттары—	Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.1 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →

Сұрау мысалдары

Ailoot Ultra · Images

curl · бір рет құрып, нәтижені толық сақтаңыз

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.

Нәтижелерді алу және сақтау

Ailoot Ultra · Images

Қайтарылған әр суретті жүктеп алыңыз немесе оның Base64 мазмұнын сақтаңыз

GET /v1/media/tasks/{task_id}
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Барлық дайын нәтижені сақтау

Әр дайын суретті сақтаңыз; қайтарылған әр URL арқылы мазмұнды алыңыз немесе оның Base64 мазмұнын декодтаңыз.

Толық жауап пен тақырыптарды, бастапқы идентификаторларды, әрбір нақты шығыс нәтижесін және пайдалану мен есепке алудың барлық өрістерін сақтаңыз. Иелігіңіздегі әрбір бірегей ресурсты сақтап, оған сілтейтін барлық рөлді сақтаңыз.

Бастапқы жауапты тексеру қажет болса

Бастапқы X-Client-Request-ID мәнін, жауапты және тақырыптарды сақтаңыз. Белгісіз нәтиже немесе result_pending_check күйі екінші рет жасауға рұқсат бермейді.

Жауап өрістері

Өріс	Түрі
Өріс`data[].url`	Түріstring
Өріс`data[].b64_json`	Түріstring
Өріс`usage`	Түріobject

Қателер және келесі қадамдар

Жауап	Шарт	Келесі қадам
Жауап400 · `invalid_request_error`	ШартМіндетті өріс, модель селекторы, түр немесе кіріс деректерінің ұсынылу пішімі жарамсыз.	Келесі қадамБөлек сұрауды дайындамас бұрын қайтарылған тексеру мәліметтерін қарап шығыңыз.
Жауап	ШартБастапқы сұрау немесе нәтиже белгісіз не тексеруді қажет етеді.	Келесі қадамБастапқы идентификаторлар мен тақырыптарды сақтаңыз; тек қолдау көрсетілетін күй немесе кітапхана жазбаларын оқыңыз. Жасау сұрауын қайта жібермеңіз.

Балама атаулар

Модельдердің балама атаулары

Ailoot Ultra recraft/recraft-v4-styles-vector

Әдіс жолдарының балама атаулары

Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.

Шақыруға арналған байланысты ID

recraft/recraft-v4-styles-vector

FAQ · Recraft: Recraft V4 Styles Vector

Қандай кіріс деректері мен нәтижелер қолжетімді?: POST /v1/images/generations · recraft/recraft-v4-styles-vector: text, image → image
Сұрау қандай өрістерді пайдаланады?: POST /v1/images/generations · recraft/recraft-v4-styles-vector: model, prompt, n, aspect_ratio, output_format, input_references, quality
Қандай шектеулер қолданылады?: POST /v1/images/generations · recraft/recraft-v4-styles-vector: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4 Styles Vector