تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

كتاب الطبخ

يمكنك استخدام واجهة برمجة التطبيقات لإنشاء عناوين وأوصاف للمنتجات باستخدام أي معلومات متوفّرة لديك عن المنتجات. تقبل واجهة برمجة التطبيقات ما يلي:

قاموس 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 خيارَين:

يمكنك الاختيار من قائمة أساليب لإنشاء أوصاف جديدة. تتضمّن القائمة أنماط النبرة التالية:

تلقائي
مرح
رسمي
مقنعة
أسلوب المحادثة

يمكنك تقديم أوصاف حالية أو مواد عرض نصية أخرى بأسلوب علامتك التجارية. سيحلّل النموذج اللغوي الكبير نبرة النص وينشئ "واصفًا لأسلوب الكتابة" وفقًا للجوانب التالية:

مستوى اللغة الرسمية (مثل رسمية أو غير رسمية)
الإسهاب (مثل: موجز، مسهب جدًا)
الأسلوب (على سبيل المثال، احترافي أو إخباري أو إيجابي أو مقنع)
بنية الجملة (مثل جملة بسيطة تتضمّن بعض أدوات الربط")
الكلمات والعبارات الأكثر استخدامًا