Recraft: Recraft V4.1 Utility

Recraft V4.1 Utility genererer rasterbilleder i 1K til ligefremme produktoptagelser, mockups og enkle scener. Den foretrækker jævn belysning og en komposition set forfra med tekstprompts og valgfrie billed- eller stilinput til en forudsigelig visuel retning.

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

Om modellen

Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.

Recraft V4.1 Utility er standardmodellen til rasterbilleder i Utility-grenen af Recrafts V4.1-familie. Den foretrækker enkle scener, jævn belysning og komposition set forfra frem for hovedmodellen V4.1's mere udtryksfulde valg af vinkel, lys og stemning. Dens praktiske rolle er en tydelig produktoptagelse eller mockup, hvor genstanden og nødvendige detaljer skal dominere. Den konkrete Utility-udgave er adskilt fra Utility Pro, hovedmodellen V4.1 og de vektorvarianter, der leverer SVG.

Producentens modelkode er recraftv4_1_utility. Den returnerer rasterbilleder i 1K som tabsfri WebP eller PNG med størrelser valgt blandt de understøttede billedformater. Et kvadratisk billede er 1024 × 1024 pixels, og et 4:3-billede er 1216 × 896. Pro Utility-udgaven bruger større 2K-dimensioner, så disse outputstørrelser bør ikke tildeles standardudgaven Utility. Vælg formen til den ønskede produktvisning eller mockup, før du beskriver scenen.

En nyttig beskrivelse navngiver produkt, synsvinkel, materiale, overflade, baggrund og belysning i enkle vendinger. Til en produktvisning kan du bede om en termoflaske set forfra på en lys baggrund, jævnt belyst, med hele silhuetten synlig og uden forstyrrende sceneelementer. Hvis et produkt har faktiske dimensioner eller karakteristiske dele, skal du angive disse detaljer udtrykkeligt. Utilitys præference for ligefrem præsentation fastslår ikke fakta om et virkeligt produkt, som manglede i beskrivelsen.

Generering understøtter prompts på op til 10.000 tegn, kontroller for foretrukne farver og baggrundsfarve, et tilfældigt seed og ét til seks output. Valgfrie kompatible brugerdefinerede stilarter eller referencebilleder kan styre et katalogs visuelle sprog. Brug referencematerialer, der stemmer overens i belysning og gengivelse, og bevar samme kompatible stil til efterfølgende produktbeskrivelser. Præcist farvematch fra reference til output er ikke garanteret, så sammenlign det færdige billede med den nødvendige palet. Ved generering med referencestil skal du bruge ét til ti PNG-, JPG- eller WebP-billeder, højst 64 MB i alt og under 20 MB hver. Hver reference skal have en korteste side på mindst 256 pixels, en længste side på højst 4.096 pixels og en opløsning på højst 16 megapixels. Brug enten disse referencer eller en kompatibel gemt stil frem for begge dele. Ved generering med referencestil tillader fleksibel matchning en løsere fortolkning, mens præcis matchning følger gengivelse, palet, komposition og belysning tættere.

Den separate billede-til-billede-arbejdsgang bruger et eksisterende billede og en prompt med en styrke fra 0 til 1, der styrer omfanget af ændringen. Lavere styrke holder resultatet tættere på kilden; højere styrke lader det bevæge sig længere væk. Input kan være PNG, JPG, WebP eller SVG under 20 MB, op til 16 MP og med sider mellem 256 og 4096 pixels. Brugerdefinerede V4.1-stilarter accepteres ikke i denne transformationsoperation, som er adskilt fra at tilknytte en stilreference til en ny generering.

V4.1 Utility accepterer ikke kuraterede stilnavne eller kontrollerne negative_prompt, text_layout, artistic_level eller no_text. Beskriv den ønskede færdige scene direkte i den positive prompt. Ved en serie produktmaterialer skal du holde anvisninger om indramning og baggrund stabile og derefter sammenligne hvert billede med den medsendte produktform, materialet og detaljerne, før du bruger det i et layout. Standardudgaven Utility er et fokuseret rasterværktøj til en behersket præsentation; vælg det konkrete outputformat og den udgave, der passer til opgaven.

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

recraft/recraft-v4.1-utility

Recraft /recraft/recraft-v4.1-utility

Start

Accepterede input: Tekst · Billeder
Resultater: Billeder

Tilgængelig i Ailoot · input og metoder

Ailoot Ultra · Billeder POST /v1/images/generations

Inputtyper: text, image
Outputtyper: image

Felt	Type	Krav	Værdier og grænser	Standard
Felt`model`	Type`string`	KravPåkrævet	Værdier og grænser recraft/recraft-v4.1-utility	Standard—
Felt`prompt`	Type`string`	KravPåkrævet	Værdier og grænser Minimumslængde: 1	Standard—
Felt`aspect_ratio`	Type`string`	KravValgfrit	Værdier og grænser 1:1, 4:3, 3:4, 16:9, 9:16, auto	Standard—
Felt`n`	Type`integer`	KravValgfrit	Værdier og grænser Minimum: 1 Maksimum: 6	Standard—
Felt`input_references`	Type`array`	KravValgfrit	Værdier og grænser Minimumsantal elementer: 0 Maksimalt antal elementer: 1	Standard—
Felt`provider`	Type`object`	KravValgfrit	Værdier og grænser	Standard—

Metodeparametre og livscyklus

Parameter	Kontrakt
Parameter`content_type`	Kontraktapplication/json
Parameter`required`	Kontraktmodel, prompt
Parameter`material_types`	Kontrakttext, image

Livscyklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · det faktisk returnerede task_id eller posten i mediebiblioteket

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Priser

Sådan beregnes det endelige beløb

De viste satser bruges til at anslå omkostningen før genereringen. Det endelige beløb beregnes ud fra den registrerede omkostning for den oprindelige generering. Den målte varighed af outputtet og de anslåede mængder er ikke den endelige fakturerbare mængde.

Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.

Hurtig tilstand: Ikke angivet Når hurtig tilstand er valgt
flex-tilstand: Ikke angivet Når flex-tilstanden er valgt
Maksimal ræsonneringsindsats: Ikke angivet Når default-justeringen anvendes ved maksimal ræsonneringsindsats

Estimerede takster til sammenligning

Priser efter konfiguration

Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.

Konfiguration	Takstplan	Forventet mængde	Afregningsenhed	Beløb
KonfigurationGrundpriser for tokens	TakstplanGrundtakst	Forventet mængde—	Afregningsenhed—	Beløb Input · Inputtokens · Estimat kun til sammenligning — / 1K tokens Output · Outputtokens · Estimat kun til sammenligning — / 1K tokens Input · Cachelæsning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning, 1 time · Estimat kun til sammenligning — / 1K tokens
Konfigurationoutputbillede	Takstplan—	Forventet mængde—	Afregningsenhedpr. outputbillede	Beløb Output · outputbillede · Estimat kun til sammenligning $0.07 pr. outputbillede
KonfigurationAnslået genereringsomkostning	Takstplan—	Forventet mængdeestimat for én generering	Afregningsenhed—	Beløb Output · Anslået genereringsomkostning · Estimat kun til sammenligning $0.07 estimat før generering Dette estimat er hverken et ekstra gebyr eller en fast pris for den færdige generering.

Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →

Eksempelanmodninger

Ailoot Ultra · Billeder

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

Hent og gem resultater

Ailoot Ultra · Billeder

Hent hvert returneret billede, eller gem dets Base64-indhold

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

Læsning af andet indhold

Hent eksisterende filer, du ejer

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 færdige resultater

Gem hvert færdigt billede; hent hver returneret URL eller afkod dets Base64-indhold.

Gem hele svaret og alle headere, alle faktisk returnerede output, de oprindeligt returnerede identifikatorer og alle felter med forbrugsdata. Gendan den oprindelige operation uden at sende oprettelsesanmodningen igen.

Hvis det oprindelige svar skal kontrolleres

Gem det returnerede X-Client-Request-ID til afstemning. Brug kun faktisk returnerede task_id/asset_id-værdier eller dit eget mediebibliotek til læseanmodninger; opbyg aldrig en opgave-URL ud fra operations-ID’et, og send aldrig oprettelsesanmodningen igen.

Svarfelter

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

Aliaser

Modelaliaser

Ailoot Ultra recraft/recraft-v4.1-utility

Aliaser for metodestier

/v1/images

Relaterede kalder-ID’er

recraft/recraft-v4.1-utility

FAQ · Recraft: Recraft V4.1 Utility

Hvilke input og resultater er tilgængelige?: POST /v1/images/generations · recraft/recraft-v4.1-utility: text, image → image
Hvilke felter bruger anmodningen?: POST /v1/images/generations · recraft/recraft-v4.1-utility: model, prompt, aspect_ratio, n, input_references, provider
Hvilke grænser gælder?: POST /v1/images/generations · recraft/recraft-v4.1-utility: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4.1 Utility