کتاب آشپزی

می‌توانید از API ما برای تولید عناوین و توضیحات محصول با استفاده از اطلاعات محصولی که در دسترس دارید استفاده کنید. 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."
  },
}

پشتیبانی از زبان هدف

این فیلد زبان متن توضیحات تولید شده در پاسخ API را مشخص می کند. به عنوان بخشی از پارامترهای 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": "カリフォルニアの黒いコーヒー豆は、あなたの鼻をくすぐる、甘く、フローラルな香りです。この香りは、コーヒー豆の豊かな香りと、ジャスミンとバラの繊細な花の香りをブレンドしたものです。カリフォルニアの黒いコーヒー豆は、あなたの家を居心地の良いカフェに変え、あなたをリラックスした気分にさせてくれるでしょう。この香りは、コーヒー好きにも、フローラルな香り好きにも最適です。カリフォルニアの黒いコーヒー豆で、あなたの家を幸せな香りで満たしましょう！"
  }
}

توجه: کاربر باید target_language برای مطابقت با نمونه های ارائه شده خود مشخص کند. همانطور که در مثال قبلی مشاهده شد، اگرچه توضیحات برای ژاپنی ارائه شد، عنوان به زبان اسپانیایی باقی ماند.

وارد کردن کد زبان نادرست ممکن است منجر به خطا شود.

اگر زبان یا مقدار پشتیبانی نمی شود، متن توضیحات به طور پیش فرض به انگلیسی خواهد بود.

شخصی سازی آهنگ صدا برای نسل توضیحات

برای کمک به ایجاد برند خود و متمایز کردن فروشگاه آنلاین خود از سایرین، می توانید لحن صدای توضیحات تولید شده خود را شخصی سازی کنید. Text API دو گزینه ارائه می دهد:

برای ایجاد توضیحات جدید می توانید از لیستی از آهنگ ها انتخاب کنید. این لیست شامل این سبک های لحن است:

• پیش فرض
• بازیگوش
• رسمی
• متقاعد کننده
• محاوره ای

می توانید توضیحات موجود یا سایر دارایی های متنی را با لحن صدای برند خود ارائه دهید. LLM لحن متن را تجزیه و تحلیل می کند و یک "توصیف کننده سبک نوشتاری" با توجه به این جنبه ها ایجاد می کند:

• رسمی (به عنوان مثال، رسمی، گاه به گاه)
• پرحرفی (مثلاً مختصر، بسیار پرمخاطب)
• لحن (به عنوان مثال، حرفه ای، آموزنده، مثبت، متقاعد کننده)
• ساختار جمله (به عنوان مثال، "جمله ساده با چند حرف ربط")
• بیشترین کلمات و عبارات استفاده شده