Guide de démarrage rapide des templates

Dans ce tutoriel, vous exécuterez un template public depuis un script Python ou TypeScript. Le template transforme une photo décontractée prise au téléphone d’un vêtement en packshot propre, puis le script enregistre le résultat à côté. Le tutoriel dure environ cinq minutes, dont moins d’une minute pour l’exécution elle-même.

Un template est un ElevenCreative Flow publié : une chaîne de modèles qui reçoit un ensemble fixe d’entrées et produit un ensemble fixe de sorties. Celui que vous allez exécuter, Photo prise au téléphone vers packshot, reçoit une image et renvoie une image. Son auteur a déjà choisi les modèles et les prompts, votre code n’a donc qu’à transmettre la photo.

Configuration

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

Trouver le code du template

Ouvrez Photo prise au téléphone vers packshot dans l’application ElevenLabs et sélectionnez l’onglet API. Chaque template en possède un, avec le code permettant de l’exécuter en cURL, Python et TypeScript.

L’onglet présente trois étapes : obtenir une clé API, choisir comment obtenir le résultat et exécuter le template. Sous Choisir comment obtenir le résultat, l’option Attendre le résultat est sélectionnée par défaut. Le code de la troisième étape s’ouvre sur cURL ; sélectionnez Python ou TypeScript, et l’étape devient Exécuter et attendre le résultat. Son extrait démarre une exécution, attend qu’elle se termine et affiche chaque sortie. Il transmet une valeur sous inputs pour chacune des entrées du template, identifiée par l’id de l’entrée, et lit chaque résultat depuis outputs à l’aide de l’id de la sortie. Ce template possède une entrée, garment_photo, et une sortie, packshot. Ces deux id sont les seuls noms dont votre code a besoin.

Exécuter le template

Créez packshot.py ou packshot.mts. Il s’agit de l’extrait de l’onglet API avec les modifications suivantes :

• La clé API est chargée depuis votre fichier .env.
• La photo est transmise en base64 à la place de YOUR_ASSET_ID, l’id d’un fichier déjà importé dans ElevenLabs.
• Le script affiche une ligne pendant l’exécution et enregistre le packshot dans packshot.jpg au lieu d’afficher son URL.

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 en TypeScript) démarre l’exécution, puis vérifie son état à l’intervalle suggéré par l’API jusqu’à ce que chaque sortie soit terminée. Une exécution qui échoue est renvoyée, sans lever d’exception ; le script vérifie donc le status de la sortie avant de la lire. version_id fige la version du template utilisée pour rédiger ce tutoriel, afin qu’une modification ultérieure du template ne puisse pas casser le script.

Exécutez le script. Une exécution de ce template utilise environ 1 020 crédits, comme dans l’application.

python packshot.py

Après 30 secondes à une minute, le script affiche :

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

Ouvrez packshot.jpg. Le vêtement de la photo est désormais sur un mannequin devant un fond de studio uni ; le lit et l’éclairage ont disparu.

L’exécuter avec votre propre photo

Prenez avec votre téléphone une photo de n’importe quel vêtement. Elle n’a pas besoin d’être réussie : un t-shirt sur votre lit ou une veste sur une chaise conviennent. Enregistrez-la en JPEG sous garment.jpg et exécutez à nouveau le script.

Vous obtenez un packshot de votre vêtement avec le même rendu studio, car chaque exécution d’un template passe par les mêmes modèles et réglages. Les détails peuvent toutefois varier d’une exécution à l’autre, même avec la même photo.

Ce que vous avez appris

• Un template reçoit des entrées nommées et produit des sorties nommées, et son onglet API affiche le code permettant de l’exécuter.
• flows.templates.runs.create_and_wait démarre une exécution avec une valeur par id d’entrée et renvoie le résultat une fois terminée. Vous lisez chaque sortie à l’aide de son id et vérifiez son status.
• En production, un webhook transmet chaque exécution terminée, sans que rien n’ait à l’attendre.

Étapes suivantes