Een snellere editie voor beeldcreatie
Seedream 5.0 Flash is het beeldgeneratie- en bewerkingsmodel van ByteDance Seed voor workflows die generatiesnelheid vooropstellen. De Pro/Flash-gids van de maker beschrijft zowel tekst-naar-beeld als afbeelding-naar-afbeeldingcreatie met één of meerdere referenties. Hij onderscheidt de snellere generatie van Flash van de hogere beeldkwaliteitsprioriteit van Pro, zonder een vaste antwoordtijd voor elke briefing vast te leggen.
De kenmerkende gedeelde functies zijn interactieve bewerking, laagontleding en native meertalige generatie. Gewone generatie geeft één afgewerkte afbeelding terug. De Flash-workflow van de fabrikant ondersteunt geen opeenvolgende generatie van verwante beelden, webzoeken of streaming van beelduitvoer. De promptoptimalisatie gebruikt standaardmodus; de afzonderlijke snelle optimalisatie-instelling hoort bij Pro, niet bij Flash.
Creëren vanuit een briefing en referenties
Vermeld het bedoelde beeld, hoofdonderwerp, compositie en visuele uitwerking en benoem daarna wat elke referentie stuurt. Scheid bij een productbeeld de referentie die het object bepaalt van een referentie die een palet of oppervlaktemateriaal levert. “Behoud silhouet en kijkhoek van het object uit de eerste afbeelding; gebruik de tweede alleen voor het ingetogen achtergrondpalet” geeft de referenties verschillende rollen.
De maker beveelt beknopte prompts aan, maximaal 300 Chinese tekens of 600 Engelse woorden. Dat is voorbereidingsadvies, geen opgegeven harde afkapgrens voor tekstinvoer. Zet de doorslaggevende vereisten eerst, inclusief exacte tekst die moet verschijnen, de gewenste beeldverhouding en details die ongewijzigd moeten blijven. Vergelijk het afgewerkte beeld met die lijst in plaats van alleen op het algemene uiterlijk te vertrouwen.
Ruimtelijk gestuurde bewerking
Flash kan punten, begrenzingsvakken, pijlen en vrije markeringen gebruiken om aan te geven waar een bewerking moet plaatsvinden. Lever het bronbeeld aan samen met een locatie en de wijziging. Markeer voor een interieurconcept de stoel, vraag een vervanging van de stof en benoem vloer, muur, camerahoek en nabije objecten die moeten blijven. Vraag expliciet om de markeringen uit het eindbeeld te verwijderen als ze alleen aanwijzingen zijn.
De coördinatenbewerkingsgids van de maker gebruikt <point>- en <bbox>-tags met coördinaten genormaliseerd naar 0–999 ten opzichte van de opgegeven invoerafbeelding. Een punt bevat x en y; een vak bevat de coördinaten linksboven en rechtsonder. Benoem afbeeldingsnummer en doelobject, vooral als een vak meerdere onderwerpen omvat. Onderscheid bij een bewerking tussen afbeeldingen het object uit de ene referentie en het bestemmingsgebied in een andere.
Gebruik de eigen afmetingen van de getoonde afbeelding om de relatieve locatie te bepalen; canvaszoom, verschuiving of browsercoördinaten zijn geen genormaliseerde afbeeldingscoördinaten. Beschrijf beschermde gebieden naast het bewerkte gebied. Vergelijk perspectief, verlichting en omliggende details van het resultaat met de oorspronkelijke bron.
Splits een compositie op in bewerkbare lagen
Laagontleding is een afzonderlijke modus die precies één afbeelding gebruikt en een basisafbeelding plus maximaal 16 onafhankelijke lagen teruggeeft. Elke laag is een PNG met alfa. Een prompt kan de te scheiden elementen benoemen, zoals titel, hoofdonderwerp en decoraties; zonder ontledingsprompt bepaalt het model de hoofdelementen automatisch.
De resultaten bevatten laagnamen, beschrijvingen, stapelvolgorde en plaatsingsvakken. Gebruik de basisafbeelding met stapelindex nul en plaats de andere lagen daarna in oplopende stapelvolgorde. Absolute vakken beschrijven de plaatsing in de uitvoerbasisafbeelding; genormaliseerde vakken beschrijven relatieve plaatsing op een ander canvas. Bewaar die teruggestuurde plaatsingsmetadata bij de afbeeldingsbestanden, zodat je de oorspronkelijke compositie kan reconstrueren voordat je ze herschikt.
Scheid voor een posterherziening het hoofdbeeld van titel en decoraties en controleer daarna randen en eventueel herstelde achtergrondzones. Een transparante laag kan worden bewerkt als één invoer met alfakanaal, met transparante PNG-uitvoer. De optie voor transparante achtergrond geldt voor die workflow voor beeldbewerking met één invoer; gewone tekst-naar-beeldgeneratie is een afzonderlijke bewerking.
Meertalige compositie
Naast Chinees en Engels documenteert de maker native ondersteuning voor prompts en beeldtekst in Russisch, Arabisch, Filipijns, Thai, Turks, Koreaans, Maleis, Spaans, Portugees, Indonesisch, Frans, Duits, Vietnamees en Japans. Geef de exacte goedgekeurde formulering en leesrichting op en benoem in welke zone elk tekstblok staat. Controleer accenten, verbonden tekens, regelafbrekingen en kleine labels in het eindbeeld.
Referentiebestanden en uitvoerspecificaties
Beeldgeneratie accepteert maximaal 10 referenties in JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC of HEIF. Elke afbeelding mag maximaal 30 MB zijn, met beide zijden groter dan 14 pixels, 196–36.000.000 pixels in totaal en een beeldverhouding van 1:16 tot 16:1. Laagontleding vereist daarentegen één JPEG of PNG van 262.144–36.000.000 pixels, maximaal 30 MB, binnen hetzelfde verhoudingsbereik.
Generatie biedt uitvoerniveaus 1K, 1.5K en 2K, standaard 2K, of expliciete afmetingen met 921.600–4.624.220 pixels in totaal en verhoudingen van 1:16 tot 16:1. Beide voorwaarden gelden voor aangepaste afmetingen. Laaguitvoer gebruikt 1K, 1.5K, 2K of auto, met auto als standaard; de basis en elke laag behouden hun respectieve bronverhoudingen.
Afgewerkte afbeeldingen zijn JPEG of PNG. Het formaat van de basisafbeelding kan afzonderlijk worden gekozen, terwijl ontlede lagen PNG met alfa blijven. Levering kan gecodeerde afbeeldingsdata of downloadlinks met een bewaartijd van 24 uur gebruiken. Bewaar elke teruggestuurde afbeelding en haar metadata voor de bedoelde ontwerpworkflow. Controleer tekst, bewerkte details en laaguitlijning op de grootte waarop het beeld zal worden gebruikt.
", "aboutText": "Een snellere editie voor beeldcreatie\n\nSeedream 5.0 Flash is het beeldgeneratie- en bewerkingsmodel van ByteDance Seed voor workflows die generatiesnelheid vooropstellen. De Pro/Flash-gids van de maker beschrijft zowel tekst-naar-beeld als afbeelding-naar-afbeeldingcreatie met één of meerdere referenties. Hij onderscheidt de snellere generatie van Flash van de hogere beeldkwaliteitsprioriteit van Pro, zonder een vaste antwoordtijd voor elke briefing vast te leggen.\n\nDe kenmerkende gedeelde functies zijn interactieve bewerking, laagontleding en native meertalige generatie. Gewone generatie geeft één afgewerkte afbeelding terug. De Flash-workflow van de fabrikant ondersteunt geen opeenvolgende generatie van verwante beelden, webzoeken of streaming van beelduitvoer. De promptoptimalisatie gebruikt standaardmodus; de afzonderlijke snelle optimalisatie-instelling hoort bij Pro, niet bij Flash.\n\nCreëren vanuit een briefing en referenties\n\nVermeld het bedoelde beeld, hoofdonderwerp, compositie en visuele uitwerking en benoem daarna wat elke referentie stuurt. Scheid bij een productbeeld de referentie die het object bepaalt van een referentie die een palet of oppervlaktemateriaal levert. “Behoud silhouet en kijkhoek van het object uit de eerste afbeelding; gebruik de tweede alleen voor het ingetogen achtergrondpalet” geeft de referenties verschillende rollen.\n\nDe maker beveelt beknopte prompts aan, maximaal 300 Chinese tekens of 600 Engelse woorden. Dat is voorbereidingsadvies, geen opgegeven harde afkapgrens voor tekstinvoer. Zet de doorslaggevende vereisten eerst, inclusief exacte tekst die moet verschijnen, de gewenste beeldverhouding en details die ongewijzigd moeten blijven. Vergelijk het afgewerkte beeld met die lijst in plaats van alleen op het algemene uiterlijk te vertrouwen.\n\nRuimtelijk gestuurde bewerking\n\nFlash kan punten, begrenzingsvakken, pijlen en vrije markeringen gebruiken om aan te geven waar een bewerking moet plaatsvinden. Lever het bronbeeld aan samen met een locatie en de wijziging. Markeer voor een interieurconcept de stoel, vraag een vervanging van de stof en benoem vloer, muur, camerahoek en nabije objecten die moeten blijven. Vraag expliciet om de markeringen uit het eindbeeld te verwijderen als ze alleen aanwijzingen zijn.\n\nDe coördinatenbewerkingsgids van de maker gebruiktbytedance-seed/seedream-5-0-flashMaak één afgewerkte afbeelding op basis van een tekstuele briefing.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Een snellere editie voor beeldcreatie
Seedream 5.0 Flash is het beeldgeneratie- en bewerkingsmodel van ByteDance Seed voor workflows die generatiesnelheid vooropstellen. De Pro/Flash-gids van de maker beschrijft zowel tekst-naar-beeld als afbeelding-naar-afbeeldingcreatie met één of meerdere referenties. Hij onderscheidt de snellere generatie van Flash van de hogere beeldkwaliteitsprioriteit van Pro, zonder een vaste antwoordtijd voor elke briefing vast te leggen.
De kenmerkende gedeelde functies zijn interactieve bewerking, laagontleding en native meertalige generatie. Gewone generatie geeft één afgewerkte afbeelding terug. De Flash-workflow van de fabrikant ondersteunt geen opeenvolgende generatie van verwante beelden, webzoeken of streaming van beelduitvoer. De promptoptimalisatie gebruikt standaardmodus; de afzonderlijke snelle optimalisatie-instelling hoort bij Pro, niet bij Flash.
Creëren vanuit een briefing en referenties
Vermeld het bedoelde beeld, hoofdonderwerp, compositie en visuele uitwerking en benoem daarna wat elke referentie stuurt. Scheid bij een productbeeld de referentie die het object bepaalt van een referentie die een palet of oppervlaktemateriaal levert. “Behoud silhouet en kijkhoek van het object uit de eerste afbeelding; gebruik de tweede alleen voor het ingetogen achtergrondpalet” geeft de referenties verschillende rollen.
De maker beveelt beknopte prompts aan, maximaal 300 Chinese tekens of 600 Engelse woorden. Dat is voorbereidingsadvies, geen opgegeven harde afkapgrens voor tekstinvoer. Zet de doorslaggevende vereisten eerst, inclusief exacte tekst die moet verschijnen, de gewenste beeldverhouding en details die ongewijzigd moeten blijven. Vergelijk het afgewerkte beeld met die lijst in plaats van alleen op het algemene uiterlijk te vertrouwen.
Ruimtelijk gestuurde bewerking
Flash kan punten, begrenzingsvakken, pijlen en vrije markeringen gebruiken om aan te geven waar een bewerking moet plaatsvinden. Lever het bronbeeld aan samen met een locatie en de wijziging. Markeer voor een interieurconcept de stoel, vraag een vervanging van de stof en benoem vloer, muur, camerahoek en nabije objecten die moeten blijven. Vraag expliciet om de markeringen uit het eindbeeld te verwijderen als ze alleen aanwijzingen zijn.
De coördinatenbewerkingsgids van de maker gebruikt <point>- en <bbox>-tags met coördinaten genormaliseerd naar 0–999 ten opzichte van de opgegeven invoerafbeelding. Een punt bevat x en y; een vak bevat de coördinaten linksboven en rechtsonder. Benoem afbeeldingsnummer en doelobject, vooral als een vak meerdere onderwerpen omvat. Onderscheid bij een bewerking tussen afbeeldingen het object uit de ene referentie en het bestemmingsgebied in een andere.
Gebruik de eigen afmetingen van de getoonde afbeelding om de relatieve locatie te bepalen; canvaszoom, verschuiving of browsercoördinaten zijn geen genormaliseerde afbeeldingscoördinaten. Beschrijf beschermde gebieden naast het bewerkte gebied. Vergelijk perspectief, verlichting en omliggende details van het resultaat met de oorspronkelijke bron.
Splits een compositie op in bewerkbare lagen
Laagontleding is een afzonderlijke modus die precies één afbeelding gebruikt en een basisafbeelding plus maximaal 16 onafhankelijke lagen teruggeeft. Elke laag is een PNG met alfa. Een prompt kan de te scheiden elementen benoemen, zoals titel, hoofdonderwerp en decoraties; zonder ontledingsprompt bepaalt het model de hoofdelementen automatisch.
De resultaten bevatten laagnamen, beschrijvingen, stapelvolgorde en plaatsingsvakken. Gebruik de basisafbeelding met stapelindex nul en plaats de andere lagen daarna in oplopende stapelvolgorde. Absolute vakken beschrijven de plaatsing in de uitvoerbasisafbeelding; genormaliseerde vakken beschrijven relatieve plaatsing op een ander canvas. Bewaar die teruggestuurde plaatsingsmetadata bij de afbeeldingsbestanden, zodat je de oorspronkelijke compositie kan reconstrueren voordat je ze herschikt.
Scheid voor een posterherziening het hoofdbeeld van titel en decoraties en controleer daarna randen en eventueel herstelde achtergrondzones. Een transparante laag kan worden bewerkt als één invoer met alfakanaal, met transparante PNG-uitvoer. De optie voor transparante achtergrond geldt voor die workflow voor beeldbewerking met één invoer; gewone tekst-naar-beeldgeneratie is een afzonderlijke bewerking.
Meertalige compositie
Naast Chinees en Engels documenteert de maker native ondersteuning voor prompts en beeldtekst in Russisch, Arabisch, Filipijns, Thai, Turks, Koreaans, Maleis, Spaans, Portugees, Indonesisch, Frans, Duits, Vietnamees en Japans. Geef de exacte goedgekeurde formulering en leesrichting op en benoem in welke zone elk tekstblok staat. Controleer accenten, verbonden tekens, regelafbrekingen en kleine labels in het eindbeeld.
Referentiebestanden en uitvoerspecificaties
Beeldgeneratie accepteert maximaal 10 referenties in JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC of HEIF. Elke afbeelding mag maximaal 30 MB zijn, met beide zijden groter dan 14 pixels, 196–36.000.000 pixels in totaal en een beeldverhouding van 1:16 tot 16:1. Laagontleding vereist daarentegen één JPEG of PNG van 262.144–36.000.000 pixels, maximaal 30 MB, binnen hetzelfde verhoudingsbereik.
Generatie biedt uitvoerniveaus 1K, 1.5K en 2K, standaard 2K, of expliciete afmetingen met 921.600–4.624.220 pixels in totaal en verhoudingen van 1:16 tot 16:1. Beide voorwaarden gelden voor aangepaste afmetingen. Laaguitvoer gebruikt 1K, 1.5K, 2K of auto, met auto als standaard; de basis en elke laag behouden hun respectieve bronverhoudingen.
Afgewerkte afbeeldingen zijn JPEG of PNG. Het formaat van de basisafbeelding kan afzonderlijk worden gekozen, terwijl ontlede lagen PNG met alfa blijven. Levering kan gecodeerde afbeeldingsdata of downloadlinks met een bewaartijd van 24 uur gebruiken. Bewaar elke teruggestuurde afbeelding en haar metadata voor de bedoelde ontwerpworkflow. Controleer tekst, bewerkte details en laaguitlijning op de grootte waarop het beeld zal worden gebruikt.
POST /v1/images/generationstextimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten bytedance-seed/seedream-5-0-flash | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 Voorwaarden: Niet-lege UTF8-prompt. Er wordt geen tekenlimiet voor alle modellen van de fabrikant verzonnen. | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten 1 | Standaard1 |
Veldresponse_format | Typestring | VereisteOptioneel | Waarden en limieten url, b64_json | Standaard— |
Veldstream | Typeboolean | VereisteOptioneel | Waarden en limieten false | Standaardfalse |
Tekst naar afbeelding · Vereist: prompt
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parametermaterial_types | Contracttext |
Parameteroptional | Contractn, response_format, stream |
Parametern | Contract1 |
Parameterstream | Contractfalse |
Parameterresponse_format | Contracturl, b64_json |
Parameterreference_images | Contractfalse |
Parameteredit | Contractfalse |
Parameteroutput_format_optional | Contract |
Parameterresolution_control | Contractnull |
Parameteraspect_ratio_control | Contractnull |
Parameterother_fields | Contractgeweigerd, behalve voor de exacte vastgezette interne routering naar de aanbieder |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · daadwerkelijk teruggegeven task_id of record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Genereer één afbeelding op basis van een prompt.
Sla elk gegevensitem op; url/b64_json zijn coderingen van het resultaat.
De getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Rekeneenheid | Kosten |
|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Rekeneenheid— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| Configuratieinvoerafbeelding | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper invoerafbeelding | Kosten Invoer · invoerafbeelding · Schatting uitsluitend ter vergelijking $0 per invoerafbeelding |
| ConfiguratieUltra | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper uitvoerafbeelding | Kosten Uitvoer · afbeeldingsuitvoer · Schatting uitsluitend ter vergelijking $0.036 per uitvoerafbeelding |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.036 schatting vóór generatie Deze raming is geen extra kost of vast tarief voor de voltooide generatie. |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Referentiestaffels op modelniveau veranderen de methodeselectie, kostenramingen of afschrijvingen niet. Voor de actieve kostenberekening gelden de tarieven van de geselecteerde Ailoot-methode.
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Factureringsvoorwaarden | Kosten |
|---|---|---|
| ConfiguratieUitvoerafbeelding | FactureringsvoorwaardenEr is geen prijsvariant gedeclareerd. | Kosten Uitvoer · Uitvoerafbeelding $0.036 per afbeelding |
| ConfiguratieInvoerafbeelding | FactureringsvoorwaardenEr is geen prijsvariant gedeclareerd. | Kosten Invoer · Invoerafbeelding $0 per afbeelding |
Gelijkwaardige vermeldingen beschrijven dezelfde aanrekening; ze voegen geen tweede kost toe.
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");\nDownload elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Sla elk gegevensitem op. Decodeer elke b64_json of haal elke teruggegeven ondertekende URL op. Kies een bestandsextensie op basis van de daadwerkelijke MIME/bytes.
Als het resultaat van een afbeeldingsgeneratie of -bewerking gecontroleerd moet worden, bewaar dan de oorspronkelijke operation_id/X-Client-Request-ID en de teruggegeven resultaatinformatie. Haal bestaande eigen resultaten terug via de mediabibliotheek met daadwerkelijk teruggegeven task_id- of asset_id-waarden. Dien de generatie- of bewerkingsaanvraag niet opnieuw in en stel geen polling-URL samen op basis van operation_id.
| Veld | Type |
|---|---|
Veldcreated | Typeinteger |
Velddata[].url | Typestring |
Velddata[].b64_json | Typebase64 string |
Veldusage | Typeobject |
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig | Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag. |
Antwoordserver_error | VoorwaardeDe teruggegeven respons geeft aan dat de bewerking of het resultaat gecontroleerd moet worden | Volgende stapBewaar de oorspronkelijk teruggegeven bewerkings-/taak-ID, aanvraagheaders en respons; blijf de oorspronkelijke bewerking uitlezen via de ondersteunde leesaanvragen. Dien de aanmaakaanvraag niet opnieuw in. |
Ailoot Ultra bytedance-seed/seedream-5-0-flash
Gebruik de hierboven getoonde methodepaden.