Tarif Defteri

Mevcut ürün bilgilerini kullanarak ürün başlıkları ve açıklamaları oluşturmak için API'mizi kullanabilirsiniz. API şunları kabul eder:

  • Ürün özelliklerinizi içeren isteğe bağlı bir JSON sözlüğü. Örneğin: {"brand": "MyBrand", "title": "White Tee", "size": "XL"}.
  • İsteğe bağlı ürün resmi. Örneğin: {"uri": "https://my-store.com/img/1.png"}.
  • Başlık biçimlendirme seçenekleri (ör. attribute_separator, target_language, attribute_order.
  • Veri etiketleme örnekleri. (aşağıda gösterilmiştir)

Öncelikle ön koşulları ayarlayın.

import requests
API_KEY=""
API_ENDPOINT=""

Yalnızca bir resimden başlık önerileri alarak ürün oluşturma sürecini hızlandırın.

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

Açıklamalardan başlık önerileri alarak ürün oluşturma sürecini hızlandırın.

Ürün oluşturma akışınızda kullanıcıdan resim ve kısa açıklama isteniyorsa aşağıdaki kalıbı kullanarak ürün başlığı önerebilirsiniz.

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

Başlık ve açıklamadan başlık önerileri alarak ürün oluşturma sürecini hızlandırın.

Bu örnekte, yapay zekanın tanımlamasını istediğimiz ürün özelliklerini açıkça etiketliyoruz.

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

Başlıktan açıklama önerileri alarak ürün oluşturma sürecini hızlandırın.

Ürün oluşturma akışınızda kullanıcıdan resim ve başlık isteniyorsa aşağıdaki kalıbı kullanarak ürün açıklaması önerebilirsiniz.

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.

Marka ve renk bilgilerinden hem başlık hem de açıklama alarak ürün oluşturma sürecini hızlandırın.

Bu örnekte hem başlığı hem de açıklamayı almak için workflow_id değerini "tide" olarak ayarladığımıza dikkat edin.

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

Hedef Dil Desteği

Bu alan, API yanıtında oluşturulan açıklama metninin dilini belirtir. output_spec parametrelerinin bir parçası olarak eklenir.

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

Örnek Değerler:

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

Yük için örnek 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"}}}

Örnek Çıkış

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

Yanlış dil kodu girilmesi hataya neden olabilir.

Dil veya değer desteklenmiyorsa açıklama metni varsayılan olarak İngilizce olur.

Açıklama oluşturma için ses tonunu kişiselleştirme

Markanızı oluşturmanıza ve online mağazanızı diğerlerinden ayırmanıza yardımcı olması için oluşturulan açıklamalarınızın üslubunu kişiselleştirebilirsiniz. Text API iki seçenek sunar:

Yeni açıklamalar oluşturmak için ton listesinden seçim yapabilirsiniz. Listede şu üslup stilleri yer alır:

  • Varsayılan
  • Şen
  • Resmi
  • İkna edici
  • Görüşmeler

Mevcut açıklamaları veya diğer metin öğelerini markanızın üslubuna uygun şekilde sağlayabilirsiniz. LLM, metnin üslubunu analiz eder ve şu yönlere göre bir "yazım stili tanımlayıcısı" oluşturur:

  • Resmiyet (ör. resmi, gündelik)
  • Ayrıntı düzeyi (ör. kısa, çok ayrıntılı)
  • Üslup (ör. profesyonel, bilgilendirici, olumlu, ikna edici)
  • Cümle yapısı (ör. "simple sentence with few conjunctions") [Birkaç bağlaç içeren basit cümle]
  • En sık kullanılan kelimeler ve kelime öbekleri