Recraft: Recraft V4.1 Utility

Recraft V4.1 Utility sodda mahsulot kadrlari, maketlar va oddiy sahnalar uchun 1K rastr tasvirlar yaratadi. U tekis yoritish va old tomondan kompozitsiyani afzal ko‘radi; oldindan anglashiladigan vizual yo‘nalish uchun matn topshiriqlari hamda ixtiyoriy tasvir yoki uslub kirishlaridan foydalanadi.

Ailoot Ultra · Rasmlar POST /v1/images/generations recraft/recraft-v4.1-utility

Model haqida

Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.

Recraft V4.1 Utility — Recraft V4.1 oilasidagi standart rastr Utility modeli. U asosiy V4.1 modelining ifodaliroq rakurs, yorug‘lik va kayfiyat tanlovlaridan ko‘ra sodda sahnalar, tekis yoritish va old tomondan kompozitsiyani afzal ko‘radi. Uning amaliy vazifasi — obyekt va kerakli detallar ustun turadigan aniq mahsulot kadri yoki maket. Aynan Utility nashri Utility Pro, asosiy V4.1 modeli va SVG chiqaruvchi vektor variantlaridan alohida.

Ishlab chiqaruvchi model kodi recraftv4_1_utility. U qo‘llanadigan tomonlar nisbatidan tanlangan o‘lchamlarda, yo‘qotishsiz WebP yoki PNG shaklida 1K rastr tasvirlar qaytaradi. Kvadrat tasvir 1024 × 1024 piksel, 4:3 tasvir esa 1216 × 896. Pro Utility nashri kattaroq 2K o‘lchamlardan foydalanadi, shuning uchun ularni standart Utility ga tegishli deb belgilamaslik kerak. Sahnani tasvirlashdan oldin kerakli e’lon yoki maket formatini tanlang.

Foydali topshiriq mahsulot, ko‘rish nuqtasi, material, sirt, fon va yoritishni oddiy so‘zlar bilan nomlaydi. Mahsulot e’loni uchun och fonda old tomondan ko‘rinadigan, bir tekis yoritilgan, butun silueti ko‘rinib turadigan va chalg‘ituvchi sahna elementlarisiz issiqlikni saqlovchi idishni so‘rang. Mahsulotning haqiqiy o‘lchamlari yoki o‘ziga xos qismlari bo‘lsa, ularni aniq bering. Utility ning sodda taqdimotga moyilligi topshiriqda yo‘q real mahsulot faktlarini o‘rnatmaydi.

Yaratish 10,000 belgigacha topshiriq, afzal ranglar va fon rangi boshqaruvlari, tasodifiy seed hamda birdan oltitagacha natijani qo‘llaydi. Ixtiyoriy mos maxsus uslublar yoki namuna tasvirlari katalogning vizual tilini yo‘naltirishi mumkin. Yoritish va tasvirlash usuli mos namunalarni ishlating, keyingi mahsulot topshiriqlarida esa bir xil mos uslubni saqlang. Namuna va natija orasida aniq rang mosligi kafolatlanmaydi, shuning uchun yakuniy vizualni kerakli palitraga solishtiring. Namuna uslubida yaratish uchun birdan o‘ntagacha PNG, JPG yoki WebP tasvir ishlating: jami ko‘pi bilan 64 MB, har biri 20 MB dan kichik. Har bir namunaning eng qisqa tomoni kamida 256 piksel, eng uzuni ko‘pi bilan 4,096 piksel, aniqligi esa ko‘pi bilan 16 megapiksel bo‘lishi kerak. Shu namunalar yoki mos saqlangan uslubdan birini ishlating, ikkalasini birga emas. Namuna uslubida yaratishda flexible matching erkinroq talqinga, precise matching esa tasvirlash, palitra, kompozitsiya va yoritishni yaqinroq kuzatishga imkon beradi.

Alohida tasvirdan tasvir jarayoni mavjud tasvir va topshiriqdan foydalanadi; o‘zgarish darajasi 0 dan 1 gacha strength bilan boshqariladi. Pastroq strength natijani manbaga yaqinroq saqlaydi, yuqorirog‘i uzoqlashishga ruxsat beradi. Kirish PNG, JPG, WebP yoki SVG, 20 MB dan kichik, 16 MP gacha va tomonlari 256–4096 piksel oralig‘ida bo‘lishi mumkin. V4.1 maxsus uslublari ushbu o‘zgartirish amalida qabul qilinmaydi; bu yangi yaratishga uslub namunasi biriktirishdan alohida.

V4.1 Utility tayyor tanlangan uslub nomlari, negative_prompt, text_layout, artistic_level yoki no_text boshqaruvlarini qabul qilmaydi. Kerakli tayyor sahnani bevosita ijobiy topshiriqda bering. Mahsulot materiallari seriyasida kadr kompozitsiyasi va fon ko‘rsatmalarini bir xil saqlang, keyin har bir tasvirni maketda ishlatishdan oldin berilgan mahsulot shakli, materiali va detallariga solishtiring. Standart Utility — vazmin taqdimot uchun yo‘naltirilgan rastr vositasi; chiqish formati va nashrni vazifaga mos tanlang.

Ailoot Ultra · Rasmlar POST /v1/images/generations recraft/recraft-v4.1-utility

recraft/recraft-v4.1-utility

Recraft /recraft/recraft-v4.1-utility

Boshlash

Qabul qilinadigan kirish ma’lumotlari: Matn · Rasmlar
Natijalar: Rasmlar

Ailoot da mavjud · kirish ma’lumotlari va usullar

Ailoot Ultra · Rasmlar POST /v1/images/generations

Kirish: text, image
Chiqish: image

Maydon	Tur	Talab	Qiymatlar va cheklovlar	Standart
Maydon`model`	Tur`string`	TalabMajburiy	Qiymatlar va cheklovlar recraft/recraft-v4.1-utility	Standart—
Maydon`prompt`	Tur`string`	TalabMajburiy	Qiymatlar va cheklovlar Eng kam uzunlik: 1	Standart—
Maydon`aspect_ratio`	Tur`string`	TalabIxtiyoriy	Qiymatlar va cheklovlar 1:1, 4:3, 3:4, 16:9, 9:16, auto	Standart—
Maydon`n`	Tur`integer`	TalabIxtiyoriy	Qiymatlar va cheklovlar Eng kam: 1 Eng ko‘p: 6	Standart—
Maydon`input_references`	Tur`array`	TalabIxtiyoriy	Qiymatlar va cheklovlar Elementlarning eng kam soni: 0 Elementlarning eng ko‘p soni: 1	Standart—
Maydon`provider`	Tur`object`	TalabIxtiyoriy	Qiymatlar va cheklovlar	Standart—

Usul parametrlari va hayot sikli

Parametr	Parametr talablari
Parametr`content_type`	Parametr talablariapplication/json
Parametr`required`	Parametr talablarimodel, prompt
Parametr`material_types`	Parametr talablaritext, image

Hayot sikli: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Amalda qaytarilgan task_id yoki media kutubxonasidagi yozuv

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Tariflar

Yakuniy to‘lov qanday hisoblanadi

Ko‘rsatilgan tariflar xarajatni generatsiyadan oldin taxminiy hisoblash uchun xizmat qiladi. Yakuniy to‘lov dastlabki generatsiya uchun qayd etilgan xarajat asosida hisoblanadi. Natijaning o‘lchangan davomiyligi va oldindan taxmin qilingan miqdorlar haq undiriladigan yakuniy miqdor hisoblanmaydi.

Tarif ma’lumotlari so‘rov imkoniyatlarini qo‘shmaydi. Qo‘llab-quvvatlanadigan parametrlar tanlangan usulda ko‘rsatilgan.

Tezkor rejim: Ko‘rsatilmagan Tezkor rejim tanlanganda
Flex rejimi: Ko‘rsatilmagan flex rejimi tanlanganda
Maksimal fikrlash darajasi: Ko‘rsatilmagan Maksimal fikrlash darajasi uchun standart (default) tuzatish qo‘llanganda

Taqqoslash uchun taxminiy tariflar

Sozlamalar bo‘yicha narxlar

Har bir to‘lovni ko‘rsatilgan shartlarga moslang. Har bir muqobil sozlamalar to‘plami uchun bitta tarifdan foydalaning.

Sozlama	Tariflar jadvali	Prognoz miqdori	Hisob birligi	To‘lov
SozlamaTokenlar uchun bazaviy tariflar	Tariflar jadvaliAsosiy tarif	Prognoz miqdori—	Hisob birligi—	To‘lov Kirish · Kirish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Chiqish · Chiqish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshdan o‘qish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish, 1 soat · Faqat taqqoslash uchun taxmin — / 1K token
Sozlamachiqish rasmi	Tariflar jadvali—	Prognoz miqdori—	Hisob birligichiqish rasmi uchun	To‘lov Chiqish · chiqish rasmi · Faqat taqqoslash uchun taxmin $0.07 chiqish rasmi uchun
SozlamaYaratishning taxminiy qiymati	Tariflar jadvali—	Prognoz miqdoribir generatsiya uchun taxmin	Hisob birligi—	To‘lov Chiqish · Yaratishning taxminiy narxi · Faqat taqqoslash uchun taxmin $0.07 yaratishdan oldingi taxmin Bu taxmin qo‘shimcha to‘lov ham, tugallangan generatsiya uchun qat’iy tarif ham emas.

Ailoot so‘rovdan oldin taxminiy summani band qiladi. Natijadan keyin o‘lchangan sarf asosidagi yakuniy to‘lovni yechadi. Oqimli javob bo‘yicha yakuniy hisob-kitob yakuniy sarf yozuviga asoslanadi. Summani band qilish va to‘lovni hisoblash tartibi →

So‘rov namunalari

Ailoot Ultra · Rasmlar

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-utility', '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

Natijalarni olish va saqlash

Ailoot Ultra · Rasmlar

Har bir qaytarilgan rasmni yuklab oling yoki uning Base64 kontentini saqlang

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

Boshqa kontentni o‘qish

O‘zingizga tegishli mavjud materiallarni o‘qish

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.

Barcha tayyor natijalarni saqlash

Har bir tayyor rasmni saqlang; har bir qaytarilgan URL dan kontentni oling yoki uning Base64 kontentini dekodlang.

To‘liq javob va sarlavhalarni, amalda qaytarilgan barcha natijalarni, dastlab qaytarilgan identifikatorlarni hamda barcha usage maydonlarini saqlang. Yaratish so‘rovini qayta yubormasdan dastlabki operatsiyani tiklang.

Asl javobni tekshirish kerak bo‘lsa

Qaytarilgan X-Client-Request-ID ni ma’lumotlarni solishtirib tekshirish uchun saqlang. Faqat amalda qaytarilgan task_id/asset_id qiymatlari bo‘yicha yoki o‘zingizga tegishli media kutubxonasidan ma’lumot o‘qing; operatsiya ID sidan vazifa URL manzilini hech qachon tuzmang va yaratish so‘rovini qayta yubormang.

Javob maydonlari

Maydon	Tur
Maydon`created`	Tur
Maydon`data[].url`	Tur
Maydon`data[].b64_json`	Tur
Maydon`usage`	Tur

Taxalluslar

Model taxalluslari

Ailoot Ultra recraft/recraft-v4.1-utility

Usul yo‘llari taxalluslari

/v1/images

Chaqirish uchun tegishli ID lar

recraft/recraft-v4.1-utility

FAQ · Recraft: Recraft V4.1 Utility

Qanday kirish ma’lumotlari va natijalar mavjud?: POST /v1/images/generations · recraft/recraft-v4.1-utility: text, image → image
So‘rov qaysi maydonlardan foydalanadi?: POST /v1/images/generations · recraft/recraft-v4.1-utility: model, prompt, aspect_ratio, n, input_references, provider
Qanday cheklovlar amal qiladi?: POST /v1/images/generations · recraft/recraft-v4.1-utility: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4.1 Utility