{ "aboutHtml": "

En snabbare utgåva för bildskapande

Seedream 5.0 Flash är ByteDance Seeds modell för bildgenerering och redigering i arbetsflöden som prioriterar genereringshastighet. Tillverkarens Pro/Flash-guide beskriver både text-till-bild och bild-till-bild med en eller flera referenser. Den skiljer Flashs snabbare generering från Pros högre prioritet på bildkvalitet, utan att fastställa en fast svarstid för varje instruktion.

De utmärkande gemensamma funktionerna är interaktiv redigering, lageruppdelning och inbyggd flerspråkig generering. Vanlig generering returnerar en färdig bild. Tillverkarens Flash-flöde stöder inte sekventiell generering av relaterade bilder, webbsökning eller strömmande bildutdata. Dess promptoptimering använder standardläge; den separata kontrollen för snabb optimering hör till Pro, inte Flash.

Skapande från en instruktion och referenser

Ange avsedd bild, huvudmotiv, komposition och visuell behandling och identifiera sedan vad varje referens styr. För en produktbild skiljer du referensen som fastställer föremålet från en som ger en palett eller ett ytmaterial. ”Behåll föremålets silhuett och synvinkel från första bilden; använd andra bilden bara för den dämpade bakgrundspaletten” ger referenserna separata roller.

Tillverkaren rekommenderar koncisa prompter, högst 300 kinesiska tecken eller 600 engelska ord. Detta är förberedelsevägledning snarare än en angiven hård textindatagräns. Lista avgörande krav först, inklusive exakt ordalydelse som måste visas, önskat bildförhållande och detaljer som måste förbli oförändrade. Granska den färdiga bilden mot listan i stället för att bara förlita dig på helhetsutseendet.

Rumsligt styrd redigering

Flash kan använda punkter, begränsningsrutor, pilar och fria markeringar för att ange var en redigering ska ske. Skicka in källbilden tillsammans med plats och ändring. För ett inredningskoncept markerar du stolen, begär ett tygbyte och anger golv, vägg, kameravinkel och närliggande föremål som ska bevaras. Om markeringarna bara är vägledning ber du uttryckligen att de tas bort från slutbilden.

Tillverkarens guide för koordinatredigering använder taggarna <point> och <bbox> med koordinater normaliserade till 0–999 relativt angiven indatabild. En punkt innehåller x och y; en ruta innehåller koordinaterna för övre vänstra och nedre högra hörnet. Ange bildnummer och målobjekt, särskilt när en ruta innehåller flera motiv. För en redigering mellan bilder skiljer du föremålet som ska hämtas från en referens från destinationsområdet i en annan.

Använd den visade bildens egna dimensioner när den proportionella platsen hämtas; arbetsytans zoom, panorering eller webbläsarkoordinater är inte de normaliserade bildkoordinaterna. Beskriv skyddade områden såväl som redigerat område. Jämför resultatets perspektiv, belysning och omgivande detaljer med originalkällan.

Dela en komposition i redigerbara lager

Lageruppdelning är ett separat läge som tar emot exakt en bild och returnerar en basbild plus upp till 16 oberoende lager. Varje lager är PNG med alfa. En prompt kan namnge elementen att separera, som titel, huvudmotiv och dekorationer; utan en uppdelningsprompt identifierar modellen huvudelementen automatiskt.

Resultaten innehåller lagernamn, beskrivningar, staplingsordning och placeringsrutor. Använd basbilden med staplingsindex noll och placera sedan övriga lager i stigande staplingsordning. Absoluta rutor beskriver placering i utdatans basbild; normaliserade rutor beskriver proportionell placering på en annan arbetsyta. Behåll returnerad placeringsmetadata med bildfilerna så att originalkompositionen kan återskapas innan den arrangeras om.

För en affischrevidering separerar du huvudbilden från titeln och dekorationerna och granskar sedan kanter och eventuell återställd bakgrundsyta. Ett transparent lager kan redigeras som en enda indatabild med alfakanal och ge transparent PNG-utdata. Alternativet för transparent bakgrund är avgränsat till detta bildredigeringsflöde med en enda indatabild; vanlig text-till-bild-generering är en separat operation.

Flerspråkig komposition

Utöver kinesiska och engelska dokumenterar tillverkaren inbyggt stöd för prompter och bildtext på ryska, arabiska, filipino, thailändska, turkiska, koreanska, malajiska, spanska, portugisiska, indonesiska, franska, tyska, vietnamesiska och japanska. Ange exakt godkänd ordalydelse och läsriktning och identifiera vilket område som innehåller varje textblock. Granska accenter, sammanfogade tecken, radbrytningar och små etiketter i slutbilden.

Referensfiler och utdataspecifikationer

Bildgenerering tar emot upp till 10 referenser i JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC eller HEIF. Var och en får vara högst 30 MB, med båda sidor över 14 pixlar, totalt 196–36 000 000 pixlar och bildförhållande från 1:16 till 16:1. Lageruppdelning kräver i stället en JPEG eller PNG på 262 144–36 000 000 pixlar, högst 30 MB, inom samma förhållandeintervall.

Generering erbjuder utdatanivåerna 1K, 1.5K och 2K, med 2K som standard, eller uttryckliga dimensioner med totalt 921 600–4 624 220 pixlar och förhållanden från 1:16 till 16:1. Båda begränsningarna gäller egna dimensioner. Lagerutdata använder 1K, 1.5K, 2K eller auto, med auto som standard; basbilden och varje lager behåller sina respektive källförhållanden.

Färdiga bilder är JPEG eller PNG. Basbildens format kan väljas separat, medan uppdelade lager förblir PNG med alfa. Leverans kan använda kodade bilddata eller nedladdningslänkar som behålls i 24 timmar. Spara varje returnerad bild och dess metadata för det avsedda designflödet. Granska text, redigerade detaljer och lagerjustering i den storlek där bildmaterialet ska användas.

", "aboutText": "En snabbare utgåva för bildskapande\n\nSeedream 5.0 Flash är ByteDance Seeds modell för bildgenerering och redigering i arbetsflöden som prioriterar genereringshastighet. Tillverkarens Pro/Flash-guide beskriver både text-till-bild och bild-till-bild med en eller flera referenser. Den skiljer Flashs snabbare generering från Pros högre prioritet på bildkvalitet, utan att fastställa en fast svarstid för varje instruktion.\n\nDe utmärkande gemensamma funktionerna är interaktiv redigering, lageruppdelning och inbyggd flerspråkig generering. Vanlig generering returnerar en färdig bild. Tillverkarens Flash-flöde stöder inte sekventiell generering av relaterade bilder, webbsökning eller strömmande bildutdata. Dess promptoptimering använder standardläge; den separata kontrollen för snabb optimering hör till Pro, inte Flash.\n\nSkapande från en instruktion och referenser\n\nAnge avsedd bild, huvudmotiv, komposition och visuell behandling och identifiera sedan vad varje referens styr. För en produktbild skiljer du referensen som fastställer föremålet från en som ger en palett eller ett ytmaterial. ”Behåll föremålets silhuett och synvinkel från första bilden; använd andra bilden bara för den dämpade bakgrundspaletten” ger referenserna separata roller.\n\nTillverkaren rekommenderar koncisa prompter, högst 300 kinesiska tecken eller 600 engelska ord. Detta är förberedelsevägledning snarare än en angiven hård textindatagräns. Lista avgörande krav först, inklusive exakt ordalydelse som måste visas, önskat bildförhållande och detaljer som måste förbli oförändrade. Granska den färdiga bilden mot listan i stället för att bara förlita dig på helhetsutseendet.\n\nRumsligt styrd redigering\n\nFlash kan använda punkter, begränsningsrutor, pilar och fria markeringar för att ange var en redigering ska ske. Skicka in källbilden tillsammans med plats och ändring. För ett inredningskoncept markerar du stolen, begär ett tygbyte och anger golv, vägg, kameravinkel och närliggande föremål som ska bevaras. Om markeringarna bara är vägledning ber du uttryckligen att de tas bort från slutbilden.\n\nTillverkarens guide för koordinatredigering använder taggarna och med koordinater normaliserade till 0–999 relativt angiven indatabild. En punkt innehåller x och y; en ruta innehåller koordinaterna för övre vänstra och nedre högra hörnet. Ange bildnummer och målobjekt, särskilt när en ruta innehåller flera motiv. För en redigering mellan bilder skiljer du föremålet som ska hämtas från en referens från destinationsområdet i en annan.\n\nAnvänd den visade bildens egna dimensioner när den proportionella platsen hämtas; arbetsytans zoom, panorering eller webbläsarkoordinater är inte de normaliserade bildkoordinaterna. Beskriv skyddade områden såväl som redigerat område. Jämför resultatets perspektiv, belysning och omgivande detaljer med originalkällan.\n\nDela en komposition i redigerbara lager\n\nLageruppdelning är ett separat läge som tar emot exakt en bild och returnerar en basbild plus upp till 16 oberoende lager. Varje lager är PNG med alfa. En prompt kan namnge elementen att separera, som titel, huvudmotiv och dekorationer; utan en uppdelningsprompt identifierar modellen huvudelementen automatiskt.\n\nResultaten innehåller lagernamn, beskrivningar, staplingsordning och placeringsrutor. Använd basbilden med staplingsindex noll och placera sedan övriga lager i stigande staplingsordning. Absoluta rutor beskriver placering i utdatans basbild; normaliserade rutor beskriver proportionell placering på en annan arbetsyta. Behåll returnerad placeringsmetadata med bildfilerna så att originalkompositionen kan återskapas innan den arrangeras om.\n\nFör en affischrevidering separerar du huvudbilden från titeln och dekorationerna och granskar sedan kanter och eventuell återställd bakgrundsyta. Ett transparent lager kan redigeras som en enda indatabild med alfakanal och ge transparent PNG-utdata. Alternativet för transparent bakgrund är avgränsat till detta bildredigeringsflöde med en enda indatabild; vanlig text-till-bild-generering är en separat operation.\n\nFlerspråkig komposition\n\nUtöver kinesiska och engelska dokumenterar tillverkaren inbyggt stöd för prompter och bildtext på ryska, arabiska, filipino, thailändska, turkiska, koreanska, malajiska, spanska, portugisiska, indonesiska, franska, tyska, vietnamesiska och japanska. Ange exakt godkänd ordalydelse och läsriktning och identifiera vilket område som innehåller varje textblock. Granska accenter, sammanfogade tecken, radbrytningar och små etiketter i slutbilden.\n\nReferensfiler och utdataspecifikationer\n\nBildgenerering tar emot upp till 10 referenser i JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC eller HEIF. Var och en får vara högst 30 MB, med båda sidor över 14 pixlar, totalt 196–36 000 000 pixlar och bildförhållande från 1:16 till 16:1. Lageruppdelning kräver i stället en JPEG eller PNG på 262 144–36 000 000 pixlar, högst 30 MB, inom samma förhållandeintervall.\n\nGenerering erbjuder utdatanivåerna 1K, 1.5K och 2K, med 2K som standard, eller uttryckliga dimensioner med totalt 921 600–4 624 220 pixlar och förhållanden från 1:16 till 16:1. Båda begränsningarna gäller egna dimensioner. Lagerutdata använder 1K, 1.5K, 2K eller auto, med auto som standard; basbilden och varje lager behåller sina respektive källförhållanden.\n\nFärdiga bilder är JPEG eller PNG. Basbildens format kan väljas separat, medan uppdelade lager förblir PNG med alfa. Leverans kan använda kodade bilddata eller nedladdningslänkar som behålls i 24 timmar. Spara varje returnerad bild och dess metadata för det avsedda designflödet. Granska text, redigerade detaljer och lagerjustering i den storlek där bildmaterialet ska användas.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "003ba55bbbf37b68e66016b36ec028feacc3f60a356b3268a2a1cb07fcbe6f37", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "sv", "methods": [ { "html": "
•

ByteDance Seed: Seedream 5.0 Flash

ByteDance Seed /bytedance-seed/seedream-5-0-flash

Start

Skapa en enda färdig bild utifrån en textbeskrivning.

  • Skapa en stillbild av en produkt
  • Utforska ett visuellt koncept
  • Illustrera en scen
Godkända indata
Text
Resultat
Bilder
Om modellen

Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.

En snabbare utgåva för bildskapande

Seedream 5.0 Flash är ByteDance Seeds modell för bildgenerering och redigering i arbetsflöden som prioriterar genereringshastighet. Tillverkarens Pro/Flash-guide beskriver både text-till-bild och bild-till-bild med en eller flera referenser. Den skiljer Flashs snabbare generering från Pros högre prioritet på bildkvalitet, utan att fastställa en fast svarstid för varje instruktion.

De utmärkande gemensamma funktionerna är interaktiv redigering, lageruppdelning och inbyggd flerspråkig generering. Vanlig generering returnerar en färdig bild. Tillverkarens Flash-flöde stöder inte sekventiell generering av relaterade bilder, webbsökning eller strömmande bildutdata. Dess promptoptimering använder standardläge; den separata kontrollen för snabb optimering hör till Pro, inte Flash.

Skapande från en instruktion och referenser

Ange avsedd bild, huvudmotiv, komposition och visuell behandling och identifiera sedan vad varje referens styr. För en produktbild skiljer du referensen som fastställer föremålet från en som ger en palett eller ett ytmaterial. ”Behåll föremålets silhuett och synvinkel från första bilden; använd andra bilden bara för den dämpade bakgrundspaletten” ger referenserna separata roller.

Tillverkaren rekommenderar koncisa prompter, högst 300 kinesiska tecken eller 600 engelska ord. Detta är förberedelsevägledning snarare än en angiven hård textindatagräns. Lista avgörande krav först, inklusive exakt ordalydelse som måste visas, önskat bildförhållande och detaljer som måste förbli oförändrade. Granska den färdiga bilden mot listan i stället för att bara förlita dig på helhetsutseendet.

Rumsligt styrd redigering

Flash kan använda punkter, begränsningsrutor, pilar och fria markeringar för att ange var en redigering ska ske. Skicka in källbilden tillsammans med plats och ändring. För ett inredningskoncept markerar du stolen, begär ett tygbyte och anger golv, vägg, kameravinkel och närliggande föremål som ska bevaras. Om markeringarna bara är vägledning ber du uttryckligen att de tas bort från slutbilden.

Tillverkarens guide för koordinatredigering använder taggarna <point> och <bbox> med koordinater normaliserade till 0–999 relativt angiven indatabild. En punkt innehåller x och y; en ruta innehåller koordinaterna för övre vänstra och nedre högra hörnet. Ange bildnummer och målobjekt, särskilt när en ruta innehåller flera motiv. För en redigering mellan bilder skiljer du föremålet som ska hämtas från en referens från destinationsområdet i en annan.

Använd den visade bildens egna dimensioner när den proportionella platsen hämtas; arbetsytans zoom, panorering eller webbläsarkoordinater är inte de normaliserade bildkoordinaterna. Beskriv skyddade områden såväl som redigerat område. Jämför resultatets perspektiv, belysning och omgivande detaljer med originalkällan.

Dela en komposition i redigerbara lager

Lageruppdelning är ett separat läge som tar emot exakt en bild och returnerar en basbild plus upp till 16 oberoende lager. Varje lager är PNG med alfa. En prompt kan namnge elementen att separera, som titel, huvudmotiv och dekorationer; utan en uppdelningsprompt identifierar modellen huvudelementen automatiskt.

Resultaten innehåller lagernamn, beskrivningar, staplingsordning och placeringsrutor. Använd basbilden med staplingsindex noll och placera sedan övriga lager i stigande staplingsordning. Absoluta rutor beskriver placering i utdatans basbild; normaliserade rutor beskriver proportionell placering på en annan arbetsyta. Behåll returnerad placeringsmetadata med bildfilerna så att originalkompositionen kan återskapas innan den arrangeras om.

För en affischrevidering separerar du huvudbilden från titeln och dekorationerna och granskar sedan kanter och eventuell återställd bakgrundsyta. Ett transparent lager kan redigeras som en enda indatabild med alfakanal och ge transparent PNG-utdata. Alternativet för transparent bakgrund är avgränsat till detta bildredigeringsflöde med en enda indatabild; vanlig text-till-bild-generering är en separat operation.

Flerspråkig komposition

Utöver kinesiska och engelska dokumenterar tillverkaren inbyggt stöd för prompter och bildtext på ryska, arabiska, filipino, thailändska, turkiska, koreanska, malajiska, spanska, portugisiska, indonesiska, franska, tyska, vietnamesiska och japanska. Ange exakt godkänd ordalydelse och läsriktning och identifiera vilket område som innehåller varje textblock. Granska accenter, sammanfogade tecken, radbrytningar och små etiketter i slutbilden.

Referensfiler och utdataspecifikationer

Bildgenerering tar emot upp till 10 referenser i JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC eller HEIF. Var och en får vara högst 30 MB, med båda sidor över 14 pixlar, totalt 196–36 000 000 pixlar och bildförhållande från 1:16 till 16:1. Lageruppdelning kräver i stället en JPEG eller PNG på 262 144–36 000 000 pixlar, högst 30 MB, inom samma förhållandeintervall.

Generering erbjuder utdatanivåerna 1K, 1.5K och 2K, med 2K som standard, eller uttryckliga dimensioner med totalt 921 600–4 624 220 pixlar och förhållanden från 1:16 till 16:1. Båda begränsningarna gäller egna dimensioner. Lagerutdata använder 1K, 1.5K, 2K eller auto, med auto som standard; basbilden och varje lager behåller sina respektive källförhållanden.

Färdiga bilder är JPEG eller PNG. Basbildens format kan väljas separat, medan uppdelade lager förblir PNG med alfa. Leverans kan använda kodade bilddata eller nedladdningslänkar som behålls i 24 timmar. Spara varje returnerad bild och dess metadata för det avsedda designflödet. Granska text, redigerade detaljer och lagerjustering i den storlek där bildmaterialet ska användas.

Tillgängligt i Ailoot · indata & metoder

Ailoot Ultra · Bilder POST /v1/images/generations
Indatatyper
text
Utdatatyper
image
Utdataformat
Bildfil
Antal utdata
1 utdata
FältTypKravVärden & gränserStandard
FältmodelTypstringKravObligatorisktVärden & gränser
bytedance-seed/seedream-5-0-flash
Standard—
FältpromptTypstringKravObligatorisktVärden & gränser
Minsta längd: 1
Villkor: Icke-tom UTF8-prompt. Ingen generell teckengräns för tillverkaren hittas på.
Standard—
FältnTypintegerKravValfrittVärden & gränser
1
Standard1
Fältresponse_formatTypstringKravValfrittVärden & gränser
url, b64_json
Standard—
FältstreamTypbooleanKravValfrittVärden & gränser
false
Standardfalse
Kombinationer av indatamaterial

Text till bild · Krävs: prompt

Metodparametrar och livscykel
ParameterAvtal
Parametercontent_typeAvtalapplication/json
ParameterrequiredAvtalmodel, prompt
Parametermaterial_typesAvtaltext
ParameteroptionalAvtaln, response_format, stream
ParameternAvtal1
ParameterstreamAvtalfalse
Parameterresponse_formatAvtalurl, b64_json
Parameterreference_imagesAvtalfalse
ParametereditAvtalfalse
Parameteroutput_format_optionalAvtal
Parameterresolution_controlAvtalnull
Parameteraspect_ratio_controlAvtalnull
Parameterother_fieldsAvtalavvisas utom vid exakt låst intern leverantörsroutning

Livscykel: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Det task_id som faktiskt returnerades eller en post i mediebiblioteket

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Generera en bild från en prompt.

Spara varje datapost; url/b64_json är resultatkodningar.

Priser

Så beräknas slutavgiften

De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.

Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.

Snabbt läge
Ej angivet När snabbt läge är valt
Flex-läge
Ej angivet När läget flex är valt
Högsta resonemangsnivå
Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)

Uppskattade priser för jämförelse

Priser efter konfiguration

Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.

KonfigurationPrislistaPrognostiserad mängdDebiteringsenhetAvgift
KonfigurationGrundpriser för tokenPrislistaGrundprisPrognostiserad mängd—Debiteringsenhet—Avgift
Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token
Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token
Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token
Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token
Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token
KonfigurationindatabildPrislista—Prognostiserad mängd—Debiteringsenhetper indatabildAvgift
Indata · indatabild · Uppskattning endast för jämförelse $0 per indatabild
KonfigurationUltraPrislista—Prognostiserad mängd—Debiteringsenhetper utdatabildAvgift
Utdata · bildutdata · Uppskattning endast för jämförelse $0.036 per utdatabild
KonfigurationUppskattad genereringskostnadPrislista—Prognostiserad mängduppskattning för en genereringDebiteringsenhet—Avgift
Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.036 uppskattning före generering

Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen.

Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →

Detaljer om referenstariffen

Referensprislistor på modellnivå ändrar inte metodval, prisuppgifter eller avgifter. Aktiva avgifter använder priserna för den valda Ailoot-metoden.

Priskonfigurationer för bilder

Priser efter konfiguration

Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.

KonfigurationDebiteringsvillkorAvgift
KonfigurationUtdatabildDebiteringsvillkorIngen prisvariant har deklarerats.Avgift
Utdata · Utdatabild $0.036 per bild
KonfigurationIndatabildDebiteringsvillkorIngen prisvariant har deklarerats.Avgift
Indata · Indatabild $0 per bild

Likvärdiga prisposter beskriver samma debitering; de lägger inte till en andra avgift.

Exempelbegäranden

Ailoot Ultra · Bilder

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\n

Ta emot och spara resultat

Ailoot Ultra · Bilder

Ladda ned varje returnerad bild eller spara dess Base64-innehåll

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Behåll alla färdiga resultat

Spara varje färdig bild; hämta varje returnerad URL eller avkoda dess Base64-innehåll.

Spara varje dataobjekt. Avkoda varje b64_json-värde eller hämta innehållet via varje returnerad signerad URL. Välj filändelse utifrån den faktiska MIME-typen och filens byteinnehåll.

Om det ursprungliga svaret behöver kontrolleras

Om resultatet av en bildgenerering eller bildredigering behöver kontrolleras ska du behålla de ursprungliga värdena för operation_id/X-Client-Request-ID och den returnerade resultatinformationen. Hämta befintliga resultat som tillhör dig genom mediebiblioteket med de faktiska task_id- eller asset_id-värdena. Skicka inte genererings- eller redigeringsförfrågan igen och bygg inte en URL för statusavläsning från operation_id.

Svarsfält
FältTyp
FältcreatedTypinteger
Fältdata[].urlTypstring
Fältdata[].b64_jsonTypbase64 string
FältusageTypobject
Fel och nästa steg
SvarVillkorNästa steg
Svar400 · invalid_request_errorVillkorOgiltiga obligatoriska fält, ogiltig representation av underlaget eller ogiltigt parametervärdeNästa stegKorrigera de angivna fälten före en ny begäran om att skapa.
Svarserver_errorVillkorDet returnerade svaret anger att operationen eller resultatet behöver kontrollerasNästa stegSpara det ursprungliga operations- eller uppgifts-ID som returnerades, förfrågans headers och svaret. Fortsätt att läsa den ursprungliga operationen med de läsmetoder som stöds. Skicka inte skapandeförfrågan igen.

Alias

Modellalias

Ailoot Ultra bytedance-seed/seedream-5-0-flash

Alias för metodsökvägar

Använd metodsökvägarna som visas ovan.

Relaterade anropar-ID:n

bytedance-seed/seedream-5-0-flash

", "method_identity": { "effective_request_model_id": "bytedance-seed/seedream-5-0-flash", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "bytedance-seed/seedream-5-0-flash", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|bytedance-seed%2Fseedream-5-0-flash", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Save every data item. Decode each b64_json or fetch every returned signed URL. Select a filename extension from the actual MIME/bytes.", "errors": [ { "code": null, "condition": "Ogiltiga obligatoriska fält, ogiltig representation av underlaget eller ogiltigt parametervärde", "http_status": 400, "recovery": "Korrigera de angivna fälten före en ny begäran om att skapa.", "type": "invalid_request_error" }, { "code": null, "condition": "Det returnerade svaret anger att operationen eller resultatet behöver kontrolleras", "http_status": null, "recovery": "Spara det ursprungliga operations- eller uppgifts-ID som returnerades, förfrågans headers och svaret. Fortsätt att läsa den ursprungliga operationen med de läsmetoder som stöds. Skicka inte skapandeförfrågan igen.", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Om resultatet av en bildgenerering eller bildredigering behöver kontrolleras ska du behålla de ursprungliga värdena för operation_id/X-Client-Request-ID och den returnerade resultatinformationen. Hämta befintliga resultat som tillhör dig genom mediebiblioteket med de faktiska task_id- eller asset_id-värdena. Skicka inte genererings- eller redigeringsförfrågan igen och bygg inte en URL för statusavläsning från operation_id." }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_image", "reference_images": false, "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_image" ], "outputs": { "all_results": "Spara varje dataobjekt. Avkoda varje b64_json-värde eller hämta innehållet via varje returnerad signerad URL. Välj filändelse utifrån den faktiska MIME-typen och filens byteinnehåll.", "count": 1, "family": "image", "fields": [ { "description": null, "name": "created", "type": "integer" }, { "description": null, "name": "data[].url", "type": "string" }, { "description": null, "name": "data[].b64_json", "type": "base64 string" }, { "description": null, "name": "usage", "type": "object" } ], "format": "actual validated raster MIME" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance-seed/seedream-5-0-flash" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "conditions": "Icke-tom UTF8-prompt. Ingen generell teckengräns för tillverkaren hittas på.", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "enum": [ 1 ], "enum_known": true, "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "url", "b64_json" ], "enum_known": true, "name": "response_format", "required": false, "type": "string" }, { "availability": "source_interface", "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [ "image edits/references", "resolution/size", "aspect_ratio", "stream=true", "n other than1", "other fields outside this exact facade profile", "output_format field must be omitted" ] }, "hints": [ "Generera en bild från en prompt.", "Spara varje datapost; url/b64_json är resultatkodningar." ], "input": { "aspect_ratio_control": null, "content_type": "application/json", "edit": false, "material_types": [ "text" ], "n": [ 1 ], "optional": [ "n", "response_format", "stream" ], "other_fields": "avvisas utom vid exakt låst intern leverantörsroutning", "output_format_optional": [], "reference_images": false, "required": [ "model", "prompt" ], "resolution_control": null, "response_format": [ "url", "b64_json" ], "stream": [ false ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "Det task_id som faktiskt returnerades eller en post i mediebiblioteket", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "If an image generation or edit result requires a check, keep the original operation_id/X-Client-Request-ID and returned result information. Recover existing owned results through the media library using actual task_id or asset_id values. Do not resubmit the generation/edit request or construct a polling URL from operation_id." }, "manufacturer_capability": null, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "operation_modes": [ "text_to_image" ], "output": { "count": 1, "family": "image", "format": "validated raster MIME", "result": "actual owned URL or b64_json" } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per input image" }, "label": "indatabild", "units": [ { "amount": "0", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_input", "label": "input image", "native_amount_usd_per_unit": "0", "native_quantity": 1, "public_unit_label": "per input image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "image_input" } ] }, { "dimensions": { "quoted_unit": "per image output" }, "label": "Ultra", "units": [ { "amount": "0.036", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "image output", "native_amount_usd_per_unit": "0.036", "native_quantity": 1, "public_unit_label": "per image output", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Uppskattad genereringskostnad", "units": [ { "amount": "0.036", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.036", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "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\" och med koordinater normaliserade till 0–999 relativt angiven indatabild. En punkt innehåller x och y; en ruta innehåller koordinaterna för övre vänstra och nedre högra hörnet. Ange bildnummer och målobjekt, särskilt när en ruta innehåller flera motiv. För en redigering mellan bilder skiljer du föremålet som ska hämtas från en referens från destinationsområdet i en annan.\n\nAnvänd den visade bildens egna dimensioner när den proportionella platsen hämtas; arbetsytans zoom, panorering eller webbläsarkoordinater är inte de normaliserade bildkoordinaterna. Beskriv skyddade områden såväl som redigerat område. Jämför resultatets perspektiv, belysning och omgivande detaljer med originalkällan.\n\nDela en komposition i redigerbara lager\n\nLageruppdelning är ett separat läge som tar emot exakt en bild och returnerar en basbild plus upp till 16 oberoende lager. Varje lager är PNG med alfa. En prompt kan namnge elementen att separera, som titel, huvudmotiv och dekorationer; utan en uppdelningsprompt identifierar modellen huvudelementen automatiskt.\n\nResultaten innehåller lagernamn, beskrivningar, staplingsordning och placeringsrutor. Använd basbilden med staplingsindex noll och placera sedan övriga lager i stigande staplingsordning. Absoluta rutor beskriver placering i utdatans basbild; normaliserade rutor beskriver proportionell placering på en annan arbetsyta. Behåll returnerad placeringsmetadata med bildfilerna så att originalkompositionen kan återskapas innan den arrangeras om.\n\nFör en affischrevidering separerar du huvudbilden från titeln och dekorationerna och granskar sedan kanter och eventuell återställd bakgrundsyta. Ett transparent lager kan redigeras som en enda indatabild med alfakanal och ge transparent PNG-utdata. Alternativet för transparent bakgrund är avgränsat till detta bildredigeringsflöde med en enda indatabild; vanlig text-till-bild-generering är en separat operation.\n\nFlerspråkig komposition\n\nUtöver kinesiska och engelska dokumenterar tillverkaren inbyggt stöd för prompter och bildtext på ryska, arabiska, filipino, thailändska, turkiska, koreanska, malajiska, spanska, portugisiska, indonesiska, franska, tyska, vietnamesiska och japanska. Ange exakt godkänd ordalydelse och läsriktning och identifiera vilket område som innehåller varje textblock. Granska accenter, sammanfogade tecken, radbrytningar och små etiketter i slutbilden.\n\nReferensfiler och utdataspecifikationer\n\nBildgenerering tar emot upp till 10 referenser i JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC eller HEIF. Var och en får vara högst 30 MB, med båda sidor över 14 pixlar, totalt 196–36 000 000 pixlar och bildförhållande från 1:16 till 16:1. Lageruppdelning kräver i stället en JPEG eller PNG på 262 144–36 000 000 pixlar, högst 30 MB, inom samma förhållandeintervall.\n\nGenerering erbjuder utdatanivåerna 1K, 1.5K och 2K, med 2K som standard, eller uttryckliga dimensioner med totalt 921 600–4 624 220 pixlar och förhållanden från 1:16 till 16:1. Båda begränsningarna gäller egna dimensioner. Lagerutdata använder 1K, 1.5K, 2K eller auto, med auto som standard; basbilden och varje lager behåller sina respektive källförhållanden.\n\nFärdiga bilder är JPEG eller PNG. Basbildens format kan väljas separat, medan uppdelade lager förblir PNG med alfa. Leverans kan använda kodade bilddata eller nedladdningslänkar som behålls i 24 timmar. Spara varje returnerad bild och dess metadata för det avsedda designflödet. Granska text, redigerade detaljer och lagerjustering i den storlek där bildmaterialet ska användas.", "alias_of": null, "aliases": [], "author": "ByteDance Seed", "available": null, "canonical_model": "bytedance-seed/seedream-5-0-flash", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "image" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.036", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.036", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Fullständig prissättning för konfigurationen finns i detaljerna." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "c28268da12f5c8a4b252dcc4", "label": "Priskonfigurationer för bilder", "profiles": [ { "basis": "Likvärdiga prisposter beskriver samma debitering; de lägger inte till en andra avgift.", "dimensions": { "conditions": "Ingen prisvariant har deklarerats." }, "label": "Utdatabild", "units": [ { "amount": "0.036", "amount_unit": "usd_per_image", "billing_input": false, "key": "output_image", "label": "Output image", "public_unit_label": "per image", "quantity": 1, "rate_role": "typed_image_reference", "side": "out", "unit": "image" } ] }, { "basis": "Likvärdiga prisposter beskriver samma debitering; de lägger inte till en andra avgift.", "dimensions": { "conditions": "Ingen prisvariant har deklarerats." }, "label": "Indatabild", "units": [ { "amount": "0", "amount_unit": "usd_per_image", "billing_input": false, "key": "input_image", "label": "Input image", "public_unit_label": "per image", "quantity": 1, "rate_role": "typed_image_reference", "side": "in", "unit": "image" } ] } ] } ], "entity_type": "model", "formats": [ "images" ], "id": "bytedance-seed/seedream-5-0-flash", "input": [ "text" ], "kind": "image", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Save every data item. Decode each b64_json or fetch every returned signed URL. Select a filename extension from the actual MIME/bytes.", "errors": [ { "code": null, "condition": "Ogiltiga obligatoriska fält, ogiltig representation av underlaget eller ogiltigt parametervärde", "http_status": 400, "recovery": "Korrigera de angivna fälten före en ny begäran om att skapa.", "type": "invalid_request_error" }, { "code": null, "condition": "Det returnerade svaret anger att operationen eller resultatet behöver kontrolleras", "http_status": null, "recovery": "Spara det ursprungliga operations- eller uppgifts-ID som returnerades, förfrågans headers och svaret. Fortsätt att läsa den ursprungliga operationen med de läsmetoder som stöds. Skicka inte skapandeförfrågan igen.", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Om resultatet av en bildgenerering eller bildredigering behöver kontrolleras ska du behålla de ursprungliga värdena för operation_id/X-Client-Request-ID och den returnerade resultatinformationen. Hämta befintliga resultat som tillhör dig genom mediebiblioteket med de faktiska task_id- eller asset_id-värdena. Skicka inte genererings- eller redigeringsförfrågan igen och bygg inte en URL för statusavläsning från operation_id." }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_image", "reference_images": false, "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_image" ], "outputs": { "all_results": "Spara varje dataobjekt. Avkoda varje b64_json-värde eller hämta innehållet via varje returnerad signerad URL. Välj filändelse utifrån den faktiska MIME-typen och filens byteinnehåll.", "count": 1, "family": "image", "fields": [ { "description": null, "name": "created", "type": "integer" }, { "description": null, "name": "data[].url", "type": "string" }, { "description": null, "name": "data[].b64_json", "type": "base64 string" }, { "description": null, "name": "usage", "type": "object" } ], "format": "actual validated raster MIME" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance-seed/seedream-5-0-flash" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "conditions": "Icke-tom UTF8-prompt. Ingen generell teckengräns för tillverkaren hittas på.", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "enum": [ 1 ], "enum_known": true, "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "url", "b64_json" ], "enum_known": true, "name": "response_format", "required": false, "type": "string" }, { "availability": "source_interface", "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [ "image edits/references", "resolution/size", "aspect_ratio", "stream=true", "n other than1", "other fields outside this exact facade profile", "output_format field must be omitted" ] }, "hints": [ "Generera en bild från en prompt.", "Spara varje datapost; url/b64_json är resultatkodningar." ], "input": { "aspect_ratio_control": null, "content_type": "application/json", "edit": false, "material_types": [ "text" ], "n": [ 1 ], "optional": [ "n", "response_format", "stream" ], "other_fields": "avvisas utom vid exakt låst intern leverantörsroutning", "output_format_optional": [], "reference_images": false, "required": [ "model", "prompt" ], "resolution_control": null, "response_format": [ "url", "b64_json" ], "stream": [ false ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "Det task_id som faktiskt returnerades eller en post i mediebiblioteket", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "If an image generation or edit result requires a check, keep the original operation_id/X-Client-Request-ID and returned result information. Recover existing owned results through the media library using actual task_id or asset_id values. Do not resubmit the generation/edit request or construct a polling URL from operation_id." }, "manufacturer_capability": null, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "operation_modes": [ "text_to_image" ], "output": { "count": 1, "family": "image", "format": "validated raster MIME", "result": "actual owned URL or b64_json" } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per input image" }, "label": "indatabild", "units": [ { "amount": "0", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_input", "label": "input image", "native_amount_usd_per_unit": "0", "native_quantity": 1, "public_unit_label": "per input image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "image_input" } ] }, { "dimensions": { "quoted_unit": "per image output" }, "label": "Ultra", "units": [ { "amount": "0.036", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "image output", "native_amount_usd_per_unit": "0.036", "native_quantity": 1, "public_unit_label": "per image output", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Uppskattad genereringskostnad", "units": [ { "amount": "0.036", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.036", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "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\"