Recraft V4.1 Utility er standardmodellen til rasterbilleder i Utility-grenen af Recrafts V4.1-familie. Den foretrækker enkle scener, jævn belysning og komposition set forfra frem for hovedmodellen V4.1's mere udtryksfulde valg af vinkel, lys og stemning. Dens praktiske rolle er en tydelig produktoptagelse eller mockup, hvor genstanden og nødvendige detaljer skal dominere. Den konkrete Utility-udgave er adskilt fra Utility Pro, hovedmodellen V4.1 og de vektorvarianter, der leverer SVG.
Producentens modelkode er recraftv4_1_utility. Den returnerer rasterbilleder i 1K som tabsfri WebP eller PNG med størrelser valgt blandt de understøttede billedformater. Et kvadratisk billede er 1024 × 1024 pixels, og et 4:3-billede er 1216 × 896. Pro Utility-udgaven bruger større 2K-dimensioner, så disse outputstørrelser bør ikke tildeles standardudgaven Utility. Vælg formen til den ønskede produktvisning eller mockup, før du beskriver scenen.
En nyttig beskrivelse navngiver produkt, synsvinkel, materiale, overflade, baggrund og belysning i enkle vendinger. Til en produktvisning kan du bede om en termoflaske set forfra på en lys baggrund, jævnt belyst, med hele silhuetten synlig og uden forstyrrende sceneelementer. Hvis et produkt har faktiske dimensioner eller karakteristiske dele, skal du angive disse detaljer udtrykkeligt. Utilitys præference for ligefrem præsentation fastslår ikke fakta om et virkeligt produkt, som manglede i beskrivelsen.
Generering understøtter prompts på op til 10.000 tegn, kontroller for foretrukne farver og baggrundsfarve, et tilfældigt seed og ét til seks output. Valgfrie kompatible brugerdefinerede stilarter eller referencebilleder kan styre et katalogs visuelle sprog. Brug referencematerialer, der stemmer overens i belysning og gengivelse, og bevar samme kompatible stil til efterfølgende produktbeskrivelser. Præcist farvematch fra reference til output er ikke garanteret, så sammenlign det færdige billede med den nødvendige palet. 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.
Den separate billede-til-billede-arbejdsgang bruger et eksisterende billede og en prompt med en styrke fra 0 til 1, der styrer omfanget af ændringen. Lavere styrke holder resultatet tættere på kilden; højere styrke lader det bevæge sig længere væk. Input kan være PNG, JPG, WebP eller SVG under 20 MB, op til 16 MP og med sider mellem 256 og 4096 pixels. Brugerdefinerede V4.1-stilarter accepteres ikke i denne transformationsoperation, som er adskilt fra at tilknytte en stilreference til en ny generering.
V4.1 Utility accepterer ikke kuraterede stilnavne eller kontrollerne negative_prompt, text_layout, artistic_level eller no_text. Beskriv den ønskede færdige scene direkte i den positive prompt. Ved en serie produktmaterialer skal du holde anvisninger om indramning og baggrund stabile og derefter sammenligne hvert billede med den medsendte produktform, materialet og detaljerne, før du bruger det i et layout. Standardudgaven Utility er et fokuseret rasterværktøj til en behersket præsentation; vælg det konkrete outputformat og den udgave, der passer til opgaven.
", "aboutText": "Recraft V4.1 Utility er standardmodellen til rasterbilleder i Utility-grenen af Recrafts V4.1-familie. Den foretrækker enkle scener, jævn belysning og komposition set forfra frem for hovedmodellen V4.1's mere udtryksfulde valg af vinkel, lys og stemning. Dens praktiske rolle er en tydelig produktoptagelse eller mockup, hvor genstanden og nødvendige detaljer skal dominere. Den konkrete Utility-udgave er adskilt fra Utility Pro, hovedmodellen V4.1 og de vektorvarianter, der leverer SVG.\n\nProducentens modelkode er recraftv4_1_utility. Den returnerer rasterbilleder i 1K som tabsfri WebP eller PNG med størrelser valgt blandt de understøttede billedformater. Et kvadratisk billede er 1024 × 1024 pixels, og et 4:3-billede er 1216 × 896. Pro Utility-udgaven bruger større 2K-dimensioner, så disse outputstørrelser bør ikke tildeles standardudgaven Utility. Vælg formen til den ønskede produktvisning eller mockup, før du beskriver scenen.\n\nEn nyttig beskrivelse navngiver produkt, synsvinkel, materiale, overflade, baggrund og belysning i enkle vendinger. Til en produktvisning kan du bede om en termoflaske set forfra på en lys baggrund, jævnt belyst, med hele silhuetten synlig og uden forstyrrende sceneelementer. Hvis et produkt har faktiske dimensioner eller karakteristiske dele, skal du angive disse detaljer udtrykkeligt. Utilitys præference for ligefrem præsentation fastslår ikke fakta om et virkeligt produkt, som manglede i beskrivelsen.\n\nGenerering understøtter prompts på op til 10.000 tegn, kontroller for foretrukne farver og baggrundsfarve, et tilfældigt seed og ét til seks output. Valgfrie kompatible brugerdefinerede stilarter eller referencebilleder kan styre et katalogs visuelle sprog. Brug referencematerialer, der stemmer overens i belysning og gengivelse, og bevar samme kompatible stil til efterfølgende produktbeskrivelser. Præcist farvematch fra reference til output er ikke garanteret, så sammenlign det færdige billede med den nødvendige palet. 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.\n\nDen separate billede-til-billede-arbejdsgang bruger et eksisterende billede og en prompt med en styrke fra 0 til 1, der styrer omfanget af ændringen. Lavere styrke holder resultatet tættere på kilden; højere styrke lader det bevæge sig længere væk. Input kan være PNG, JPG, WebP eller SVG under 20 MB, op til 16 MP og med sider mellem 256 og 4096 pixels. Brugerdefinerede V4.1-stilarter accepteres ikke i denne transformationsoperation, som er adskilt fra at tilknytte en stilreference til en ny generering.\n\nV4.1 Utility accepterer ikke kuraterede stilnavne eller kontrollerne negative_prompt, text_layout, artistic_level eller no_text. Beskriv den ønskede færdige scene direkte i den positive prompt. Ved en serie produktmaterialer skal du holde anvisninger om indramning og baggrund stabile og derefter sammenligne hvert billede med den medsendte produktform, materialet og detaljerne, før du bruger det i et layout. Standardudgaven Utility er et fokuseret rasterværktøj til en behersket præsentation; vælg det konkrete outputformat og den udgave, der passer til opgaven.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "603bc408886d0c0945000b30634b76071a49abef58d7a329bbc8d036a107a5af", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "da", "methods": [ { "html": "recraft/recraft-v4.1-utilityRecraft V4.1 Utility genererer rasterbilleder i 1K til ligefremme produktoptagelser, mockups og enkle scener. Den foretrækker jævn belysning og en komposition set forfra med tekstprompts og valgfrie billed- eller stilinput til en forudsigelig visuel retning.
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 er standardmodellen til rasterbilleder i Utility-grenen af Recrafts V4.1-familie. Den foretrækker enkle scener, jævn belysning og komposition set forfra frem for hovedmodellen V4.1's mere udtryksfulde valg af vinkel, lys og stemning. Dens praktiske rolle er en tydelig produktoptagelse eller mockup, hvor genstanden og nødvendige detaljer skal dominere. Den konkrete Utility-udgave er adskilt fra Utility Pro, hovedmodellen V4.1 og de vektorvarianter, der leverer SVG.
Producentens modelkode er recraftv4_1_utility. Den returnerer rasterbilleder i 1K som tabsfri WebP eller PNG med størrelser valgt blandt de understøttede billedformater. Et kvadratisk billede er 1024 × 1024 pixels, og et 4:3-billede er 1216 × 896. Pro Utility-udgaven bruger større 2K-dimensioner, så disse outputstørrelser bør ikke tildeles standardudgaven Utility. Vælg formen til den ønskede produktvisning eller mockup, før du beskriver scenen.
En nyttig beskrivelse navngiver produkt, synsvinkel, materiale, overflade, baggrund og belysning i enkle vendinger. Til en produktvisning kan du bede om en termoflaske set forfra på en lys baggrund, jævnt belyst, med hele silhuetten synlig og uden forstyrrende sceneelementer. Hvis et produkt har faktiske dimensioner eller karakteristiske dele, skal du angive disse detaljer udtrykkeligt. Utilitys præference for ligefrem præsentation fastslår ikke fakta om et virkeligt produkt, som manglede i beskrivelsen.
Generering understøtter prompts på op til 10.000 tegn, kontroller for foretrukne farver og baggrundsfarve, et tilfældigt seed og ét til seks output. Valgfrie kompatible brugerdefinerede stilarter eller referencebilleder kan styre et katalogs visuelle sprog. Brug referencematerialer, der stemmer overens i belysning og gengivelse, og bevar samme kompatible stil til efterfølgende produktbeskrivelser. Præcist farvematch fra reference til output er ikke garanteret, så sammenlign det færdige billede med den nødvendige palet. 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.
Den separate billede-til-billede-arbejdsgang bruger et eksisterende billede og en prompt med en styrke fra 0 til 1, der styrer omfanget af ændringen. Lavere styrke holder resultatet tættere på kilden; højere styrke lader det bevæge sig længere væk. Input kan være PNG, JPG, WebP eller SVG under 20 MB, op til 16 MP og med sider mellem 256 og 4096 pixels. Brugerdefinerede V4.1-stilarter accepteres ikke i denne transformationsoperation, som er adskilt fra at tilknytte en stilreference til en ny generering.
V4.1 Utility accepterer ikke kuraterede stilnavne eller kontrollerne negative_prompt, text_layout, artistic_level eller no_text. Beskriv den ønskede færdige scene direkte i den positive prompt. Ved en serie produktmaterialer skal du holde anvisninger om indramning og baggrund stabile og derefter sammenligne hvert billede med den medsendte produktform, materialet og detaljerne, før du bruger det i et layout. Standardudgaven Utility er et fokuseret rasterværktøj til en behersket præsentation; vælg det konkrete outputformat og den udgave, der passer til opgaven.
POST /v1/images/generationstext, imageimage| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser recraft/recraft-v4.1-utility | 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— |
| 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}
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.
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.07 pr. outputbillede |
| KonfigurationAnslået genereringsomkostning | Takstplan— | Forventet mængdeestimat for én generering | Afregningsenhed— | Beløb Output · Anslået genereringsomkostning · Estimat kun til sammenligning $0.07 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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'recraft/recraft-v4.1-utility', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nHent 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}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nGem 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.
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.
| Felt | Type |
|---|---|
Feltcreated | Type |
Feltdata[].url | Type |
Feltdata[].b64_json | Type |
Feltusage | Type |
Ailoot Ultra recraft/recraft-v4.1-utility
/v1/images