modellen

Recraft: Recraft V4.1 Utility

Markdown · JSON

Recraft: Recraft V4.1 Utility

Recraft V4.1 Utility genereert 1K-rasterafbeeldingen voor eenvoudige productshots, mock-ups en simpele scènes. Het geeft de voorkeur aan vlakke belichting en frontale compositie, met tekstprompts en optionele afbeeldings- of stijlinvoer voor een voorspelbare visuele 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 is het standaard Utility-rastermodel in Recrafts V4.1-familie. Het geeft de voorkeur aan eenvoudige scènes, vlakke belichting en frontale compositie boven de expressievere keuzes voor hoek, licht en sfeer van het hoofdmodel V4.1. De praktische rol is een duidelijk productshot of mock-up waarin het object en de noodzakelijke details overheersen. De specifieke Utility-editie staat los van Utility Pro, het hoofdmodel V4.1 en de vectorvarianten die SVG produceren.

De modelcode van de producent is recraftv4_1_utility. Het retourneert 1K-rasterafbeeldingen in verliesloos WebP of PNG, met formaten gekozen uit de ondersteunde beeldverhoudingen. Een vierkante afbeelding is 1024 × 1024 pixels en een 4:3-afbeelding is 1216 × 896. De Pro Utility-editie gebruikt grotere 2K-afmetingen, dus die uitvoerformaten mogen niet aan standaard Utility worden toegeschreven. Kies de vorm van de gewenste productvermelding of mock-up voordat je de scène beschrijft.

Een bruikbare briefing benoemt product, standpunt, materiaal, oppervlak, achtergrond en belichting in gewone woorden. Vraag voor een productvermelding om een frontaal getoonde thermosfles tegen een lichte achtergrond, gelijkmatig verlicht, met het volledige silhouet zichtbaar en zonder afleidende scène-elementen. Lever feitelijke afmetingen of onderscheidende onderdelen van een product expliciet aan. De voorkeur van Utility voor een eenvoudige presentatie legt geen feiten over een echt product vast die in de briefing ontbraken.

Generatie ondersteunt prompts tot 10000 tekens, instellingen voor voorkeurskleuren en achtergrondkleur, een willekeurige seed en één tot zes uitvoerafbeeldingen. Optionele compatibele aangepaste stijlen of referentieafbeeldingen kunnen de visuele taal van een catalogus sturen. Gebruik referentiebeelden die in belichting en weergave overeenstemmen en behoud dezelfde compatibele stijl voor volgende productbriefings. Een exacte kleurovereenkomst tussen referentie en uitvoer is niet gegarandeerd, dus vergelijk het uiteindelijke beeld met het vereiste palet. Gebruik voor generatie met een referentiestijl één tot tien PNG-, JPG- of WebP-afbeeldingen, samen maximaal 64 MB en elk kleiner dan 20 MB. Elke referentie vereist een kortste zijde van minimaal 256 pixels, een langste zijde van maximaal 4096 pixels en een resolutie van maximaal 16 megapixels. Gebruik deze referenties óf een compatibele opgeslagen stijl, niet beide. Bij generatie met een referentiestijl laat flexible matching een vrijere interpretatie toe, terwijl precise matching de weergave, het palet, de compositie en belichting nauwer volgt.

De afzonderlijke afbeelding-naar-afbeeldingprocedure gebruikt een bestaande afbeelding en een prompt, met een sterkte van 0 tot 1 die de mate van verandering regelt. Lagere sterkte houdt het resultaat dichter bij de bron; hogere sterkte laat het verder afwijken. Invoer kan PNG, JPG, WebP of SVG kleiner dan 20 MB zijn, maximaal 16 MP, met zijden tussen 256 en 4096 pixels. Aangepaste V4.1-stijlen worden niet geaccepteerd in die transformatieoperatie, die verschilt van het toevoegen van een stijlreferentie aan een nieuwe generatie.

V4.1 Utility accepteert geen voorgeselecteerde stijlnamen of de instellingen negative_prompt, text_layout, artistic_level of no_text. Geef de gewenste voltooide scène rechtstreeks op in de positieve prompt. Houd voor een reeks productbeelden kadrerings- en achtergrondinstructies stabiel en vergelijk vervolgens elke afbeelding met de aangeleverde productvorm, het materiaal en de details voordat je deze in een lay-out gebruikt. Standaard Utility is een gericht rasterhulpmiddel voor een ingetogen presentatie; kies het specifieke uitvoerformaat en de editie passend bij de taak.

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

recraft/recraft-v4.1-utility

Recraft /recraft/recraft-v4.1-utility

Aan de slag

Recraft V4.1 Utility genereert 1K-rasterafbeeldingen voor eenvoudige productshots, mock-ups en simpele scènes. Het geeft de voorkeur aan vlakke belichting en frontale compositie, met tekstprompts en optionele afbeeldings- of stijlinvoer voor een voorspelbare visuele 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
VeldTypeVereisteWaarden en limietenStandaard
VeldmodelTypestringVereisteVereistWaarden en limieten
recraft/recraft-v4.1-utility
Standaard—
VeldpromptTypestringVereisteVereistWaarden en limieten
Minimumlengte: 1
Standaard—
Veldaspect_ratioTypestringVereisteOptioneelWaarden en limieten
1:1, 4:3, 3:4, 16:9, 9:16, auto
Standaard—
VeldnTypeintegerVereisteOptioneelWaarden en limieten
Minimum: 1
Maximum: 6
Standaard—
Veldinput_referencesTypearrayVereisteOptioneelWaarden en limieten
Minimumaantal items: 0
Maximumaantal items: 1
Standaard—
VeldproviderTypeobjectVereisteOptioneelWaarden en limietenStandaard—
Methodeparameters en levenscyclus
ParameterContract
Parametercontent_typeContractapplication/json
ParameterrequiredContractmodel, prompt
Parametermaterial_typesContracttext, 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.

ConfiguratieTariefstaffelVerwachte hoeveelheidRekeneenheidKosten
ConfiguratieBasistarieven voor tokensTariefstaffelBasistariefVerwachte 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
ConfiguratieuitvoerafbeeldingTariefstaffel—Verwachte hoeveelheid—Rekeneenheidper uitvoerafbeeldingKosten
Uitvoer · uitvoerafbeelding · Schatting uitsluitend ter vergelijking $0.07 per uitvoerafbeelding
ConfiguratieGeschatte generatiekostenTariefstaffel—Verwachte hoeveelheidschatting voor één generatieRekeneenheid—Kosten
Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.07 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

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

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}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Lezen van andere inhoud
Bestaande eigen bestanden ophalen
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
VeldType
VeldcreatedType
Velddata[].urlType
Velddata[].b64_jsonType
VeldusageType

Aliasnamen

Modelaliasnamen

Ailoot Ultra recraft/recraft-v4.1-utility

Aliasnamen voor methodepaden

/v1/images

Gerelateerde aanroeper-ID’s

recraft/recraft-v4.1-utility

FAQ · Recraft: Recraft V4.1 Utility
Welke invoer en resultaten zijn beschikbaar?

POST /v1/images/generations · recraft/recraft-v4.1-utility: text, image → image

Welke velden gebruikt het verzoek?

POST /v1/images/generations · recraft/recraft-v4.1-utility: model, prompt, aspect_ratio, n, input_references, provider

Welke limieten gelden?

POST /v1/images/generations · recraft/recraft-v4.1-utility: n.minimum: 1; n.maximum: 6

Meer details

Verbind Ailoot met Claude Code, OpenCode, Hermes of je eigen applicatie.

Het bedrijf en zijn projectenportefeuille

Het bedrijf en zijn projectenportefeuille: miljoenen klanten; maandelijkse verkopen in de miljarden.

Koop tokens met korting.

Abonnementsvoordeel voor regelmatig gebruik. Promotiecodes geven tot 50% korting op tokens.

Abonnement
Kies een abonnement met korting voor je terugkerende verzoeken.
Promotiecode tot 50%
Vul de code bij aankoop in. De prijs wordt volgens de lopende actie herberekend.
Kosten in de geschiedenis
Model, tokens en bedrag worden per verzoek bewaard.

Kies een abonnement · Bekijk modelprijzen

Verbind de API met het product dat je verkoopt.

SaaS, apps en bots volgens de openbare aanbodvoorwaarden en licentieovereenkomst van Ailoot. Vraag voor doorverkoop een resellerlicentie aan.

Commerciële applicatie
Voeg tekst-, beeld-, video- en geluidsgeneratie aan betaalde functies van je service toe.
Resellerlicentie
Stuur een projectbeschrijving en toegangsschema. Vraag schriftelijke voorwaarden voor gebruik en doorverkoop.
Documenten op de site
Aanbodvoorwaarden, licentieovereenkomst en gegevensbeleid zijn vóór het verbinden beschikbaar.

Vraag een resellerlicentie aan · Aanbodvoorwaarden en licentieovereenkomst