Diese Seite wurde von der Cloud Translation API übersetzt.

Kochbuch

Mit unserer API können Sie Produkttitel und ‑beschreibungen anhand der verfügbaren Produktinformationen generieren. Die API akzeptiert:

Ein optionales JSON-Wörterbuch mit Ihren Produktattributen, z. B.: {"brand": "MyBrand", "title": "White Tee", "size": "XL"}.
Ein optionales Produktbild, z. B. {"uri": "https://my-store.com/img/1.png"}.
Optionen für die Titelformatierung, z. B.: attribute_separator, target_language, attribute_order.
Beispiele für Daten-Labeling. (siehe unten)

Richten Sie zuerst die Voraussetzungen ein.

import requests
API_KEY=""
API_ENDPOINT=""

Die Produkterstellung beschleunigen, indem Sie nur anhand eines Bildes Titelvorschläge erhalten

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

Mit vorgeschlagenen Titeln, die auf einer Beschreibung basieren, können Sie Produkte schneller erstellen.

Wenn der Nutzer im Rahmen der Produkterstellung aufgefordert wird, ein Bild und eine kurze Beschreibung anzugeben, können Sie ihm mit dem folgenden Muster einen Produkttitel vorschlagen.

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

Sie können die Produkterstellung beschleunigen, indem Sie sich Titel auf Grundlage eines Titels und einer Beschreibung vorschlagen lassen.

In diesem Beispiel kennzeichnen wir die Produktattribute, die von der KI identifiziert werden sollen, explizit.

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"
      },
    }
  }
}

Produktbeschreibungen aus einem Titel generieren lassen, um die Produkterstellung zu beschleunigen

Wenn der Nutzer im Rahmen der Produkterstellung nach einem Bild und einem Titel gefragt wird, können Sie ihm mit dem folgenden Muster eine Produktbeschreibung vorschlagen.

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.

Beschleunigen Sie die Produkterstellung, indem Sie sowohl einen Titel als auch eine Beschreibung aus einer Marke und einer Farbe generieren lassen.

In diesem Beispiel wird workflow_id auf "tide" gesetzt, um sowohl Titel als auch Beschreibung zu erhalten.

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."
  },
}

Unterstützung von Zielsprachen

In diesem Feld wird die Sprache des Beschreibungstexts angegeben, der in der API-Antwort generiert wird. Er wird als Teil der output_spec-Parameter hinzugefügt.

{"output_spec": {"target_language": "language"}}

Beispielwerte:

"korean" (Korean)
"english" (English)
"spanish" (Spanish)
"french" (French)
"pirate" (Pirate)

Beispiel für JSON-Code für die Nutzlast

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"}}}

Beispielausgabe

{
  "description": {
    "text": "カリフォルニアの黒いコーヒー豆は、あなたの鼻をくすぐる、甘く、フローラルな香りです。この香りは、コーヒー豆の豊かな香りと、ジャスミンとバラの繊細な花の香りをブレンドしたものです。カリフォルニアの黒いコーヒー豆は、あなたの家を居心地の良いカフェに変え、あなたをリラックスした気分にさせてくれるでしょう。この香りは、コーヒー好きにも、フローラルな香り好きにも最適です。カリフォルニアの黒いコーヒー豆で、あなたの家を幸せな香りで満たしましょう！"
  }
}

Wenn Sie einen falschen Sprachcode eingeben, kann es zu einem Fehler kommen.

Wenn die Sprache oder der Wert nicht unterstützt wird, wird der Beschreibungstext standardmäßig auf Englisch angezeigt.

Personalisierung des Formulierungsstils für die Beschreibungserstellung

Um Ihre Marke zu etablieren und Ihren Onlineshop von anderen abzuheben, können Sie den Ton der generierten Beschreibungen personalisieren. Die Text API bietet zwei Optionen:

Sie können aus einer Liste von Tönen auswählen, um neue Beschreibungen zu generieren. Die Liste enthält die folgenden Stilrichtungen:

Standard
Verspielt
Formell
Überzeugend
Locker und dialogorientiert

Sie können vorhandene Beschreibungen oder andere Text-Assets im Stil Ihrer Marke bereitstellen. Das LLM analysiert den Ton des Texts und generiert einen „Schreibstildeskriptor“ anhand der folgenden Aspekte:

Förmlichkeit (z.B. formell, informell)
Ausführlichkeit (z.B. prägnant, sehr ausführlich)
Ton (z.B. professionell, informativ, positiv, überzeugend)
Satzstruktur (z.B. einfacher Satz mit wenigen Konjunktionen)
Häufig verwendete Wörter und Wortgruppen