Recraft V4.1 Utility je standardni rastrski model Utility v družini Recraft V4.1. Daje prednost preprostim prizorom, enakomerni osvetlitvi in čelni kompoziciji, medtem ko glavni model V4.1 izbira izrazitejše kote, svetlobo in vzdušje. Njegova praktična vloga je jasna fotografija izdelka ali maketa, v kateri prevladujejo predmet in potrebne podrobnosti. Ta izdaja Utility je ločena od modelov Utility Pro, glavnega V4.1 in vektorskih različic, ki ustvarjajo SVG.
Proizvajalčeva oznaka modela je recraftv4_1_utility. Vrača rastrske slike 1K v formatu WebP brez izgub ali PNG, z velikostmi, izbranimi med podprtimi razmerji stranic. Kvadratna slika meri 1024 × 1024 slikovnih pik, slika v razmerju 4:3 pa 1216 × 896. Izdaja Pro Utility uporablja večje dimenzije 2K, zato teh izhodnih velikosti ne smemo pripisati standardni izdaji Utility. Pred opisom prizora izberite obliko, ki ustreza predvideni predstavitvi izdelka ali maketi.
Uporaben opis v preprostih besedah navede izdelek, zorni kot, material, podlago, ozadje in osvetlitev. Za predstavitev izdelka zahtevajte čelni pogled na izolirano steklenico na svetlem ozadju, z enakomerno osvetlitvijo, vidnim celotnim obrisom in brez motečih elementov prizora. Če ima izdelek dejanske dimenzije ali značilne sestavne dele, te podatke izrecno navedite. Nagnjenost modela Utility k preprosti predstavitvi ne določa dejstev o resničnem izdelku, ki jih v opisu ni bilo.
Ustvarjanje podpira pozive do 10.000 znakov, nastavitve želenih barv in barve ozadja, naključno seme ter od enega do šest izhodov. Izbirni združljivi slogi po meri ali referenčne slike lahko usmerjajo vizualni jezik kataloga. Uporabite reference, ki se ujemajo v osvetlitvi in načinu upodobitve, ter isti združljivi slog ohranite pri naslednjih opisih izdelkov. Natančno ujemanje barv med referenco in izhodom ni zagotovljeno, zato končno podobo primerjajte z zahtevano paleto. Za ustvarjanje po referenčnem slogu uporabite od ene do deset slik PNG, JPG ali WebP, skupaj največ 64 MB, pri čemer mora biti vsaka manjša od 20 MB. Najkrajša stranica vsake reference mora meriti vsaj 256 slikovnih pik, najdaljša največ 4.096 slikovnih pik, ločljivost pa ne sme presegati 16 milijonov slikovnih pik. Uporabite bodisi te reference bodisi združljiv shranjeni slog, ne obojega hkrati. Pri ustvarjanju po referenčnem slogu prilagodljivo ujemanje dopušča svobodnejšo interpretacijo, natančno ujemanje pa tesneje sledi upodobitvi, paleti, kompoziciji in osvetlitvi.
Ločen postopek pretvorbe slike v sliko uporablja obstoječo sliko in poziv, pri čemer moč od 0 do 1 določa obseg spremembe. Nižja moč ohrani rezultat bližje izvirniku, višja pa dopušča večji odmik. Vhod je lahko PNG, JPG, WebP ali SVG, manjši od 20 MB, z največ 16 MP in stranicama med 256 in 4096 slikovnimi pikami. Ta postopek preoblikovanja ne sprejema slogov po meri za V4.1 in se razlikuje od dodajanja slogovne reference novemu ustvarjanju.
V4.1 Utility ne sprejema imen predpripravljenih slogov ali nastavitev negative_prompt, text_layout, artistic_level in no_text. Želeni končni prizor opišite neposredno v pozitivnem pozivu. Pri seriji slik izdelkov ohranite enaka navodila za kadriranje in ozadje, nato pa vsako sliko primerjajte s podano obliko, materialom in podrobnostmi izdelka, preden jo uporabite v postavitvi. Standardni Utility je namensko rastrsko orodje za zadržano predstavitev; konkretni izhodni format in izdajo izberite glede na nalogo.
", "aboutText": "Recraft V4.1 Utility je standardni rastrski model Utility v družini Recraft V4.1. Daje prednost preprostim prizorom, enakomerni osvetlitvi in čelni kompoziciji, medtem ko glavni model V4.1 izbira izrazitejše kote, svetlobo in vzdušje. Njegova praktična vloga je jasna fotografija izdelka ali maketa, v kateri prevladujejo predmet in potrebne podrobnosti. Ta izdaja Utility je ločena od modelov Utility Pro, glavnega V4.1 in vektorskih različic, ki ustvarjajo SVG.\n\nProizvajalčeva oznaka modela je recraftv4_1_utility. Vrača rastrske slike 1K v formatu WebP brez izgub ali PNG, z velikostmi, izbranimi med podprtimi razmerji stranic. Kvadratna slika meri 1024 × 1024 slikovnih pik, slika v razmerju 4:3 pa 1216 × 896. Izdaja Pro Utility uporablja večje dimenzije 2K, zato teh izhodnih velikosti ne smemo pripisati standardni izdaji Utility. Pred opisom prizora izberite obliko, ki ustreza predvideni predstavitvi izdelka ali maketi.\n\nUporaben opis v preprostih besedah navede izdelek, zorni kot, material, podlago, ozadje in osvetlitev. Za predstavitev izdelka zahtevajte čelni pogled na izolirano steklenico na svetlem ozadju, z enakomerno osvetlitvijo, vidnim celotnim obrisom in brez motečih elementov prizora. Če ima izdelek dejanske dimenzije ali značilne sestavne dele, te podatke izrecno navedite. Nagnjenost modela Utility k preprosti predstavitvi ne določa dejstev o resničnem izdelku, ki jih v opisu ni bilo.\n\nUstvarjanje podpira pozive do 10.000 znakov, nastavitve želenih barv in barve ozadja, naključno seme ter od enega do šest izhodov. Izbirni združljivi slogi po meri ali referenčne slike lahko usmerjajo vizualni jezik kataloga. Uporabite reference, ki se ujemajo v osvetlitvi in načinu upodobitve, ter isti združljivi slog ohranite pri naslednjih opisih izdelkov. Natančno ujemanje barv med referenco in izhodom ni zagotovljeno, zato končno podobo primerjajte z zahtevano paleto. Za ustvarjanje po referenčnem slogu uporabite od ene do deset slik PNG, JPG ali WebP, skupaj največ 64 MB, pri čemer mora biti vsaka manjša od 20 MB. Najkrajša stranica vsake reference mora meriti vsaj 256 slikovnih pik, najdaljša največ 4.096 slikovnih pik, ločljivost pa ne sme presegati 16 milijonov slikovnih pik. Uporabite bodisi te reference bodisi združljiv shranjeni slog, ne obojega hkrati. Pri ustvarjanju po referenčnem slogu prilagodljivo ujemanje dopušča svobodnejšo interpretacijo, natančno ujemanje pa tesneje sledi upodobitvi, paleti, kompoziciji in osvetlitvi.\n\nLočen postopek pretvorbe slike v sliko uporablja obstoječo sliko in poziv, pri čemer moč od 0 do 1 določa obseg spremembe. Nižja moč ohrani rezultat bližje izvirniku, višja pa dopušča večji odmik. Vhod je lahko PNG, JPG, WebP ali SVG, manjši od 20 MB, z največ 16 MP in stranicama med 256 in 4096 slikovnimi pikami. Ta postopek preoblikovanja ne sprejema slogov po meri za V4.1 in se razlikuje od dodajanja slogovne reference novemu ustvarjanju.\n\nV4.1 Utility ne sprejema imen predpripravljenih slogov ali nastavitev negative_prompt, text_layout, artistic_level in no_text. Želeni končni prizor opišite neposredno v pozitivnem pozivu. Pri seriji slik izdelkov ohranite enaka navodila za kadriranje in ozadje, nato pa vsako sliko primerjajte s podano obliko, materialom in podrobnostmi izdelka, preden jo uporabite v postavitvi. Standardni Utility je namensko rastrsko orodje za zadržano predstavitev; konkretni izhodni format in izdajo izberite glede na nalogo.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "b6097ab313ccd10dbf4f115b9ed3a7f734d8222754866fc90a24898c9fa4d47c", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "sl", "methods": [ { "html": "recraft/recraft-v4.1-utilityRecraft V4.1 Utility ustvarja rastrske slike 1K za preproste fotografije izdelkov, makete in nezapletene prizore. Daje prednost enakomerni osvetlitvi in čelni kompoziciji, z besedilnimi pozivi ter izbirnimi slikovnimi ali slogovnimi vhodi pa omogoča predvidljivo vizualno usmeritev.
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
Recraft V4.1 Utility je standardni rastrski model Utility v družini Recraft V4.1. Daje prednost preprostim prizorom, enakomerni osvetlitvi in čelni kompoziciji, medtem ko glavni model V4.1 izbira izrazitejše kote, svetlobo in vzdušje. Njegova praktična vloga je jasna fotografija izdelka ali maketa, v kateri prevladujejo predmet in potrebne podrobnosti. Ta izdaja Utility je ločena od modelov Utility Pro, glavnega V4.1 in vektorskih različic, ki ustvarjajo SVG.
Proizvajalčeva oznaka modela je recraftv4_1_utility. Vrača rastrske slike 1K v formatu WebP brez izgub ali PNG, z velikostmi, izbranimi med podprtimi razmerji stranic. Kvadratna slika meri 1024 × 1024 slikovnih pik, slika v razmerju 4:3 pa 1216 × 896. Izdaja Pro Utility uporablja večje dimenzije 2K, zato teh izhodnih velikosti ne smemo pripisati standardni izdaji Utility. Pred opisom prizora izberite obliko, ki ustreza predvideni predstavitvi izdelka ali maketi.
Uporaben opis v preprostih besedah navede izdelek, zorni kot, material, podlago, ozadje in osvetlitev. Za predstavitev izdelka zahtevajte čelni pogled na izolirano steklenico na svetlem ozadju, z enakomerno osvetlitvijo, vidnim celotnim obrisom in brez motečih elementov prizora. Če ima izdelek dejanske dimenzije ali značilne sestavne dele, te podatke izrecno navedite. Nagnjenost modela Utility k preprosti predstavitvi ne določa dejstev o resničnem izdelku, ki jih v opisu ni bilo.
Ustvarjanje podpira pozive do 10.000 znakov, nastavitve želenih barv in barve ozadja, naključno seme ter od enega do šest izhodov. Izbirni združljivi slogi po meri ali referenčne slike lahko usmerjajo vizualni jezik kataloga. Uporabite reference, ki se ujemajo v osvetlitvi in načinu upodobitve, ter isti združljivi slog ohranite pri naslednjih opisih izdelkov. Natančno ujemanje barv med referenco in izhodom ni zagotovljeno, zato končno podobo primerjajte z zahtevano paleto. Za ustvarjanje po referenčnem slogu uporabite od ene do deset slik PNG, JPG ali WebP, skupaj največ 64 MB, pri čemer mora biti vsaka manjša od 20 MB. Najkrajša stranica vsake reference mora meriti vsaj 256 slikovnih pik, najdaljša največ 4.096 slikovnih pik, ločljivost pa ne sme presegati 16 milijonov slikovnih pik. Uporabite bodisi te reference bodisi združljiv shranjeni slog, ne obojega hkrati. Pri ustvarjanju po referenčnem slogu prilagodljivo ujemanje dopušča svobodnejšo interpretacijo, natančno ujemanje pa tesneje sledi upodobitvi, paleti, kompoziciji in osvetlitvi.
Ločen postopek pretvorbe slike v sliko uporablja obstoječo sliko in poziv, pri čemer moč od 0 do 1 določa obseg spremembe. Nižja moč ohrani rezultat bližje izvirniku, višja pa dopušča večji odmik. Vhod je lahko PNG, JPG, WebP ali SVG, manjši od 20 MB, z največ 16 MP in stranicama med 256 in 4096 slikovnimi pikami. Ta postopek preoblikovanja ne sprejema slogov po meri za V4.1 in se razlikuje od dodajanja slogovne reference novemu ustvarjanju.
V4.1 Utility ne sprejema imen predpripravljenih slogov ali nastavitev negative_prompt, text_layout, artistic_level in no_text. Želeni končni prizor opišite neposredno v pozitivnem pozivu. Pri seriji slik izdelkov ohranite enaka navodila za kadriranje in ozadje, nato pa vsako sliko primerjajte s podano obliko, materialom in podrobnostmi izdelka, preden jo uporabite v postavitvi. Standardni Utility je namensko rastrsko orodje za zadržano predstavitev; konkretni izhodni format in izdajo izberite glede na nalogo.
POST /v1/images/generationstext, imageimage| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve recraft/recraft-v4.1-utility | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Najmanjša dolžina: 1 | Privzeto— |
Poljeaspect_ratio | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 1:1, 4:3, 3:4, 16:9, 9:16, auto | Privzeto— |
Poljen | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 Največ: 6 | Privzeto— |
Poljeinput_references | Vrstaarray | ZahtevaIzbirno | Vrednosti in omejitve Najmanjše število elementov: 0 Največ elementov: 1 | Privzeto— |
Poljeprovider | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, prompt |
Parametermaterial_types | Specifikacijatext, image |
Življenjski cikel: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Dejansko vrnjeni task_id ali zapis v medijski knjižnici
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.
Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.
Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.
| Nastavitev | Cenovna lestvica | Predvidena količina | Obračunska enota | Strošek |
|---|---|---|---|---|
| NastavitevOsnovne cene žetonov | Cenovna lestvicaOsnovna cena | Predvidena količina— | Obračunska enota— | Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo — / 1K žetonov |
| Nastavitevizhodna slika | Cenovna lestvica— | Predvidena količina— | Obračunska enotana izhodno sliko | Strošek Izhod · izhodna slika · Ocena samo za primerjavo $0.07 na izhodno sliko |
| NastavitevOcenjeni strošek ustvarjanja | Cenovna lestvica— | Predvidena količinaocena za eno generiranje | Obračunska enota— | Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $0.07 ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje. |
Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →
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\nPrenesite vsako vrnjeno sliko ali shranite njeno vsebino Base64
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.\nShranite vsako dokončano sliko; pridobite vsebino z vsake vrnjene URL ali dekodirajte njeno vsebino Base64.
Shranite celoten odgovor in glave, vse dejanske izhode, izvirne vrnjene identifikatorje in vsa polja s podatki o porabi. Pridobite podatke izvirne operacije brez ponovnega pošiljanja zahteve za ustvarjanje.
Shranite vrnjeni X-Client-Request-ID za uskladitev evidenc. Berite samo dejansko vrnjene vrednosti task_id/asset_id ali svojo medijsko knjižnico; iz ID operacije nikoli ne sestavite URL opravila in zahteve za ustvarjanje nikoli ne pošljite znova.
| Polje | Vrsta |
|---|---|
Poljecreated | Vrsta |
Poljedata[].url | Vrsta |
Poljedata[].b64_json | Vrsta |
Poljeusage | Vrsta |
Ailoot Ultra recraft/recraft-v4.1-utility
/v1/images