Recraft: Recraft V4.1 Utility Pro
Recraft V4.1 Utility Pro genereert 2K-rasterafbeeldingen met de nadruk op eenvoudige, voorspelbare scènes, vlakke belichting en een frontale compositie. Het past bij gedetailleerde productfoto's en mock-ups die een duidelijke presentatie nodig hebben in plaats van een expressieve artistieke richting.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Recraft V4.1 Utility Pro is de rastervariant met hogere resolutie van de Utility-tak binnen Recraft V4.1. De fabrikant onderscheidt de heldere presentatie van Utility van de expressievere keuzes in hoek, belichting en compositie van het hoofdmodel V4.1. Utility geeft de voorkeur aan eenvoudige scènes, vlakke belichting en frontaal weergegeven onderwerpen. Het is daardoor geschikt voor productbeelden in verkoopoverzichten, mock-ups en ander werk waarbij het object gemakkelijk te herkennen moet zijn en een rustige compositie de taak ondersteunt.
De exacte modelcode is recraftv4_1_utility_pro. De referentie van de producent vermeldt 2K-rasteruitvoer met fijnere details, in verliesvrij WebP of PNG. De formaattabel geeft 2048 × 2048 pixels voor vierkante afbeeldingen en 2432 × 1792 voor 4:3, terwijl andere ondersteunde beeldverhoudingen hun eigen afmetingen gebruiken. Dit onderscheidt Utility Pro van de 1K-uitvoer van standaard Utility. Het maakt de afbeelding niet tot een bewerkbaar vectorbestand; daarvoor levert een Vector-editie SVG.
Begin met een briefing die het object, materiaal, de kijkhoek, achtergrond en de enkele details benoemt die zichtbaar moeten zijn. Vraag voor een productvermelding om een frontaal weergegeven keramische voorraadpot op een licht, neutraal oppervlak, gelijkmatige verlichting, een gesloten deksel en duidelijke ruimte rond het silhouet. Als de scène eenvoudig moet blijven, zeg dat dan expliciet in plaats van erop te vertrouwen dat de naam Utility alle presentatiekeuzes bevat. Houd voor een reeks productbeelden de eisen voor kadrering en achtergrond gelijk en verander alleen de productbeschrijving.
De generatiereferentie van V4.1 ondersteunt prompts tot 10,000 tekens, instellingen voor voorkeurskleuren en achtergrondkleur, een willekeurige seed en één tot zes uitvoerbeelden. Een compatibele opgeslagen stijl of optionele referentieafbeeldingen kunnen het uiterlijk sturen; de speciale V4 Styles-familie is de afzonderlijke lijn waarin een stijl altijd verplicht is. Gebruik voor optionele referenties duidelijke bestanden met een overeenkomende visuele richting. Exacte kleurreproductie uit een referentie is niet gegarandeerd, dus een eis voor merkkleuren vereist nog steeds een expliciete briefing en controle van de uitvoer. Gebruik voor generatie met referentiestijl één tot tien PNG-, JPG- of WebP-afbeeldingen, samen maximaal 64 MB en elk kleiner dan 20 MB. Elke referentie moet een kortste zijde van minstens 256 pixels, een langste zijde van maximaal 4,096 pixels en een resolutie van maximaal 16 megapixels hebben. Gebruik deze referenties of een compatibele opgeslagen stijl, niet beide tegelijk. Bij generatie met referentiestijl staat flexibel afstemmen een vrijere interpretatie toe, terwijl nauwkeurig afstemmen de weergave, het palet, de compositie en belichting dichter volgt.
Recraft documenteert ook beeld-naar-beeld voor de V4.1-lijn, waarbij een bestaande afbeelding wordt gecombineerd met een prompt en een sterkte van 0 tot 1. Een lagere sterkte blijft dichter bij de bron en een hogere waarde staat een grotere wijziging toe. Dit is nuttig wanneer de uitgangscompositie of het onderwerp een nieuwe versie moet sturen. Deze transformatie accepteert geen aangepaste V4.1-stijlinstellingen binnen dezelfde bewerking. De invoerlimieten voor afbeeldingen van de producent zijn kleiner dan 20 MB, maximaal 16 MP en zijden tussen 256 en 4096 pixels.
Utility Pro deelt de V4.1-beperkingen voor de instellingen negative_prompt, vooraf geselecteerde stijlnamen, text_layout, artistic_level en no_text. Geef een positieve beschrijving van de bedoelde scène en reserveer nauwkeurig werk aan belettering of opmaak indien nodig voor een passende afwerkingsstap. Controleer een productbeeld op het aangeleverde materiaal, de vorm en noodzakelijke details voordat je het als een getrouw productbeeld behandelt. Het bruikbare resultaat is een grotere rastercompositie die is voorbereid voor een duidelijke product- of mock-upbriefing, terwijl de exacte productfeiten afkomstig blijven uit de gegevens die voor de taak zijn aangeleverd.
Ailoot Ultra · Afbeeldingen POST /v1/images/generations recraft/recraft-v4.1-utility-pro
recraft/recraft-v4.1-utility-pro
recraft/recraft-v4.1-utility-proAan de slag
Recraft V4.1 Utility Pro genereert 2K-rasterafbeeldingen met de nadruk op eenvoudige, voorspelbare scènes, vlakke belichting en een frontale compositie. Het past bij gedetailleerde productfoto's en mock-ups die een duidelijke presentatie nodig hebben in plaats van een expressieve artistieke richting.
- Toegestane invoer
- Tekst · Afbeeldingen
- Resultaten
- Afbeeldingen
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Afbeeldingen POST /v1/images/generations
- Invoertypen
text,image- Uitvoertypen
image
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten recraft/recraft-v4.1-utility-pro | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 1:1, 4:3, 3:4, 16:9, 9:16, auto | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 6 | Standaard— |
Veldinput_references | Typearray | VereisteOptioneel | Waarden en limieten Minimumaantal items: 0 Maximumaantal items: 1 | Standaard— |
Veldprovider | Typeobject | VereisteOptioneel | Waarden en limieten | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parametermaterial_types | Contracttext, image |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · de daadwerkelijk geretourneerde task_id of het record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarieven
Zo worden de uiteindelijke kosten berekend
De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij maximale redeneerinspanning de default-aanpassing wordt gebruikt
Geschatte tarieven ter vergelijking
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Rekeneenheid | Kosten |
|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Rekeneenheid— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| Configuratieuitvoerafbeelding | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper uitvoerafbeelding | Kosten Uitvoer · uitvoerafbeelding · Schatting uitsluitend ter vergelijking $0.42 per uitvoerafbeelding |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.42 schatting vóór generatie Deze schatting is geen extra bedrag of vast tarief voor de voltooide generatie. |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
Ailoot Ultra · Afbeeldingen
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
Resultaten ophalen en opslaan
Ailoot Ultra · Afbeeldingen
Download elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Lezen van andere inhoud
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.
Alle voltooide resultaten bewaren
Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Bewaar het volledige antwoord en de headers, alle daadwerkelijke uitvoer, de oorspronkelijk geretourneerde identificatoren en alle gebruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de geretourneerde X-Client-Request-ID voor reconciliatie. Lees alleen daadwerkelijk geretourneerde task_id/asset_id-waarden of de eigen mediabibliotheek uit; bouw nooit een taak-URL op basis van de bewerkings-ID en dien de aanmaakaanvraag nooit opnieuw in.
Antwoordvelden
| Veld | Type |
|---|---|
Veldcreated | Type |
Velddata[].url | Type |
Velddata[].b64_json | Type |
Veldusage | Type |
Aliasnamen
Modelaliasnamen
Ailoot Ultra recraft/recraft-v4.1-utility-pro
Aliasnamen voor methodepaden
/v1/images
Gerelateerde aanroeper-ID’s
FAQ · Recraft: Recraft V4.1 Utility Pro
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/images/generations·recraft/recraft-v4.1-utility-pro:text,image→image- Welke velden gebruikt het verzoek?
POST /v1/images/generations·recraft/recraft-v4.1-utility-pro:model,prompt,aspect_ratio,n,input_references,provider- Welke limieten gelden?
POST /v1/images/generations·recraft/recraft-v4.1-utility-pro:n.minimum:1;n.maximum:6