Recraft: Recraft V4.1 Utility

Recraft V4.1 Utility genererer rasterbilder i 1K for enkle produktopptak, mockuper og ukompliserte scener. Den favoriserer flat belysning og frontvendt komposisjon, med tekstprompter og valgfrie bilde- eller stilinndata for en forutsigbar visuell retning.

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

Om modellen

Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.

Recraft V4.1 Utility er standardmodellen for rasterbilder i Utility-grenen av Recrafts V4.1-familie. Den favoriserer enkle scener, flat belysning og frontvendt komposisjon, fremfor de mer uttrykksfulle valgene av vinkel, lys og stemning i hovedmodellen V4.1. Den praktiske rollen er et tydelig produktopptak eller en mockup der objektet og nødvendige detaljer skal dominere. Den spesifikke Utility-utgaven er atskilt fra Utility Pro, hovedmodellen V4.1 og vektorvariantene som produserer SVG.

Produsentens modellkode er recraftv4_1_utility. Den returnerer rasterbilder i 1K som tapsfri WebP eller PNG, med størrelser valgt blant de støttede sideforholdene. Et kvadratisk bilde er 1024 × 1024 piksler, og et 4:3-bilde er 1216 × 896. Pro Utility-utgaven bruker større 2K-dimensjoner, så disse utdatastørrelsene skal ikke tilordnes standardutgaven Utility. Velg formatet til den tiltenkte produktoppføringen eller mockupen før du beskriver scenen.

En nyttig beskrivelse navngir produkt, synsvinkel, materiale, overflate, bakgrunn og lyssetting med enkle ord. For en produktoppføring kan du be om en frontvendt isolert flaske mot en lys bakgrunn, jevnt belyst, med hele silhuetten synlig og uten distraherende sceneelementer. Hvis et produkt har faktiske dimensjoner eller særegne deler, oppgir du disse detaljene uttrykkelig. Utilitys preferanse for enkel presentasjon fastslår ikke fakta om et virkelig produkt som manglet i beskrivelsen.

Generering støtter prompter på opptil 10 000 tegn, kontroller for foretrukne farger og bakgrunnsfarge, en tilfeldig seed og ett til seks resultater. Valgfrie kompatible egendefinerte stiler eller referansebilder kan styre katalogens visuelle språk. Bruk referansemateriale som samsvarer i lyssetting og gjengivelse, og behold samme kompatible stil for senere produktbeskrivelser. Nøyaktig fargesamsvar mellom referanse og resultat er ikke garantert, så sammenlign sluttbildet med den nødvendige paletten. For generering med referansestil bruker du ett til ti PNG-, JPG- eller WebP-bilder, høyst 64 MB til sammen og under 20 MB hver. Hver referanse trenger en kortside på minst 256 piksler, en langside på høyst 4 096 piksler og en oppløsning på høyst 16 megapiksler. Bruk enten disse referansene eller en kompatibel lagret stil, fremfor begge deler. Ved generering med referansestil tillater flexible matching en friere tolkning, mens precise matching følger gjengivelse, palett, komposisjon og lyssetting tettere.

Den separate bilde-til-bilde-arbeidsflyten bruker et eksisterende bilde og en prompt, med styrke fra 0 til 1 som styrer omfanget av endringen. Lavere styrke holder resultatet nærmere kilden; høyere styrke lar det bevege seg lenger unna. Inndata kan være PNG, JPG, WebP eller SVG under 20 MB, opptil 16 MP, med sider mellom 256 og 4096 piksler. Egendefinerte V4.1-stiler godtas ikke i denne transformasjonsoperasjonen, som er atskilt fra å knytte en stilreferanse til en ny generering.

V4.1 Utility godtar ikke kuraterte stilnavn eller kontrollene negative_prompt, text_layout, artistic_level og no_text. Angi den ønskede ferdige scenen direkte i den positive prompten. For en serie produktbilder holder du utsnitts- og bakgrunnsinstruksjonene stabile, og sammenligner deretter hvert bilde med produktets innsendte form, materiale og detaljer før det brukes i en layout. Standardutgaven Utility er et avgrenset rasterverktøy for en behersket presentasjon; velg det konkrete utdataformatet og utgaven etter oppgaven.

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

recraft/recraft-v4.1-utility

Recraft /recraft/recraft-v4.1-utility

Start

Godkjente inndata: Tekst · Bilder
Resultater: Bilder

Tilgjengelig i Ailoot · inndata & metoder

Ailoot Ultra · Bilder POST /v1/images/generations

Inndatatyper: text, image
Utdatatyper: image

Felt	Type	Krav	Verdier & grenser	Standard
Felt`model`	Type`string`	KravPåkrevd	Verdier & grenser recraft/recraft-v4.1-utility	Standard—
Felt`prompt`	Type`string`	KravPåkrevd	Verdier & grenser Minste lengde: 1	Standard—
Felt`aspect_ratio`	Type`string`	KravValgfritt	Verdier & grenser 1:1, 4:3, 3:4, 16:9, 9:16, auto	Standard—
Felt`n`	Type`integer`	KravValgfritt	Verdier & grenser Minimum: 1 Maksimum: 6	Standard—
Felt`input_references`	Type`array`	KravValgfritt	Verdier & grenser Minste antall elementer: 0 Maksimalt antall elementer: 1	Standard—
Felt`provider`	Type`object`	KravValgfritt	Verdier & grenser	Standard—

Metodeparametere og livssyklus

Parameter	Avtale
Parameter`content_type`	Avtaleapplication/json
Parameter`required`	Avtalemodel, prompt
Parameter`material_types`	Avtaletext, image

Livssyklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · faktisk returnert task_id eller oppføring i mediebiblioteket

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Priser

Slik beregnes det endelige beløpet

De viste satsene anslår kostnaden før generering. Det endelige beløpet beregnes ut fra kostnaden som er registrert for den opprinnelige genereringen. Målt varighet på utdataene og anslåtte mengder er ikke den endelige fakturerbare mengden.

Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.

Hurtigmodus: Ikke angitt Når hurtigmodus er valgt
Flex-modus: Ikke angitt Når flex-modus er valgt
Maksimal resonneringsinnsats: Ikke angitt Når justeringen «default» brukes for maksimal resonneringsinnsats

Estimerte satser for sammenligning

Priser etter konfigurasjon

Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.

Konfigurasjon	Prisplan	Forventet mengde	Faktureringsenhet	Kostnad
KonfigurasjonGrunnpriser for tokener	PrisplanGrunnsats	Forventet mengde—	Faktureringsenhet—	Kostnad Inndata · Inngående tokener · Estimat kun for sammenligning — / 1K tokener Utdata · Utgående tokener · Estimat kun for sammenligning — / 1K tokener Inndata · Lesing fra hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time · Estimat kun for sammenligning — / 1K tokener
Konfigurasjonutdatabilde	Prisplan—	Forventet mengde—	Faktureringsenhetper utdatabilde	Kostnad Utdata · utdatabilde · Estimat kun for sammenligning $0.07 per utdatabilde
KonfigurasjonAnslått genereringskostnad	Prisplan—	Forventet mengdeestimat for én generering	Faktureringsenhet—	Kostnad Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $0.07 estimat før generering Dette anslaget er verken en tilleggsavgift eller en fast sats for den fullførte genereringen.

Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →

Eksempelforespørsler

Ailoot Ultra · Bilder

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

Motta og lagre resultater

Ailoot Ultra · Bilder

Last ned hvert returnerte bilde eller lagre Base64-innholdet

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

Andre innholdslesinger

Les eksisterende ressurser som tilhører deg

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.

Behold alle ferdige resultater

Lagre hvert ferdige bilde; hent hver returnerte URL eller dekod Base64-innholdet.

Bevar hele svaret og svarhodene, alle faktiske utdata, de opprinnelige returnerte identifikatorene og alle bruksfeltene. Hent den opprinnelige operasjonen igjen uten å sende opprettelsesforespørselen på nytt.

Hvis det opprinnelige svaret må kontrolleres

Bevar returnert X-Client-Request-ID for avstemming. Les bare faktisk returnerte task_id/asset_id-verdier eller egne oppføringer i mediebiblioteket; bygg aldri en oppgave-URL fra operasjons-ID-en, og send aldri opprettelsesforespørselen på nytt.

Svarfelter

Felt	Type
Felt`created`	Type
Felt`data[].url`	Type
Felt`data[].b64_json`	Type
Felt`usage`	Type

Aliaser

Modellaliaser

Ailoot Ultra recraft/recraft-v4.1-utility

Aliaser for metodestier

/v1/images

Tilknyttede anroper-ID-er

recraft/recraft-v4.1-utility

FAQ · Recraft: Recraft V4.1 Utility

Hvilke inndata og resultater er tilgjengelige?: POST /v1/images/generations · recraft/recraft-v4.1-utility: text, image → image
Hvilke felt bruker forespørselen?: POST /v1/images/generations · recraft/recraft-v4.1-utility: model, prompt, aspect_ratio, n, input_references, provider
Hvilke grenser gjelder?: POST /v1/images/generations · recraft/recraft-v4.1-utility: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4.1 Utility