Recraft V3 ist ein Bilderzeugungsmodell 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 zugleich die Stilkonsistenz anhand von Beispielbildern ohne erneutes Training.
V3 arbeitet mit Text innerhalb des Bildes, einschließlich längerer Texte und mittelgroßer Schrift. Recraft beschreibt einen Layoutschritt, der vor der Bilderzeugung Wörter und ihre Positionen festlegt. Das Layout kann automatisch aus dem Briefing entstehen oder in Recrafts Designumgebung manuell angeordnet werden. Dadurch lassen sich Überschrift, Illustration und ergänzender Text in einer Komposition verbinden. Der Hersteller dokumentiert außerdem ausdrückliche Textlayout-Koordinaten, die relativ zum Bild statt auf einem festen Pixelraster angegeben werden. Jedes Textelement enthält ein einzelnes Wort und vier Eckpunkte in normalisierten Koordinaten: (0, 0) liegt oben links und (1, 1) unten rechts. Koordinaten dürfen diesen Bereich überschreiten; dann wird die Form zugeschnitten. Wörter in einem ausdrücklich vorgegebenen Textlayout müssen den dokumentierten Zeichenbeschränkungen entsprechen.
Geben Sie für ein Plakat oder Cover den exakten Wortlaut an und beschreiben Sie seine Hierarchie: welche Zeile führt, wo sie steht 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 Vektorstilbibliothek. Recraft V3 Raw ist der Standardstil des Rastermodells; Vector art ist der Standard der Vektorvariante. Photorealism zielt auf eine fotografische Erscheinung, 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 erstellen. Sie liefern eine wiederverwendbare Bildsprache über eine Bildserie hinweg. Mit den dokumentierten Mischsteuerungen können Referenzen und Ausgangsstile separate Gewichte erhalten; die Anzahl der Gewichte entspricht der Anzahl der Quellen. PaletteMatch und MaxWeight sind die beiden aufgeführten Mischregeln. Der Hersteller erlaubt bis zu 10 Stilreferenzbilder und verwendet bei V3 den regulären Stilabgleichmodus. 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 leiten die Palette. Dokumentiert sind bis zu 10 RGB-Farben, deren Komponenten jeweils von 0 bis 255 reichen. Optionale relative Gewichte liegen zwischen 0 und 1. Sie müssen entweder für jede Farbe oder für keine angegeben werden, und ihre Summe darf 1 nicht überschreiten. Das künstlerische Niveau reicht von 0 für eine statische, klare Gestaltung bis 5 für dynamischere, exzentrische Kompositionen. Ein negativer Prompt beschreibt unerwünschte Elemente; eine separate Steuerung zum Unterdrücken von Text deaktiviert eingebettete Textlayouts. Für Reproduzierbarkeit steht ein Zufalls-Seed zur Verfügung. Diese Steuerelemente bieten unterschiedliche Ansatzpunkte für die Szene, ihren Stil und ihr visuelles Layout.
Recraft dokumentiert zwei V3-Varianten. Das Rastermodell erzeugt verlustfreies WebP oder PNG und eignet sich für fotografische Details, Schattierungen und texturierte Illustration. Recraft V3 Vector erzeugt SVG: Pfade und Formen, die ohne feste Pixelauflösung skalieren. Es eignet sich für Piktogramme, Logoentwürfe, Abzeichen und detaillierte Vektorgrafiken. Die Umwandlung von Raster in Vektor ist eine separate Operation gegenüber der direkten Erzeugung von Vektorgrafiken.
Beide Varianten haben eine eigene Identität. Ein Bild mit vektorähnlicher Optik und eine tatsächliche SVG-Ausgabe sind unterschiedliche Optionen. Wählen Sie bei der Vorbereitung eines Designworkflows die gewünschte Ausgabe, statt den gemeinsamen Namen V3 als Beleg zu nehmen, dass jede Operation denselben Dateityp zurückgibt.
Recrafts V3-Dokumentation führt Image-to-Image-Generierung, Inpainting, Outpainting sowie Hintergrundersetzung oder -generierung auf. Image-to-Image kombiniert ein vorhandenes Bild mit einem neuen Briefing. Inpainting erzeugt den ausgewählten Bereich anhand eines Bildes und einer passenden Maske neu; Outpainting ergänzt Inhalte außerhalb des ursprünglichen Bildrahmens. Hintergrundoperationen bearbeiten die Umgebung eines Motivs.
Das begleitende Werkzeugset umfasst außerdem Radieren, Hintergrundentfernung, Vektorisierung und zwei Upscaling-Verfahren. Kreatives Upscaling kann neue Details einbringen; scharfes Upscaling zielt auf eine schärfere, größere Wiedergabe vorhandener Inhalte. Dies sind eigenständige Operationen mit eigenen Eingaben und Ergebnissen und keine zusätzlichen Bedeutungen des Raster- oder Vektormodellnamens.
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 Liste unterstützter Größen stammen; SVG verwendet Seitenverhältnisse ohne feste Pixelgröße. Wenn die Größe fehlt, wählt das Herstellersystem sie anhand des Prompts.
Für Operationen mit Bildeingabe nennt der Hersteller PNG, JPG und WebP sowie SVG, wenn die jeweilige Operation es erlaubt. Dateien müssen unter 20 MB bleiben und dürfen höchstens 16 MP aufweisen; die längste Seite darf höchstens 4096 Pixel messen. Die kürzeste Seite muss mindestens 256 Pixel haben, mit einer 32-Pixel-Ausnahme für scharfes Upscaling. Masken entsprechen der Bildgröße und verwenden reines Schwarz und Weiß; für Stilreferenzen gilt ein gemeinsames Limit von 64 MB.
Formulieren Sie für ein Ailoot-API-Projekt die Aufgabe als gezieltes Bildbriefing: exakter Text, Objektanordnung, Bildstil und gewünschte Komposition. Ein Plakat, eine Produktszene und eine Iconserie benötigen 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 Bilderzeugungsmodell 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 zugleich die Stilkonsistenz anhand von Beispielbildern ohne erneutes Training.\n\n### Text als Teil der Komposition\n\nV3 arbeitet mit Text innerhalb des Bildes, einschließlich längerer Texte und mittelgroßer Schrift. Recraft beschreibt einen Layoutschritt, der vor der Bilderzeugung Wörter und ihre Positionen festlegt. Das Layout kann automatisch aus dem Briefing entstehen oder in Recrafts Designumgebung manuell angeordnet werden. Dadurch lassen sich Überschrift, Illustration und ergänzender Text in einer Komposition verbinden. Der Hersteller dokumentiert außerdem ausdrückliche Textlayout-Koordinaten, die relativ zum Bild statt auf einem festen Pixelraster angegeben werden. Jedes Textelement enthält ein einzelnes Wort und vier Eckpunkte in normalisierten Koordinaten: (0, 0) liegt oben links und (1, 1) unten rechts. Koordinaten dürfen diesen Bereich überschreiten; dann wird die Form zugeschnitten. Wörter in einem ausdrücklich vorgegebenen Textlayout müssen den dokumentierten Zeichenbeschränkungen entsprechen.\n\nGeben Sie für ein Plakat oder Cover den exakten Wortlaut an und beschreiben Sie seine Hierarchie: welche Zeile führt, wo sie steht 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 Vektorstilbibliothek. Recraft V3 Raw ist der Standardstil des Rastermodells; Vector art ist der Standard der Vektorvariante. Photorealism zielt auf eine fotografische Erscheinung, 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 erstellen. Sie liefern eine wiederverwendbare Bildsprache über eine Bildserie hinweg. Mit den dokumentierten Mischsteuerungen können Referenzen und Ausgangsstile separate Gewichte erhalten; die Anzahl der Gewichte entspricht der Anzahl der Quellen. PaletteMatch und MaxWeight sind die beiden aufgeführten Mischregeln. Der Hersteller erlaubt bis zu 10 Stilreferenzbilder und verwendet bei V3 den regulären Stilabgleichmodus. 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 leiten die Palette. Dokumentiert sind bis zu 10 RGB-Farben, deren Komponenten jeweils von 0 bis 255 reichen. Optionale relative Gewichte liegen zwischen 0 und 1. Sie müssen entweder für jede Farbe oder für keine angegeben werden, und ihre Summe darf 1 nicht überschreiten. Das künstlerische Niveau reicht von 0 für eine statische, klare Gestaltung bis 5 für dynamischere, exzentrische Kompositionen. Ein negativer Prompt beschreibt unerwünschte Elemente; eine separate Steuerung zum Unterdrücken von Text deaktiviert eingebettete Textlayouts. Für Reproduzierbarkeit steht ein Zufalls-Seed zur Verfügung. Diese Steuerelemente bieten unterschiedliche Ansatzpunkte für die Szene, ihren Stil und ihr 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 Illustration. Recraft V3 Vector erzeugt SVG: Pfade und Formen, die ohne feste Pixelauflösung skalieren. Es eignet sich für Piktogramme, Logoentwürfe, Abzeichen und detaillierte Vektorgrafiken. Die Umwandlung von Raster in Vektor ist eine separate Operation gegenüber der direkten Erzeugung von Vektorgrafiken.\n\nBeide Varianten haben eine eigene Identität. Ein Bild mit vektorähnlicher Optik und eine tatsächliche SVG-Ausgabe sind unterschiedliche Optionen. Wählen Sie bei der Vorbereitung eines Designworkflows die gewünschte Ausgabe, statt den gemeinsamen Namen V3 als Beleg zu nehmen, dass jede Operation denselben Dateityp zurückgibt.\n\n### Vorhandene Grafiken bearbeiten und fertigstellen\n\nRecrafts V3-Dokumentation führt Image-to-Image-Generierung, Inpainting, Outpainting sowie Hintergrundersetzung oder -generierung auf. Image-to-Image kombiniert ein vorhandenes Bild mit einem neuen Briefing. Inpainting erzeugt den ausgewählten Bereich anhand eines Bildes und einer passenden Maske neu; Outpainting ergänzt Inhalte außerhalb des ursprünglichen Bildrahmens. Hintergrundoperationen bearbeiten die Umgebung eines Motivs.\n\nDas begleitende Werkzeugset umfasst außerdem Radieren, Hintergrundentfernung, Vektorisierung und zwei Upscaling-Verfahren. Kreatives Upscaling kann neue Details einbringen; scharfes Upscaling zielt auf eine schärfere, größere Wiedergabe vorhandener Inhalte. Dies sind eigenständige Operationen mit eigenen Eingaben und Ergebnissen und keine zusätzlichen Bedeutungen des Raster- oder Vektormodellnamens.\n\n### Grenzen für Prompts, Größen 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 Liste unterstützter Größen stammen; SVG verwendet Seitenverhältnisse ohne feste Pixelgröße. Wenn die Größe fehlt, wählt das Herstellersystem sie anhand des Prompts.\n\nFür Operationen mit Bildeingabe nennt der Hersteller PNG, JPG und WebP sowie SVG, wenn die jeweilige Operation es erlaubt. Dateien müssen unter 20 MB bleiben und dürfen höchstens 16 MP aufweisen; die längste Seite darf höchstens 4096 Pixel messen. Die kürzeste Seite muss mindestens 256 Pixel haben, mit einer 32-Pixel-Ausnahme für scharfes Upscaling. Masken entsprechen der Bildgröße und verwenden reines Schwarz und Weiß; für Stilreferenzen gilt ein gemeinsames Limit von 64 MB.\n\nFormulieren Sie für ein Ailoot-API-Projekt die Aufgabe als gezieltes Bildbriefing: exakter Text, Objektanordnung, Bildstil und gewünschte Komposition. Ein Plakat, eine Produktszene und eine Iconserie benötigen 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": "311631b2cb9b4892946baae234051830787306b034f8cdfb4a6fd26f93c15338", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "de", "methods": [ { "html": "recraft/recraft-v3Recraft V3 erstellt Fotos, Illustrationen und grafische Layouts mit textbewusster Komposition und Stilsteuerungen. Seine getrennten Raster- und SVG-Varianten eignen sich für Plakate, Markenbildserien, Icons und Designs, in 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 Bilderzeugungsmodell 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 zugleich die Stilkonsistenz anhand von Beispielbildern ohne erneutes Training.
V3 arbeitet mit Text innerhalb des Bildes, einschließlich längerer Texte und mittelgroßer Schrift. Recraft beschreibt einen Layoutschritt, der vor der Bilderzeugung Wörter und ihre Positionen festlegt. Das Layout kann automatisch aus dem Briefing entstehen oder in Recrafts Designumgebung manuell angeordnet werden. Dadurch lassen sich Überschrift, Illustration und ergänzender Text in einer Komposition verbinden. Der Hersteller dokumentiert außerdem ausdrückliche Textlayout-Koordinaten, die relativ zum Bild statt auf einem festen Pixelraster angegeben werden. Jedes Textelement enthält ein einzelnes Wort und vier Eckpunkte in normalisierten Koordinaten: (0, 0) liegt oben links und (1, 1) unten rechts. Koordinaten dürfen diesen Bereich überschreiten; dann wird die Form zugeschnitten. Wörter in einem ausdrücklich vorgegebenen Textlayout müssen den dokumentierten Zeichenbeschränkungen entsprechen.
Geben Sie für ein Plakat oder Cover den exakten Wortlaut an und beschreiben Sie seine Hierarchie: welche Zeile führt, wo sie steht 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 Vektorstilbibliothek. Recraft V3 Raw ist der Standardstil des Rastermodells; Vector art ist der Standard der Vektorvariante. Photorealism zielt auf eine fotografische Erscheinung, 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 erstellen. Sie liefern eine wiederverwendbare Bildsprache über eine Bildserie hinweg. Mit den dokumentierten Mischsteuerungen können Referenzen und Ausgangsstile separate Gewichte erhalten; die Anzahl der Gewichte entspricht der Anzahl der Quellen. PaletteMatch und MaxWeight sind die beiden aufgeführten Mischregeln. Der Hersteller erlaubt bis zu 10 Stilreferenzbilder und verwendet bei V3 den regulären Stilabgleichmodus. 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 leiten die Palette. Dokumentiert sind bis zu 10 RGB-Farben, deren Komponenten jeweils von 0 bis 255 reichen. Optionale relative Gewichte liegen zwischen 0 und 1. Sie müssen entweder für jede Farbe oder für keine angegeben werden, und ihre Summe darf 1 nicht überschreiten. Das künstlerische Niveau reicht von 0 für eine statische, klare Gestaltung bis 5 für dynamischere, exzentrische Kompositionen. Ein negativer Prompt beschreibt unerwünschte Elemente; eine separate Steuerung zum Unterdrücken von Text deaktiviert eingebettete Textlayouts. Für Reproduzierbarkeit steht ein Zufalls-Seed zur Verfügung. Diese Steuerelemente bieten unterschiedliche Ansatzpunkte für die Szene, ihren Stil und ihr visuelles Layout.
Recraft dokumentiert zwei V3-Varianten. Das Rastermodell erzeugt verlustfreies WebP oder PNG und eignet sich für fotografische Details, Schattierungen und texturierte Illustration. Recraft V3 Vector erzeugt SVG: Pfade und Formen, die ohne feste Pixelauflösung skalieren. Es eignet sich für Piktogramme, Logoentwürfe, Abzeichen und detaillierte Vektorgrafiken. Die Umwandlung von Raster in Vektor ist eine separate Operation gegenüber der direkten Erzeugung von Vektorgrafiken.
Beide Varianten haben eine eigene Identität. Ein Bild mit vektorähnlicher Optik und eine tatsächliche SVG-Ausgabe sind unterschiedliche Optionen. Wählen Sie bei der Vorbereitung eines Designworkflows die gewünschte Ausgabe, statt den gemeinsamen Namen V3 als Beleg zu nehmen, dass jede Operation denselben Dateityp zurückgibt.
Recrafts V3-Dokumentation führt Image-to-Image-Generierung, Inpainting, Outpainting sowie Hintergrundersetzung oder -generierung auf. Image-to-Image kombiniert ein vorhandenes Bild mit einem neuen Briefing. Inpainting erzeugt den ausgewählten Bereich anhand eines Bildes und einer passenden Maske neu; Outpainting ergänzt Inhalte außerhalb des ursprünglichen Bildrahmens. Hintergrundoperationen bearbeiten die Umgebung eines Motivs.
Das begleitende Werkzeugset umfasst außerdem Radieren, Hintergrundentfernung, Vektorisierung und zwei Upscaling-Verfahren. Kreatives Upscaling kann neue Details einbringen; scharfes Upscaling zielt auf eine schärfere, größere Wiedergabe vorhandener Inhalte. Dies sind eigenständige Operationen mit eigenen Eingaben und Ergebnissen und keine zusätzlichen Bedeutungen des Raster- oder Vektormodellnamens.
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 Liste unterstützter Größen stammen; SVG verwendet Seitenverhältnisse ohne feste Pixelgröße. Wenn die Größe fehlt, wählt das Herstellersystem sie anhand des Prompts.
Für Operationen mit Bildeingabe nennt der Hersteller PNG, JPG und WebP sowie SVG, wenn die jeweilige Operation es erlaubt. Dateien müssen unter 20 MB bleiben und dürfen höchstens 16 MP aufweisen; die längste Seite darf höchstens 4096 Pixel messen. Die kürzeste Seite muss mindestens 256 Pixel haben, mit einer 32-Pixel-Ausnahme für scharfes Upscaling. Masken entsprechen der Bildgröße und verwenden reines Schwarz und Weiß; für Stilreferenzen gilt ein gemeinsames Limit von 64 MB.
Formulieren Sie für ein Ailoot-API-Projekt die Aufgabe als gezieltes Bildbriefing: exakter Text, Objektanordnung, Bildstil und gewünschte Komposition. Ein Plakat, eine Produktszene und eine Iconserie benötigen 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 | VertragAusschließlich 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 genaue 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 |
|---|---|---|---|---|
| KonfigurationBasistarife für Token | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Token Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Lesen · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Token |
| KonfigurationUltra | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Ausgabebild | Gebühr Ausgabe · Bildausgabe · Schätzung nur zum Vergleich $0.08 pro Ausgabebild |
| KonfigurationGeschätzte Generierungskosten | 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 abschließenden 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 Abrechnung; sie fügen keine zweite Gebühr hinzu. |
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 als Ihnen zugeordnete Assets. 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