Recraft: Recraft V4 Styles
Recraft V4 Styles genereert 1K-rasterafbeeldingen in een door referenties bepaalde visuele stijl. Het is ontworpen voor dagelijks merk- en campagnewerk waarbij elk nieuw onderwerp dezelfde weergave, textuur en totale uitstraling moet behouden.
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 Styles is de standaardrastereditie van Recrafts speciale familie voor stijlconsistente generatie. Het maakt een nieuwe afbeelding vanuit een tekstprompt en volgt daarbij een stijl die door referentiebeelden wordt bepaald. Het model is nuttig voor een reeks illustraties, banners of productscènes met een gedeelde herkenbare visuele behandeling. De referentie draagt weergave, textuur en kleurlogica; de prompt introduceert onderwerp en scène voor elk nieuw beeld.
De producent vermeldt 1K-rasteruitvoer in verliesloos WebP of PNG. Het vierkante formaat is 1024 × 1024 pixels en het gedocumenteerde 16:9-formaat is 1344 × 768; portret- en andere ondersteunde verhoudingen gebruiken eigen formaten. Deze editie verschilt van de 2K-rasteruitvoer van Styles Pro en de Vector-modellen die SVG produceren. Kies de beeldverhouding voor de uiteindelijke lay-out in plaats van aan te nemen dat het label 1K betekent dat elke afbeelding dezelfde breedte en hoogte heeft.
Een stijl is verplicht. Gebruik één tot tien PNG-, JPG- of WebP-referenties of een compatibele stijl die bij eerdere stijlcreatie is opgeslagen. De gedocumenteerde procedure accepteert geen opgeslagen stijl-ID en nieuwe referenties samen. Referenties kunnen bestaand merk- of campagnemateriaal zijn en hoeven niet oorspronkelijk door Recraft te zijn gegenereerd. Ze moeten kleiner dan 20 MB per bestand en samen maximaal 64 MB zijn. Er is geen afzonderlijke door de gebruiker uitgevoerde trainingstaak voordat de stijl kan worden gebruikt. Elke referentie moet een kortste zijde van minimaal 256 pixels, een langste zijde van maximaal 4096 pixels en een totale resolutie van maximaal 16 megapixels hebben.
Begin met één sterke referentie of verschillende referenties die al dezelfde visuele taal spreken. Consistente referenties helpen de stijl breder toe te passen dan op één object of houding; een ongerelateerd moodboard kan concurrerende motieven introduceren. Flexible matching is standaard en laat meer interpretatieruimte; precise matching volgt weergave, palet, compositie en belichting van de referentie nauwer. Exacte kleurreproductie is nog steeds niet gegarandeerd.
Beschrijf voor een bannerreeks een koerier die een pakket voor de voordeur neerzet, een rustige horizontale compositie en open ruimte aan één kant voor latere tekst. Volgende briefings kunnen gebeurtenis of camerahoek veranderen en dezelfde stijl behouden. De producent staat prompts tot 10000 tekens, voorkeurskleuren, een gewenste achtergrondkleur, een willekeurige seed en één tot zes afbeeldingen toe. Het ondersteunt negative_prompt, voorgeselecteerde stijlnamen of text_layout niet; beschrijf gewenst onderwerp en lay-out daarom rechtstreeks in de briefing.
De Styles-lijn biedt geen afbeelding naar afbeelding of inpainting. Een stijlreferentie stuurt een nieuw gegenereerd beeld en garandeert geen behoud van objecten of pixels uit de referentie. Pas houding, handeling, kadrering of scènedetail aan als de set repetitief oogt, in plaats van een conflicterende referentie toe te voegen. Beoordeel elk resultaat in de beoogde lay-out op duidelijkheid van het onderwerp, bruikbare ruimte en samenhangende weergave en behoud daarna dezelfde compatibele stijl voor het volgende beeld. Zo is het model praktisch voor een herhaalbare visuele taal met wisselende inhoud.
Ailoot Ultra · Afbeeldingen POST /v1/images/generations recraft/recraft-v4-styles
recraft/recraft-v4-stylesAan de slag
Recraft V4 Styles genereert 1K-rasterafbeeldingen in een door referenties bepaalde visuele stijl. Het is ontworpen voor dagelijks merk- en campagnewerk waarbij elk nieuw onderwerp dezelfde weergave, textuur en totale uitstraling moet behouden.
- 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-styles | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 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: 1 Maximumaantal items: 10 | 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 | Factureringsvoorwaarden | Kosten |
|---|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Rekeneenheid— | Factureringsvoorwaarden— | 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 |
| ConfiguratieInvoerreferentie | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper verzoek | FactureringsvoorwaardenStijlcreatie bij genereren met stijlreferenties; eenmaal per verzoek, boven op de prijs voor uitvoerafbeeldingen. | Kosten Invoer · Invoerreferentie · Schatting uitsluitend ter vergelijking $0.01 per verzoek |
| Configuratieuitvoerafbeelding | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper uitvoerafbeelding | Factureringsvoorwaarden— | Kosten Uitvoer · uitvoerafbeelding · Schatting uitsluitend ter vergelijking $0.07 per uitvoerafbeelding |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Factureringsvoorwaarden— | 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
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-styles', '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-styles
Aliasnamen voor methodepaden
/v1/images
Gerelateerde aanroeper-ID’s
FAQ · Recraft: Recraft V4 Styles
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/images/generations·recraft/recraft-v4-styles:text,image→image- Welke velden gebruikt het verzoek?
POST /v1/images/generations·recraft/recraft-v4-styles:model,prompt,aspect_ratio,n,input_references,provider- Welke limieten gelden?
POST /v1/images/generations·recraft/recraft-v4-styles:n.minimum:1;n.maximum:6