Recraft V3 is een afbeeldingsgeneratiemodel voor grafisch ontwerp én fotografische en geïllustreerde scènes. Een geschreven briefing beschrijft onderwerp, omgeving en compositie; het resultaat is een afbeelding. V3 ontwikkelt Recrafts tekstweergave en fotorealisme verder en behoudt stijlconsistentie vanuit voorbeeldafbeeldingen zonder opnieuw te trainen.
V3 werkt met tekst in de afbeelding, waaronder langere tekst en middelgrote letters. Recraft beschrijft een lay-outfase die woorden en hun posities vóór de afbeeldingsgeneratie vastlegt. De lay-out kan automatisch vanuit de briefing worden gemaakt of handmatig in Recrafts ontwerpomgeving worden ingedeeld. Dit helpt een kop, illustratie en ondersteunende tekst in één compositie te verbinden. De fabrikant documenteert ook expliciete tekstlay-outcoördinaten, uitgedrukt ten opzichte van de afbeelding en niet als een vast pixelraster. Elk tekstelement bevat één woord en vier hoekpunten in genormaliseerde coördinaten: (0, 0) is linksboven en (1, 1) rechtsonder. Coördinaten mogen buiten dat bereik vallen, waarbij de vorm wordt afgesneden. Woorden in expliciete tekstlay-outs moeten de gedocumenteerde tekenbeperkingen volgen.
Lever voor een poster of cover de exacte tekst aan en beschrijf de hiërarchie: welke regel leidt, waar die staat en hoe het beeld die ondersteunt. Controleer weergegeven spelling en spatiëring bij de keuze van een resultaat.
V3 bevat voorgeselecteerde stijlen voor fotografie, illustratie en emblemen, plus een afzonderlijke vectorstijlbibliotheek. Recraft V3 Raw is de standaardstijl van het rastermodel; Vector art is de standaard voor de vectorvariant. Photorealism beoogt een fotografisch uiterlijk, terwijl Illustration gestileerde texturen, schaduwwerking en complexere kleurovergangen omvat. Vectorstijlen geven de voorkeur aan vormen, beperkte paletten en vlakke vullingen of eenvoudige verlopen.
Aangepaste stijlen kunnen vanuit referentieafbeeldingen, bestaande compatibele stijlen of een combinatie worden opgebouwd. Ze geven een herbruikbare visuele richting over een afbeeldingsreeks heen. De gedocumenteerde menginstellingen laten referenties en bronstijlen afzonderlijke gewichten dragen; het aantal gewichten komt overeen met de bronnen. PaletteMatch en MaxWeight zijn de twee vermelde mengbeleidsopties. De fabrikant staat maximaal 10 stijlreferentieafbeeldingen toe en gebruikt de gewone style-match-modus voor V3. Een opgeslagen aangepaste stijl en directe stijlreferenties zijn alternatieve invoeren en een aangepaste stijl moet passen bij het model dat voor generatie wordt gebruikt.
Voorkeurskleuren en een achtergrondkleur sturen het palet. Maximaal 10 RGB-kleuren zijn gedocumenteerd, met elke component van 0 tot 255. Optionele relatieve gewichten lopen van 0 tot 1; ze moeten voor elke kleur of voor geen enkele worden opgegeven en hun totaal mag niet hoger zijn dan 1. Artistic level loopt van 0 voor een statische, rustige behandeling tot 5 voor dynamischere, excentriekere composities. Een negatieve prompt beschrijft ongewenste elementen; een afzonderlijke instelling zonder tekst schakelt ingebedde tekstlay-outs uit. Een willekeurige seed is beschikbaar voor reproduceerbaarheid. Deze instellingen bieden verschillende aangrijpingspunten voor de scène, de stijl en de visuele lay-out.
Recraft documenteert twee V3-varianten. Het rastermodel produceert verliesloos WebP of PNG en is geschikt voor fotografisch detail, schaduwwerking en illustraties met textuur. Recraft V3 Vector produceert SVG: paden en vormen die zonder vaste pixelresolutie kunnen schalen. Het past bij pictogrammen, logoconcepten, badges en gedetailleerd vectorwerk. Raster-naar-vectorconversie is een afzonderlijke operatie ten opzichte van het rechtstreeks genereren van vectorbeelden.
Beide varianten hebben hun eigen identiteit. Een afbeelding met een vectorachtig uiterlijk en daadwerkelijke SVG-uitvoer zijn verschillende keuzes. Kies de gewenste uitvoer bij het voorbereiden van een ontwerpprocedure, in plaats van de gedeelde V3-naam te behandelen als bewijs dat elke operatie hetzelfde bestandstype retourneert.
Recrafts V3-documentatie vermeldt afbeelding-naar-afbeeldinggeneratie, inpainting, outpainting en achtergrondvervanging of -generatie. Afbeelding-naar-afbeeldingwerk combineert een bestaande afbeelding met een nieuwe briefing. Inpainting genereert het gekozen gebied opnieuw met een afbeelding en bijpassend masker; outpainting voegt inhoud buiten het oorspronkelijke kader toe. Achtergrondoperaties behandelen de omgeving van een onderwerp.
De bijbehorende gereedschapsset omvat ook wissen, achtergrondverwijdering, vectorisatie en twee vergrotingsmethoden. Creatieve vergroting kan nieuwe details toevoegen; scherpe vergroting beoogt een scherpere grotere weergave van bestaande inhoud. Dit zijn afzonderlijke operaties met eigen invoer en resultaten en geen aanvullende betekenissen van de raster- of vectormodelnaam.
De V3-generatiespecificatie van de fabrikant accepteert een prompt tot 1000 tekens en 1–6 afbeeldingen per aanvraag. Ze ondersteunt 14 beeldverhoudingen: 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 6:10, 14:10, 10:14, 16:9 en 9:16. Gedocumenteerde rastervoorbeelden omvatten 1024x1024, 1820x1024 en 1024x1820. Exacte rasterafmetingen moeten uit de ondersteunde lijst komen; SVG gebruikt beeldverhoudingen zonder vaste pixelafmeting. Als formaat wordt weggelaten, kiest het systeem van de fabrikant dit op basis van de prompt.
Voor operaties met afbeeldingsinvoer vermeldt de fabrikant PNG, JPG en WebP, met SVG waar de specifieke operatie dat toestaat. Bestanden moeten kleiner zijn dan 20 MB, maximaal 16 MP, met een langste zijde van maximaal 4096 pixels. De kortste zijde is minimaal 256 pixels, met een uitzondering van 32 pixels voor scherpe vergroting. Maskers komen overeen met het afbeeldingsformaat en gebruiken puur zwart en wit; stijlreferenties hebben een gezamenlijke limiet van 64 MB.
Zet voor een Ailoot API-project de taak om in een gerichte afbeeldingsbriefing: exacte tekst, objectindeling, visuele stijl en gewenste compositie. Een poster, productscène en iconenreeks vragen om verschillende briefings; behoud de relevante verschillen tussen V3-varianten en operaties wanneer je bepaalt hoe elk resultaat wordt gebruikt.
", "aboutText": "Recraft V3 is een afbeeldingsgeneratiemodel voor grafisch ontwerp én fotografische en geïllustreerde scènes. Een geschreven briefing beschrijft onderwerp, omgeving en compositie; het resultaat is een afbeelding. V3 ontwikkelt Recrafts tekstweergave en fotorealisme verder en behoudt stijlconsistentie vanuit voorbeeldafbeeldingen zonder opnieuw te trainen.\n\n### Tekst als onderdeel van de compositie\n\nV3 werkt met tekst in de afbeelding, waaronder langere tekst en middelgrote letters. Recraft beschrijft een lay-outfase die woorden en hun posities vóór de afbeeldingsgeneratie vastlegt. De lay-out kan automatisch vanuit de briefing worden gemaakt of handmatig in Recrafts ontwerpomgeving worden ingedeeld. Dit helpt een kop, illustratie en ondersteunende tekst in één compositie te verbinden. De fabrikant documenteert ook expliciete tekstlay-outcoördinaten, uitgedrukt ten opzichte van de afbeelding en niet als een vast pixelraster. Elk tekstelement bevat één woord en vier hoekpunten in genormaliseerde coördinaten: (0, 0) is linksboven en (1, 1) rechtsonder. Coördinaten mogen buiten dat bereik vallen, waarbij de vorm wordt afgesneden. Woorden in expliciete tekstlay-outs moeten de gedocumenteerde tekenbeperkingen volgen.\n\nLever voor een poster of cover de exacte tekst aan en beschrijf de hiërarchie: welke regel leidt, waar die staat en hoe het beeld die ondersteunt. Controleer weergegeven spelling en spatiëring bij de keuze van een resultaat.\n\n### Stijl, palet en artistieke richting\n\nV3 bevat voorgeselecteerde stijlen voor fotografie, illustratie en emblemen, plus een afzonderlijke vectorstijlbibliotheek. Recraft V3 Raw is de standaardstijl van het rastermodel; Vector art is de standaard voor de vectorvariant. Photorealism beoogt een fotografisch uiterlijk, terwijl Illustration gestileerde texturen, schaduwwerking en complexere kleurovergangen omvat. Vectorstijlen geven de voorkeur aan vormen, beperkte paletten en vlakke vullingen of eenvoudige verlopen.\n\nAangepaste stijlen kunnen vanuit referentieafbeeldingen, bestaande compatibele stijlen of een combinatie worden opgebouwd. Ze geven een herbruikbare visuele richting over een afbeeldingsreeks heen. De gedocumenteerde menginstellingen laten referenties en bronstijlen afzonderlijke gewichten dragen; het aantal gewichten komt overeen met de bronnen. PaletteMatch en MaxWeight zijn de twee vermelde mengbeleidsopties. De fabrikant staat maximaal 10 stijlreferentieafbeeldingen toe en gebruikt de gewone style-match-modus voor V3. Een opgeslagen aangepaste stijl en directe stijlreferenties zijn alternatieve invoeren en een aangepaste stijl moet passen bij het model dat voor generatie wordt gebruikt.\n\nVoorkeurskleuren en een achtergrondkleur sturen het palet. Maximaal 10 RGB-kleuren zijn gedocumenteerd, met elke component van 0 tot 255. Optionele relatieve gewichten lopen van 0 tot 1; ze moeten voor elke kleur of voor geen enkele worden opgegeven en hun totaal mag niet hoger zijn dan 1. Artistic level loopt van 0 voor een statische, rustige behandeling tot 5 voor dynamischere, excentriekere composities. Een negatieve prompt beschrijft ongewenste elementen; een afzonderlijke instelling zonder tekst schakelt ingebedde tekstlay-outs uit. Een willekeurige seed is beschikbaar voor reproduceerbaarheid. Deze instellingen bieden verschillende aangrijpingspunten voor de scène, de stijl en de visuele lay-out.\n\n### Rasterafbeeldingen en een afzonderlijke SVG-variant\n\nRecraft documenteert twee V3-varianten. Het rastermodel produceert verliesloos WebP of PNG en is geschikt voor fotografisch detail, schaduwwerking en illustraties met textuur. Recraft V3 Vector produceert SVG: paden en vormen die zonder vaste pixelresolutie kunnen schalen. Het past bij pictogrammen, logoconcepten, badges en gedetailleerd vectorwerk. Raster-naar-vectorconversie is een afzonderlijke operatie ten opzichte van het rechtstreeks genereren van vectorbeelden.\n\nBeide varianten hebben hun eigen identiteit. Een afbeelding met een vectorachtig uiterlijk en daadwerkelijke SVG-uitvoer zijn verschillende keuzes. Kies de gewenste uitvoer bij het voorbereiden van een ontwerpprocedure, in plaats van de gedeelde V3-naam te behandelen als bewijs dat elke operatie hetzelfde bestandstype retourneert.\n\n### Bestaand beeldmateriaal bewerken en afwerken\n\nRecrafts V3-documentatie vermeldt afbeelding-naar-afbeeldinggeneratie, inpainting, outpainting en achtergrondvervanging of -generatie. Afbeelding-naar-afbeeldingwerk combineert een bestaande afbeelding met een nieuwe briefing. Inpainting genereert het gekozen gebied opnieuw met een afbeelding en bijpassend masker; outpainting voegt inhoud buiten het oorspronkelijke kader toe. Achtergrondoperaties behandelen de omgeving van een onderwerp.\n\nDe bijbehorende gereedschapsset omvat ook wissen, achtergrondverwijdering, vectorisatie en twee vergrotingsmethoden. Creatieve vergroting kan nieuwe details toevoegen; scherpe vergroting beoogt een scherpere grotere weergave van bestaande inhoud. Dit zijn afzonderlijke operaties met eigen invoer en resultaten en geen aanvullende betekenissen van de raster- of vectormodelnaam.\n\n### Prompt-, formaat- en bronafbeeldingslimieten\n\nDe V3-generatiespecificatie van de fabrikant accepteert een prompt tot 1000 tekens en 1–6 afbeeldingen per aanvraag. Ze ondersteunt 14 beeldverhoudingen: 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 6:10, 14:10, 10:14, 16:9 en 9:16. Gedocumenteerde rastervoorbeelden omvatten 1024x1024, 1820x1024 en 1024x1820. Exacte rasterafmetingen moeten uit de ondersteunde lijst komen; SVG gebruikt beeldverhoudingen zonder vaste pixelafmeting. Als formaat wordt weggelaten, kiest het systeem van de fabrikant dit op basis van de prompt.\n\nVoor operaties met afbeeldingsinvoer vermeldt de fabrikant PNG, JPG en WebP, met SVG waar de specifieke operatie dat toestaat. Bestanden moeten kleiner zijn dan 20 MB, maximaal 16 MP, met een langste zijde van maximaal 4096 pixels. De kortste zijde is minimaal 256 pixels, met een uitzondering van 32 pixels voor scherpe vergroting. Maskers komen overeen met het afbeeldingsformaat en gebruiken puur zwart en wit; stijlreferenties hebben een gezamenlijke limiet van 64 MB.\n\nZet voor een Ailoot API-project de taak om in een gerichte afbeeldingsbriefing: exacte tekst, objectindeling, visuele stijl en gewenste compositie. Een poster, productscène en iconenreeks vragen om verschillende briefings; behoud de relevante verschillen tussen V3-varianten en operaties wanneer je bepaalt hoe elk resultaat wordt gebruikt.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "5ad552de06470919feb2fc5b8d64f4df8f8a06b8011e113f9996cad058666feb", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nl", "methods": [ { "html": "recraft/recraft-v3Recraft V3 maakt foto's, illustraties en grafische lay-outs met tekstbewuste compositie en stijlinstellingen. De afzonderlijke raster- en SVG-varianten passen bij posters, merkbeeldsets, iconen en ontwerpen waarin tekst en visuele structuur moeten samenwerken.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Recraft V3 is een afbeeldingsgeneratiemodel voor grafisch ontwerp én fotografische en geïllustreerde scènes. Een geschreven briefing beschrijft onderwerp, omgeving en compositie; het resultaat is een afbeelding. V3 ontwikkelt Recrafts tekstweergave en fotorealisme verder en behoudt stijlconsistentie vanuit voorbeeldafbeeldingen zonder opnieuw te trainen.
V3 werkt met tekst in de afbeelding, waaronder langere tekst en middelgrote letters. Recraft beschrijft een lay-outfase die woorden en hun posities vóór de afbeeldingsgeneratie vastlegt. De lay-out kan automatisch vanuit de briefing worden gemaakt of handmatig in Recrafts ontwerpomgeving worden ingedeeld. Dit helpt een kop, illustratie en ondersteunende tekst in één compositie te verbinden. De fabrikant documenteert ook expliciete tekstlay-outcoördinaten, uitgedrukt ten opzichte van de afbeelding en niet als een vast pixelraster. Elk tekstelement bevat één woord en vier hoekpunten in genormaliseerde coördinaten: (0, 0) is linksboven en (1, 1) rechtsonder. Coördinaten mogen buiten dat bereik vallen, waarbij de vorm wordt afgesneden. Woorden in expliciete tekstlay-outs moeten de gedocumenteerde tekenbeperkingen volgen.
Lever voor een poster of cover de exacte tekst aan en beschrijf de hiërarchie: welke regel leidt, waar die staat en hoe het beeld die ondersteunt. Controleer weergegeven spelling en spatiëring bij de keuze van een resultaat.
V3 bevat voorgeselecteerde stijlen voor fotografie, illustratie en emblemen, plus een afzonderlijke vectorstijlbibliotheek. Recraft V3 Raw is de standaardstijl van het rastermodel; Vector art is de standaard voor de vectorvariant. Photorealism beoogt een fotografisch uiterlijk, terwijl Illustration gestileerde texturen, schaduwwerking en complexere kleurovergangen omvat. Vectorstijlen geven de voorkeur aan vormen, beperkte paletten en vlakke vullingen of eenvoudige verlopen.
Aangepaste stijlen kunnen vanuit referentieafbeeldingen, bestaande compatibele stijlen of een combinatie worden opgebouwd. Ze geven een herbruikbare visuele richting over een afbeeldingsreeks heen. De gedocumenteerde menginstellingen laten referenties en bronstijlen afzonderlijke gewichten dragen; het aantal gewichten komt overeen met de bronnen. PaletteMatch en MaxWeight zijn de twee vermelde mengbeleidsopties. De fabrikant staat maximaal 10 stijlreferentieafbeeldingen toe en gebruikt de gewone style-match-modus voor V3. Een opgeslagen aangepaste stijl en directe stijlreferenties zijn alternatieve invoeren en een aangepaste stijl moet passen bij het model dat voor generatie wordt gebruikt.
Voorkeurskleuren en een achtergrondkleur sturen het palet. Maximaal 10 RGB-kleuren zijn gedocumenteerd, met elke component van 0 tot 255. Optionele relatieve gewichten lopen van 0 tot 1; ze moeten voor elke kleur of voor geen enkele worden opgegeven en hun totaal mag niet hoger zijn dan 1. Artistic level loopt van 0 voor een statische, rustige behandeling tot 5 voor dynamischere, excentriekere composities. Een negatieve prompt beschrijft ongewenste elementen; een afzonderlijke instelling zonder tekst schakelt ingebedde tekstlay-outs uit. Een willekeurige seed is beschikbaar voor reproduceerbaarheid. Deze instellingen bieden verschillende aangrijpingspunten voor de scène, de stijl en de visuele lay-out.
Recraft documenteert twee V3-varianten. Het rastermodel produceert verliesloos WebP of PNG en is geschikt voor fotografisch detail, schaduwwerking en illustraties met textuur. Recraft V3 Vector produceert SVG: paden en vormen die zonder vaste pixelresolutie kunnen schalen. Het past bij pictogrammen, logoconcepten, badges en gedetailleerd vectorwerk. Raster-naar-vectorconversie is een afzonderlijke operatie ten opzichte van het rechtstreeks genereren van vectorbeelden.
Beide varianten hebben hun eigen identiteit. Een afbeelding met een vectorachtig uiterlijk en daadwerkelijke SVG-uitvoer zijn verschillende keuzes. Kies de gewenste uitvoer bij het voorbereiden van een ontwerpprocedure, in plaats van de gedeelde V3-naam te behandelen als bewijs dat elke operatie hetzelfde bestandstype retourneert.
Recrafts V3-documentatie vermeldt afbeelding-naar-afbeeldinggeneratie, inpainting, outpainting en achtergrondvervanging of -generatie. Afbeelding-naar-afbeeldingwerk combineert een bestaande afbeelding met een nieuwe briefing. Inpainting genereert het gekozen gebied opnieuw met een afbeelding en bijpassend masker; outpainting voegt inhoud buiten het oorspronkelijke kader toe. Achtergrondoperaties behandelen de omgeving van een onderwerp.
De bijbehorende gereedschapsset omvat ook wissen, achtergrondverwijdering, vectorisatie en twee vergrotingsmethoden. Creatieve vergroting kan nieuwe details toevoegen; scherpe vergroting beoogt een scherpere grotere weergave van bestaande inhoud. Dit zijn afzonderlijke operaties met eigen invoer en resultaten en geen aanvullende betekenissen van de raster- of vectormodelnaam.
De V3-generatiespecificatie van de fabrikant accepteert een prompt tot 1000 tekens en 1–6 afbeeldingen per aanvraag. Ze ondersteunt 14 beeldverhoudingen: 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 6:10, 14:10, 10:14, 16:9 en 9:16. Gedocumenteerde rastervoorbeelden omvatten 1024x1024, 1820x1024 en 1024x1820. Exacte rasterafmetingen moeten uit de ondersteunde lijst komen; SVG gebruikt beeldverhoudingen zonder vaste pixelafmeting. Als formaat wordt weggelaten, kiest het systeem van de fabrikant dit op basis van de prompt.
Voor operaties met afbeeldingsinvoer vermeldt de fabrikant PNG, JPG en WebP, met SVG waar de specifieke operatie dat toestaat. Bestanden moeten kleiner zijn dan 20 MB, maximaal 16 MP, met een langste zijde van maximaal 4096 pixels. De kortste zijde is minimaal 256 pixels, met een uitzondering van 32 pixels voor scherpe vergroting. Maskers komen overeen met het afbeeldingsformaat en gebruiken puur zwart en wit; stijlreferenties hebben een gezamenlijke limiet van 64 MB.
Zet voor een Ailoot API-project de taak om in een gerichte afbeeldingsbriefing: exacte tekst, objectindeling, visuele stijl en gewenste compositie. Een poster, productscène en iconenreeks vragen om verschillende briefings; behoud de relevante verschillen tussen V3-varianten en operaties wanneer je bepaalt hoe elk resultaat wordt gebruikt.
POST /v1/images/generationstext, imageimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten recraft/recraft-v3 | 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
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parametermaterial_types | Contracttext, image |
Parameteroptional_controls | Contractaspect_ratio, n, input_references |
Parameterexact_supported_parameters | Contract{"aspect_ratio":{"type":"enum","values":["1:1","4:3","3:4","16:9","9:16","auto"]},"n":{"type":"range","min":1,"max":6},"input_references":{"type":"range","min":0,"max":1}} |
Parameterreference_material_rule | ContractUitsluitend daadwerkelijke afbeeldingsreferenties van de klant; de voorwaarden van het providerendpoint zijn hierop van toepassing. |
Methodealiasnamen: /v1/images
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}
Gebruik het exacte model en de gedocumenteerde invoervelden.
Bewaar het volledige antwoord, alle daadwerkelijke uitvoer en de oorspronkelijk geretourneerde IDs.
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.
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 · afbeeldingsuitvoer · 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 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 →
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 kosten; ze voegen geen tweede vergoeding 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-v3', '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-v3', '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-v3", "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 data-item en het volledige gebruik; neem alle daadwerkelijk geretourneerde afbeeldingen in eigendom en sla ze op. Geen verzonnen URLs of IDs.
Als het resultaat van een afbeeldingsgeneratie of -bewerking moet worden gecontroleerd, bewaar dan de oorspronkelijke operation_id/X-Client-Request-ID en de geretourneerde resultaatinformatie. Haal bestaande eigen resultaten terug via de mediabibliotheek met de daadwerkelijke task_id- of asset_id-waarden. Dien de generatie-/bewerkingsaanvraag niet opnieuw in en bouw geen polling-URL op basis van operation_id.
| Veld | Type |
|---|---|
Veldcreated | Typeinteger |
Velddata[].url | Typestring |
Velddata[].b64_json | Typebase64 string |
Veldusage | Typeobject |
Ailoot Ultra recraft/recraft-v3
/v1/images