Halaman ini diterjemahkan oleh Cloud Translation API.

Cookbook

Anda dapat menggunakan API kami untuk membuat judul dan deskripsi produk menggunakan informasi produk apa pun yang tersedia. API menerima:

Kamus JSON opsional yang berisi atribut produk Anda. Misalnya, {"brand": "MyBrand", "title": "White Tee", "size": "XL"}.
Gambar produk opsional. misalnya, {"uri": "https://my-store.com/img/1.png"}.
Opsi pemformatan judul. Misalnya, attribute_separator, target_language, attribute_order.
Contoh pelabelan data. (terlihat di bawah)

Siapkan prasyarat Anda terlebih dahulu.

import requests
API_KEY=""
API_ENDPOINT=""

Percepat pembuatan produk dengan mendapatkan saran judul hanya dari gambar.

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

Percepat pembuatan produk dengan mendapatkan saran judul dari deskripsi.

Jika alur pembuatan produk Anda meminta pengguna untuk memberikan gambar dan deskripsi singkat, Anda dapat menggunakan pola berikut untuk menyarankan judul produk kepada mereka.

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

Percepat pembuatan produk dengan mendapatkan saran judul dari judul dan deskripsi.

Dalam contoh ini, kita secara eksplisit memberi label pada atribut produk yang ingin diidentifikasi oleh AI.

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

Percepat pembuatan produk dengan mendapatkan saran deskripsi dari judul.

Jika alur pembuatan produk Anda meminta pengguna untuk memberikan gambar dan judul, Anda dapat menggunakan pola berikut untuk menyarankan deskripsi produk kepada mereka.

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.

Percepat pembuatan produk dengan mendapatkan judul dan deskripsi dari merek dan warna.

Perhatikan bagaimana dalam contoh ini kita menyetel workflow_id ke "tide" untuk mendapatkan judul dan deskripsi.

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

Dukungan Bahasa Target

Kolom ini menentukan bahasa teks deskripsi yang dihasilkan dalam respons API. Objek ini ditambahkan sebagai bagian dari parameter output_spec.

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

Contoh Nilai:

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

Contoh JSON untuk payload

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

Contoh Output

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

Memasukkan kode bahasa yang salah dapat menyebabkan error.

Jika bahasa atau nilai tidak didukung, teks deskripsi akan ditetapkan ke bahasa Inggris secara default.

Personalisasi Gaya Bahasa untuk Pembuatan Deskripsi

Untuk membantu membangun merek Anda dan membedakan toko online Anda dari toko lainnya, Anda dapat mempersonalisasi gaya bahasa deskripsi yang dibuat. Text API menawarkan dua opsi:

Anda dapat memilih dari daftar gaya bahasa untuk membuat deskripsi baru. Daftar ini mencakup gaya bahasa berikut:

Default
Lucu
Formal
Persuasif
Bisa percakapan

Anda dapat memberikan deskripsi yang ada atau aset teks lainnya dalam gaya bahasa merek Anda. LLM akan menganalisis nada teks dan menghasilkan "deskriptor gaya penulisan" sesuai dengan aspek-aspek berikut:

Formalitas (misalnya, formal, kasual)
Panjang respons (misalnya, ringkas, sangat panjang)
Gaya bahasa (misalnya, profesional, informatif, positif, persuasif)
Struktur kalimat (misalnya, "kalimat sederhana dengan sedikit konjungsi")
Kata dan frasa yang paling sering digunakan