Recraft: Recraft V4.1

Recraft V4.1 табиғи фотореализммен, әсерлі иллюстрациямен және ойластырылған композициямен 1K растрлық кескіндер жасайды. Ол қысқа шығармашылық бағытты дамыта алады немесе егжей-тегжейлі тапсырманы орындайды; қосымша кескіндер мен жеке стильдерді кіріс ретінде беруге болады.

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

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

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

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

Өндірушідегі нақты код — recraftv4_1. Ол шығынсыз WebP немесе PNG пішімінде 1K растрлық кескіндер қайтарады: шаршы нәтиже 1024 × 1024 пиксель, 16:9 нәтижесі 1344 × 768. Басқа қолдау көрсетілетін арақатынастар өз өлшемдерін қолданады. V4.1 Pro — бөлек 2K растрлық нұсқа, Vector өңделетін SVG қайтарады, ал Utility қарапайым жарық пен көріністерге бейім. Бұл тармақтар әртүрлі материалдарға қызмет етеді, сондықтан олардың нәтиже қасиеттерін бір жиынтыққа біріктіруге болмайды.

Өндіруші табиғиырақ фотографиялық көріністерді, тыныш фонды, біркелкі градиенттерді және кең иллюстрациялық ауқымды атап көрсетеді. Мысалдарына әсерлі жазулар, жазық кейіпкер иллюстрациясы және салынған кейіпкердің үлгі парағы кіреді. Қысқа сұрау модельдің түсіндіруіне орын қалдырады; егжей-тегжейлі тапсырма нысанды, қалыпты, материалды, фон мен композицияны бекітеді. Көлемді кескін үшін беттің қасиеті мен жарық өңдеуін көрсетіңіз, бірақ нәтиже тор не өңделетін 3D жоба емес, кескін екенін ескеріңіз.

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

Генерация анықтамасы 10 000 таңбаға дейінгі сұрауға, кездейсоқ seed мәніне, қалаулы түстер мен қажетті фон түсіне және бірден алтыға дейін нәтиже алуға рұқсат етеді. Қосымша үлгі кескіндер немесе үйлесімді сақталған стильдер икемді не дәл сәйкестендіру арқылы визуалдық тілді қалыптастыра алады. Негізгі V4.1 нұсқасы үшін олар міндетті емес. Өзара үйлесетін таза үлгілерді таңдап, жаңа мазмұнды сұрау мәтінінде беріңіз; үлгі түстерінің қайталануына кепілдік жоқ. Үлгі стилімен генерациялау үшін PNG, JPG немесе WebP пішіміндегі бірден онға дейін кескін пайдаланыңыз: жалпы көлемі 64 МБ-тан аспасын, әрқайсысы 20 МБ-тан кіші болсын. Әр үлгінің қысқа жағы кемінде 256 пиксель, ұзын жағы 4 096 пиксельден аспайтын, ажыратымдылығы 16 мегапиксельден аспайтын болуы керек. Осы үлгілерді немесе үйлесімді сақталған стильді пайдаланыңыз, екеуін бірге бермеңіз.

V4.1 бар кескін, мәтін және 0-ден 1-ге дейінгі strength мәні қолданылатын бөлек image-to-image үдерісін де қолдайды. Операция strength арқылы жаңа кескіннің түпнұсқаға қаншалықты жақын қалатынын басқарады және V4.1 жеке стиль басқару параметрлерін қабылдамайды. Модельдің қазіргі генерация анықтамасы negative_prompt, дайын стильдер, text_layout, artistic_level және no_text параметрлерін қамтымайды. Қажетті көріністі тікелей сипаттап, қай визуалдық бағытты сақтайтыныңызды шешпес бұрын нәтижені мақсатты макетте, оның ішінде бөлшектерін, қиылуын және жазуларын тексеріңіз. Image-to-image үшін 20 МБ-тан кіші, 16 мегапиксельден аспайтын, екі жағы да 256–4 096 пиксель аралығындағы PNG, JPG, WebP немесе SVG беріңіз.

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

recraft/recraft-v4.1

Recraft /recraft/recraft-v4.1

Бастау

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

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

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

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

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер recraft/recraft-v4.1	Әдепкі—
Өріс`prompt`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер Ең аз ұзындық: 1	Әдепкі—
Өріс`aspect_ratio`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 1:1, 4:3, 3:4, 16:9, 9:16, auto	Әдепкі—
Өріс`n`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Ең азы: 1 Ең көбі: 6	Әдепкі—
Өріс`input_references`	Түрі`array`	ТалапМіндетті емес	Мәндер мен шектеулер Элементтердің ең аз саны: 0 Элементтердің ең көп саны: 1	Әдепкі—
Өріс`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.07 шығыс суреті үшін
БаптауГенерацияның болжамды құны	Мөлшерлемелер кестесі—	Болжамды мөлшербір генерацияға арналған болжам	Есептеу бірлігі—	Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.07 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

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.1', '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.1

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

/v1/images

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

recraft/recraft-v4.1

FAQ · Recraft: Recraft V4.1

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

Recraft: Recraft V4.1