ByteDance Seed: Seedream 5.0 Flash
Seedream 5.0 Flash skapar och redigerar bilder från text och visuella referenser, med rumsligt styrda ändringar, flerspråkig bildtext och lageruppdelning. ByteDance Seed positionerar Flash för snabbare generering och håller den åtskild från den kvalitetsinriktade Pro-utgåvan.
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.
Ailoot Ultra · Bilder POST /v1/images/generations bytedance-seed/seedream-5-0-flash
bytedance-seed/seedream-5-0-flash
bytedance-seed/seedream-5-0-flashStart
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
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Bilder POST /v1/images/generations
- Indatatyper
text- Utdatatyper
image- Utdataformat
- Bildfil
- Antal utdata
- 1 utdata
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser bytedance-seed/seedream-5-0-flash | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser Minsta längd: 1 Villkor: Icke-tom UTF8-prompt. Ingen generell teckengräns för tillverkaren hittas på. | Standard— |
Fältn | Typinteger | KravValfritt | Värden & gränser 1 | Standard1 |
Fältresponse_format | Typstring | KravValfritt | Värden & gränser url, b64_json | Standard— |
Fältstream | Typboolean | KravValfritt | Värden & gränser false | Standardfalse |
Kombinationer av indatamaterial
Text till bild · Krävs: prompt
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, prompt |
Parametermaterial_types | Avtaltext |
Parameteroptional | Avtaln, response_format, stream |
Parametern | Avtal1 |
Parameterstream | Avtalfalse |
Parameterresponse_format | Avtalurl, b64_json |
Parameterreference_images | Avtalfalse |
Parameteredit | Avtalfalse |
Parameteroutput_format_optional | Avtal |
Parameterresolution_control | Avtalnull |
Parameteraspect_ratio_control | Avtalnull |
Parameterother_fields | Avtalavvisas 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.
| Konfiguration | Prislista | Prognostiserad mängd | Debiteringsenhet | Avgift |
|---|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Prognostiserad 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 |
| Konfigurationindatabild | Prislista— | Prognostiserad mängd— | Debiteringsenhetper indatabild | Avgift Indata · indatabild · Uppskattning endast för jämförelse $0 per indatabild |
| KonfigurationUltra | Prislista— | Prognostiserad mängd— | Debiteringsenhetper utdatabild | Avgift Utdata · bildutdata · Uppskattning endast för jämförelse $0.036 per utdatabild |
| KonfigurationUppskattad genereringskostnad | Prislista— | Prognostiserad mängduppskattning för en generering | Debiteringsenhet— | 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.
| Konfiguration | Debiteringsvillkor | Avgift |
|---|---|---|
| KonfigurationUtdatabild | DebiteringsvillkorIngen prisvariant har deklarerats. | Avgift Utdata · Utdatabild $0.036 per bild |
| KonfigurationIndatabild | DebiteringsvillkorIngen 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
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "bytedance-seed/seedream-5-0-flash", "prompt": "A lighthouse on a cliff, watercolor", "n": 1, "response_format": "b64_json"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
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"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
from openai import OpenAI
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
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"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
request={'model': 'bytedance-seed/seedream-5-0-flash', 'prompt': 'A lighthouse on a cliff, watercolor', 'n': 1, 'response_format': 'b64_json'}
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.images.generate(**request)
Path("sdk-result.txt").write_text(str(result),encoding="utf-8")
save_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])
import OpenAI from "openai";
import { readFileSync, writeFileSync } from "node:fs";
const key=process.env.AILOOT_API_KEY;
if(!key) throw new Error("Set your actual Ailoot API key");
const client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});
const request={"model": "bytedance-seed/seedream-5-0-flash", "prompt": "A lighthouse on a cliff, watercolor", "n": 1, "response_format": "b64_json"};
const result=await client.images.generate(request);
writeFileSync("sdk-result.json",JSON.stringify(result,null,2));
if(!result.data?.length) throw new Error("No completed images");
for(let index=0;index<result.data.length;index++) {
const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;
if(!encoded && uri.startsWith("data:image/")) {
const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");
encoded=uri.slice(comma+1);
}
if(encoded) {
if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");
raw=Buffer.from(encoded,"base64");
} else if(uri) {
const u=new URL(uri,"https://api.ailoot.ai");
if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");
const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");
const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});
if(!response.ok) throw new Error("Image content download failed: "+response.status);
raw=Buffer.from(await response.arrayBuffer());
} else throw new Error("Image has neither bytes nor URL");
if(!raw.length) throw new Error("Empty image result");
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";
writeFileSync(`image-${index}.${ext}`,raw);
}
console.log("Every returned image saved; sdk-result.json retains complete metadata");
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}/contentGET /v1/media/assetsGET /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ält | Typ |
|---|---|
Fältcreated | Typinteger |
Fältdata[].url | Typstring |
Fältdata[].b64_json | Typbase64 string |
Fältusage | Typobject |
Fel och nästa steg
| Svar | Villkor | Nästa steg |
|---|---|---|
Svar400 · invalid_request_error | VillkorOgiltiga obligatoriska fält, ogiltig representation av underlaget eller ogiltigt parametervärde | Nästa stegKorrigera de angivna fälten före en ny begäran om att skapa. |
Svarserver_error | VillkorDet returnerade svaret anger att operationen eller resultatet behöver kontrolleras | Nä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
FAQ · ByteDance Seed: Seedream 5.0 Flash
- Vilka indata och resultat finns?
POST /v1/images/generations·bytedance-seed/seedream-5-0-flash:text→image- Vilka fält använder begäran?
POST /v1/images/generations·bytedance-seed/seedream-5-0-flash:model,prompt,n,response_format,stream