Wie man die Seedream 5.0 Flash API verwendet

Seedream 5.0 Flash ist auf EmpirioLabs verfügbar. Es ist ByteDances schnelles Seedream-Bildmodell für text-to-image Generation, Bearbeitungen kombinieren bis zu 10 Referenzbilder, präzise Bearbeitungen mit Koordinaten oder gezeichneten Markern sowie Schichtzerlegung, die ein Bild in ein Basisbild plus bis zu 16 transparente Schichten aufteilt. Es funktioniert sowohl in der API als auch im Playground.

Sehen Sie sich den Startfilm an

Jedes Bild im Film ist ein echter Seedream 5.0 Flash-Ausgang. Die Filmmusik wurde von ACE-Step auf EmpirioLabs erstellt.

Was es unterstützt

• Text-zu-Bild. Senden Sie einen Prompt ohne Bild.
• Bearbeitung und Fusion. Füge ein bis zehn Bilder hinzu und beschreibe die Veränderung oder wie man sie kombiniert.
• Markiere und koordiniere Bearbeitungen. Markiere den zu verändernden Bereich im Eingabebild mit einem Kreis, Pfeil oder einer Skizze oder gib seine genaue Position als ein <bbox> Markiere den Prompt ein.
• Schichtzerlegung. Teilen Sie ein Bild in ein Basisbild plus bis zu 16 transparente PNG-Schichten auf, die jeweils mit ihrer Position im Basisbild, einem Namen und einer Beschreibung zurückgegeben werden.
• Transparente Hintergründe. Bearbeite ein Bild, das bereits einen Alphakanal hat, und behalte die Transparenz im Ergebnis.
• Text im Bild. Schilder, Etiketten und Plakate werden in Chinesisch, Englisch und 14 weiteren Sprachen dargestellt, darunter Japanisch, Koreanisch, Arabisch, Spanisch und Französisch.

Die Ausgabe ist PNG oder JPEG in der 1K-, 1.5K- oder 2K-Auflösungsstufe oder in einer benutzerdefinierten Breite und Höhe.

Erzeugen Sie ein Bild

curl https://api.empiriolabs.ai/v1/images/generations \ -H "Autorisierung: Träger $EMPIRIOLABS_API_KEY" \ -H "Inhaltstyp: application/json" \ -d '{ "model": "seedream-5-0-flash", "prompt": "Ein Papierlaternenfest über einem Fluss in der Dämmerung, Reflexionen im Wasser", "aspect_ratio": "16:9", "quality": "2K", "sync": true }'

Synchronisieren und asynchronisieren. Mit "Synchronisation": Wahr Die Anfrage bleibt offen und gibt das fertige Bild in Daten. Ohne sie ist die Antwort ein Job mit einem job id und a poll url. Umfrage LOS /v1/jobs/<job_id> Bis Status ist abgeschlossen.

Derselbe Aufruf vom OpenAI Python SDK, der auf EmpirioLabs zeigte. Steuerungen, die das SDK nicht definiert, gehen hinein extra_body:

von openai-import OpenAI-Client = OpenAI(base_url="https://api.empiriolabs.ai/v1", api_key="YOUR_EMPIRIOLABS_API_KEY",) Ergebnis = client.images.generate(model="seedream-5-0-flash", prompt="Ein Papierlaternenfest über einem Fluss in der Dämmerung, Reflexionen im Wasser", extra_body={"sync": True, "aspect_ratio": "16:9", "quality": "2K"},) print(result.data[0].url)

Bearbeitung mit Referenzbildern

Geben Sie bis zu 10 Bild-URLs, Daten-URIs oder hochgeladene Bilder durch bild, und beziehe dich in der Aufforderung in ihrer Reihenfolge auf sie:

{ "model": "seedream-5-0-flash", "prompt": "Stelle die Tasse aus Bild 1 aus Bild 2 auf den Tisch, wobei die Beleuchtung von Bild 2 bleibt", "image": [ "https://example.com/cup.png", "https://example.com/table.jpg" ], "sync": true }

Bearbeite einen markierten Bereich

Um einen Teil eines Bildes zu verändern, markiere ihn auf der Eingabe mit einem Kreis, Pfeil oder einer Skizze und beschreibe die Veränderung, oder gib den Bereich als ein <bbox> Tag. Eine Box ist links oben rechts unten auf einem Raster von 0 bis 1000 über dem Bild, unabhängig von seiner Pixelgröße:

{ "model": "seedream-5-0-flash", "prompt": "Füge eine kleine Glasvase mit einer einzigen weißen Tulpe darin <bbox>60 80 300 520</bbox> hinzu. Alles andere bleibt unverändert.", "image": "https://example.com/kitchen.png", "sync": true }

Tags funktionieren auch über Bilder hinweg, zum Beispiel um das Motiv aus einem Bereich von Bild 1 in einen Bereich von Bild 2 zu platzieren.

Teile ein Bild in Schichten auf

Setz layer_decomposition zu Stimmt und genau ein Bild anhängen. Die Aufforderung ist optional: Lassen Sie sie weg, damit das Modell die Elemente auswählen oder die zu trennenden Elemente oder Regionen benennen.

curl https://api.empiriolabs.ai/v1/images/generations \ -H "Autorisierung: Träger $EMPIRIOLABS_API_KEY" \ -H "Inhaltstyp: application/json" \ -d '{ "model": "seedream-5-0-flash", "layer_decomposition": true, "image": "https://example.com/perfume-ad.png", "prompt": "Trenne die Parfümflasche, ihr Etikett und den Lichtstrahl", "sync": true }'

Daten[0] ist das Basisbild, mit einem z_index von 0. Jeder Eintrag danach ist eine transparente PNG-Schicht mit ihrer Stapelreihenfolge, ihrem Feld im Basisbild in Pixeln (bounding_box. absolut) und auf dem Raster von 0 bis 1000 (bounding_box. normalisiert), beide als [links, oben, rechts, unten], sowie einen Namen und eine Beschreibung:

{ "URL": "https://media.empiriolabs.ai/...", "z_index": 4, "width": 476, "height": 1024, "bounding_box": { "absolute": [1181, 268, 1657, 1292], "normalized": [419, 169, 588, 815] }, "name": "Hauptkörper der Parfümflasche", "Beschreibung": "Eine transparente quadratische Parfümflasche mit facettiertem goldenem Deckel..." }

Stapele die Schichten über dem Basisbild aufsteigend z_index um sie neu aufzubauen oder zuerst eine beliebige Ebene zu verschieben, zu vergrößern, neu zu färben oder zu ersetzen. Eine Ebene kann auch die Eingabe für eine neue Anfrage sein, zum Beispiel um ein Element neu zu färben und dessen Transparenz zu erhalten.

Dinge, die du vor deiner ersten Anfrage wissen solltest

• Ein Bild pro Anfrage. Eine Anfrage liefert ein Bild zurück, und n über 1 liefert einen Fehler. Senden Sie separate Anfragen für Variationen. Die Schichtzerlegung ist die Ausnahme: Sie gibt das Basisbild und seine Schichten zusammen zurück.
• Skaliere jede Ebene auf ihre Box. Eine PNG ist nicht immer so groß wie ihr Footprint im Basisbild, und eine Textebene kann um ein Vielfaches größer erscheinen. Skalieren Sie jede Ebene auf die Breite und Höhe ihrer bounding_box. absolut bevor er es in die obere linke Ecke der Box stellte.
• Der Prompt entscheidet, wie viele Schichten zurückkommen. Ohne Eingabeaufforderung trennt das Modell jedes gefundene Element und liefert jedes zurückgegebene Bild. Benennen Sie die benötigten Elemente oder geben Sie deren Regionen an als <bbox> Tags, um das Ergebnis auf diese zu beschränken.
• Versuchen Sie eine Schichtzerlegung erneut, die nicht verarbeitet werden konnte. Eine Schichtzerlegung scheitert gelegentlich mit einem Fehler, der besagt, dass der Bildinhalt nicht verarbeitet werden konnte. Senden Sie dieselbe Anfrage erneut.
• Es gibt keine schnelle Prompt-Optimierung. prompt_optimization_mode: "schnell" von Seedream 5.0 Pro gibt bei Flash einen Fehler zurück. Lass die Steuerung weg.
• Ein transparentes Ergebnis benötigt eine transparente Eingabe. Hintergrund: "Transparent" arbeitet an einer Bearbeitung genau eines Bildes, das bereits einen Alphakanal besitzt, wie etwa eine Schicht aus einer Zerlegung, mit output_format Setzen Sie auf PNG. JPEG-Ausgabe liefert einen Fehler.

Preisgestaltung

Laut Bild. Seedream 5.0 Flash ist Pay-as-you-go und berechnet pro zurückgegebenem Bild, zu einem Satz für jede Auflösungsstufe. Referenzbilder sind kostenlos. Eine Schichtzerlegung berechnet jedes zurückgegebene Bild, das Basisbild und jede Schicht, zum gleichen Tarif. Kein Abonnement ist erforderlich. Die aktuellen Tarife sind auf dem modellblatt und die preisseite.

Inhaltssicherheit. Generierte Bilder bestehen eine automatisierte Inhaltssicherheitsprüfung. Ein als explizit markiertes Bild wird nicht zurückgegeben, und da es vor der Prüfung erstellt wurde, wird es weiterhin abgerechnet.

Beginnen Sie mit dem Bau

Versuche Seedream 5.0 Flash in der Playground, lesen Sie die vollständige Parameterreferenz in der API-Doku, oder sie mit den anderen Bildmodellen in der Modellkatalog. Für die Pro-Stufe derselben Familie siehe Wie man die Seedream 5.0 Pro API verwendet.