Miten otan OpenAI-käännökset käyttöön AI Commercessa?
Ohje kertoo, miten aktivoit tekoälypohjaiset-käännökset kaupassasi ja säädät mallin, asetukset ja ohjeistuksen tehokkaasti.
Written by Petro Mäntylä
Updated at May 4th, 2025
Sisällysluettelo
Tämän ohjeen avulla saat käyttöön modernin OpenAI-kääntäjän, joka ymmärtää sivukontekstin, palauttaa JSON-vastaukset ja skaalautuu eri hintatasoihin. Näin nopeutat tuotteiden ja käyttöliittymän lokalisointia ilman manuaalista copy-pastea.
Hyödyt yhdellä silmäyksellä
- Konteksti mukaan (taulu, sarake, sivu) → tarkemmat käännökset
- Mallivalinta nopeuden ja hinnan mukaan → https://platform.openai.com/docs/pricing
- Voit määritellä itse Translation Instructions → Mahdollista rakentaa glossaario
Mistä editoidaan?
Avaa Hallintapaneeli → Configuration → MyStore → OpenAI **. Kaikki alla mainitut asetukset löytyvät samasta näkymästä.
Asetukset
| Asetus | Selite |
|---|---|
| OpenAI Translation Model | Pudotusvalikko (o1-mini, gpt-3.5-turbo, gpt-4o-mini, gpt-4o). Valitse nopeus / hinta / laatu. |
| OpenAI Translation Instruction | Systeemi-ohje mallille. Vakiona: ”Käännä verkkokaupan teksti ja vastaa VAIN muodossa {"translation":"…"}.” |
| OpenAI Translation Max Tokens | (Valinnainen) Vastauksen token-katto. Jätä tyhjäksi, jos haluat automaattisen skaalauksen. |
| OpenAI API Key | Salainen avain ympäristömuuttujissa (ei GUI-kenttää). |
Vaiheittainen käyttöönotto
- Avaa Hallintapaneeli → Configuration → MyStore → OpenAI **.
- Valitse OpenAI Translation Model tarpeesi mukaan:
- o1-mini – nopea & edullinen testaukseen
- o1 – paras laatu laajoihin teksteihin
- Muokkaa OpenAI Translation Instruction, jos haluat yrityksesi tone-of-voice-säännöt.
- Tarvittaessa aseta OpenAI Translation Max Tokens suojarajaksi.
- Varmista, että OpenAI API Key on asetettu ympäristöön (katso ”API-avaimen luonti”).
- Tallenna muutokset ja tee testikäännös esimerkiksi tuotekortille.
Vertailu DeepL-ratkaisuun
| OpenAI | DeepL | |
|---|---|---|
| Kontekstin määrä | Taulun ja sarakkeen nimi + sivu + instructionKey | Rajallinen context-parametri |
| Kustomoitavuus | Täysin kustomoitavissa omilla ohjeilla | Ei tue suomen kielen glossaarioita |
| Mallien valinta | Useita hintatasoja | Yksi hinnoittelu (merkkimäärä) |
| Suuret tekstit | Ei 30 kt kovaa rajaa | 30 kt/pyyntö ilman Premiumia |
| Lokalisointiin sopiva | Ymmärtää slug-ketjut ja komponentit | Sanoihin pilkkoutuva sanakirjapohja |
Ohjeen (Instruction) muokkaus
- Avaa OpenAI Translation Instruction.
- Kirjoita esim:
Translate the text into professional language for a nuclear-physics research-institute web shop, where the buyers are nuclear-energy-sector engineers. Do not translate product model codes. Reply only with {"translation":"…"}...
Use the following glossary exactly as written (do not translate or inflect the left-hand terms):
GLOSSARY:
"vaaka" → "scale"
"lamppu" → "bulb"
"kuormalava" → "pallet"- Tallenna. Ohje lähetetään system-roolissa, joten se ohittaa käyttäjän sanamuodot.
Käyttöönotto
- Tyhjennä Google Translate ja DeepL -avaimet, jotta järjestelmä tietää käyttää vain OpenAI:ta käännöksille
- Siirry https://platform.openai.com/api-keys
- Valitse API Keys → + Create new secret key.
- Kopioi avain heti.
- Tallenna se My Storessa kohtaan OpenAI API Key