Vous pouvez utiliser notre API pour générer des titres et des descriptions de produits à partir des informations produit dont vous disposez. L'API accepte :
- Dictionnaire JSON facultatif contenant les attributs de votre produit. Par exemple :
{"brand": "MyBrand", "title": "White Tee", "size": "XL"}. - Image de produit facultative. Par exemple :
{"uri": "https://my-store.com/img/1.png"}. - Options de mise en forme du titre (par exemple,
attribute_separator,target_language,attribute_order. - Exemples d'étiquetage de données. (voir ci-dessous)
Commencez par configurer les prérequis.
import requests
API_KEY=""
API_ENDPOINT=""
Accélérez la création de produits en obtenant des suggestions de titres à partir d'une image.
my_product_image = 'https://cdn.shopify.com/s/files/1/0653/5879/0892/products/1672082339438_550x825.jpg?v=1672082415'
payload = {}
payload |= {'output_spec': {'workflow_id': 'title', 'attribute_separator': '-'}}
payload |= {'product_info':{}}
payload['product_info'] |= {'product_image':{'uri': my_product_image}}
response = requests.post(API_ENDPOINT, params={'key': API_KEY}, json=payload)
suggested_title = response.json()['title']['text']
print(suggested_title)
Rustic Ceramic & Leather Leaves Necklace
Accélérez la création de produits en obtenant des titres suggérés à partir d'une description.
Si votre flux de création de produits invite l'utilisateur à fournir une image et une brève description, vous pouvez utiliser le modèle suivant pour lui suggérer un titre de produit.
my_product_description = 'selling size 12 nike dunks. oh they are red by the way!'
payload = {}
payload |= {'output_spec': {'workflow_id': 'title'}}
payload |= {'product_info':{'product_attributes': {'description': my_product_description}}}
response = requests.post(API_ENDPOINT, params={'key': API_KEY}, json=payload)
print(response.json()['title']['text'])
Nike Dunks Red Size 12
Accélérez la création de produits en obtenant des titres suggérés à partir d'un titre et d'une description.
Dans cet exemple, nous indiquons explicitement les attributs de produit que nous souhaitons que l'IA identifie.
title = 'Volumizing & Lengthening Mascara - Dark Brown'
description = "This high-impact mascara delivers both voluptuous volume and dramatic length without clumping or smudging."
payload = {}
payload |= {'output_spec': {'workflow_id': 'title'}}
payload |= {'product_info':{'product_attributes': {'title': title, 'description': description, 'brand': 'Luxe Beauty'}}}
payload |= {
"title_examples": [
{
"product_info": {
"title": "Lash Paradise Volumizing & Lengthening Mascara - Waterproof - Blackest Black",
"colour": "Black"
},
"title_format": "product",
"category": "mascara",
"final_product_info": {
"product": "Mascara",
"brand": "Lash Paradise",
"mascara_type": "Volumizing & Lengthening",
"colour": "Blackest Black",
"waterproof": "Waterproof",
}
},
{
"product_info": {
"title": "Hypnose Drama Instant Full Body Volume Mascara - Black",
"colour": "Black"
},
"title_format": "product",
"category": "mascara",
"final_product_info": {
"product": "Mascara",
"brand": "Hypnose",
"sub_brand": "Drama",
"mascara_type": "Full Body Volume",
"colour": "Black",
"eye_lash_type": "All lash types"
}
}
]
}
response = requests.post(API_ENDPOINT, params={'key': API_KEY}, json=payload)
print(response.json())
{
"title": {
"text": "Luxe Beauty Dark Brown Volumizing & Lengthening Mascara"
},
"metadata": {
"metadata": {
"attributes": {
"brand": "Luxe Beauty",
"colour": "Dark Brown",
"mascara_type": "Volumizing & Lengthening",
"product": "Mascara"
},
}
}
}
Accélérez la création de produits en obtenant des descriptions suggérées à partir d'un titre.
Si le flux de création de votre produit invite l'utilisateur à fournir une image et un titre, vous pouvez utiliser le modèle suivant pour lui suggérer une description du produit.
my_product_title = 'Rustic Ceramic & Leather Leaves Necklace'
payload = {}
payload |= {'output_spec': {'workflow_id': 'description'}}
payload |= {'product_info':{'product_attributes': {'title': my_product_title}}}
response = requests.post(API_ENDPOINT, params={'key': API_KEY}, json=payload)
print(response.json()['description']['text'])
Rustic Ceramic & Leather Leaves Necklace is a beautiful necklace made from high-quality ceramic and leather. It features a unique design that is sure to turn heads.
Accélérez la création de produits en obtenant un titre et une description à partir d'une marque et d'une couleur.
Notez que dans cet exemple, nous avons défini workflow_id sur "tide" pour obtenir à la fois le titre et la description.
payload = {}
payload |= {'output_spec': {'workflow_id': 'tide'}}
payload |= {'product_info':{'product_attributes': {'brand': 'Mr. Beast', 'color': 'purple'}}}
payload['product_info'] |= {'product_image':{'uri':'https://mrbeast.store/cdn/shop/files/0015dlv_0000_327.jpg?v=1702754475&width=500'}}
response = requests.post(API_ENDPOINT, params={'key': API_KEY}, json=payload)
print(response.text)
{
"title": {
"text": "Pajamas - Mr. Beast | Purple"
},
"description": {
"text": "Slip into the ultimate comfort and style with these Mr. Beast pajamas in a vibrant shade of purple. Crafted from the softest materials, these pajamas will envelop you in a cozy embrace, ensuring a restful night's sleep. The shorts feature a relaxed fit, allowing for easy movement, while the top boasts a classic design with a comfortable neckline. Whether you're lounging at home or drifting off to dreamland, these Mr. Beast pajamas are the perfect choice for a peaceful and stylish slumber."
},
}
Langues cibles disponibles
Ce champ spécifie la langue du texte de description généré dans la réponse de l'API. Il est ajouté aux paramètres output_spec.
{"output_spec": {"target_language": "language"}}
Exemples de valeurs :
"korean" (Korean)
"english" (English)
"spanish" (Spanish)
"french" (French)
"pirate" (Pirate)
Exemple de code JSON pour la charge utile
title = "Granos de café negro"
description = "Los granos de café negro en California"
payload = {}
payload |= {"output_spec":
{
"workflow_id": "description",
"target_language":"japanese", # specify language here
"attribute_order": ["scent", "product"],
"tone":"playful"}
}
payload |= {"product_info":{"product_attributes": {"description": description, "brand": "Parfums de Paris", "scent": "Floral"}}}
Exemple de résultat
{
"description": {
"text": "カリフォルニアの黒いコーヒー豆は、あなたの鼻をくすぐる、甘く、フローラルな香りです。この香りは、コーヒー豆の豊かな香りと、ジャスミンとバラの繊細な花の香りをブレンドしたものです。カリフォルニアの黒いコーヒー豆は、あなたの家を居心地の良いカフェに変え、あなたをリラックスした気分にさせてくれるでしょう。この香りは、コーヒー好きにも、フローラルな香り好きにも最適です。カリフォルニアの黒いコーヒー豆で、あなたの家を幸せな香りで満たしましょう！"
}
}
Si vous saisissez un code de langue incorrect, une erreur peut se produire.
Si la langue ou la valeur ne sont pas acceptées, le texte de la description sera défini par défaut sur l'anglais.
Personnalisation du ton pour la génération de descriptions
Pour vous aider à établir votre marque et à différencier votre boutique en ligne des autres, vous pouvez personnaliser le ton de vos descriptions générées. L'API Text propose deux options :
Vous pouvez choisir parmi une liste de tons pour générer de nouvelles descriptions. La liste inclut les styles de ton suivants :
- Par défaut
- Espiègle
- Formel
- Convaincant
- Je le parle avec une aisance moyenne me permettant de suivre une conversation
Vous pouvez fournir des descriptions existantes ou d'autres composants textuels dans le ton de votre marque. Le LLM analysera le ton du texte et générera un "descripteur de style d'écriture" en fonction des aspects suivants :
- le registre (formel, informel, etc.) ;
- Niveau de verbosité (par exemple, concis, très verbeux)
- Ton (par exemple, professionnel, informatif, positif, persuasif)
- Structure des phrases (par exemple, "phrase simple avec peu de conjonctions")
- Mots et expressions les plus fréquents