Recraft V4 is het standaardrastermodel in de V4-generatie van Recraft. De fabrikant benadrukt ontwerpbeoordeling: evenwichtige compositie, samenhangende kleurrelaties en details die de visuele bedoeling ondersteunen. Het kan werken met gestileerde illustratie, fotografische scènes en grafische ontwerpconcepten. Gebruik het wanneer de briefing een beeld vraagt dat esthetische keuzes combineert met promptnauwkeurigheid, of je nu vanuit een korte aanwijzing een sfeer verkent of een bewuste lay-out in detail vastlegt.
De specifieke modelcode is recraftv4. De producentendocumentatie vermeldt 1K-rasteruitvoer in verliesvrije WebP of PNG. Een vierkante afbeelding is 1024 × 1024 pixels, 16:9 is 1344 × 768 en 2:3 is 832 × 1280; andere ondersteunde verhoudingen gebruiken eigen afmetingen. V4 Pro is de afzonderlijke 2K-rastereditie, terwijl V4 Vector en Pro Vector bewerkbare SVG teruggeven. Kies de exacte V4-variant voor de bedoelde levering in plaats van die verschillende uitvoereigenschappen te combineren.
De fabrikantengids onderscheidt korte interpretatieve prompts van gestructureerde creatieve richting. Een korte zin kan ruimte laten om vorm, sfeer en kadrering te verkennen. Een gestructureerde briefing kan onderwerp, omgeving, houding, materiaal, secundaire elementen, belichting en visuele hiërarchie benoemen. Beschrijf voor een verhalende illustratie een fietser die een kleine brug oversteekt, krachtige vereenvoudigde vormen, warme ingetogen kleuren en een duidelijke beweging van links naar rechts. Die inhouds- en compositiekeuzes zijn bruikbaarder dan een lange lijst losse stijlbijvoeglijke naamwoorden.
Het bereik van V4 omvat illustratie, ruimtelijke beelden en fotorealistische visuals. De gids beveelt aan tekenlogica te beschrijven voor illustratie en materiaal, licht, camera en diepte voor een 3D-ogend beeld. Dat laatste blijft een rasterbeeld, geen bewerkbare mesh. Geef voor een poster- of verpakkingsconcept aan welke woorden primair zijn, waar ze horen en hoe beeld en typografie samenwerken. De fabrikant benadrukt leesbare korte en middellange tekst; controleer de daadwerkelijke woorden en opstelling in het teruggestuurde beeld voordat je het gebruikt.
Generatie ondersteunt prompts tot 10.000 tekens, een willekeurige seed, één tot zes afbeeldingen, voorkeurskleuren en een gewenste achtergrondkleur. Optionele compatibele aangepaste stijlen en referentiebeelden kunnen de visuele uitwerking via flexibele of precieze matching sturen. Kies een duidelijke referentie of een set uit één visuele wereld en laat de prompt daarna het nieuwe onderwerp en de scène beschrijven. Kleurmatching tussen referentie en uitvoer is niet gegarandeerd, dus hou het vereiste palet expliciet en vergelijk het resultaat ermee. Gebruik voor generatie met stijlreferenties één tot tien PNG-, JPG- of WebP-afbeeldingen, samen maximaal 64 MB en elk kleiner dan 20 MB. Elke referentie moet een korte zijde van minstens 256 pixels, een lange zijde van maximaal 4.096 pixels en een resolutie van maximaal 16 megapixels hebben. Gebruik die referenties of een compatibele opgeslagen stijl, niet beide.
De gedocumenteerde afbeelding-naar-afbeeldingbewerking combineert een bestaand beeld en een prompt, met sterkte van 0 tot 1 die bepaalt hoe ver de nieuwe uitvoer van de bron afwijkt. Die bewerking accepteert geen V4-stijlinstellingen. De huidige generatiedocumentatie sluit ook namen van gecureerde stijlen, negative_prompt, text_layout, artistic_level en no_text uit. Bereid een positieve beschrijving van het gewenste resultaat voor en beoordeel het beeld binnen de doelcompositie. Standaard V4 biedt een gerichte rasterinterpretatie van het ontwerp, met een specifieke editie, formaat en uitvoergrootte. Lever voor afbeelding-naar-afbeelding PNG, JPG, WebP of SVG aan, kleiner dan 20 MB, maximaal 16 megapixels, met beide zijden tussen 256 en 4.096 pixels.
", "aboutText": "Recraft V4 is het standaardrastermodel in de V4-generatie van Recraft. De fabrikant benadrukt ontwerpbeoordeling: evenwichtige compositie, samenhangende kleurrelaties en details die de visuele bedoeling ondersteunen. Het kan werken met gestileerde illustratie, fotografische scènes en grafische ontwerpconcepten. Gebruik het wanneer de briefing een beeld vraagt dat esthetische keuzes combineert met promptnauwkeurigheid, of je nu vanuit een korte aanwijzing een sfeer verkent of een bewuste lay-out in detail vastlegt.\n\nDe specifieke modelcode is recraftv4. De producentendocumentatie vermeldt 1K-rasteruitvoer in verliesvrije WebP of PNG. Een vierkante afbeelding is 1024 × 1024 pixels, 16:9 is 1344 × 768 en 2:3 is 832 × 1280; andere ondersteunde verhoudingen gebruiken eigen afmetingen. V4 Pro is de afzonderlijke 2K-rastereditie, terwijl V4 Vector en Pro Vector bewerkbare SVG teruggeven. Kies de exacte V4-variant voor de bedoelde levering in plaats van die verschillende uitvoereigenschappen te combineren.\n\nDe fabrikantengids onderscheidt korte interpretatieve prompts van gestructureerde creatieve richting. Een korte zin kan ruimte laten om vorm, sfeer en kadrering te verkennen. Een gestructureerde briefing kan onderwerp, omgeving, houding, materiaal, secundaire elementen, belichting en visuele hiërarchie benoemen. Beschrijf voor een verhalende illustratie een fietser die een kleine brug oversteekt, krachtige vereenvoudigde vormen, warme ingetogen kleuren en een duidelijke beweging van links naar rechts. Die inhouds- en compositiekeuzes zijn bruikbaarder dan een lange lijst losse stijlbijvoeglijke naamwoorden.\n\nHet bereik van V4 omvat illustratie, ruimtelijke beelden en fotorealistische visuals. De gids beveelt aan tekenlogica te beschrijven voor illustratie en materiaal, licht, camera en diepte voor een 3D-ogend beeld. Dat laatste blijft een rasterbeeld, geen bewerkbare mesh. Geef voor een poster- of verpakkingsconcept aan welke woorden primair zijn, waar ze horen en hoe beeld en typografie samenwerken. De fabrikant benadrukt leesbare korte en middellange tekst; controleer de daadwerkelijke woorden en opstelling in het teruggestuurde beeld voordat je het gebruikt.\n\nGeneratie ondersteunt prompts tot 10.000 tekens, een willekeurige seed, één tot zes afbeeldingen, voorkeurskleuren en een gewenste achtergrondkleur. Optionele compatibele aangepaste stijlen en referentiebeelden kunnen de visuele uitwerking via flexibele of precieze matching sturen. Kies een duidelijke referentie of een set uit één visuele wereld en laat de prompt daarna het nieuwe onderwerp en de scène beschrijven. Kleurmatching tussen referentie en uitvoer is niet gegarandeerd, dus hou het vereiste palet expliciet en vergelijk het resultaat ermee. Gebruik voor generatie met stijlreferenties één tot tien PNG-, JPG- of WebP-afbeeldingen, samen maximaal 64 MB en elk kleiner dan 20 MB. Elke referentie moet een korte zijde van minstens 256 pixels, een lange zijde van maximaal 4.096 pixels en een resolutie van maximaal 16 megapixels hebben. Gebruik die referenties of een compatibele opgeslagen stijl, niet beide.\n\nDe gedocumenteerde afbeelding-naar-afbeeldingbewerking combineert een bestaand beeld en een prompt, met sterkte van 0 tot 1 die bepaalt hoe ver de nieuwe uitvoer van de bron afwijkt. Die bewerking accepteert geen V4-stijlinstellingen. De huidige generatiedocumentatie sluit ook namen van gecureerde stijlen, negative_prompt, text_layout, artistic_level en no_text uit. Bereid een positieve beschrijving van het gewenste resultaat voor en beoordeel het beeld binnen de doelcompositie. Standaard V4 biedt een gerichte rasterinterpretatie van het ontwerp, met een specifieke editie, formaat en uitvoergrootte. Lever voor afbeelding-naar-afbeelding PNG, JPG, WebP of SVG aan, kleiner dan 20 MB, maximaal 16 megapixels, met beide zijden tussen 256 en 4.096 pixels.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "7f922e0259d6106d796ecd80e5eff9ecb422d45ccf898377f3d2ca5764ecdc0a", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nl-be", "methods": [ { "html": "recraft/recraft-v4Recraft V4 genereert 1K-rasterafbeeldingen met focus op compositie, kleurrelaties en gedetailleerde creatieve richting. Het omvat illustratie, fotorealistische scènes en grafische ontwerpconcepten, met optionele stijlinvoer en een afzonderlijke afbeelding-naar-afbeeldingworkflow.
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 is het standaardrastermodel in de V4-generatie van Recraft. De fabrikant benadrukt ontwerpbeoordeling: evenwichtige compositie, samenhangende kleurrelaties en details die de visuele bedoeling ondersteunen. Het kan werken met gestileerde illustratie, fotografische scènes en grafische ontwerpconcepten. Gebruik het wanneer de briefing een beeld vraagt dat esthetische keuzes combineert met promptnauwkeurigheid, of je nu vanuit een korte aanwijzing een sfeer verkent of een bewuste lay-out in detail vastlegt.
De specifieke modelcode is recraftv4. De producentendocumentatie vermeldt 1K-rasteruitvoer in verliesvrije WebP of PNG. Een vierkante afbeelding is 1024 × 1024 pixels, 16:9 is 1344 × 768 en 2:3 is 832 × 1280; andere ondersteunde verhoudingen gebruiken eigen afmetingen. V4 Pro is de afzonderlijke 2K-rastereditie, terwijl V4 Vector en Pro Vector bewerkbare SVG teruggeven. Kies de exacte V4-variant voor de bedoelde levering in plaats van die verschillende uitvoereigenschappen te combineren.
De fabrikantengids onderscheidt korte interpretatieve prompts van gestructureerde creatieve richting. Een korte zin kan ruimte laten om vorm, sfeer en kadrering te verkennen. Een gestructureerde briefing kan onderwerp, omgeving, houding, materiaal, secundaire elementen, belichting en visuele hiërarchie benoemen. Beschrijf voor een verhalende illustratie een fietser die een kleine brug oversteekt, krachtige vereenvoudigde vormen, warme ingetogen kleuren en een duidelijke beweging van links naar rechts. Die inhouds- en compositiekeuzes zijn bruikbaarder dan een lange lijst losse stijlbijvoeglijke naamwoorden.
Het bereik van V4 omvat illustratie, ruimtelijke beelden en fotorealistische visuals. De gids beveelt aan tekenlogica te beschrijven voor illustratie en materiaal, licht, camera en diepte voor een 3D-ogend beeld. Dat laatste blijft een rasterbeeld, geen bewerkbare mesh. Geef voor een poster- of verpakkingsconcept aan welke woorden primair zijn, waar ze horen en hoe beeld en typografie samenwerken. De fabrikant benadrukt leesbare korte en middellange tekst; controleer de daadwerkelijke woorden en opstelling in het teruggestuurde beeld voordat je het gebruikt.
Generatie ondersteunt prompts tot 10.000 tekens, een willekeurige seed, één tot zes afbeeldingen, voorkeurskleuren en een gewenste achtergrondkleur. Optionele compatibele aangepaste stijlen en referentiebeelden kunnen de visuele uitwerking via flexibele of precieze matching sturen. Kies een duidelijke referentie of een set uit één visuele wereld en laat de prompt daarna het nieuwe onderwerp en de scène beschrijven. Kleurmatching tussen referentie en uitvoer is niet gegarandeerd, dus hou het vereiste palet expliciet en vergelijk het resultaat ermee. Gebruik voor generatie met stijlreferenties één tot tien PNG-, JPG- of WebP-afbeeldingen, samen maximaal 64 MB en elk kleiner dan 20 MB. Elke referentie moet een korte zijde van minstens 256 pixels, een lange zijde van maximaal 4.096 pixels en een resolutie van maximaal 16 megapixels hebben. Gebruik die referenties of een compatibele opgeslagen stijl, niet beide.
De gedocumenteerde afbeelding-naar-afbeeldingbewerking combineert een bestaand beeld en een prompt, met sterkte van 0 tot 1 die bepaalt hoe ver de nieuwe uitvoer van de bron afwijkt. Die bewerking accepteert geen V4-stijlinstellingen. De huidige generatiedocumentatie sluit ook namen van gecureerde stijlen, negative_prompt, text_layout, artistic_level en no_text uit. Bereid een positieve beschrijving van het gewenste resultaat voor en beoordeel het beeld binnen de doelcompositie. Standaard V4 biedt een gerichte rasterinterpretatie van het ontwerp, met een specifieke editie, formaat en uitvoergrootte. Lever voor afbeelding-naar-afbeelding PNG, JPG, WebP of SVG aan, kleiner dan 20 MB, maximaal 16 megapixels, met beide zijden tussen 256 en 4.096 pixels.
POST /v1/images/generationstext, imageimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten recraft/recraft-v4 | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 6 | Standaard— |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 1:1, 4:3, 3:4, 16:9, 9:16, auto | Standaard— |
Veldinput_references | Typearray | VereisteOptioneel | Waarden en limieten Minimumaantal items: 0 Maximumaantal items: 1 | Standaard— |
Tekst naar afbeelding · Vereist: prompt
reference_guided_image · Vereist: prompt, actual image reference
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parametermaterial_types | Contracttext, image |
Parameteroptional_controls | Contractn, aspect_ratio, input_references |
Parametern | Contract{"minimum":1,"maximum":6} |
Parameterreference_images | Contract{"minimum":0,"maximum":1,"source":"werkelijk door de klant aangeleverd materiaal"} |
Parameterprovider_specific_options | ContractUitsluitend style/controls/text_layout uit de opgeslagen exacte lijst met toegelaten opties van het eindpunt; geen gegiste structuren. |
Methodealiasnamen: /v1/images
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · daadwerkelijk teruggegeven task_id of record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Het voorbeeld met uitsluitend een prompt behoudt de officiële structuur van ImageGenerationRequest.
Bewaar elke teruggestuurde afbeelding en het volledige antwoord; de uitvoerhoeveelheid is de werkelijke hoeveelheid en niet de gevraagde n.
De getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Rekeneenheid | Kosten |
|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte 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 |
| ConfiguratieUltra | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper uitvoerafbeelding | Kosten Uitvoer · uitvoerafbeelding · Schatting uitsluitend ter vergelijking $0.08 per uitvoerafbeelding |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.08 schatting vóór generatie Deze raming is geen extra kost 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 →
Referentiestaffels op modelniveau veranderen de methodeselectie, kostenramingen of afschrijvingen niet. Voor de actieve kostenberekening gelden de tarieven van de geselecteerde Ailoot-methode.
| Configuratie | Factureringsvoorwaarden | Kosten |
|---|---|---|
| ConfiguratieUitvoerafbeelding | FactureringsvoorwaardenEr is geen prijsvariant gedeclareerd. | Kosten Uitvoer · Uitvoerafbeelding $0.08 per afbeelding Gelijkwaardige vermeldingen beschrijven dezelfde aanrekening; ze voegen geen tweede kost toe. |
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', '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\nfrom openai import OpenAI\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")\n\nrequest={'model': 'recraft/recraft-v4', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "recraft/recraft-v4", "prompt": "a red panda astronaut floating in space, studio lighting"};\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\nDownload 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}Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Bewaar elk gegevensitem en het volledige verbruik; zorg dat alle werkelijk teruggestuurde afbeeldingen als eigen assets worden opgeslagen. Geen verzonnen URL's of ID's.
Als het resultaat van een afbeeldingsgeneratie of -bewerking gecontroleerd moet worden, bewaar dan de oorspronkelijke operation_id/X-Client-Request-ID en de teruggegeven resultaatinformatie. Haal bestaande eigen resultaten terug via de mediabibliotheek met daadwerkelijk teruggegeven task_id- of asset_id-waarden. Dien de generatie- of bewerkingsaanvraag niet opnieuw in en stel geen polling-URL samen op basis van operation_id.
| Veld | Type |
|---|---|
Veldcreated | Typeinteger |
Velddata[].url | Typestring |
Velddata[].b64_json | Typebase64 string |
Veldusage | Typeobject |
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig | Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag. |
Antwoordserver_error | VoorwaardeDe teruggegeven respons geeft aan dat de bewerking of het resultaat gecontroleerd moet worden | Volgende stapBewaar de oorspronkelijk teruggegeven bewerkings-/taak-ID, aanvraagheaders en respons; blijf de oorspronkelijke bewerking uitlezen via de ondersteunde leesaanvragen. Dien de aanmaakaanvraag niet opnieuw in. |
Ailoot Ultra recraft/recraft-v4
/v1/images