Recraft V4 ist das standardmässige Rastermodell der V4-Generation von Recraft. Der Hersteller betont gestalterisches Urteilsvermögen: ausgewogene Komposition, stimmige Farbbeziehungen und Details, die die visuelle Absicht unterstützen. Es kann mit stilisierten Illustrationen, fotografischen Szenen und Grafikdesignkonzepten arbeiten. Nutzen Sie es, wenn das Briefing ein Bild verlangt, das ästhetische Entscheidungen mit genauer Promptumsetzung verbindet – ob Sie aus einer kurzen Vorgabe eine Stimmung erkunden oder ein bewusstes Layout detailliert festlegen.
Der genaue Modellcode lautet recraftv4. Die Herstellerreferenz nennt eine Rasterausgabe in 1K als verlustfreies WebP oder PNG. Ein quadratisches Bild hat 1024 × 1024 Pixel, 16:9 hat 1344 × 768 und 2:3 hat 832 × 1280; andere unterstützte Seitenverhältnisse verwenden eigene Abmessungen. V4 Pro ist die separate 2K-Rasterausgabe, während V4 Vector und Pro Vector bearbeitbares SVG liefern. Wählen Sie die genaue V4-Variante für das gewünschte Ergebnis, statt diese unterschiedlichen Ausgabeeigenschaften miteinander zu kombinieren.
Der Herstellerleitfaden unterscheidet kurze interpretative Prompts von strukturierten kreativen Vorgaben. Eine kurze Formulierung kann Raum zum Erkunden von Form, Stimmung und Bildausschnitt lassen. Ein strukturiertes Briefing kann Motiv, Umgebung, Pose, Material, sekundäre Elemente, Beleuchtung und visuelle Hierarchie benennen. Beschreiben Sie für eine erzählerische Illustration eine Person auf dem Fahrrad, die eine kleine Brücke überquert, markante vereinfachte Formen, warme gedeckte Farben und eine klare Bewegung von links nach rechts. Diese Entscheidungen zu Inhalt und Komposition sind besser umsetzbar als eine lange Liste unzusammenhängender Stiladjektive.
Das Spektrum von V4 umfasst Illustrationen, räumlich wirkende Bilder und fotorealistische Motive. Der Leitfaden empfiehlt, bei Illustrationen die Zeichenlogik zu beschreiben und bei Bildern mit 3D-Anmutung Material, Licht, Kamera und Tiefe. Letztere bleiben Rasterbilder und sind keine bearbeitbaren Meshes. Geben Sie für ein Plakat- oder Verpackungskonzept an, welche Wörter im Vordergrund stehen, wohin sie gehören und wie Bild und Typografie zusammenspielen. Der Hersteller hebt lesbaren kurzen und mittellangen Text hervor; prüfen Sie den tatsächlichen Wortlaut und die Anordnung im zurückgegebenen Bild, bevor Sie es verwenden.
Die Generierung unterstützt Prompts mit bis zu 10'000 Zeichen, einen Zufalls-Seed, ein bis sechs Ausgaben, bevorzugte Farben und eine gewünschte Hintergrundfarbe. Optionale kompatible benutzerdefinierte Stile und Referenzbilder können die visuelle Behandlung durch flexiblen oder präzisen Abgleich steuern. Wählen Sie eine klare Referenz oder eine Serie aus derselben Bildwelt und lassen Sie den Prompt das neue Motiv und die Szene beschreiben. Eine Farbübereinstimmung zwischen Referenz und Ausgabe ist nicht garantiert; halten Sie die erforderliche Palette daher ausdrücklich fest und vergleichen Sie das Ergebnis damit. 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.
Die dokumentierte Bild-zu-Bild-Operation kombiniert ein vorhandenes Bild und einen Prompt; eine Stärke von 0 bis 1 bestimmt, wie weit sich die neue Ausgabe von der Vorlage entfernt. Sie akzeptiert dabei keine V4-Stileinstellungen. Die aktuelle Generierungsreferenz schliesst ausserdem kuratierte Stilnamen, negative_prompt, text_layout, artistic_level und no_text aus. Bereiten Sie eine positive Beschreibung des gewünschten Ergebnisses vor und beurteilen Sie das Bild innerhalb seiner Zielkomposition. Das standardmässige V4 liefert eine gezielte gestalterische Rasterinterpretation mit einer bestimmten Ausgabe, einem bestimmten Format und einer bestimmten Ausgabegrösse. 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 ist das standardmässige Rastermodell der V4-Generation von Recraft. Der Hersteller betont gestalterisches Urteilsvermögen: ausgewogene Komposition, stimmige Farbbeziehungen und Details, die die visuelle Absicht unterstützen. Es kann mit stilisierten Illustrationen, fotografischen Szenen und Grafikdesignkonzepten arbeiten. Nutzen Sie es, wenn das Briefing ein Bild verlangt, das ästhetische Entscheidungen mit genauer Promptumsetzung verbindet – ob Sie aus einer kurzen Vorgabe eine Stimmung erkunden oder ein bewusstes Layout detailliert festlegen.\n\nDer genaue Modellcode lautet recraftv4. Die Herstellerreferenz nennt eine Rasterausgabe in 1K als verlustfreies WebP oder PNG. Ein quadratisches Bild hat 1024 × 1024 Pixel, 16:9 hat 1344 × 768 und 2:3 hat 832 × 1280; andere unterstützte Seitenverhältnisse verwenden eigene Abmessungen. V4 Pro ist die separate 2K-Rasterausgabe, während V4 Vector und Pro Vector bearbeitbares SVG liefern. Wählen Sie die genaue V4-Variante für das gewünschte Ergebnis, statt diese unterschiedlichen Ausgabeeigenschaften miteinander zu kombinieren.\n\nDer Herstellerleitfaden unterscheidet kurze interpretative Prompts von strukturierten kreativen Vorgaben. Eine kurze Formulierung kann Raum zum Erkunden von Form, Stimmung und Bildausschnitt lassen. Ein strukturiertes Briefing kann Motiv, Umgebung, Pose, Material, sekundäre Elemente, Beleuchtung und visuelle Hierarchie benennen. Beschreiben Sie für eine erzählerische Illustration eine Person auf dem Fahrrad, die eine kleine Brücke überquert, markante vereinfachte Formen, warme gedeckte Farben und eine klare Bewegung von links nach rechts. Diese Entscheidungen zu Inhalt und Komposition sind besser umsetzbar als eine lange Liste unzusammenhängender Stiladjektive.\n\nDas Spektrum von V4 umfasst Illustrationen, räumlich wirkende Bilder und fotorealistische Motive. Der Leitfaden empfiehlt, bei Illustrationen die Zeichenlogik zu beschreiben und bei Bildern mit 3D-Anmutung Material, Licht, Kamera und Tiefe. Letztere bleiben Rasterbilder und sind keine bearbeitbaren Meshes. Geben Sie für ein Plakat- oder Verpackungskonzept an, welche Wörter im Vordergrund stehen, wohin sie gehören und wie Bild und Typografie zusammenspielen. Der Hersteller hebt lesbaren kurzen und mittellangen Text hervor; prüfen Sie den tatsächlichen Wortlaut und die Anordnung im zurückgegebenen Bild, bevor Sie es verwenden.\n\nDie Generierung unterstützt Prompts mit bis zu 10'000 Zeichen, einen Zufalls-Seed, ein bis sechs Ausgaben, bevorzugte Farben und eine gewünschte Hintergrundfarbe. Optionale kompatible benutzerdefinierte Stile und Referenzbilder können die visuelle Behandlung durch flexiblen oder präzisen Abgleich steuern. Wählen Sie eine klare Referenz oder eine Serie aus derselben Bildwelt und lassen Sie den Prompt das neue Motiv und die Szene beschreiben. Eine Farbübereinstimmung zwischen Referenz und Ausgabe ist nicht garantiert; halten Sie die erforderliche Palette daher ausdrücklich fest und vergleichen Sie das Ergebnis damit. 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\nDie dokumentierte Bild-zu-Bild-Operation kombiniert ein vorhandenes Bild und einen Prompt; eine Stärke von 0 bis 1 bestimmt, wie weit sich die neue Ausgabe von der Vorlage entfernt. Sie akzeptiert dabei keine V4-Stileinstellungen. Die aktuelle Generierungsreferenz schliesst ausserdem kuratierte Stilnamen, negative_prompt, text_layout, artistic_level und no_text aus. Bereiten Sie eine positive Beschreibung des gewünschten Ergebnisses vor und beurteilen Sie das Bild innerhalb seiner Zielkomposition. Das standardmässige V4 liefert eine gezielte gestalterische Rasterinterpretation mit einer bestimmten Ausgabe, einem bestimmten Format und einer bestimmten Ausgabegrösse. 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": "4a2d1fb743bd4e920f7d66c63bccf8dd39171facb007724bc9f4d13985e336d1", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "de-ch", "methods": [ { "html": "recraft/recraft-v4Recraft V4 erzeugt Rasterbilder in 1K mit Schwerpunkt auf Komposition, Farbbeziehungen und detaillierten kreativen Vorgaben. Es deckt Illustrationen, fotorealistische Szenen und Grafikdesignkonzepte ab, mit 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 ist das standardmässige Rastermodell der V4-Generation von Recraft. Der Hersteller betont gestalterisches Urteilsvermögen: ausgewogene Komposition, stimmige Farbbeziehungen und Details, die die visuelle Absicht unterstützen. Es kann mit stilisierten Illustrationen, fotografischen Szenen und Grafikdesignkonzepten arbeiten. Nutzen Sie es, wenn das Briefing ein Bild verlangt, das ästhetische Entscheidungen mit genauer Promptumsetzung verbindet – ob Sie aus einer kurzen Vorgabe eine Stimmung erkunden oder ein bewusstes Layout detailliert festlegen.
Der genaue Modellcode lautet recraftv4. Die Herstellerreferenz nennt eine Rasterausgabe in 1K als verlustfreies WebP oder PNG. Ein quadratisches Bild hat 1024 × 1024 Pixel, 16:9 hat 1344 × 768 und 2:3 hat 832 × 1280; andere unterstützte Seitenverhältnisse verwenden eigene Abmessungen. V4 Pro ist die separate 2K-Rasterausgabe, während V4 Vector und Pro Vector bearbeitbares SVG liefern. Wählen Sie die genaue V4-Variante für das gewünschte Ergebnis, statt diese unterschiedlichen Ausgabeeigenschaften miteinander zu kombinieren.
Der Herstellerleitfaden unterscheidet kurze interpretative Prompts von strukturierten kreativen Vorgaben. Eine kurze Formulierung kann Raum zum Erkunden von Form, Stimmung und Bildausschnitt lassen. Ein strukturiertes Briefing kann Motiv, Umgebung, Pose, Material, sekundäre Elemente, Beleuchtung und visuelle Hierarchie benennen. Beschreiben Sie für eine erzählerische Illustration eine Person auf dem Fahrrad, die eine kleine Brücke überquert, markante vereinfachte Formen, warme gedeckte Farben und eine klare Bewegung von links nach rechts. Diese Entscheidungen zu Inhalt und Komposition sind besser umsetzbar als eine lange Liste unzusammenhängender Stiladjektive.
Das Spektrum von V4 umfasst Illustrationen, räumlich wirkende Bilder und fotorealistische Motive. Der Leitfaden empfiehlt, bei Illustrationen die Zeichenlogik zu beschreiben und bei Bildern mit 3D-Anmutung Material, Licht, Kamera und Tiefe. Letztere bleiben Rasterbilder und sind keine bearbeitbaren Meshes. Geben Sie für ein Plakat- oder Verpackungskonzept an, welche Wörter im Vordergrund stehen, wohin sie gehören und wie Bild und Typografie zusammenspielen. Der Hersteller hebt lesbaren kurzen und mittellangen Text hervor; prüfen Sie den tatsächlichen Wortlaut und die Anordnung im zurückgegebenen Bild, bevor Sie es verwenden.
Die Generierung unterstützt Prompts mit bis zu 10'000 Zeichen, einen Zufalls-Seed, ein bis sechs Ausgaben, bevorzugte Farben und eine gewünschte Hintergrundfarbe. Optionale kompatible benutzerdefinierte Stile und Referenzbilder können die visuelle Behandlung durch flexiblen oder präzisen Abgleich steuern. Wählen Sie eine klare Referenz oder eine Serie aus derselben Bildwelt und lassen Sie den Prompt das neue Motiv und die Szene beschreiben. Eine Farbübereinstimmung zwischen Referenz und Ausgabe ist nicht garantiert; halten Sie die erforderliche Palette daher ausdrücklich fest und vergleichen Sie das Ergebnis damit. 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.
Die dokumentierte Bild-zu-Bild-Operation kombiniert ein vorhandenes Bild und einen Prompt; eine Stärke von 0 bis 1 bestimmt, wie weit sich die neue Ausgabe von der Vorlage entfernt. Sie akzeptiert dabei keine V4-Stileinstellungen. Die aktuelle Generierungsreferenz schliesst ausserdem kuratierte Stilnamen, negative_prompt, text_layout, artistic_level und no_text aus. Bereiten Sie eine positive Beschreibung des gewünschten Ergebnisses vor und beurteilen Sie das Bild innerhalb seiner Zielkomposition. Das standardmässige V4 liefert eine gezielte gestalterische Rasterinterpretation mit einer bestimmten Ausgabe, einem bestimmten Format und einer bestimmten Ausgabegrösse. 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 | 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
reference_guided_image · Erforderlich: prompt, actual image reference
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt |
Parametermaterial_types | Vertragtext, image |
Parameteroptional_controls | Vertragn, aspect_ratio, input_references |
Parametern | Vertrag{"minimum":1,"maximum":6} |
Parameterreference_images | Vertrag{"minimum":0,"maximum":1,"source":"Tatsächlich vom Kunden bereitgestelltes Material"} |
Parameterprovider_specific_options | VertragAusschliesslich gespeicherte exakte Freigabeliste des Endpunkts für style/controls/text_layout; keine geratenen Strukturen. |
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}
Das Beispiel mit ausschliesslich einer Texteingabe bewahrt die offizielle Struktur von ImageGenerationRequest.
Bewahren Sie jedes zurückgegebene Bild und die vollständige Antwort auf; massgebend ist die tatsächliche Ausgabeanzahl, nicht das angeforderte n.
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 · Ausgabebild · 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-v4', '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', '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", "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 |
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungPflichtfelder, Darstellung des Eingabematerials oder Parameterwert ungültig | Nächster SchrittDie angegebenen Felder vor einer neuen Erstellungsanfrage korrigieren. |
Antwortserver_error | BedingungDie zurückgegebene Antwort gibt an, dass der Vorgang oder das Ergebnis eine Prüfung erfordert | Nächster SchrittDie ursprünglich zurückgegebene Vorgangs-/Aufgaben-ID, die Anfrageheader und die Antwort aufbewahren; mit unterstützten Leseaufrufen für diesen ursprünglichen Vorgang fortfahren. Die Erstellungsanfrage nicht erneut senden. |
Ailoot Ultra recraft/recraft-v4
/v1/images