Schnellstart für Templates

In diesem Tutorial führen Sie ein öffentliches Template über ein Python- oder TypeScript-Skript aus. Das Template verwandelt ein spontanes Handyfoto eines Kleidungsstücks in eine saubere Produktaufnahme, und das Skript speichert das Ergebnis daneben. Das Tutorial dauert etwa fünf Minuten, davon der eigentliche Lauf weniger als eine Minute.

Ein Template ist ein veröffentlichtes ElevenCreative Flow: eine Kette von Modellen, die eine feste Anzahl von Eingaben annimmt und eine feste Anzahl von Ausgaben erzeugt. Das Template, das Sie ausführen werden, Phone Photo to Packshot, nimmt ein Bild entgegen und gibt ein Bild zurück. Der Autor hat Modelle und Prompts bereits ausgewählt, daher übergibt Ihr Code nur das Foto.

Einrichtung

ELEVENLABS_API_KEY=<your_api_key_here>

pip install elevenlabs
pip install python-dotenv

curl -o garment.jpg https://storage.googleapis.com/eleven-public-cdn/documentation_assets/templates/garment.jpg

Code des Templates finden

Öffnen Sie Phone Photo to Packshot in der ElevenLabs-App und wählen Sie den Tab API. Jedes Template hat einen solchen Tab mit dem Code zum Ausführen in cURL, Python und TypeScript.

Der Tab führt durch drei Schritte: API-Schlüssel abrufen, Art des Ergebnisabrufs auswählen und Template ausführen. Unter Choose how to get the result ist standardmäßig Wait for the result ausgewählt. Der Code im dritten Schritt wird in cURL geöffnet. Wählen Sie Python oder TypeScript, dann wird der Schritt zu Run and wait for the result. Das Snippet startet einen Lauf, wartet auf dessen Abschluss und gibt jede Ausgabe aus. Es übergibt für jede Eingabe des Templates einen Wert unter inputs, wobei der Schlüssel die ID der Eingabe ist, und liest jedes Ergebnis anhand der Ausgabe-ID aus outputs. Dieses Template hat eine Eingabe, garment_photo, und eine Ausgabe, packshot. Diese beiden IDs sind die einzigen Namen, die Ihr Code benötigt.

Template ausführen

Erstellen Sie packshot.py oder packshot.mts. Es ist das Snippet aus dem API-Tab mit diesen Änderungen:

• Der API-Schlüssel wird aus Ihrer .env-Datei geladen.
• Das Foto wird als Base64 anstelle von YOUR_ASSET_ID, der ID einer bereits zu ElevenLabs hochgeladenen Datei, übergeben.
• Das Skript gibt während des Laufs eine Zeile aus und speichert die Produktaufnahme in packshot.jpg, statt ihre URL auszugeben.

import base64
import os
import urllib.request
from dotenv import load_dotenv
from elevenlabs import ElevenLabs, TemplateInputReference_InlineBase64
load_dotenv()
client = ElevenLabs(api_key=os.environ["ELEVENLABS_API_KEY"])
with open("garment.jpg", "rb") as f:
    photo = base64.b64encode(f.read()).decode()
print("Running the template, this takes up to a minute...")
# Starts a run and waits for it to finish, checking back as often as the API
# asks. In production, receive the result by webhook instead.
run = client.flows.templates.runs.create_and_wait(
    template_id="Yz4DETxRv4uXyIo5PnEy",
    # Pins the version this tutorial was written against.
    version_id="Kqs4nRrpndEjQ54BhbwE",
    inputs={
        "garment_photo": TemplateInputReference_InlineBase64(
            content_base_64=photo,
            mime_type="image/jpeg",
        ),
    },
)
packshot = run.outputs["packshot"]
# Checking `type` tells your editor this output is an image, which has a content_url.
if packshot.type == "image" and packshot.status == "completed" and packshot.content_url:
    urllib.request.urlretrieve(packshot.content_url, "packshot.jpg")
    print("Saved packshot.jpg")
else:
    print("The run failed:", packshot.failure_reason)

create_and_wait (createAndWait in TypeScript) startet den Lauf und prüft ihn dann in dem von der API vorgeschlagenen Intervall, bis jede Ausgabe abgeschlossen ist. Ein fehlgeschlagener Lauf wird zurückgegeben, nicht ausgelöst. Daher prüft das Skript den status der Ausgabe, bevor es sie liest. version_id fixiert die Version des Templates, auf die sich dieses Tutorial bezieht, sodass eine spätere Änderung am Template das Skript nicht beeinträchtigen kann.

Führen Sie das Skript aus. Ein Lauf dieses Templates verbraucht etwa 1.020 Credits, genauso wie die Ausführung in der App.

python packshot.py

Nach 30 Sekunden bis einer Minute gibt das Skript Folgendes aus:

Running the template, this takes up to a minute...
Saved packshot.jpg

Öffnen Sie packshot.jpg. Das Kleidungsstück auf dem Foto befindet sich jetzt auf einer Schaufensterpuppe vor einem schlichten Studiohintergrund. Bett und Beleuchtung sind verschwunden.

Mit Ihrem eigenen Foto ausführen

Fotografieren Sie ein beliebiges Kleidungsstück mit Ihrem Handy. Das Foto muss nicht gut sein: Ein T-Shirt auf Ihrem Bett oder eine Jacke über einem Stuhl genügt. Speichern Sie es als JPEG unter garment.jpg und führen Sie das Skript erneut aus.

Sie erhalten eine Produktaufnahme Ihres Kleidungsstücks im gleichen Studio-Look, da jeder Lauf eines Templates dieselben Modelle und Einstellungen durchläuft. Die Details können trotzdem von Lauf zu Lauf variieren, auch mit demselben Foto.

Was Sie gelernt haben

• Ein Template nimmt benannte Eingaben entgegen und erzeugt benannte Ausgaben. Sein Tab API zeigt den Code zum Ausführen.
• flows.templates.runs.create_and_wait startet einen Lauf mit einem Wert pro Eingabe-ID und gibt ihn nach Abschluss zurück. Sie lesen jede Ausgabe anhand ihrer ID und prüfen ihren status.
• In der Produktion liefert ein Webhook jeden abgeschlossenen Lauf, sodass nichts darauf wartet.

Nächste Schritte