Recraft: Recraft V4 Styles
Recraft V4 Styles genererer rasterbilder i 1K i en visuell stil definert av referanser. Den er utviklet for daglig merkevare- og kampanjearbeid der hvert nye motiv skal beholde samme gjengivelse, tekstur og helhetsuttrykk.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
Recraft V4 Styles er standardrasterutgaven i Recrafts spesialiserte familie for stilkonsistent generering. Den lager et nytt bilde fra en tekstprompt og følger samtidig en stil fastsatt av referansemateriale. Modellen er nyttig for en serie illustrasjoner, bannere eller produktscener som skal dele et gjenkjennelig visuelt uttrykk. Referansen bærer gjengivelsen, teksturen og fargelogikken; prompten introduserer motivet og scenen for hvert nye bilde.
Produsenten oppgir rasterutdata i 1K som tapsfri WebP eller PNG. Kvadratisk størrelse er 1024 × 1024 piksler, og dokumentert 16:9-størrelse er 1344 × 768; stående og andre støttede sideforhold bruker egne størrelser. Denne utgaven er atskilt fra Styles Pros rasterutdata i 2K og Vector-modellene som produserer SVG. Velg sideforhold for sluttlayouten, fremfor å anta at betegnelsen 1K betyr at hvert bilde har samme bredde og høyde.
En stil er obligatorisk. Bruk ett til ti PNG-, JPG- eller WebP-referansebilder eller en kompatibel stil lagret fra tidligere stiloppretting. Den dokumenterte arbeidsflyten godtar ikke en lagret stilidentifikator og nye referanser samtidig. Referansene kan være eksisterende merkevare- eller kampanjemateriale fremfor bilder som opprinnelig ble generert av Recraft. De må være under 20 MB per fil og høyst 64 MB samlet. Det finnes ingen separat brukerutført treningsoppgave før stilen kan brukes. Hver referanse må ha en kortside på minst 256 piksler, en langside på høyst 4 096 piksler og en samlet oppløsning på høyst 16 megapiksler.
Start med én sterk referanse eller flere referanser som allerede samsvarer i det visuelle språket. Konsistente referanser bidrar til å bruke stilen utover ett objekt eller én positur; et urelatert moodboard kan innføre konkurrerende motiver. Flexible matching er standard og gir mer tolkningsrom; precise matching følger referansens gjengivelse, palett, komposisjon og lyssetting tettere. Nøyaktig fargegjengivelse er fortsatt ikke garantert.
For en bannerserie kan du beskrive et bud som plasserer en pakke på en dørstokk, en rolig horisontal komposisjon og åpen plass på én side til senere tekst. Senere beskrivelser kan endre hendelsen eller kameravinkelen og samtidig beholde samme stil. Produsenten tillater prompter på opptil 10 000 tegn, foretrukne farger, ønsket bakgrunnsfarge, en tilfeldig seed og ett til seks bilder. Den støtter ikke negative_prompt, kuraterte stilnavn eller text_layout, så beskriv ønsket motiv og layout direkte i beskrivelsen.
Styles-serien tilbyr ikke bilde-til-bilde eller utfylling av bildeområder. En stilreferanse styrer et nygenerert bilde fremfor å garantere bevaring av referansens objekter eller piksler. Hvis settet ser ensformig ut, reviderer du positur, handling, utsnitt eller scenedetaljer fremfor å legge til en motstridende referanse. Vurder hvert resultat i den tiltenkte layouten for tydelig motiv, nyttig plass og sammenhengende gjengivelse, og behold deretter samme kompatible stil for neste bilde. Dette gjør modellen praktisk for et repeterbart visuelt språk med skiftende innhold.
Ailoot Ultra · Bilder POST /v1/images/generations recraft/recraft-v4-styles
recraft/recraft-v4-stylesStart
Recraft V4 Styles genererer rasterbilder i 1K i en visuell stil definert av referanser. Den er utviklet for daglig merkevare- og kampanjearbeid der hvert nye motiv skal beholde samme gjengivelse, tekstur og helhetsuttrykk.
- Godkjente inndata
- Tekst · Bilder
- Resultater
- Bilder
Tilgjengelig i Ailoot · inndata & metoder
Ailoot Ultra · Bilder POST /v1/images/generations
- Inndatatyper
text,image- Utdatatyper
image
| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser recraft/recraft-v4-styles | Standard— |
Feltprompt | Typestring | KravPåkrevd | Verdier & grenser Minste lengde: 1 | Standard— |
Feltaspect_ratio | Typestring | KravValgfritt | Verdier & grenser 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto | Standard— |
Feltn | Typeinteger | KravValgfritt | Verdier & grenser Minimum: 1 Maksimum: 6 | Standard— |
Feltinput_references | Typearray | KravValgfritt | Verdier & grenser Minste antall elementer: 1 Maksimalt antall elementer: 10 | Standard— |
Feltprovider | Typeobject | KravValgfritt | Verdier & grenser | Standard— |
Metodeparametere og livssyklus
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, prompt |
Parametermaterial_types | Avtaletext, image |
Livssyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · faktisk returnert task_id eller oppføring i mediebiblioteket
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Slik beregnes det endelige beløpet
De viste satsene anslår kostnaden før generering. Det endelige beløpet beregnes ut fra kostnaden som er registrert for den opprinnelige genereringen. Målt varighet på utdataene og anslåtte mengder er ikke den endelige fakturerbare mengden.
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
- Hurtigmodus
- Ikke angitt Når hurtigmodus er valgt
- Flex-modus
- Ikke angitt Når flex-modus er valgt
- Maksimal resonneringsinnsats
- Ikke angitt Når justeringen «default» brukes for maksimal resonneringsinnsats
Estimerte satser for sammenligning
Priser etter konfigurasjon
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Prisplan | Forventet mengde | Faktureringsenhet | Faktureringsvilkår | Kostnad |
|---|---|---|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Forventet mengde— | Faktureringsenhet— | Faktureringsvilkår— | Kostnad Inndata · Inngående tokener · Estimat kun for sammenligning — / 1K tokener Utdata · Utgående tokener · Estimat kun for sammenligning — / 1K tokener Inndata · Lesing fra hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time · Estimat kun for sammenligning — / 1K tokener |
| KonfigurasjonInndatareferanse | Prisplan— | Forventet mengde— | Faktureringsenhetper forespørsel | FaktureringsvilkårOpprettelse av stil ved generering med stilreferanser; én gang per forespørsel, i tillegg til prisen for utdatabildet. | Kostnad Inndata · Referanse som inndata · Estimat kun for sammenligning $0.01 per forespørsel |
| Konfigurasjonutdatabilde | Prisplan— | Forventet mengde— | Faktureringsenhetper utdatabilde | Faktureringsvilkår— | Kostnad Utdata · utdatabilde · Estimat kun for sammenligning $0.07 per utdatabilde |
| KonfigurasjonAnslått genereringskostnad | Prisplan— | Forventet mengdeestimat for én generering | Faktureringsenhet— | Faktureringsvilkår— | Kostnad Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $0.07 estimat før generering Dette anslaget er verken en tilleggsavgift eller en fast sats for den fullførte genereringen. |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
Eksempelforespørsler
Ailoot Ultra · Bilder
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
Motta og lagre resultater
Ailoot Ultra · Bilder
Last ned hvert returnerte bilde eller lagre Base64-innholdet
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Andre innholdslesinger
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 ferdige resultater
Lagre hvert ferdige bilde; hent hver returnerte URL eller dekod Base64-innholdet.
Bevar hele svaret og svarhodene, alle faktiske utdata, de opprinnelige returnerte identifikatorene og alle bruksfeltene. Hent den opprinnelige operasjonen igjen uten å sende opprettelsesforespørselen på nytt.
Hvis det opprinnelige svaret må kontrolleres
Bevar returnert X-Client-Request-ID for avstemming. Les bare faktisk returnerte task_id/asset_id-verdier eller egne oppføringer i mediebiblioteket; bygg aldri en oppgave-URL fra operasjons-ID-en, og send aldri opprettelsesforespørselen på nytt.
Svarfelter
| Felt | Type |
|---|---|
Feltcreated | Type |
Feltdata[].url | Type |
Feltdata[].b64_json | Type |
Feltusage | Type |
Aliaser
Modellaliaser
Ailoot Ultra recraft/recraft-v4-styles
Aliaser for metodestier
/v1/images
Tilknyttede anroper-ID-er
FAQ · Recraft: Recraft V4 Styles
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/images/generations·recraft/recraft-v4-styles:text,image→image- Hvilke felt bruker forespørselen?
POST /v1/images/generations·recraft/recraft-v4-styles:model,prompt,aspect_ratio,n,input_references,provider- Hvilke grenser gjelder?
POST /v1/images/generations·recraft/recraft-v4-styles:n.minimum:1;n.maximum:6