Recraft: Recraft V4.1 Utility Pro
Recraft V4.1 Utility Pro genererer rasterbilleder i 2K med fokus på enkle, forudsigelige scener, jævn belysning og komposition set forfra. Den egner sig til detaljerede produktoptagelser og mockups, der kræver en tydelig præsentation frem for en udtryksfuld visuel retning.
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 Pro er rastervarianten med højere opløsning i Utility-grenen af Recraft V4.1. Producenten skelner mellem Utilitys ligefremme præsentation og hovedmodellen V4.1's mere udtryksfulde valg af vinkel, belysning og komposition. Utility foretrækker enkle scener, jævn belysning og motiver set forfra. Den egner sig derfor til produktvisninger, mockups og andet arbejde, hvor genstanden skal være let at aflæse, og en rolig komposition tjener opgaven.
Den konkrete modelkode er recraftv4_1_utility_pro. Producentens reference angiver rasteroutput i 2K med finere detaljer som tabsfri WebP eller PNG. Størrelsestabellen angiver 2048 × 2048 pixels til kvadratiske billeder og 2432 × 1792 til 4:3, mens andre understøttede billedformater bruger deres egne dimensioner. Dette adskiller Utility Pro fra standardudgaven Utilitys 1K-output. Det gør ikke billedet til en redigerbar vektorfil; en Vector-udgave leverer SVG til det formål.
Begynd med en beskrivelse, der navngiver genstand, materiale, synsvinkel, baggrund og de få detaljer, der skal være synlige. Til en produktvisning kan du bede om en keramisk opbevaringskrukke set forfra på en lys neutral overflade med jævn belysning, et lukket låg og fri plads omkring silhuetten. Hvis scenen skal forblive ligefrem, skal du sige det udtrykkeligt frem for at stole på, at Utility-navnet indkoder alle præsentationsvalg. Ved en serie produktbilleder skal du holde krav til indramning og baggrund konsistente og samtidig ændre produktbeskrivelsen.
V4.1-genereringsreferencen understøtter prompts på op til 10.000 tegn, kontroller for foretrukne farver og baggrundsfarve, et tilfældigt seed og ét til seks output. En kompatibel gemt stil eller valgfrie referencebilleder kan styre udseendet; den dedikerede V4 Styles-familie er den separate serie, hvor en stil altid er obligatorisk. Ved valgfrie referencer skal du bruge tydelige materialer med en fælles visuel retning. Præcis farvegengivelse fra en reference er ikke garanteret, så et krav om brandfarver kræver stadig en udtrykkelig beskrivelse og kontrol af output. 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.
Recraft dokumenterer også billede-til-billede til V4.1-serien, der kombinerer et eksisterende billede med en prompt og en styrke fra 0 til 1. En lavere styrke holder sig tættere på kilden, og en højere værdi tillader en større ændring. Dette er nyttigt, når startkompositionen eller motivet skal præge en ny version. Den accepterer ikke brugerdefinerede V4.1-stilkontroller i samme transformationsoperation. Producentens billedinputgrænser er under 20 MB, op til 16 MP og sider mellem 256 og 4096 pixels.
Utility Pro deler V4.1-begrænsningerne for kontrollerne negative_prompt, kuraterede stilnavne, text_layout, artistic_level og no_text. Giv en positiv beskrivelse af den ønskede scene, og reserver præcist tekst- eller layoutarbejde til et passende færdiggørelsestrin, når det er nødvendigt. Gennemgå et produktbillede for det medsendte materiale, formen og nødvendige detaljer, før det betragtes som et trofast produktvisningsmateriale. Det nyttige resultat er en større rasterkomposition forberedt til en tydelig produkt- eller mockupbeskrivelse, mens de præcise produktfakta forbliver dem, der er angivet i opgaven.
Ailoot Ultra · Billeder POST /v1/images/generations recraft/recraft-v4.1-utility-pro
recraft/recraft-v4.1-utility-pro
recraft/recraft-v4.1-utility-proStart
Recraft V4.1 Utility Pro genererer rasterbilleder i 2K med fokus på enkle, forudsigelige scener, jævn belysning og komposition set forfra. Den egner sig til detaljerede produktoptagelser og mockups, der kræver en tydelig præsentation frem for en udtryksfuld visuel retning.
- 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 |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser recraft/recraft-v4.1-utility-pro | Standard— |
Feltprompt | Typestring | KravPåkrævet | Værdier og grænser Minimumslængde: 1 | Standard— |
Feltaspect_ratio | Typestring | KravValgfrit | Værdier og grænser 1:1, 4:3, 3:4, 16:9, 9:16, auto | Standard— |
Feltn | Typeinteger | KravValgfrit | Værdier og grænser Minimum: 1 Maksimum: 6 | Standard— |
Feltinput_references | Typearray | KravValgfrit | Værdier og grænser Minimumsantal elementer: 0 Maksimalt antal elementer: 1 | Standard— |
Feltprovider | Typeobject | KravValgfrit | Værdier og grænser | Standard— |
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, prompt |
Parametermaterial_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.42 pr. outputbillede |
| KonfigurationAnslået genereringsomkostning | Takstplan— | Forventet mængdeestimat for én generering | Afregningsenhed— | Beløb Output · Anslået genereringsomkostning · Estimat kun til sammenligning $0.42 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
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-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
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}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Læsning af andet indhold
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 |
|---|---|
Feltcreated | Type |
Feltdata[].url | Type |
Feltdata[].b64_json | Type |
Feltusage | Type |
Aliaser
Modelaliaser
Ailoot Ultra recraft/recraft-v4.1-utility-pro
Aliaser for metodestier
/v1/images
Relaterede kalder-ID’er
FAQ · Recraft: Recraft V4.1 Utility Pro
- Hvilke input og resultater er tilgængelige?
POST /v1/images/generations·recraft/recraft-v4.1-utility-pro:text,image→image- Hvilke felter bruger anmodningen?
POST /v1/images/generations·recraft/recraft-v4.1-utility-pro:model,prompt,aspect_ratio,n,input_references,provider- Hvilke grænser gælder?
POST /v1/images/generations·recraft/recraft-v4.1-utility-pro:n.minimum:1;n.maximum:6