Recraft V3 ist ein Bildgenerierungsmodell für Grafikdesign sowie fotografische und illustrierte Szenen. Ein schriftliches Briefing beschreibt Motiv, Umgebung und Komposition; das Ergebnis ist ein Bild. V3 entwickelt Recrafts Textdarstellung und Fotorealismus weiter und erhält dabei Stilkonsistenz anhand von Beispielbildern ohne erneutes Training.
V3 arbeitet mit Text innerhalb des Bildes, einschliesslich längerer Texte und mittelgrosser Schrift. Recraft beschreibt eine Layoutphase, die Wörter und ihre Positionen vor der Bildgenerierung festlegt. Das Layout kann automatisch aus dem Briefing erzeugt oder manuell in Recrafts Designumgebung angeordnet werden. Das hilft, eine Überschrift, eine Illustration und ergänzenden Text in einer Komposition miteinander zu verbinden. Der Hersteller dokumentiert auch ausdrückliche Textlayout-Koordinaten, die relativ zum Bild statt als festes Pixelraster angegeben werden. Jedes Textelement enthält ein einzelnes Wort und vier Eckpunkte in normalisierten Koordinaten: (0, 0) bezeichnet oben links, (1, 1) unten rechts. Koordinaten dürfen über diesen Bereich hinausgehen; dann wird die Form beschnitten. Wörter in ausdrücklich festgelegten Textlayouts müssen den dokumentierten Zeichenbeschränkungen entsprechen.
Geben Sie für ein Plakat oder Cover den genauen Wortlaut an und beschreiben Sie seine Hierarchie: welche Zeile führt, wo sie sitzt und wie das Bild sie unterstützt. Prüfen Sie bei der Auswahl eines Ergebnisses die gerenderte Schreibweise und die Abstände.
V3 enthält kuratierte Foto-, Illustrations- und Emblemstile sowie eine separate Bibliothek für Vektorstile. Recraft V3 Raw ist der Standardstil des Rastermodells; Vector art ist der Standard der Vektorvariante. Photorealism zielt auf ein fotografisches Erscheinungsbild, während Illustration stilisierte Texturen, Schattierungen und komplexere Farbübergänge ermöglicht. Vektorstile bevorzugen Formen, begrenzte Paletten und flächige Füllungen oder einfache Verläufe.
Benutzerdefinierte Stile lassen sich aus Referenzbildern, vorhandenen kompatiblen Stilen oder einer Kombination daraus erstellen. Sie bieten eine wiederverwendbare visuelle Richtung für eine Bildserie. Die dokumentierten Mischeinstellungen erlauben separate Gewichte für Referenzen und Ausgangsstile; die Anzahl der Gewichte entspricht der Anzahl der Quellen. PaletteMatch und MaxWeight sind die beiden aufgeführten Mischrichtlinien. Der Hersteller erlaubt bis zu 10 Stilreferenzbilder und nutzt für V3 den regulären Stilabgleich. Ein gespeicherter benutzerdefinierter Stil und direkte Stilreferenzen sind alternative Eingaben; ein benutzerdefinierter Stil muss zum für die Generierung verwendeten Modell passen.
Bevorzugte Farben und eine Hintergrundfarbe führen die Palette. Dokumentiert sind bis zu 10 RGB-Farben mit Komponenten von jeweils 0 bis 255. Optionale relative Gewichte reichen von 0 bis 1; sie müssen für jede Farbe oder für keine angegeben werden, und ihre Summe darf 1 nicht überschreiten. Der künstlerische Grad reicht von 0 für eine statische, klare Behandlung bis zu 5 für dynamischere, exzentrische Kompositionen. Ein negativer Prompt beschreibt unerwünschte Elemente; eine separate Einstellung für Bilder ohne Text deaktiviert eingebettete Textlayouts. Ein Zufalls-Seed steht für Reproduzierbarkeit zur Verfügung. Diese Einstellungen bieten unterschiedliche Ansatzpunkte für Szene, Stil und visuelles Layout.
Recraft dokumentiert zwei V3-Varianten. Das Rastermodell erzeugt verlustfreies WebP oder PNG und eignet sich für fotografische Details, Schattierungen und texturierte Illustrationen. Recraft V3 Vector erzeugt SVG: Pfade und Formen, die ohne feste Pixelauflösung skalierbar sind. Es eignet sich für Piktogramme, Logokonzepte, Abzeichen und detaillierte Vektorgrafiken. Raster-zu-Vektor-Konvertierung ist eine separate Operation gegenüber der direkten Generierung von Vektorgrafiken.
Beide Varianten haben eine eigene Identität. Ein Bild mit vektorähnlichem Aussehen und eine tatsächliche SVG-Ausgabe sind unterschiedliche Optionen. Wählen Sie bei der Vorbereitung eines Designablaufs die gewünschte Ausgabe, statt den gemeinsamen Namen V3 als Nachweis zu behandeln, dass jede Operation denselben Dateityp liefert.
Recrafts V3-Dokumentation nennt Bild-zu-Bild-Generierung, Inpainting, Outpainting sowie Hintergrundaustausch oder Hintergrundgenerierung. Bild-zu-Bild-Arbeit kombiniert ein vorhandenes Bild mit einem neuen Briefing. Inpainting generiert den ausgewählten Bereich anhand eines Bildes und einer passenden Maske neu; Outpainting ergänzt Inhalt ausserhalb des ursprünglichen Rahmens. Hintergrundoperationen betreffen die Umgebung eines Motivs.
Zum zugehörigen Werkzeugsatz gehören ausserdem Radieren, Hintergrundentfernung, Vektorisierung und zwei Ansätze zur Hochskalierung. Kreative Hochskalierung kann neue Details hinzufügen; scharfe Hochskalierung zielt auf eine schärfere, grössere Darstellung des vorhandenen Inhalts. Dies sind getrennte Operationen mit eigenen Eingaben und Ergebnissen und keine zusätzlichen Bedeutungen der Raster- oder Vektormodellnamen.
Die V3-Generierungsspezifikation des Herstellers akzeptiert einen Prompt mit bis zu 1000 Zeichen und 1–6 Bilder pro Anfrage. Sie unterstützt 14 Seitenverhältnisse: 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 und 9:16. Dokumentierte Rasterbeispiele sind 1024x1024, 1820x1024 und 1024x1820. Exakte Rasterabmessungen müssen aus der unterstützten Liste stammen; SVG nutzt Seitenverhältnisse ohne feste Pixelgrösse. Wird die Grösse weggelassen, wählt das Herstellersystem sie anhand des Prompts aus.
Für Operationen mit Bildeingabe nennt der Hersteller PNG, JPG und WebP sowie SVG, sofern die jeweilige Operation es erlaubt. Dateien müssen unter 20 MB bleiben, dürfen höchstens 16 MP haben und auf der längsten Seite höchstens 4096 Pixel messen. Die kürzeste Seite beträgt mindestens 256 Pixel; für scharfe Hochskalierung gilt eine Ausnahme von 32 Pixeln. Masken entsprechen der Bildgrösse und verwenden reines Schwarz und Weiss; Stilreferenzen haben gemeinsam eine Grenze von 64 MB.
Formulieren Sie die Aufgabe für ein Ailoot-API-Projekt als gezieltes Bildbriefing: den genauen Text, die Anordnung der Objekte, den visuellen Stil und die gewünschte Komposition. Ein Plakat, eine Produktszene und eine Iconserie erfordern unterschiedliche Briefings; bewahren Sie bei der Entscheidung über die Verwendung jedes Ergebnisses die relevanten Unterschiede zwischen V3-Varianten und Operationen.
", "aboutText": "Recraft V3 ist ein Bildgenerierungsmodell für Grafikdesign sowie fotografische und illustrierte Szenen. Ein schriftliches Briefing beschreibt Motiv, Umgebung und Komposition; das Ergebnis ist ein Bild. V3 entwickelt Recrafts Textdarstellung und Fotorealismus weiter und erhält dabei Stilkonsistenz anhand von Beispielbildern ohne erneutes Training.\n\n### Text als Teil der Komposition\n\nV3 arbeitet mit Text innerhalb des Bildes, einschliesslich längerer Texte und mittelgrosser Schrift. Recraft beschreibt eine Layoutphase, die Wörter und ihre Positionen vor der Bildgenerierung festlegt. Das Layout kann automatisch aus dem Briefing erzeugt oder manuell in Recrafts Designumgebung angeordnet werden. Das hilft, eine Überschrift, eine Illustration und ergänzenden Text in einer Komposition miteinander zu verbinden. Der Hersteller dokumentiert auch ausdrückliche Textlayout-Koordinaten, die relativ zum Bild statt als festes Pixelraster angegeben werden. Jedes Textelement enthält ein einzelnes Wort und vier Eckpunkte in normalisierten Koordinaten: (0, 0) bezeichnet oben links, (1, 1) unten rechts. Koordinaten dürfen über diesen Bereich hinausgehen; dann wird die Form beschnitten. Wörter in ausdrücklich festgelegten Textlayouts müssen den dokumentierten Zeichenbeschränkungen entsprechen.\n\nGeben Sie für ein Plakat oder Cover den genauen Wortlaut an und beschreiben Sie seine Hierarchie: welche Zeile führt, wo sie sitzt und wie das Bild sie unterstützt. Prüfen Sie bei der Auswahl eines Ergebnisses die gerenderte Schreibweise und die Abstände.\n\n### Stil, Palette und künstlerische Richtung\n\nV3 enthält kuratierte Foto-, Illustrations- und Emblemstile sowie eine separate Bibliothek für Vektorstile. Recraft V3 Raw ist der Standardstil des Rastermodells; Vector art ist der Standard der Vektorvariante. Photorealism zielt auf ein fotografisches Erscheinungsbild, während Illustration stilisierte Texturen, Schattierungen und komplexere Farbübergänge ermöglicht. Vektorstile bevorzugen Formen, begrenzte Paletten und flächige Füllungen oder einfache Verläufe.\n\nBenutzerdefinierte Stile lassen sich aus Referenzbildern, vorhandenen kompatiblen Stilen oder einer Kombination daraus erstellen. Sie bieten eine wiederverwendbare visuelle Richtung für eine Bildserie. Die dokumentierten Mischeinstellungen erlauben separate Gewichte für Referenzen und Ausgangsstile; die Anzahl der Gewichte entspricht der Anzahl der Quellen. PaletteMatch und MaxWeight sind die beiden aufgeführten Mischrichtlinien. Der Hersteller erlaubt bis zu 10 Stilreferenzbilder und nutzt für V3 den regulären Stilabgleich. Ein gespeicherter benutzerdefinierter Stil und direkte Stilreferenzen sind alternative Eingaben; ein benutzerdefinierter Stil muss zum für die Generierung verwendeten Modell passen.\n\nBevorzugte Farben und eine Hintergrundfarbe führen die Palette. Dokumentiert sind bis zu 10 RGB-Farben mit Komponenten von jeweils 0 bis 255. Optionale relative Gewichte reichen von 0 bis 1; sie müssen für jede Farbe oder für keine angegeben werden, und ihre Summe darf 1 nicht überschreiten. Der künstlerische Grad reicht von 0 für eine statische, klare Behandlung bis zu 5 für dynamischere, exzentrische Kompositionen. Ein negativer Prompt beschreibt unerwünschte Elemente; eine separate Einstellung für Bilder ohne Text deaktiviert eingebettete Textlayouts. Ein Zufalls-Seed steht für Reproduzierbarkeit zur Verfügung. Diese Einstellungen bieten unterschiedliche Ansatzpunkte für Szene, Stil und visuelles Layout.\n\n### Rasterbilder und eine separate SVG-Variante\n\nRecraft dokumentiert zwei V3-Varianten. Das Rastermodell erzeugt verlustfreies WebP oder PNG und eignet sich für fotografische Details, Schattierungen und texturierte Illustrationen. Recraft V3 Vector erzeugt SVG: Pfade und Formen, die ohne feste Pixelauflösung skalierbar sind. Es eignet sich für Piktogramme, Logokonzepte, Abzeichen und detaillierte Vektorgrafiken. Raster-zu-Vektor-Konvertierung ist eine separate Operation gegenüber der direkten Generierung von Vektorgrafiken.\n\nBeide Varianten haben eine eigene Identität. Ein Bild mit vektorähnlichem Aussehen und eine tatsächliche SVG-Ausgabe sind unterschiedliche Optionen. Wählen Sie bei der Vorbereitung eines Designablaufs die gewünschte Ausgabe, statt den gemeinsamen Namen V3 als Nachweis zu behandeln, dass jede Operation denselben Dateityp liefert.\n\n### Vorhandene Grafiken bearbeiten und fertigstellen\n\nRecrafts V3-Dokumentation nennt Bild-zu-Bild-Generierung, Inpainting, Outpainting sowie Hintergrundaustausch oder Hintergrundgenerierung. Bild-zu-Bild-Arbeit kombiniert ein vorhandenes Bild mit einem neuen Briefing. Inpainting generiert den ausgewählten Bereich anhand eines Bildes und einer passenden Maske neu; Outpainting ergänzt Inhalt ausserhalb des ursprünglichen Rahmens. Hintergrundoperationen betreffen die Umgebung eines Motivs.\n\nZum zugehörigen Werkzeugsatz gehören ausserdem Radieren, Hintergrundentfernung, Vektorisierung und zwei Ansätze zur Hochskalierung. Kreative Hochskalierung kann neue Details hinzufügen; scharfe Hochskalierung zielt auf eine schärfere, grössere Darstellung des vorhandenen Inhalts. Dies sind getrennte Operationen mit eigenen Eingaben und Ergebnissen und keine zusätzlichen Bedeutungen der Raster- oder Vektormodellnamen.\n\n### Grenzen für Prompt, Grösse und Ausgangsbilder\n\nDie V3-Generierungsspezifikation des Herstellers akzeptiert einen Prompt mit bis zu 1000 Zeichen und 1–6 Bilder pro Anfrage. Sie unterstützt 14 Seitenverhältnisse: 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 und 9:16. Dokumentierte Rasterbeispiele sind 1024x1024, 1820x1024 und 1024x1820. Exakte Rasterabmessungen müssen aus der unterstützten Liste stammen; SVG nutzt Seitenverhältnisse ohne feste Pixelgrösse. Wird die Grösse weggelassen, wählt das Herstellersystem sie anhand des Prompts aus.\n\nFür Operationen mit Bildeingabe nennt der Hersteller PNG, JPG und WebP sowie SVG, sofern die jeweilige Operation es erlaubt. Dateien müssen unter 20 MB bleiben, dürfen höchstens 16 MP haben und auf der längsten Seite höchstens 4096 Pixel messen. Die kürzeste Seite beträgt mindestens 256 Pixel; für scharfe Hochskalierung gilt eine Ausnahme von 32 Pixeln. Masken entsprechen der Bildgrösse und verwenden reines Schwarz und Weiss; Stilreferenzen haben gemeinsam eine Grenze von 64 MB.\n\nFormulieren Sie die Aufgabe für ein Ailoot-API-Projekt als gezieltes Bildbriefing: den genauen Text, die Anordnung der Objekte, den visuellen Stil und die gewünschte Komposition. Ein Plakat, eine Produktszene und eine Iconserie erfordern unterschiedliche Briefings; bewahren Sie bei der Entscheidung über die Verwendung jedes Ergebnisses die relevanten Unterschiede zwischen V3-Varianten und Operationen.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "274201fc5bdaf5ba5c31c314e0c38ab7d38c2ca5e81141cb45074f770b2f68fd", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "de-ch", "methods": [ { "html": "recraft/recraft-v3Recraft V3 erstellt Fotografien, Illustrationen und grafische Layouts mit textbewusster Komposition und Stileinstellungen. Seine getrennten Raster- und SVG-Varianten eignen sich für Plakate, Bildserien im Markendesign, Icons und Designs, bei denen Wortlaut und visuelle Struktur zusammenwirken müssen.
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Recraft V3 ist ein Bildgenerierungsmodell für Grafikdesign sowie fotografische und illustrierte Szenen. Ein schriftliches Briefing beschreibt Motiv, Umgebung und Komposition; das Ergebnis ist ein Bild. V3 entwickelt Recrafts Textdarstellung und Fotorealismus weiter und erhält dabei Stilkonsistenz anhand von Beispielbildern ohne erneutes Training.
V3 arbeitet mit Text innerhalb des Bildes, einschliesslich längerer Texte und mittelgrosser Schrift. Recraft beschreibt eine Layoutphase, die Wörter und ihre Positionen vor der Bildgenerierung festlegt. Das Layout kann automatisch aus dem Briefing erzeugt oder manuell in Recrafts Designumgebung angeordnet werden. Das hilft, eine Überschrift, eine Illustration und ergänzenden Text in einer Komposition miteinander zu verbinden. Der Hersteller dokumentiert auch ausdrückliche Textlayout-Koordinaten, die relativ zum Bild statt als festes Pixelraster angegeben werden. Jedes Textelement enthält ein einzelnes Wort und vier Eckpunkte in normalisierten Koordinaten: (0, 0) bezeichnet oben links, (1, 1) unten rechts. Koordinaten dürfen über diesen Bereich hinausgehen; dann wird die Form beschnitten. Wörter in ausdrücklich festgelegten Textlayouts müssen den dokumentierten Zeichenbeschränkungen entsprechen.
Geben Sie für ein Plakat oder Cover den genauen Wortlaut an und beschreiben Sie seine Hierarchie: welche Zeile führt, wo sie sitzt und wie das Bild sie unterstützt. Prüfen Sie bei der Auswahl eines Ergebnisses die gerenderte Schreibweise und die Abstände.
V3 enthält kuratierte Foto-, Illustrations- und Emblemstile sowie eine separate Bibliothek für Vektorstile. Recraft V3 Raw ist der Standardstil des Rastermodells; Vector art ist der Standard der Vektorvariante. Photorealism zielt auf ein fotografisches Erscheinungsbild, während Illustration stilisierte Texturen, Schattierungen und komplexere Farbübergänge ermöglicht. Vektorstile bevorzugen Formen, begrenzte Paletten und flächige Füllungen oder einfache Verläufe.
Benutzerdefinierte Stile lassen sich aus Referenzbildern, vorhandenen kompatiblen Stilen oder einer Kombination daraus erstellen. Sie bieten eine wiederverwendbare visuelle Richtung für eine Bildserie. Die dokumentierten Mischeinstellungen erlauben separate Gewichte für Referenzen und Ausgangsstile; die Anzahl der Gewichte entspricht der Anzahl der Quellen. PaletteMatch und MaxWeight sind die beiden aufgeführten Mischrichtlinien. Der Hersteller erlaubt bis zu 10 Stilreferenzbilder und nutzt für V3 den regulären Stilabgleich. Ein gespeicherter benutzerdefinierter Stil und direkte Stilreferenzen sind alternative Eingaben; ein benutzerdefinierter Stil muss zum für die Generierung verwendeten Modell passen.
Bevorzugte Farben und eine Hintergrundfarbe führen die Palette. Dokumentiert sind bis zu 10 RGB-Farben mit Komponenten von jeweils 0 bis 255. Optionale relative Gewichte reichen von 0 bis 1; sie müssen für jede Farbe oder für keine angegeben werden, und ihre Summe darf 1 nicht überschreiten. Der künstlerische Grad reicht von 0 für eine statische, klare Behandlung bis zu 5 für dynamischere, exzentrische Kompositionen. Ein negativer Prompt beschreibt unerwünschte Elemente; eine separate Einstellung für Bilder ohne Text deaktiviert eingebettete Textlayouts. Ein Zufalls-Seed steht für Reproduzierbarkeit zur Verfügung. Diese Einstellungen bieten unterschiedliche Ansatzpunkte für Szene, Stil und visuelles Layout.
Recraft dokumentiert zwei V3-Varianten. Das Rastermodell erzeugt verlustfreies WebP oder PNG und eignet sich für fotografische Details, Schattierungen und texturierte Illustrationen. Recraft V3 Vector erzeugt SVG: Pfade und Formen, die ohne feste Pixelauflösung skalierbar sind. Es eignet sich für Piktogramme, Logokonzepte, Abzeichen und detaillierte Vektorgrafiken. Raster-zu-Vektor-Konvertierung ist eine separate Operation gegenüber der direkten Generierung von Vektorgrafiken.
Beide Varianten haben eine eigene Identität. Ein Bild mit vektorähnlichem Aussehen und eine tatsächliche SVG-Ausgabe sind unterschiedliche Optionen. Wählen Sie bei der Vorbereitung eines Designablaufs die gewünschte Ausgabe, statt den gemeinsamen Namen V3 als Nachweis zu behandeln, dass jede Operation denselben Dateityp liefert.
Recrafts V3-Dokumentation nennt Bild-zu-Bild-Generierung, Inpainting, Outpainting sowie Hintergrundaustausch oder Hintergrundgenerierung. Bild-zu-Bild-Arbeit kombiniert ein vorhandenes Bild mit einem neuen Briefing. Inpainting generiert den ausgewählten Bereich anhand eines Bildes und einer passenden Maske neu; Outpainting ergänzt Inhalt ausserhalb des ursprünglichen Rahmens. Hintergrundoperationen betreffen die Umgebung eines Motivs.
Zum zugehörigen Werkzeugsatz gehören ausserdem Radieren, Hintergrundentfernung, Vektorisierung und zwei Ansätze zur Hochskalierung. Kreative Hochskalierung kann neue Details hinzufügen; scharfe Hochskalierung zielt auf eine schärfere, grössere Darstellung des vorhandenen Inhalts. Dies sind getrennte Operationen mit eigenen Eingaben und Ergebnissen und keine zusätzlichen Bedeutungen der Raster- oder Vektormodellnamen.
Die V3-Generierungsspezifikation des Herstellers akzeptiert einen Prompt mit bis zu 1000 Zeichen und 1–6 Bilder pro Anfrage. Sie unterstützt 14 Seitenverhältnisse: 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 und 9:16. Dokumentierte Rasterbeispiele sind 1024x1024, 1820x1024 und 1024x1820. Exakte Rasterabmessungen müssen aus der unterstützten Liste stammen; SVG nutzt Seitenverhältnisse ohne feste Pixelgrösse. Wird die Grösse weggelassen, wählt das Herstellersystem sie anhand des Prompts aus.
Für Operationen mit Bildeingabe nennt der Hersteller PNG, JPG und WebP sowie SVG, sofern die jeweilige Operation es erlaubt. Dateien müssen unter 20 MB bleiben, dürfen höchstens 16 MP haben und auf der längsten Seite höchstens 4096 Pixel messen. Die kürzeste Seite beträgt mindestens 256 Pixel; für scharfe Hochskalierung gilt eine Ausnahme von 32 Pixeln. Masken entsprechen der Bildgrösse und verwenden reines Schwarz und Weiss; Stilreferenzen haben gemeinsam eine Grenze von 64 MB.
Formulieren Sie die Aufgabe für ein Ailoot-API-Projekt als gezieltes Bildbriefing: den genauen Text, die Anordnung der Objekte, den visuellen Stil und die gewünschte Komposition. Ein Plakat, eine Produktszene und eine Iconserie erfordern unterschiedliche Briefings; bewahren Sie bei der Entscheidung über die Verwendung jedes Ergebnisses die relevanten Unterschiede zwischen V3-Varianten und Operationen.
POST /v1/images/generationstext, imageimage| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits recraft/recraft-v3 | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 | Standard— |
Feldn | Typinteger | AnforderungOptional | Werte und Limits Minimum: 1 Maximum: 6 | Standard— |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits 1:1, 4:3, 3:4, 16:9, 9:16, auto | Standard— |
Feldinput_references | Typarray | AnforderungOptional | Werte und Limits Mindestanzahl Elemente: 0 Maximale Anzahl Elemente: 1 | Standard— |
Text zu Bild · Erforderlich: prompt
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt |
Parametermaterial_types | Vertragtext, image |
Parameteroptional_controls | Vertragaspect_ratio, n, input_references |
Parameterexact_supported_parameters | Vertrag{"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 | VertragAusschliesslich tatsächliche Bildreferenzen des Kunden; für sie gelten die Bedingungen des Anbieterendpunkts. |
Methodenaliasnamen: /v1/images
Lebenszyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · die tatsächlich zurückgegebene task_id oder ein Eintrag in der Medienbibliothek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Verwenden Sie das exakte Modell und die dokumentierten Eingabefelder.
Bewahren Sie die vollständige Antwort, jede tatsächliche Ausgabe und die ursprünglich zurückgegebenen IDs auf.
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Abrechnungseinheit | Gebühr |
|---|---|---|---|---|
| KonfigurationToken-Basistarife | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| KonfigurationUltra | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Ausgabebild | Gebühr Ausgabe · Bildausgabe · Schätzung nur zum Vergleich $0.08 pro Ausgabebild |
| KonfigurationGeschätzte Erzeugungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Abrechnungseinheit— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.08 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Referenztarifstaffeln auf Modellebene ändern weder Methodenauswahl noch Kostenvoranschläge oder Gebühren. Für die aktive Abrechnung gelten die Tarife der ausgewählten Ailoot-Methode.
| Konfiguration | Abrechnungsbedingungen | Gebühr |
|---|---|---|
| KonfigurationAusgabebild | AbrechnungsbedingungenEs ist keine Preisvariante deklariert. | Gebühr Ausgabe · Ausgabebild $0.08 pro Bild Gleichwertige Einträge beschreiben dieselbe Abbuchung; sie verursachen keine zweite Gebühr. |
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");\nLaden Sie jedes zurückgegebene Bild herunter oder speichern Sie seinen Base64-Inhalt
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Speichern Sie jedes fertiggestellte Bild; rufen Sie jede zurückgegebene URL ab oder dekodieren Sie seinen Base64-Inhalt.
Bewahren Sie jedes Datenelement und die vollständigen Verbrauchsdaten auf; übernehmen und speichern Sie alle tatsächlich zurückgegebenen Bilder unter eigener Kontrolle. Keine erfundenen URLs oder IDs.
Wenn das Ergebnis einer Bildgenerierung oder -bearbeitung geprüft werden muss, die ursprüngliche operation_id/X-Client-Request-ID und die zurückgegebenen Ergebnisinformationen aufbewahren. Bereits vorhandene eigene Ergebnisse über die Medienbibliothek anhand tatsächlicher task_id- oder asset_id-Werte wiederherstellen. Die Generierungs-/Bearbeitungsanfrage nicht erneut senden und keine Abfrage-URL aus operation_id bilden.
| Feld | Typ |
|---|---|
Feldcreated | Typinteger |
Felddata[].url | Typstring |
Felddata[].b64_json | Typbase64 string |
Feldusage | Typobject |
Ailoot Ultra recraft/recraft-v3
/v1/images