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 September 23rd, 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, gpt-5-mini, gpt-5). 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
- GPT5 – 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 |
| Nopeus | 20 käännöstä / min | 100 käännöstä / min |
Glossaryn muokkaus
- Avaa Local & Taxes > Languages > Valitse kieli > Glossary.
- Kirjoita esim:
Ohjaustarvikkeet=Liikluskorralduse lisaseadmed, Opastimet=Käeshoitavad märgid, Käsiopastimet=Käesignaalid ...- Tallenna. Ohje lähetetään system-roolissa, joten se ohittaa käännettävän tekstin sanamuodot.
Käyttöönotto
- Tyhjennä tarvittaessa Google Translate ja DeepL -avaimet, jotta myöhemmin ei tule epäselvyyttä käytössä olevasta käännöspalvelusta.
- 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