Eine schnellere Ausgabe zur Bilderstellung
Seedream 5.0 Flash ist ByteDance Seeds Bildgenerierungs- und Bearbeitungsmodell für Abläufe mit Schwerpunkt auf Generierungsgeschwindigkeit. Der Pro-/Flash-Leitfaden beschreibt Text-zu-Bild sowie Bild-zu-Bild mit einer oder mehreren Referenzen. Er unterscheidet Flashs schnellere Generierung von Pros höherer Bildqualitätspriorität, ohne eine feste Antwortzeit für jedes Briefing festzulegen.
Die prägenden gemeinsamen Funktionen sind interaktive Bearbeitung, Ebenenzerlegung und native mehrsprachige Generierung. Normale Generierung liefert ein fertiges Bild. Der Flash-Ablauf des Herstellers unterstützt weder sequenzielle Generierung zusammengehöriger Bilder noch Websuche oder gestreamte Bildausgabe. Seine Prompt-Optimierung nutzt standard; die separate schnelle Optimierungssteuerung gehört zu Pro, nicht Flash.
Erstellung aus Briefing und Referenzen
Beschreiben Sie gewünschtes Bild, Hauptmotiv, Komposition und Gestaltung und benennen Sie danach, was jede Referenz steuert. Trennen Sie bei Produktmotiven die Objektidentitätsreferenz von einer Referenz für Palette oder Oberflächenmaterial. „Behalte Objektsilhouette und Blickwinkel aus dem ersten Bild bei; verwende das zweite nur für die gedämpfte Hintergrundpalette“ weist klare Rollen zu.
Der Hersteller empfiehlt knappe Prompts mit höchstens 300 chinesischen Zeichen oder 600 englischen Wörtern. Das ist Vorbereitungshilfe und keine genannte harte Texteingabegrenze. Listen Sie entscheidende Anforderungen zuerst auf, einschließlich exakt sichtbarem Wortlaut, gewünschtem Seitenverhältnis und unveränderten Details. Prüfen Sie das fertige Bild an dieser Liste statt nur nach Gesamteindruck.
Räumlich geführte Bearbeitung
Flash kann Punkte, Begrenzungsrahmen, Pfeile und freie Markierungen zur Bearbeitungsortangabe nutzen. Liefern Sie das Ausgangsbild mit Ort und Änderung. Markieren Sie für ein Innenraumkonzept den Stuhl, verlangen Sie einen Stoffaustausch und benennen Sie zu erhaltenden Boden, Wand, Kamerawinkel und benachbarte Gegenstände. Dienen die Markierungen nur als Vorgabe, verlangen Sie ausdrücklich ihre Entfernung aus dem fertigen Bild.
Der Koordinatenleitfaden des Herstellers verwendet <point>- und <bbox>-Tags mit auf 0–999 normalisierten Koordinaten relativ zum genannten Eingabebild. Ein Punkt enthält x und y; ein Rahmen die obere linke und untere rechte Koordinate. Benennen Sie Bildnummer und Zielobjekt, besonders wenn ein Rahmen mehrere Motive einschließt. Unterscheiden Sie bei bildübergreifender Bearbeitung das aus einer Referenz zu übernehmende Objekt und den Zielbereich in einer anderen.
Nutzen Sie für die proportionale Position die eigenen Abmessungen des angezeigten Bildes; Zoom, Verschiebung der Arbeitsfläche oder Browserkoordinaten sind keine normalisierten Bildkoordinaten. Beschreiben Sie geschützte und bearbeitete Bereiche. Vergleichen Sie Perspektive, Licht und Umgebungsdetails des Ergebnisses mit der Originalquelle.
Eine Komposition in bearbeitbare Ebenen zerlegen
Ebenenzerlegung ist ein separater Modus, der genau ein Bild nimmt und ein Basisbild mit bis zu 16 unabhängigen Ebenen zurückgibt. Jede Ebene ist ein PNG mit Alphakanal. Ein Prompt kann zu trennende Elemente nennen, etwa Titel, Hauptmotiv und Dekorationen; ohne Zerlegungsprompt erkennt das Modell Hauptelemente automatisch.
Die Ergebnisse enthalten Ebenennamen, Beschreibungen, Stapelreihenfolge und Platzierungsrahmen. Verwenden Sie das Basisbild mit Stapelindex null und platzieren Sie weitere Ebenen in aufsteigender Reihenfolge. Absolute Rahmen beschreiben die Platzierung im Ausgabebasisbild, normalisierte Rahmen die proportionale Platzierung auf einer anderen Arbeitsfläche. Bewahren Sie diese Metadaten mit den Bilddateien auf, um die Originalkomposition vor einer Umordnung rekonstruieren zu können.
Trennen Sie für eine Plakatüberarbeitung Hauptbild, Titel und Dekorationen und prüfen Sie anschließend Kanten und wiederhergestellte Hintergrundflächen. Eine transparente Ebene lässt sich als einzelne Alphakanaleingabe mit transparenter PNG-Ausgabe bearbeiten. Die Transparenzoption gilt für diesen Bildbearbeitungsablauf mit einer Eingabe; normale Text-zu-Bild-Generierung ist eine separate Operation.
Mehrsprachige Komposition
Neben Chinesisch und Englisch dokumentiert der Hersteller native Prompt- und Bildtextunterstützung für Russisch, Arabisch, Filipino, Thai, Türkisch, Koreanisch, Malaiisch, Spanisch, Portugiesisch, Indonesisch, Französisch, Deutsch, Vietnamesisch und Japanisch. Geben Sie genauen freigegebenen Wortlaut und Leserichtung vor und benennen Sie den Bereich jedes Textblocks. Prüfen Sie Akzente, verbundene Zeichen, Zeilenumbrüche und kleine Beschriftungen im fertigen Bild.
Referenzdateien und Ausgabespezifikationen
Bildgenerierung akzeptiert bis zu 10 Referenzen in JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC oder HEIF. Jede darf bis 30 MB groß sein, mit beiden Seiten über 14 Pixeln, insgesamt 196–36.000.000 Pixeln und Seitenverhältnissen von 1:16 bis 16:1. Ebenenzerlegung benötigt stattdessen ein JPEG oder PNG mit 262.144–36.000.000 Pixeln, bis 30 MB und demselben Verhältnisbereich.
Die Generierung bietet Ausgabestufen von 1K, 1.5K und 2K, standardmäßig 2K, oder ausdrückliche Abmessungen mit insgesamt 921.600–4.624.220 Pixeln und Verhältnissen von 1:16 bis 16:1. Beide Vorgaben gelten für eigene Abmessungen. Ebenenausgabe nutzt 1K, 1.5K, 2K oder auto, standardmäßig auto; Basis und jede Ebene behalten ihre jeweiligen Quellseitenverhältnisse.
Fertige Bilder sind JPEG oder PNG. Das Basisbildformat kann separat gewählt werden; zerlegte Ebenen bleiben PNG mit Alphakanal. Bereitstellung kann über kodierte Bilddaten oder 24 Stunden aufbewahrte Downloadlinks erfolgen. Sichern Sie jedes zurückgegebene Bild und seine Metadaten für den vorgesehenen Designablauf. Prüfen Sie Text, bearbeitete Details und Ebenenausrichtung in der späteren Anzeigegröße.
", "aboutText": "Eine schnellere Ausgabe zur Bilderstellung\n\nSeedream 5.0 Flash ist ByteDance Seeds Bildgenerierungs- und Bearbeitungsmodell für Abläufe mit Schwerpunkt auf Generierungsgeschwindigkeit. Der Pro-/Flash-Leitfaden beschreibt Text-zu-Bild sowie Bild-zu-Bild mit einer oder mehreren Referenzen. Er unterscheidet Flashs schnellere Generierung von Pros höherer Bildqualitätspriorität, ohne eine feste Antwortzeit für jedes Briefing festzulegen.\n\nDie prägenden gemeinsamen Funktionen sind interaktive Bearbeitung, Ebenenzerlegung und native mehrsprachige Generierung. Normale Generierung liefert ein fertiges Bild. Der Flash-Ablauf des Herstellers unterstützt weder sequenzielle Generierung zusammengehöriger Bilder noch Websuche oder gestreamte Bildausgabe. Seine Prompt-Optimierung nutzt standard; die separate schnelle Optimierungssteuerung gehört zu Pro, nicht Flash.\n\nErstellung aus Briefing und Referenzen\n\nBeschreiben Sie gewünschtes Bild, Hauptmotiv, Komposition und Gestaltung und benennen Sie danach, was jede Referenz steuert. Trennen Sie bei Produktmotiven die Objektidentitätsreferenz von einer Referenz für Palette oder Oberflächenmaterial. „Behalte Objektsilhouette und Blickwinkel aus dem ersten Bild bei; verwende das zweite nur für die gedämpfte Hintergrundpalette“ weist klare Rollen zu.\n\nDer Hersteller empfiehlt knappe Prompts mit höchstens 300 chinesischen Zeichen oder 600 englischen Wörtern. Das ist Vorbereitungshilfe und keine genannte harte Texteingabegrenze. Listen Sie entscheidende Anforderungen zuerst auf, einschließlich exakt sichtbarem Wortlaut, gewünschtem Seitenverhältnis und unveränderten Details. Prüfen Sie das fertige Bild an dieser Liste statt nur nach Gesamteindruck.\n\nRäumlich geführte Bearbeitung\n\nFlash kann Punkte, Begrenzungsrahmen, Pfeile und freie Markierungen zur Bearbeitungsortangabe nutzen. Liefern Sie das Ausgangsbild mit Ort und Änderung. Markieren Sie für ein Innenraumkonzept den Stuhl, verlangen Sie einen Stoffaustausch und benennen Sie zu erhaltenden Boden, Wand, Kamerawinkel und benachbarte Gegenstände. Dienen die Markierungen nur als Vorgabe, verlangen Sie ausdrücklich ihre Entfernung aus dem fertigen Bild.\n\nDer Koordinatenleitfaden des Herstellers verwendetbytedance-seed/seedream-5-0-flashAus einer Textbeschreibung ein fertiges Bild erstellen.
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.
Eine schnellere Ausgabe zur Bilderstellung
Seedream 5.0 Flash ist ByteDance Seeds Bildgenerierungs- und Bearbeitungsmodell für Abläufe mit Schwerpunkt auf Generierungsgeschwindigkeit. Der Pro-/Flash-Leitfaden beschreibt Text-zu-Bild sowie Bild-zu-Bild mit einer oder mehreren Referenzen. Er unterscheidet Flashs schnellere Generierung von Pros höherer Bildqualitätspriorität, ohne eine feste Antwortzeit für jedes Briefing festzulegen.
Die prägenden gemeinsamen Funktionen sind interaktive Bearbeitung, Ebenenzerlegung und native mehrsprachige Generierung. Normale Generierung liefert ein fertiges Bild. Der Flash-Ablauf des Herstellers unterstützt weder sequenzielle Generierung zusammengehöriger Bilder noch Websuche oder gestreamte Bildausgabe. Seine Prompt-Optimierung nutzt standard; die separate schnelle Optimierungssteuerung gehört zu Pro, nicht Flash.
Erstellung aus Briefing und Referenzen
Beschreiben Sie gewünschtes Bild, Hauptmotiv, Komposition und Gestaltung und benennen Sie danach, was jede Referenz steuert. Trennen Sie bei Produktmotiven die Objektidentitätsreferenz von einer Referenz für Palette oder Oberflächenmaterial. „Behalte Objektsilhouette und Blickwinkel aus dem ersten Bild bei; verwende das zweite nur für die gedämpfte Hintergrundpalette“ weist klare Rollen zu.
Der Hersteller empfiehlt knappe Prompts mit höchstens 300 chinesischen Zeichen oder 600 englischen Wörtern. Das ist Vorbereitungshilfe und keine genannte harte Texteingabegrenze. Listen Sie entscheidende Anforderungen zuerst auf, einschließlich exakt sichtbarem Wortlaut, gewünschtem Seitenverhältnis und unveränderten Details. Prüfen Sie das fertige Bild an dieser Liste statt nur nach Gesamteindruck.
Räumlich geführte Bearbeitung
Flash kann Punkte, Begrenzungsrahmen, Pfeile und freie Markierungen zur Bearbeitungsortangabe nutzen. Liefern Sie das Ausgangsbild mit Ort und Änderung. Markieren Sie für ein Innenraumkonzept den Stuhl, verlangen Sie einen Stoffaustausch und benennen Sie zu erhaltenden Boden, Wand, Kamerawinkel und benachbarte Gegenstände. Dienen die Markierungen nur als Vorgabe, verlangen Sie ausdrücklich ihre Entfernung aus dem fertigen Bild.
Der Koordinatenleitfaden des Herstellers verwendet <point>- und <bbox>-Tags mit auf 0–999 normalisierten Koordinaten relativ zum genannten Eingabebild. Ein Punkt enthält x und y; ein Rahmen die obere linke und untere rechte Koordinate. Benennen Sie Bildnummer und Zielobjekt, besonders wenn ein Rahmen mehrere Motive einschließt. Unterscheiden Sie bei bildübergreifender Bearbeitung das aus einer Referenz zu übernehmende Objekt und den Zielbereich in einer anderen.
Nutzen Sie für die proportionale Position die eigenen Abmessungen des angezeigten Bildes; Zoom, Verschiebung der Arbeitsfläche oder Browserkoordinaten sind keine normalisierten Bildkoordinaten. Beschreiben Sie geschützte und bearbeitete Bereiche. Vergleichen Sie Perspektive, Licht und Umgebungsdetails des Ergebnisses mit der Originalquelle.
Eine Komposition in bearbeitbare Ebenen zerlegen
Ebenenzerlegung ist ein separater Modus, der genau ein Bild nimmt und ein Basisbild mit bis zu 16 unabhängigen Ebenen zurückgibt. Jede Ebene ist ein PNG mit Alphakanal. Ein Prompt kann zu trennende Elemente nennen, etwa Titel, Hauptmotiv und Dekorationen; ohne Zerlegungsprompt erkennt das Modell Hauptelemente automatisch.
Die Ergebnisse enthalten Ebenennamen, Beschreibungen, Stapelreihenfolge und Platzierungsrahmen. Verwenden Sie das Basisbild mit Stapelindex null und platzieren Sie weitere Ebenen in aufsteigender Reihenfolge. Absolute Rahmen beschreiben die Platzierung im Ausgabebasisbild, normalisierte Rahmen die proportionale Platzierung auf einer anderen Arbeitsfläche. Bewahren Sie diese Metadaten mit den Bilddateien auf, um die Originalkomposition vor einer Umordnung rekonstruieren zu können.
Trennen Sie für eine Plakatüberarbeitung Hauptbild, Titel und Dekorationen und prüfen Sie anschließend Kanten und wiederhergestellte Hintergrundflächen. Eine transparente Ebene lässt sich als einzelne Alphakanaleingabe mit transparenter PNG-Ausgabe bearbeiten. Die Transparenzoption gilt für diesen Bildbearbeitungsablauf mit einer Eingabe; normale Text-zu-Bild-Generierung ist eine separate Operation.
Mehrsprachige Komposition
Neben Chinesisch und Englisch dokumentiert der Hersteller native Prompt- und Bildtextunterstützung für Russisch, Arabisch, Filipino, Thai, Türkisch, Koreanisch, Malaiisch, Spanisch, Portugiesisch, Indonesisch, Französisch, Deutsch, Vietnamesisch und Japanisch. Geben Sie genauen freigegebenen Wortlaut und Leserichtung vor und benennen Sie den Bereich jedes Textblocks. Prüfen Sie Akzente, verbundene Zeichen, Zeilenumbrüche und kleine Beschriftungen im fertigen Bild.
Referenzdateien und Ausgabespezifikationen
Bildgenerierung akzeptiert bis zu 10 Referenzen in JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC oder HEIF. Jede darf bis 30 MB groß sein, mit beiden Seiten über 14 Pixeln, insgesamt 196–36.000.000 Pixeln und Seitenverhältnissen von 1:16 bis 16:1. Ebenenzerlegung benötigt stattdessen ein JPEG oder PNG mit 262.144–36.000.000 Pixeln, bis 30 MB und demselben Verhältnisbereich.
Die Generierung bietet Ausgabestufen von 1K, 1.5K und 2K, standardmäßig 2K, oder ausdrückliche Abmessungen mit insgesamt 921.600–4.624.220 Pixeln und Verhältnissen von 1:16 bis 16:1. Beide Vorgaben gelten für eigene Abmessungen. Ebenenausgabe nutzt 1K, 1.5K, 2K oder auto, standardmäßig auto; Basis und jede Ebene behalten ihre jeweiligen Quellseitenverhältnisse.
Fertige Bilder sind JPEG oder PNG. Das Basisbildformat kann separat gewählt werden; zerlegte Ebenen bleiben PNG mit Alphakanal. Bereitstellung kann über kodierte Bilddaten oder 24 Stunden aufbewahrte Downloadlinks erfolgen. Sichern Sie jedes zurückgegebene Bild und seine Metadaten für den vorgesehenen Designablauf. Prüfen Sie Text, bearbeitete Details und Ebenenausrichtung in der späteren Anzeigegröße.
POST /v1/images/generationstextimage| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits bytedance-seed/seedream-5-0-flash | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 Bedingungen: Nicht leerer UTF8-Prompt. Es wird keine herstellerweit geltende Zeichengrenze erfunden. | Standard— |
Feldn | Typinteger | AnforderungOptional | Werte und Limits 1 | Standard1 |
Feldresponse_format | Typstring | AnforderungOptional | Werte und Limits url, b64_json | Standard— |
Feldstream | Typboolean | AnforderungOptional | Werte und Limits false | Standardfalse |
Text zu Bild · Erforderlich: prompt
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt |
Parametermaterial_types | Vertragtext |
Parameteroptional | Vertragn, response_format, stream |
Parametern | Vertrag1 |
Parameterstream | Vertragfalse |
Parameterresponse_format | Vertragurl, b64_json |
Parameterreference_images | Vertragfalse |
Parameteredit | Vertragfalse |
Parameteroutput_format_optional | Vertrag |
Parameterresolution_control | Vertragnull |
Parameteraspect_ratio_control | Vertragnull |
Parameterother_fields | Vertragabgelehnt, außer bei der exakt festgelegten internen Anbieterroutenwahl |
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}
Generieren Sie ein Bild aus einem Prompt.
Speichern Sie jedes Datenelement; url/b64_json sind Ergebniskodierungen.
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 Tokens | 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 · In Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · In Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| KonfigurationEingabebild | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Eingabebild | Gebühr Eingabe · Eingabebild · Schätzung nur zum Vergleich $0 pro Eingabebild |
| KonfigurationUltra | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Ausgabebild | Gebühr Ausgabe · Bildausgabe · Schätzung nur zum Vergleich $0.036 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.036 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.
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Abrechnungsbedingungen | Gebühr |
|---|---|---|
| KonfigurationAusgabebild | AbrechnungsbedingungenEs ist keine Preisvariante deklariert. | Gebühr Ausgabe · Ausgabebild $0.036 pro Bild |
| KonfigurationEingabebild | AbrechnungsbedingungenEs ist keine Preisvariante deklariert. | Gebühr Eingabe · Eingabebild $0 pro Bild |
Gleichwertige Einträge beschreiben denselben Betrag; 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=json.loads('{"model": "bytedance-seed/seedream-5-0-flash", "prompt": "A lighthouse on a cliff, watercolor", "n": 1, "response_format": "b64_json"}')\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': 'bytedance-seed/seedream-5-0-flash', 'prompt': 'A lighthouse on a cliff, watercolor', 'n': 1, 'response_format': 'b64_json'}\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": "bytedance-seed/seedream-5-0-flash", "prompt": "A lighthouse on a cliff, watercolor", "n": 1, "response_format": "b64_json"};\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.
Jedes Datenelement speichern. Jedes b64_json dekodieren oder jede zurückgegebene signierte URL abrufen. Die Dateiendung anhand des tatsächlichen MIME-Typs bzw. der Bytes wählen.
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 bytedance-seed/seedream-5-0-flash
Verwenden Sie die oben angezeigten Methodenpfade.