Recraft V4 Pro ist das höher auflösende Rastermodell in Recrafts V4-Familie. V4 konzentriert sich auf visuelles Urteilsvermögen, ausgewogene Komposition, stimmige Farben und eine sorgfältige Interpretation kreativer Vorgaben. Der Hersteller positioniert Pro für feinere Details, realistischere komplexe Szenen und umfangreiche Produktionsmotive. Nutzen Sie es für eine detaillierte Illustration, ein redaktionelles Bild, ein Plakatkonzept oder ein anderes Motiv, das von einem grösseren Rasterergebnis profitiert. Es bleibt vom späteren Modell V4.1 und von der SVG-Ausgabe von V4 Pro Vector getrennt.
Der genaue Herstellercode lautet recraftv4_pro. Die dokumentierte Ausgabe ist ein Rasterbild in 2K als verlustfreies WebP oder PNG: 2048 × 2048 Pixel für ein Quadrat, 2688 × 1536 für 16:9 und 1664 × 2560 für 2:3. Weitere unterstützte Seitenverhältnisse haben eigene Abmessungen. Wählen Sie ein Seitenverhältnis für das vorgesehene Layout oder eine exakt erlaubte Grösse; beliebige Pixelgrössen gehören nicht zum dokumentierten Generierungsvertrag. Das standardmässige V4 hat eine kleinere 1K-Rasterausgabe, während Vektormodelle keine feste Pixelauflösung haben.
V4 kann einen kurzen Prompt zur Erkundung oder einen strukturierten Prompt für ein kontrolliertes Ergebnis interpretieren. Für eine bestimmte künstlerische Richtung führt der Herstellerleitfaden von Motiv und Umgebung über Bildausschnitt, Eigenschaften, räumliche Beziehungen und Beleuchtung bis zu Tiefe und Stimmung. Fordern Sie für ein redaktionelles Produktbild eine dramatische vertikale Fotografie eines skulpturalen Stuhls, Oberflächen aus gebürstetem Metall, Seitenlicht, einen ruhigen dunklen Hintergrund und Platz oberhalb des Objekts für einen Titel an. Diese Beziehungen zu benennen macht die beabsichtigte Komposition klarer als eine allgemeine Bitte um ein hochwertiges Bild.
Das kreative Spektrum der Familie umfasst erzählerische Illustration, fotorealistische Szenen und räumlich wirkende Motive mit Material- und Lichthinweisen. Ein Ergebnis in 3D-Anmutung bleibt ein Bild und ist keine bearbeitbare 3D-Szene. Geben Sie für ein grafisches Plakat die visuellen Ebenen und ihr Zusammenspiel vor: Hintergrund, Illustration oder Fotografie, Hierarchie der Überschriften und ergänzender Text. V4 wird für lesbare kurze und mittellange Formulierungen positioniert; prüfen Sie jedoch fertige Schreibweise und Hierarchie, statt sie aus dem Modellnamen abzuleiten.
Die aktuelle Generierungsreferenz erlaubt Prompts mit bis zu 10'000 Zeichen, ein bis sechs Ausgaben, einen Zufalls-Seed sowie Einstellungen für bevorzugte Farben und Hintergrundfarbe. Optionale benutzerdefinierte Stile oder kompatible Referenzbilder können das Erscheinungsbild mit flexiblem oder präzisem Abgleich vorgeben. Das Modell akzeptiert die älteren V3-Einstellungen negative_prompt, kuratierte Stile, text_layout, artistic_level und no_text nicht. Beschreiben Sie das gewünschte fertige Bild im positiven Prompt und halten Sie Anforderungen an Motiv, Layout und Farben ausdrücklich fest. Für die Generierung anhand von Stilreferenzen verwenden Sie ein bis zehn PNG-, JPG- oder WebP-Bilder, insgesamt höchstens 64 MB und jeweils unter 20 MB. Bei jeder Referenz muss die kürzeste Seite mindestens 256 Pixel, die längste höchstens 4'096 Pixel und die Auflösung höchstens 16 Megapixel betragen. Verwenden Sie entweder diese Referenzen oder einen kompatiblen gespeicherten Stil, nicht beides zusammen.
Recraft dokumentiert eine separate Bild-zu-Bild-Operation für V4. Sie kombiniert ein vorhandenes Bild und einen Prompt mit einer Stärke von 0 bis 1 zur Steuerung des Änderungsgrads und akzeptiert dabei keine Einstellungen für benutzerdefinierte V4-Stile. Bereiten Sie die Vorlage innerhalb der Bild-Eingabegrenzen des Herstellers vor und nennen Sie die Eigenschaften, die in das neue Ergebnis übernommen werden sollen. Prüfen Sie bei einem grösseren fertigen Bild feine Details, Beschnitt und Schrift in der vorgesehenen Grösse. Die zusätzlichen Rasterdetails von Pro unterstützen diese Prüfung; das Bild bleibt eine generierte Interpretation des gelieferten kreativen Briefings. Für Bild-zu-Bild liefern Sie PNG, JPG, WebP oder SVG unter 20 MB mit höchstens 16 Megapixeln und beiden Seiten zwischen 256 und 4'096 Pixeln.
", "aboutText": "Recraft V4 Pro ist das höher auflösende Rastermodell in Recrafts V4-Familie. V4 konzentriert sich auf visuelles Urteilsvermögen, ausgewogene Komposition, stimmige Farben und eine sorgfältige Interpretation kreativer Vorgaben. Der Hersteller positioniert Pro für feinere Details, realistischere komplexe Szenen und umfangreiche Produktionsmotive. Nutzen Sie es für eine detaillierte Illustration, ein redaktionelles Bild, ein Plakatkonzept oder ein anderes Motiv, das von einem grösseren Rasterergebnis profitiert. Es bleibt vom späteren Modell V4.1 und von der SVG-Ausgabe von V4 Pro Vector getrennt.\n\nDer genaue Herstellercode lautet recraftv4_pro. Die dokumentierte Ausgabe ist ein Rasterbild in 2K als verlustfreies WebP oder PNG: 2048 × 2048 Pixel für ein Quadrat, 2688 × 1536 für 16:9 und 1664 × 2560 für 2:3. Weitere unterstützte Seitenverhältnisse haben eigene Abmessungen. Wählen Sie ein Seitenverhältnis für das vorgesehene Layout oder eine exakt erlaubte Grösse; beliebige Pixelgrössen gehören nicht zum dokumentierten Generierungsvertrag. Das standardmässige V4 hat eine kleinere 1K-Rasterausgabe, während Vektormodelle keine feste Pixelauflösung haben.\n\nV4 kann einen kurzen Prompt zur Erkundung oder einen strukturierten Prompt für ein kontrolliertes Ergebnis interpretieren. Für eine bestimmte künstlerische Richtung führt der Herstellerleitfaden von Motiv und Umgebung über Bildausschnitt, Eigenschaften, räumliche Beziehungen und Beleuchtung bis zu Tiefe und Stimmung. Fordern Sie für ein redaktionelles Produktbild eine dramatische vertikale Fotografie eines skulpturalen Stuhls, Oberflächen aus gebürstetem Metall, Seitenlicht, einen ruhigen dunklen Hintergrund und Platz oberhalb des Objekts für einen Titel an. Diese Beziehungen zu benennen macht die beabsichtigte Komposition klarer als eine allgemeine Bitte um ein hochwertiges Bild.\n\nDas kreative Spektrum der Familie umfasst erzählerische Illustration, fotorealistische Szenen und räumlich wirkende Motive mit Material- und Lichthinweisen. Ein Ergebnis in 3D-Anmutung bleibt ein Bild und ist keine bearbeitbare 3D-Szene. Geben Sie für ein grafisches Plakat die visuellen Ebenen und ihr Zusammenspiel vor: Hintergrund, Illustration oder Fotografie, Hierarchie der Überschriften und ergänzender Text. V4 wird für lesbare kurze und mittellange Formulierungen positioniert; prüfen Sie jedoch fertige Schreibweise und Hierarchie, statt sie aus dem Modellnamen abzuleiten.\n\nDie aktuelle Generierungsreferenz erlaubt Prompts mit bis zu 10'000 Zeichen, ein bis sechs Ausgaben, einen Zufalls-Seed sowie Einstellungen für bevorzugte Farben und Hintergrundfarbe. Optionale benutzerdefinierte Stile oder kompatible Referenzbilder können das Erscheinungsbild mit flexiblem oder präzisem Abgleich vorgeben. Das Modell akzeptiert die älteren V3-Einstellungen negative_prompt, kuratierte Stile, text_layout, artistic_level und no_text nicht. Beschreiben Sie das gewünschte fertige Bild im positiven Prompt und halten Sie Anforderungen an Motiv, Layout und Farben ausdrücklich fest. Für die Generierung anhand von Stilreferenzen verwenden Sie ein bis zehn PNG-, JPG- oder WebP-Bilder, insgesamt höchstens 64 MB und jeweils unter 20 MB. Bei jeder Referenz muss die kürzeste Seite mindestens 256 Pixel, die längste höchstens 4'096 Pixel und die Auflösung höchstens 16 Megapixel betragen. Verwenden Sie entweder diese Referenzen oder einen kompatiblen gespeicherten Stil, nicht beides zusammen.\n\nRecraft dokumentiert eine separate Bild-zu-Bild-Operation für V4. Sie kombiniert ein vorhandenes Bild und einen Prompt mit einer Stärke von 0 bis 1 zur Steuerung des Änderungsgrads und akzeptiert dabei keine Einstellungen für benutzerdefinierte V4-Stile. Bereiten Sie die Vorlage innerhalb der Bild-Eingabegrenzen des Herstellers vor und nennen Sie die Eigenschaften, die in das neue Ergebnis übernommen werden sollen. Prüfen Sie bei einem grösseren fertigen Bild feine Details, Beschnitt und Schrift in der vorgesehenen Grösse. Die zusätzlichen Rasterdetails von Pro unterstützen diese Prüfung; das Bild bleibt eine generierte Interpretation des gelieferten kreativen Briefings. Für Bild-zu-Bild liefern Sie PNG, JPG, WebP oder SVG unter 20 MB mit höchstens 16 Megapixeln und beiden Seiten zwischen 256 und 4'096 Pixeln.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "b28ad0d05c15c796f2d6d61e46e62f97b68603cadb006dacd92a473d636354ae", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "de-ch", "methods": [ { "html": "recraft/recraft-v4-proRecraft V4 Pro erzeugt Rasterbilder in 2K für detailreiche Kompositionen, Fotorealismus, Illustrationen und auf Druck ausgerichtete kreative Arbeit. Es ist die höher auflösende V4-Ausgabe mit Textbriefings, optionalen Stileingaben und einem separaten Bild-zu-Bild-Ablauf.
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 V4 Pro ist das höher auflösende Rastermodell in Recrafts V4-Familie. V4 konzentriert sich auf visuelles Urteilsvermögen, ausgewogene Komposition, stimmige Farben und eine sorgfältige Interpretation kreativer Vorgaben. Der Hersteller positioniert Pro für feinere Details, realistischere komplexe Szenen und umfangreiche Produktionsmotive. Nutzen Sie es für eine detaillierte Illustration, ein redaktionelles Bild, ein Plakatkonzept oder ein anderes Motiv, das von einem grösseren Rasterergebnis profitiert. Es bleibt vom späteren Modell V4.1 und von der SVG-Ausgabe von V4 Pro Vector getrennt.
Der genaue Herstellercode lautet recraftv4_pro. Die dokumentierte Ausgabe ist ein Rasterbild in 2K als verlustfreies WebP oder PNG: 2048 × 2048 Pixel für ein Quadrat, 2688 × 1536 für 16:9 und 1664 × 2560 für 2:3. Weitere unterstützte Seitenverhältnisse haben eigene Abmessungen. Wählen Sie ein Seitenverhältnis für das vorgesehene Layout oder eine exakt erlaubte Grösse; beliebige Pixelgrössen gehören nicht zum dokumentierten Generierungsvertrag. Das standardmässige V4 hat eine kleinere 1K-Rasterausgabe, während Vektormodelle keine feste Pixelauflösung haben.
V4 kann einen kurzen Prompt zur Erkundung oder einen strukturierten Prompt für ein kontrolliertes Ergebnis interpretieren. Für eine bestimmte künstlerische Richtung führt der Herstellerleitfaden von Motiv und Umgebung über Bildausschnitt, Eigenschaften, räumliche Beziehungen und Beleuchtung bis zu Tiefe und Stimmung. Fordern Sie für ein redaktionelles Produktbild eine dramatische vertikale Fotografie eines skulpturalen Stuhls, Oberflächen aus gebürstetem Metall, Seitenlicht, einen ruhigen dunklen Hintergrund und Platz oberhalb des Objekts für einen Titel an. Diese Beziehungen zu benennen macht die beabsichtigte Komposition klarer als eine allgemeine Bitte um ein hochwertiges Bild.
Das kreative Spektrum der Familie umfasst erzählerische Illustration, fotorealistische Szenen und räumlich wirkende Motive mit Material- und Lichthinweisen. Ein Ergebnis in 3D-Anmutung bleibt ein Bild und ist keine bearbeitbare 3D-Szene. Geben Sie für ein grafisches Plakat die visuellen Ebenen und ihr Zusammenspiel vor: Hintergrund, Illustration oder Fotografie, Hierarchie der Überschriften und ergänzender Text. V4 wird für lesbare kurze und mittellange Formulierungen positioniert; prüfen Sie jedoch fertige Schreibweise und Hierarchie, statt sie aus dem Modellnamen abzuleiten.
Die aktuelle Generierungsreferenz erlaubt Prompts mit bis zu 10'000 Zeichen, ein bis sechs Ausgaben, einen Zufalls-Seed sowie Einstellungen für bevorzugte Farben und Hintergrundfarbe. Optionale benutzerdefinierte Stile oder kompatible Referenzbilder können das Erscheinungsbild mit flexiblem oder präzisem Abgleich vorgeben. Das Modell akzeptiert die älteren V3-Einstellungen negative_prompt, kuratierte Stile, text_layout, artistic_level und no_text nicht. Beschreiben Sie das gewünschte fertige Bild im positiven Prompt und halten Sie Anforderungen an Motiv, Layout und Farben ausdrücklich fest. Für die Generierung anhand von Stilreferenzen verwenden Sie ein bis zehn PNG-, JPG- oder WebP-Bilder, insgesamt höchstens 64 MB und jeweils unter 20 MB. Bei jeder Referenz muss die kürzeste Seite mindestens 256 Pixel, die längste höchstens 4'096 Pixel und die Auflösung höchstens 16 Megapixel betragen. Verwenden Sie entweder diese Referenzen oder einen kompatiblen gespeicherten Stil, nicht beides zusammen.
Recraft dokumentiert eine separate Bild-zu-Bild-Operation für V4. Sie kombiniert ein vorhandenes Bild und einen Prompt mit einer Stärke von 0 bis 1 zur Steuerung des Änderungsgrads und akzeptiert dabei keine Einstellungen für benutzerdefinierte V4-Stile. Bereiten Sie die Vorlage innerhalb der Bild-Eingabegrenzen des Herstellers vor und nennen Sie die Eigenschaften, die in das neue Ergebnis übernommen werden sollen. Prüfen Sie bei einem grösseren fertigen Bild feine Details, Beschnitt und Schrift in der vorgesehenen Grösse. Die zusätzlichen Rasterdetails von Pro unterstützen diese Prüfung; das Bild bleibt eine generierte Interpretation des gelieferten kreativen Briefings. Für Bild-zu-Bild liefern Sie PNG, JPG, WebP oder SVG unter 20 MB mit höchstens 16 Megapixeln und beiden Seiten zwischen 256 und 4'096 Pixeln.
POST /v1/images/generationstext, imageimage| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits recraft/recraft-v4-pro | 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.5 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.5 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.5 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-v4-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nfrom openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\n\nrequest={'model': 'recraft/recraft-v4-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "recraft/recraft-v4-pro", "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-v4-pro
/v1/images