Recraft: Recraft V4 Styles Pro

Recraft V4 Styles Pro үлгілермен анықталған визуалдық стильде 2K растрлық кескіндер жасайды. Ол нысан өзгергенде де текстурасы, бейнелеу мәнері, палитрасы мен жалпы көрінісі біркелкі қалуы тиіс егжей-тегжейлі науқан материалдары мен кескіндер жиынтығына арналған.

Ailoot Ultra · Суреттер POST /v1/images/generations recraft/recraft-v4-styles-pro

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

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

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

Styles Pro шығынсыз WebP немесе PNG пішімінде 2K растрлық нәтиже шығарады. Өндірушінің өлшемдер кестесінде шаршы нәтиже 2048 × 2048 пиксель, ал 16:9 нәтижесі 2688 × 1536; басқа қолдау көрсетілетін арақатынастардың өз өлшемдері бар. Pro нұсқасының ірі нәтижесі егжей-тегжейлі науқан кескіндері мен үлкен макеттер үшін пайдалы. Векторлық нұсқалар SVG шығарады және олардың бекітілген пиксель өлшемі жоқ, сондықтан өңделетін векторлық файл қажет болса, бұл растрлық Pro нұсқасын таңдамаңыз.

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

Икемді стиль сәйкестендіруі әдепкі режим болып саналады және үлгіні еркінірек түсіндіруге мүмкіндік береді. Дәл сәйкестендіру бейнелеу мәнерін, палитраны, композиция мен жарықты жақынырақ ұстанады. Үлгі визуалдық тілді анықтайды; мәтіндік тапсырма жаңа нысанды, әрекетті, көрініс пен кадрлауды бәрібір сипаттауы керек. Егжей-тегжейлі тауар науқаны үшін ашық түсті тас беттегі шыны бөтелкені, үш ширектік ракурсты, жұмсақ бүйір жарығын және тақырыпқа арналған бос орынды көрсетіңіз, ал берілген үлгі фотографиялық өңдеуді жеткізеді.

Модель 10 000 таңбаға дейінгі сұрауды қабылдайды, қалаулы түстер мен қажетті фон түсін қолдайды және кездейсоқ seed мәнін қолдана алады. Құжатталған генерация үдерісі бірден алтыға дейін кескін қайтарады. Оның пайдалы басқару мүмкіндіктері ескі Recraft нұсқаларынан өзгеше: дайын стиль атаулары, negative_prompt және text_layout қолдау таппайды, ал Styles топтамасында image-to-image не inpainting жоқ. Үлгі — стиль көзі; ол маска да, бар фотосуретті пиксельге дейін сақтауға арналған нұсқау да емес.

Таза, жеткілікті егжей-тегжейлі үлгі материалдарды дайындап, жиынтық әзірлеу кезінде бір стильді қайта пайдаланыңыз. Нәтижелер бір-бірін қайталай бастаса, қатыссыз үлгі қоспай, мәтіндік тапсырмадағы нысанды, қалыпты, камера ракурсын немесе көріністі өзгертіңіз. Үлгі мен нәтиже түстерінің дәл сәйкестігіне кепілдік жоқ; қалаулы түс параметрлері түсті дәл тексеріп бекітетін нәтиже емес, бағыт береді. Соңғы науқан материалын жоспарланған экрандық не баспа өлшемінде бағалап, нысанның, пайдалы бос кеңістік пен визуалдық өңдеудің тапсырмаға сай екенін тексеріңіз.

Ailoot Ultra · Суреттер POST /v1/images/generations recraft/recraft-v4-styles-pro

recraft/recraft-v4-styles-pro

Recraft /recraft/recraft-v4-styles-pro

Бастау

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

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

Ailoot Ultra · Суреттер POST /v1/images/generations

Кіріс: text, image
Шығыс: image

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер recraft/recraft-v4-styles-pro	Әдепкі—
Өріс`prompt`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер Ең аз ұзындық: 1	Әдепкі—
Өріс`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	Әдепкі—
Өріс`n`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Ең азы: 1 Ең көбі: 6	Әдепкі—
Өріс`input_references`	Түрі`array`	ТалапМіндетті емес	Мәндер мен шектеулер Элементтердің ең аз саны: 1 Элементтердің ең көп саны: 10	Әдепкі—
Өріс`provider`	Түрі`object`	ТалапМіндетті емес	Мәндер мен шектеулер	Әдепкі—

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

Параметр	Параметр талаптары
Параметр`content_type`	Параметр талаптарыapplication/json
Параметр`required`	Параметр талаптарыmodel, prompt
Параметр`material_types`	Параметр талаптарыtext, image

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

GET /v1/media/tasks/{task_id} · Нақты қайтарылған task_id немесе медиатека жазбасы

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Тарифтер

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

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

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

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

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

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

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

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

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

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

Ailoot Ultra · Суреттер

curl

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={'model': 'recraft/recraft-v4-styles-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

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
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

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

Ailoot Ultra · Суреттер

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

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

Басқа мазмұнды оқу

Өзіңізге тиесілі қолда бар материалдарды оқу

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

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

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

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

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

Есептерді салыстырып тексеру үшін қайтарылған X-Client-Request-ID мәнін сақтаңыз. Тек нақты қайтарылған task_id/asset_id мәндері арқылы немесе өзіңізге тиесілі медиатекадан оқыңыз; операция ID мәнінен тапсырманың URL мекенжайын ешқашан құрастырмаңыз және жасау сұрауын ешқашан қайта жібермеңіз.

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

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

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

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

Ailoot Ultra recraft/recraft-v4-styles-pro

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

/v1/images

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

recraft/recraft-v4-styles-pro

FAQ · Recraft: Recraft V4 Styles Pro

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

Recraft: Recraft V4 Styles Pro