Recraft V3 er en bildegenereringsmodell bygget for grafisk design så vel som fotografiske og illustrerte scener. En skriftlig beskrivelse angir motiv, omgivelser og komposisjon; resultatet er et bilde. V3 videreutvikler Recrafts tekstgjengivelse og fotorealisme og bevarer samtidig stilkonsistens fra eksempelbilder uten ny trening.
V3 arbeider med tekst i bildet, inkludert lengre tekst og mellomstore bokstaver. Recraft beskriver et layouttrinn som fastsetter ord og plassering før bildegenerering. Layouten kan produseres automatisk fra beskrivelsen eller arrangeres manuelt i Recrafts designmiljø. Dette bidrar til å knytte en overskrift, en illustrasjon og støttetekst sammen i én komposisjon. Produsenten dokumenterer også uttrykkelige tekstlayoutkoordinater, angitt relativt til bildet fremfor som et fast pikselnett. Hvert tekstelement inneholder ett ord og fire hjørnepunkter i normaliserte koordinater: (0, 0) er øvre venstre og (1, 1) nedre høyre hjørne. Koordinatene kan strekke seg utenfor dette intervallet, og da beskjæres formen. Ord i uttrykkelig tekstlayout må følge de dokumenterte tegnbegrensningene.
For en plakat eller et omslag oppgir du den nøyaktige ordlyden og beskriver hierarkiet: hvilken linje som leder, hvor den står og hvordan bildet støtter den. Kontroller den gjengitte stavingen og avstanden når du velger et resultat.
V3 inkluderer kuraterte fotografiske stiler, illustrasjons- og emblemstiler, i tillegg til et eget bibliotek med vektorstiler. Recraft V3 Raw er rastermodellens standardstil; Vector art er standard for vektorvarianten. Photorealism sikter mot et fotografisk utseende, mens Illustration rommer stiliserte teksturer, skyggelegging og mer komplekse fargeoverganger. Vektorstiler favoriserer former, begrensede paletter og flate fyll eller enkle graderinger.
Egendefinerte stiler kan bygges fra referansebilder, eksisterende kompatible stiler eller en kombinasjon. De gir en gjenbrukbar visuell retning gjennom en bildeserie. De dokumenterte blandingskontrollene lar referanser og kildestiler ha separate vekter; antallet vekter samsvarer med kildene. PaletteMatch og MaxWeight er de to oppførte blandingsreglene. Produsenten tillater opptil 10 stilreferansebilder og bruker vanlig stilmatchingsmodus for V3. En lagret egendefinert stil og direkte stilreferanser er alternative inndata, og en egendefinert stil må passe modellen som brukes til genereringen.
Foretrukne farger og en bakgrunnsfarge styrer paletten. Opptil 10 RGB-farger er dokumentert, med hver komponent fra 0 til 255. Valgfrie relative vekter går fra 0 til 1; de må oppgis for hver farge eller for ingen, og summen kan ikke overstige 1. Kunstnerisk nivå går fra 0 for en statisk, ren behandling til 5 for mer dynamiske, eksentriske komposisjoner. En negativ prompt beskriver uønskede elementer; en egen kontroll for ingen tekst deaktiverer innebygde tekstlayouter. En tilfeldig seed er tilgjengelig for reproduserbarhet. Disse kontrollene gir ulike virkemidler for scenen, stilsettingen og den visuelle layouten.
Recraft dokumenterer to V3-varianter. Rastermodellen produserer tapsfri WebP eller PNG og passer til fotografiske detaljer, skyggelegging og teksturert illustrasjon. Recraft V3 Vector produserer SVG: baner og former som kan skaleres uten en fast pikseloppløsning. Den passer til piktogrammer, logokonsepter, merker og detaljert vektorgrafikk. Konvertering fra raster til vektor er en egen operasjon, atskilt fra å generere vektorgrafikk direkte.
Begge variantene har sin egen identitet. Et bilde med vektorlignende utseende og faktiske SVG-utdata er forskjellige valg. Velg ønsket resultat når du klargjør en designarbeidsflyt, fremfor å behandle det felles V3-navnet som bevis på at hver operasjon returnerer samme filtype.
Recrafts V3-dokumentasjon oppgir bilde-til-bilde-generering, utfylling av bildeområder, utvidelse utenfor bildekanten og bakgrunnsutskifting eller -generering. Bilde-til-bilde-arbeid kombinerer et eksisterende bilde med en ny beskrivelse. Utfylling regenererer det valgte området ved hjelp av et bilde og en samsvarende maske; utvidelse legger til innhold utenfor originalrammen. Bakgrunnsoperasjoner gjelder omgivelsene til et motiv.
Det tilhørende verktøysettet inkluderer også visking, bakgrunnsfjerning, vektorisering og to tilnærminger til oppskalering. Kreativ oppskalering kan innføre nye detaljer; skarp oppskalering sikter mot en skarpere, større gjengivelse av eksisterende innhold. Dette er egne operasjoner med egne inndata og resultater, fremfor flere betydninger av navnet på raster- eller vektormodellen.
Produsentens V3-genereringsspesifikasjon godtar en prompt på opptil 1000 tegn og 1–6 bilder per forespørsel. Den støtter 14 sideforhold: 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 og 9:16. Dokumenterte rastereksempler omfatter 1024x1024, 1820x1024 og 1024x1820. Nøyaktige rasterdimensjoner må være fra den støttede listen; SVG bruker sideforhold uten fast pikselstørrelse. Når størrelse utelates, velger produsentens system den fra prompten.
For operasjoner med bildeinndata oppgir produsenten PNG, JPG og WebP, med SVG der den konkrete operasjonen tillater det. Filer må være under 20 MB, ikke større enn 16 MP, med en langside på høyst 4096 piksler. Kortsiden er minst 256 piksler, med et unntak på 32 piksler for skarp oppskalering. Masker samsvarer med bildestørrelsen og bruker rent svart og hvitt; stilreferanser har en samlet grense på 64 MB.
For et Ailoot API-prosjekt gjør du oppgaven om til en avgrenset bildebeskrivelse: nøyaktig tekst, objektoppsett, visuell stil og ønsket komposisjon. En plakat, en produktscene og en ikonserie krever ulike beskrivelser; bevar de relevante skillene mellom V3-variantene og operasjonene når du avgjør hvordan hvert resultat skal brukes.
", "aboutText": "Recraft V3 er en bildegenereringsmodell bygget for grafisk design så vel som fotografiske og illustrerte scener. En skriftlig beskrivelse angir motiv, omgivelser og komposisjon; resultatet er et bilde. V3 videreutvikler Recrafts tekstgjengivelse og fotorealisme og bevarer samtidig stilkonsistens fra eksempelbilder uten ny trening.\n\n### Tekst som del av komposisjonen\n\nV3 arbeider med tekst i bildet, inkludert lengre tekst og mellomstore bokstaver. Recraft beskriver et layouttrinn som fastsetter ord og plassering før bildegenerering. Layouten kan produseres automatisk fra beskrivelsen eller arrangeres manuelt i Recrafts designmiljø. Dette bidrar til å knytte en overskrift, en illustrasjon og støttetekst sammen i én komposisjon. Produsenten dokumenterer også uttrykkelige tekstlayoutkoordinater, angitt relativt til bildet fremfor som et fast pikselnett. Hvert tekstelement inneholder ett ord og fire hjørnepunkter i normaliserte koordinater: (0, 0) er øvre venstre og (1, 1) nedre høyre hjørne. Koordinatene kan strekke seg utenfor dette intervallet, og da beskjæres formen. Ord i uttrykkelig tekstlayout må følge de dokumenterte tegnbegrensningene.\n\nFor en plakat eller et omslag oppgir du den nøyaktige ordlyden og beskriver hierarkiet: hvilken linje som leder, hvor den står og hvordan bildet støtter den. Kontroller den gjengitte stavingen og avstanden når du velger et resultat.\n\n### Stil, palett og visuell regi\n\nV3 inkluderer kuraterte fotografiske stiler, illustrasjons- og emblemstiler, i tillegg til et eget bibliotek med vektorstiler. Recraft V3 Raw er rastermodellens standardstil; Vector art er standard for vektorvarianten. Photorealism sikter mot et fotografisk utseende, mens Illustration rommer stiliserte teksturer, skyggelegging og mer komplekse fargeoverganger. Vektorstiler favoriserer former, begrensede paletter og flate fyll eller enkle graderinger.\n\nEgendefinerte stiler kan bygges fra referansebilder, eksisterende kompatible stiler eller en kombinasjon. De gir en gjenbrukbar visuell retning gjennom en bildeserie. De dokumenterte blandingskontrollene lar referanser og kildestiler ha separate vekter; antallet vekter samsvarer med kildene. PaletteMatch og MaxWeight er de to oppførte blandingsreglene. Produsenten tillater opptil 10 stilreferansebilder og bruker vanlig stilmatchingsmodus for V3. En lagret egendefinert stil og direkte stilreferanser er alternative inndata, og en egendefinert stil må passe modellen som brukes til genereringen.\n\nForetrukne farger og en bakgrunnsfarge styrer paletten. Opptil 10 RGB-farger er dokumentert, med hver komponent fra 0 til 255. Valgfrie relative vekter går fra 0 til 1; de må oppgis for hver farge eller for ingen, og summen kan ikke overstige 1. Kunstnerisk nivå går fra 0 for en statisk, ren behandling til 5 for mer dynamiske, eksentriske komposisjoner. En negativ prompt beskriver uønskede elementer; en egen kontroll for ingen tekst deaktiverer innebygde tekstlayouter. En tilfeldig seed er tilgjengelig for reproduserbarhet. Disse kontrollene gir ulike virkemidler for scenen, stilsettingen og den visuelle layouten.\n\n### Rasterbilder og en egen SVG-variant\n\nRecraft dokumenterer to V3-varianter. Rastermodellen produserer tapsfri WebP eller PNG og passer til fotografiske detaljer, skyggelegging og teksturert illustrasjon. Recraft V3 Vector produserer SVG: baner og former som kan skaleres uten en fast pikseloppløsning. Den passer til piktogrammer, logokonsepter, merker og detaljert vektorgrafikk. Konvertering fra raster til vektor er en egen operasjon, atskilt fra å generere vektorgrafikk direkte.\n\nBegge variantene har sin egen identitet. Et bilde med vektorlignende utseende og faktiske SVG-utdata er forskjellige valg. Velg ønsket resultat når du klargjør en designarbeidsflyt, fremfor å behandle det felles V3-navnet som bevis på at hver operasjon returnerer samme filtype.\n\n### Redigering og ferdigstilling av eksisterende illustrasjoner\n\nRecrafts V3-dokumentasjon oppgir bilde-til-bilde-generering, utfylling av bildeområder, utvidelse utenfor bildekanten og bakgrunnsutskifting eller -generering. Bilde-til-bilde-arbeid kombinerer et eksisterende bilde med en ny beskrivelse. Utfylling regenererer det valgte området ved hjelp av et bilde og en samsvarende maske; utvidelse legger til innhold utenfor originalrammen. Bakgrunnsoperasjoner gjelder omgivelsene til et motiv.\n\nDet tilhørende verktøysettet inkluderer også visking, bakgrunnsfjerning, vektorisering og to tilnærminger til oppskalering. Kreativ oppskalering kan innføre nye detaljer; skarp oppskalering sikter mot en skarpere, større gjengivelse av eksisterende innhold. Dette er egne operasjoner med egne inndata og resultater, fremfor flere betydninger av navnet på raster- eller vektormodellen.\n\n### Grenser for prompt, størrelse og kildebilder\n\nProdusentens V3-genereringsspesifikasjon godtar en prompt på opptil 1000 tegn og 1–6 bilder per forespørsel. Den støtter 14 sideforhold: 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 og 9:16. Dokumenterte rastereksempler omfatter 1024x1024, 1820x1024 og 1024x1820. Nøyaktige rasterdimensjoner må være fra den støttede listen; SVG bruker sideforhold uten fast pikselstørrelse. Når størrelse utelates, velger produsentens system den fra prompten.\n\nFor operasjoner med bildeinndata oppgir produsenten PNG, JPG og WebP, med SVG der den konkrete operasjonen tillater det. Filer må være under 20 MB, ikke større enn 16 MP, med en langside på høyst 4096 piksler. Kortsiden er minst 256 piksler, med et unntak på 32 piksler for skarp oppskalering. Masker samsvarer med bildestørrelsen og bruker rent svart og hvitt; stilreferanser har en samlet grense på 64 MB.\n\nFor et Ailoot API-prosjekt gjør du oppgaven om til en avgrenset bildebeskrivelse: nøyaktig tekst, objektoppsett, visuell stil og ønsket komposisjon. En plakat, en produktscene og en ikonserie krever ulike beskrivelser; bevar de relevante skillene mellom V3-variantene og operasjonene når du avgjør hvordan hvert resultat skal brukes.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "fcbba1446f5e015785a7b3be53c0e8971db195ffb7b3cbd4ebff89f231ce85d0", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nb", "methods": [ { "html": "recraft/recraft-v3Recraft V3 lager fotografier, illustrasjoner og grafiske layouter med tekstbevisst komposisjon og stilkontroller. De egne raster- og SVG-variantene passer til plakater, merkevarebildesett, ikoner og design der ordlyd og visuell struktur må fungere sammen.
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
Recraft V3 er en bildegenereringsmodell bygget for grafisk design så vel som fotografiske og illustrerte scener. En skriftlig beskrivelse angir motiv, omgivelser og komposisjon; resultatet er et bilde. V3 videreutvikler Recrafts tekstgjengivelse og fotorealisme og bevarer samtidig stilkonsistens fra eksempelbilder uten ny trening.
V3 arbeider med tekst i bildet, inkludert lengre tekst og mellomstore bokstaver. Recraft beskriver et layouttrinn som fastsetter ord og plassering før bildegenerering. Layouten kan produseres automatisk fra beskrivelsen eller arrangeres manuelt i Recrafts designmiljø. Dette bidrar til å knytte en overskrift, en illustrasjon og støttetekst sammen i én komposisjon. Produsenten dokumenterer også uttrykkelige tekstlayoutkoordinater, angitt relativt til bildet fremfor som et fast pikselnett. Hvert tekstelement inneholder ett ord og fire hjørnepunkter i normaliserte koordinater: (0, 0) er øvre venstre og (1, 1) nedre høyre hjørne. Koordinatene kan strekke seg utenfor dette intervallet, og da beskjæres formen. Ord i uttrykkelig tekstlayout må følge de dokumenterte tegnbegrensningene.
For en plakat eller et omslag oppgir du den nøyaktige ordlyden og beskriver hierarkiet: hvilken linje som leder, hvor den står og hvordan bildet støtter den. Kontroller den gjengitte stavingen og avstanden når du velger et resultat.
V3 inkluderer kuraterte fotografiske stiler, illustrasjons- og emblemstiler, i tillegg til et eget bibliotek med vektorstiler. Recraft V3 Raw er rastermodellens standardstil; Vector art er standard for vektorvarianten. Photorealism sikter mot et fotografisk utseende, mens Illustration rommer stiliserte teksturer, skyggelegging og mer komplekse fargeoverganger. Vektorstiler favoriserer former, begrensede paletter og flate fyll eller enkle graderinger.
Egendefinerte stiler kan bygges fra referansebilder, eksisterende kompatible stiler eller en kombinasjon. De gir en gjenbrukbar visuell retning gjennom en bildeserie. De dokumenterte blandingskontrollene lar referanser og kildestiler ha separate vekter; antallet vekter samsvarer med kildene. PaletteMatch og MaxWeight er de to oppførte blandingsreglene. Produsenten tillater opptil 10 stilreferansebilder og bruker vanlig stilmatchingsmodus for V3. En lagret egendefinert stil og direkte stilreferanser er alternative inndata, og en egendefinert stil må passe modellen som brukes til genereringen.
Foretrukne farger og en bakgrunnsfarge styrer paletten. Opptil 10 RGB-farger er dokumentert, med hver komponent fra 0 til 255. Valgfrie relative vekter går fra 0 til 1; de må oppgis for hver farge eller for ingen, og summen kan ikke overstige 1. Kunstnerisk nivå går fra 0 for en statisk, ren behandling til 5 for mer dynamiske, eksentriske komposisjoner. En negativ prompt beskriver uønskede elementer; en egen kontroll for ingen tekst deaktiverer innebygde tekstlayouter. En tilfeldig seed er tilgjengelig for reproduserbarhet. Disse kontrollene gir ulike virkemidler for scenen, stilsettingen og den visuelle layouten.
Recraft dokumenterer to V3-varianter. Rastermodellen produserer tapsfri WebP eller PNG og passer til fotografiske detaljer, skyggelegging og teksturert illustrasjon. Recraft V3 Vector produserer SVG: baner og former som kan skaleres uten en fast pikseloppløsning. Den passer til piktogrammer, logokonsepter, merker og detaljert vektorgrafikk. Konvertering fra raster til vektor er en egen operasjon, atskilt fra å generere vektorgrafikk direkte.
Begge variantene har sin egen identitet. Et bilde med vektorlignende utseende og faktiske SVG-utdata er forskjellige valg. Velg ønsket resultat når du klargjør en designarbeidsflyt, fremfor å behandle det felles V3-navnet som bevis på at hver operasjon returnerer samme filtype.
Recrafts V3-dokumentasjon oppgir bilde-til-bilde-generering, utfylling av bildeområder, utvidelse utenfor bildekanten og bakgrunnsutskifting eller -generering. Bilde-til-bilde-arbeid kombinerer et eksisterende bilde med en ny beskrivelse. Utfylling regenererer det valgte området ved hjelp av et bilde og en samsvarende maske; utvidelse legger til innhold utenfor originalrammen. Bakgrunnsoperasjoner gjelder omgivelsene til et motiv.
Det tilhørende verktøysettet inkluderer også visking, bakgrunnsfjerning, vektorisering og to tilnærminger til oppskalering. Kreativ oppskalering kan innføre nye detaljer; skarp oppskalering sikter mot en skarpere, større gjengivelse av eksisterende innhold. Dette er egne operasjoner med egne inndata og resultater, fremfor flere betydninger av navnet på raster- eller vektormodellen.
Produsentens V3-genereringsspesifikasjon godtar en prompt på opptil 1000 tegn og 1–6 bilder per forespørsel. Den støtter 14 sideforhold: 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 og 9:16. Dokumenterte rastereksempler omfatter 1024x1024, 1820x1024 og 1024x1820. Nøyaktige rasterdimensjoner må være fra den støttede listen; SVG bruker sideforhold uten fast pikselstørrelse. Når størrelse utelates, velger produsentens system den fra prompten.
For operasjoner med bildeinndata oppgir produsenten PNG, JPG og WebP, med SVG der den konkrete operasjonen tillater det. Filer må være under 20 MB, ikke større enn 16 MP, med en langside på høyst 4096 piksler. Kortsiden er minst 256 piksler, med et unntak på 32 piksler for skarp oppskalering. Masker samsvarer med bildestørrelsen og bruker rent svart og hvitt; stilreferanser har en samlet grense på 64 MB.
For et Ailoot API-prosjekt gjør du oppgaven om til en avgrenset bildebeskrivelse: nøyaktig tekst, objektoppsett, visuell stil og ønsket komposisjon. En plakat, en produktscene og en ikonserie krever ulike beskrivelser; bevar de relevante skillene mellom V3-variantene og operasjonene når du avgjør hvordan hvert resultat skal brukes.
POST /v1/images/generationstext, imageimage| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser recraft/recraft-v3 | Standard— |
Feltprompt | Typestring | KravPåkrevd | Verdier & grenser Minste lengde: 1 | Standard— |
Feltn | Typeinteger | KravValgfritt | Verdier & grenser Minimum: 1 Maksimum: 6 | Standard— |
Feltaspect_ratio | Typestring | KravValgfritt | Verdier & grenser 1:1, 4:3, 3:4, 16:9, 9:16, auto | Standard— |
Feltinput_references | Typearray | KravValgfritt | Verdier & grenser Minste antall elementer: 0 Maksimalt antall elementer: 1 | Standard— |
Tekst til bilde · Påkrevd: prompt
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, prompt |
Parametermaterial_types | Avtaletext, image |
Parameteroptional_controls | Avtaleaspect_ratio, n, input_references |
Parameterexact_supported_parameters | Avtale{"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 | AvtaleBare faktiske bildereferanser fra kunden; vilkårene for leverandørens endepunkt gjelder for dem. |
Metodealiaser: /v1/images
Livssyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · faktisk returnert task_id eller oppføring i mediebiblioteket
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Bruk den eksakte modellen og de dokumenterte inndatafeltene.
Behold hele svaret, alle faktiske utdata og opprinnelige returnerte ID-er.
De viste satsene anslår kostnaden før generering. Det endelige beløpet beregnes ut fra kostnaden som er registrert for den opprinnelige genereringen. Målt varighet på utdataene og anslåtte mengder er ikke den endelige fakturerbare mengden.
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Prisplan | Forventet mengde | Faktureringsenhet | Kostnad |
|---|---|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Forventet mengde— | Faktureringsenhet— | Kostnad Inndata · Inngående tokener · Estimat kun for sammenligning — / 1K tokener Utdata · Utgående tokener · Estimat kun for sammenligning — / 1K tokener Inndata · Lesing fra hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time · Estimat kun for sammenligning — / 1K tokener |
| KonfigurasjonUltra | Prisplan— | Forventet mengde— | Faktureringsenhetper utdatabilde | Kostnad Utdata · bildeutdata · Estimat kun for sammenligning $0.08 per utdatabilde |
| KonfigurasjonAnslått genereringskostnad | Prisplan— | Forventet mengdeestimat for én generering | Faktureringsenhet— | Kostnad Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $0.08 estimat før generering Dette anslaget er verken en tilleggsavgift eller en fast sats for den fullførte genereringen. |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
Referanseprisplaner på modellnivå endrer ikke metodevalg, prisoverslag eller kostnader. Aktive kostnader bruker satsene til den valgte Ailoot-metoden.
| Konfigurasjon | Faktureringsvilkår | Kostnad |
|---|---|---|
| KonfigurasjonUtdatabilde | FaktureringsvilkårIngen prisvariant er deklarert. | Kostnad Utdata · Utdatabilde $0.08 per bilde Tilsvarende oppføringer beskriver samme belastning; de legger ikke til enda en avgift. |
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");\nLast ned hvert returnerte bilde eller lagre Base64-innholdet
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Lagre hvert ferdige bilde; hent hver returnerte URL eller dekod Base64-innholdet.
Behold hvert dataelement og alt forbruk; ta eierskap til og lagre alle faktiske returnerte bilder. Ingen oppdiktede adresser eller ID-er.
Hvis et resultat fra bildegenerering eller bilderedigering må kontrolleres, bevar opprinnelig operation_id/X-Client-Request-ID og den returnerte resultatinformasjonen. Hent eksisterende resultater du eier via mediebiblioteket, ved hjelp av faktiske task_id- eller asset_id-verdier. Ikke send genererings-/redigeringsforespørselen på nytt, og ikke konstruer en URL for statusavlesning fra operation_id.
| Felt | Type |
|---|---|
Feltcreated | Typeinteger |
Feltdata[].url | Typestring |
Feltdata[].b64_json | Typebase64 string |
Feltusage | Typeobject |
Ailoot Ultra recraft/recraft-v3
/v1/images