कुकबुक

हमारे एपीआई का इस्तेमाल करके, प्रॉडक्ट के टाइटल और ब्यौरे जनरेट किए जा सकते हैं. इसके लिए, आपके पास प्रॉडक्ट की जो भी जानकारी उपलब्ध है उसका इस्तेमाल किया जा सकता है. एपीआई इन फ़ॉर्मैट में डेटा स्वीकार करता है:

  • यह एक JSON डिक्शनरी है, जिसमें आपके प्रॉडक्ट एट्रिब्यूट शामिल होते हैं. यह ज़रूरी नहीं है. उदाहरण के लिए, {"brand": "MyBrand", "title": "White Tee", "size": "XL"}.
  • प्रॉडक्ट की इमेज (ज़रूरी नहीं). उदाहरण के लिए, {"uri": "https://my-store.com/img/1.png"}.
  • टाइटल को फ़ॉर्मैट करने के विकल्प. जैसे, attribute_separator, target_language, attribute_order.
  • डेटा लेबलिंग के उदाहरण. (नीचे दिया गया है)

सबसे पहले, ज़रूरी शर्तें पूरी करें.

import requests
API_KEY=""
API_ENDPOINT=""

सिर्फ़ इमेज से सुझाए गए टाइटल पाकर, प्रॉडक्ट बनाने की प्रोसेस को तेज़ करें.

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

ब्यौरे से सुझाए गए टाइटल पाकर, प्रॉडक्ट बनाने की प्रोसेस को तेज़ करें.

अगर प्रॉडक्ट बनाने के फ़्लो में, उपयोगकर्ता से इमेज और छोटे ब्यौरे के लिए कहा जाता है, तो उन्हें प्रॉडक्ट का टाइटल सुझाने के लिए, इस पैटर्न का इस्तेमाल किया जा सकता है.

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

टाइटल और ब्यौरे से सुझाए गए टाइटल पाकर, प्रॉडक्ट बनाने की प्रोसेस को तेज़ करें.

इस उदाहरण में, हमने उन प्रॉडक्ट एट्रिब्यूट को साफ़ तौर पर लेबल किया है जिन्हें हम चाहते हैं कि एआई पहचान सके.

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

टाइटल से सुझाए गए ब्यौरे पाकर, प्रॉडक्ट बनाने की प्रोसेस को तेज़ करें.

अगर प्रॉडक्ट बनाने के फ़्लो में, उपयोगकर्ता से इमेज और टाइटल मांगा जाता है, तो उसे प्रॉडक्ट का ब्यौरा सुझाने के लिए, इस पैटर्न का इस्तेमाल किया जा सकता है.

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.

ब्रैंड और रंग के आधार पर टाइटल और ब्यौरा, दोनों की जानकारी पाकर प्रॉडक्ट बनाने की प्रोसेस को तेज़ करें.

ध्यान दें कि इस उदाहरण में, हमने workflow_id को "tide" पर सेट किया है, ताकि हमें टाइटल और ब्यौरा, दोनों मिल सकें.

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

टारगेट की गई भाषा में सहायता

इस फ़ील्ड से, एपीआई रिस्पॉन्स में जनरेट किए गए ब्यौरे के टेक्स्ट की भाषा के बारे में पता चलता है. इसे output_spec पैरामीटर के हिस्से के तौर पर जोड़ा जाता है.

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

वैल्यू के उदाहरण:

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

पेलोड के लिए JSON का उदाहरण

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

आउटपुट का उदाहरण

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

गलत भाषा कोड डालने पर, गड़बड़ी हो सकती है.

अगर भाषा या वैल्यू काम नहीं करती है, तो ब्यौरे का टेक्स्ट डिफ़ॉल्ट रूप से अंग्रेज़ी में दिखेगा.

ब्यौरा जनरेट करने के लिए, आवाज़ के लहज़े को मनमुताबिक बनाने की सुविधा

अपने ब्रैंड को बेहतर तरीके से पेश करने और अपने ऑनलाइन स्टोर को दूसरों से अलग दिखाने के लिए, जनरेट किए गए ब्यौरों की टोन को अपनी पसंद के मुताबिक बनाया जा सकता है. Text API के दो विकल्प उपलब्ध हैं:

नई जानकारी जनरेट करने के लिए, टोन की सूची में से कोई टोन चुनी जा सकती है. इस सूची में, टोन की ये स्टाइल शामिल हैं:

  • डिफ़ॉल्ट
  • प्लेफ़ुल
  • फ़ॉर्मल
  • दिलचस्प
  • बोलचाल वाला

अपने ब्रैंड की टोन में, मौजूदा ब्यौरे या अन्य टेक्स्ट ऐसेट दी जा सकती हैं. एलएलएम, टेक्स्ट की टोन का विश्लेषण करेगा. इसके बाद, इन पहलुओं के हिसाब से "लिखने के तरीके का ब्यौरा" जनरेट करेगा:

  • औपचारिकता (जैसे, औपचारिक, अनौपचारिक)
  • कितने शब्दों में जानकारी दी जाए (जैसे, कम शब्दों में, बहुत ज़्यादा शब्दों में)
  • टोन (जैसे, प्रोफ़ेशनल, जानकारी देने वाला, सकारात्मक, लुभाने वाला)
  • वाक्य की संरचना (जैसे, "simple sentence with few conjunctions")
  • सबसे ज़्यादा इस्तेमाल किए गए शब्द और वाक्यांश