Recraft: Recraft V4.1 Pro

Recraft V4.1 Pro generuoja detalius 2K rastrinius vaizdus išraiškingoms fotografijoms, iliustracijoms ir didesnei kūrybinei medžiagai. Modelis derina natūralų V4.1 fotorealizmą ir trumpų užklausų interpretavimą su pasirenkamais stiliaus etalonais bei vaizdo keitimo pagal vaizdą eiga.

Ailoot Ultra · Vaizdai POST /v1/images/generations recraft/recraft-v4.1-pro

Apie modelį

Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.

Recraft V4.1 Pro yra didesnės raiškos rastrinė išraiškingo Recraft V4.1 generavimo šeimos versija. Gamintojas pabrėžia natūralų fotorealizmą, apgalvotą kompoziciją ir iliustracijų stilius, kuriuos galima išplėtoti iš trumpos kūrybinės krypties. Pro skirtas darbams, kuriuose svarbios smulkesnės detalės ir didesnis rastrinis rezultatas, įskaitant didelius rinkodaros vaizdus bei spaudai orientuotus maketus. Jis skiriasi nuo paprastesnio Utility Pro pateikimo ir redaguojamą SVG kuriančio Pro Vector.

Tikslus modelio kodas yra recraftv4_1_pro. Gamintojo specifikacijoje nurodyta 2K išvestis nenuostolingu WebP arba PNG formatu. Kvadratinis dydis yra 2048 × 2048 pikselių, 16:9 – 2688 × 1536, o 3:4 – 1792 × 2432; kiti leidžiami santykiai turi atskirus matmenis. Naudokite būsimam maketui tinkamą kraštinių santykį arba tikslų dydį iš gamintojo lentelės. Pro pavadinimas nereiškia, kad kiekviena kompozicija yra kvadratinė, ir nepaverčia rastrinio vaizdo vektorine geometrija.

V4.1 gali interpretuoti trumpą kryptį, pats parinkdamas šviesą, nuotaiką ir kompoziciją. Tai naudinga ieškant redakcinės fotografijos, stilizuotos iliustracijos ar erdvinio vaizdo su atspindinčiomis medžiagomis. Atvaizduotas 3D įspūdis lieka vaizdu, o ne redaguojama trimate scena. Kai reikia konkrečios meninės krypties, aprašykite objektą ir sceną, kadravimą, medžiagų savybes, šviesos kryptį, foną ir vizualinę hierarchiją, užuot tikėjęsi, kad atvira užklausa kiekvieną detalę išspręs būtent taip, kaip norite.

Redakcinei fotografijai paprašykite artimo šlifuoto metalo šviestuvo vaizdo minkštoje lango šviesoje, šilto gyvenamo interjero ir ramios kompozicijos su vieta užrašui. Iliustratyvesnis aprašas gali nurodyti plačias spalvines formas, gyvą veikėjo pozą ir santūrų foną. Pateikite numatomą paskirtį ir objektą išskiriančias detales, tada didesniame rezultate patikrinkite medžiagas, anatomiją ir kompoziciją. Rezultatas yra aprašu valdoma kūrybinė medžiaga, o ne tikros scenos stebėjimas.

Generavimas priima iki 10 000 simbolių užklausas, pageidaujamas spalvas, norimą fono spalvą, atsitiktinumo sėklą ir nuo vieno iki šešių rezultatų. Pasirenkami stiliaus etalonai ar suderinami išsaugoti stiliai gali suteikti pasikartojantį vizualinį apdorojimą su lanksčiu arba tiksliu derinimu. Naudokite nuoseklius, aiškius etalonus ir užklausoje nurodykite turinį; tikslus spalvų atitikimas etalonui negarantuojamas. V4.1 nepalaiko negative_prompt, parinktų stilių pavadinimų, text_layout, artistic_level ir no_text, todėl šių valdiklių nereikėtų perkelti iš senesnių versijų. Generavimui pagal stiliaus etalonus naudokite nuo vieno iki dešimties PNG, JPG arba WebP vaizdų: iš viso ne daugiau kaip 64 MB, kiekvienas mažesnis nei 20 MB. Trumpesnė kiekvieno etalono kraštinė turi būti bent 256 pikselių, ilgesnė – ne daugiau kaip 4 096 pikselių, o raiška – ne didesnė nei 16 megapikselių. Naudokite šiuos etalonus arba suderinamą išsaugotą stilių, bet ne abu kartu.

Atskira Recraft vaizdo keitimo pagal vaizdą operacija palaiko V4.1 šeimą su esamu vaizdu, užklausa ir strength nuo 0 iki 1. Ji gali išsaugoti vienas šaltinio ypatybes ir keisti kitas; mažesnė reikšmė išlieka arčiau šaltinio, didesnė leidžia daugiau pakeitimų. Ši operacija nepriima V4.1 individualių stilių valdiklių. Paruoškite šaltinio vaizdą pagal dokumentuotus apribojimus ir nurodykite norimą pakeitimą bei savybes, kurios turėtų atsispindėti naujame rezultate. Galutinę medžiagą patikrinkite tikroje kompozicijoje, ypač smulkias detales, raides ir apkirpimą. Vaizdo keitimui pagal vaizdą pateikite mažesnį nei 20 MB PNG, JPG, WebP arba SVG, ne daugiau kaip 16 megapikselių, su abiem kraštinėmis nuo 256 iki 4 096 pikselių.

Ailoot Ultra · Vaizdai POST /v1/images/generations recraft/recraft-v4.1-pro

recraft/recraft-v4.1-pro

Recraft /recraft/recraft-v4.1-pro

Pradžia

Leidžiamos įvestys: Tekstas · Vaizdai
Rezultatai: Vaizdai

Prieinama Ailoot · įvestys ir metodai

Ailoot Ultra · Vaizdai POST /v1/images/generations

Įvestis: text, image
Išvestis: image

Laukas	Tipas	Reikalavimas	Reikšmės ir ribos	Numatyta
Laukas`model`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos recraft/recraft-v4.1-pro	Numatyta—
Laukas`prompt`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos Mažiausias ilgis: 1	Numatyta—
Laukas`aspect_ratio`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos 1:1, 4:3, 3:4, 16:9, 9:16, auto	Numatyta—
Laukas`n`	Tipas`integer`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausia reikšmė: 1 Didžiausia reikšmė: 6	Numatyta—
Laukas`input_references`	Tipas`array`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausias elementų skaičius: 0 Didžiausias elementų skaičius: 1	Numatyta—
Laukas`provider`	Tipas`object`	ReikalavimasNeprivaloma	Reikšmės ir ribos	Numatyta—

Metodo parametrai ir gyvavimo ciklas

Parametras	Specifikacija
Parametras`content_type`	Specifikacijaapplication/json
Parametras`required`	Specifikacijamodel, prompt
Parametras`material_types`	Specifikacijatext, image

Gyvavimo ciklas: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · faktiškai grąžinta task_id reikšmė arba medijos bibliotekos įrašas

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Planai

Kaip apskaičiuojamas galutinis mokestis

Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.

Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.

Spartusis režimas: Nenurodyta Pasirinkus spartųjį režimą
Flex režimas: Nenurodyta Pasirinkus flex režimą
Didžiausios samprotavimo pastangos: Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)

Numatomi įkainiai palyginimui

Kainos pagal konfigūraciją

Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.

Konfigūracija	Įkainių lentelė	Numatomas kiekis	Apskaitos vienetas	Mokestis
KonfigūracijaBaziniai žetonų įkainiai	Įkainių lentelėBazinis įkainis	Numatomas kiekis—	Apskaitos vienetas—	Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui — / 1K tokenų
Konfigūracijaišvesties vaizdas	Įkainių lentelė—	Numatomas kiekis—	Apskaitos vienetasuž išvesties vaizdą	Mokestis Išvestis · išvesties vaizdas · Įvertis tik palyginimui $0.42 už išvesties vaizdą
KonfigūracijaNumatoma generavimo kaina	Įkainių lentelė—	Numatomas kiekisvieno generavimo įvertis	Apskaitos vienetas—	Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $0.42 įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis.

Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →

Užklausų pavyzdžiai

Ailoot Ultra · Vaizdai

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-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

Gauti ir išsaugoti rezultatus

Ailoot Ultra · Vaizdai

Atsisiųskite kiekvieną grąžintą vaizdą arba išsaugokite jo Base64 turinį

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

Kito turinio skaitymas

Skaityti esamą jums priklausančią medžiagą

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.

Išsaugoti visus baigtus rezultatus

Išsaugokite kiekvieną baigtą vaizdą; gaukite turinį iš kiekvieno grąžinto URL arba dekoduokite jo Base64 turinį.

Išsaugokite visą atsakymą ir antraštes, visus faktiškai gautus rezultatus, pradinius grąžintus identifikatorius ir visus naudojimo apskaitos laukus. Atkurkite prieigą prie pradinės operacijos pakartotinai neteikdami kūrimo užklausos.

Jei reikia patikrinti pradinį atsakymą

Išsaugokite grąžintą X-Client-Request-ID duomenims sutikrinti. Tikrinkite tik faktiškai grąžintas task_id/asset_id reikšmes arba jums priklausančią medijos biblioteką; niekada nekurkite užduoties URL iš operacijos ID ir niekada pakartotinai neteikite kūrimo užklausos.

Atsakymo laukai

Laukas	Tipas
Laukas`created`	Tipas
Laukas`data[].url`	Tipas
Laukas`data[].b64_json`	Tipas
Laukas`usage`	Tipas

Pseudonimai

Modelių pseudonimai

Ailoot Ultra recraft/recraft-v4.1-pro

Metodų kelių pseudonimai

/v1/images

Susiję ID iškvietimui

recraft/recraft-v4.1-pro

FAQ · Recraft: Recraft V4.1 Pro

Kokios įvestys ir rezultatai prieinami?: POST /v1/images/generations · recraft/recraft-v4.1-pro: text, image → image
Kokius laukus naudoja užklausa?: POST /v1/images/generations · recraft/recraft-v4.1-pro: model, prompt, aspect_ratio, n, input_references, provider
Kokie apribojimai taikomi?: POST /v1/images/generations · recraft/recraft-v4.1-pro: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4.1 Pro