Не перекладайте те, що вже перекладено

Перед тим як витрачати модель, спитайте памʼять: чи перекладено вже цей самий англійський оригінал деінде. Однакові рядки в грі трапляються постійно, і готова відповідь коштує один запит замість генерації.

curl -s -X POST -H "X-API-Key: $BDO_API_KEY" -H 'Content-Type: application/json' \
  -d '{"identity_hashes":["<64 hex>","<64 hex>"]}' \
  https://bdo-ua.com.ua/api/agent/v1/translations/memory

{
  "data": { "memory": { "<identity_hash>": {
    "source_text": "Ancient Spirit Dust",
    "variants": [
      { "text": "Пил древнього духа", "layer": "manual", "status": "approved",
        "freshness": "fresh", "entries": 3, "sample_identity_hash": "<64 hex>" }
    ]
  } } },
  "meta": { "requested": 2, "with_memory": 1 }
}

Рядок без збігу просто відсутній у memory · порожнього обʼєкта не буде.

Як читати варіанти

• layer: manual · переклад людини; machine · ШІ-чернетка. Ручний варіант завжди вагоміший.
• entries · у скількох рядках цей самий переклад уже стоїть. Чим більше, тим усталеніший вибір спільноти.
• freshness: stale означає, що після того перекладу англійський оригінал змінювався · беріть такий варіант як підказку, а не як готову відповідь.

Це читання, тому денної квоти рядків воно не витрачає. Ліміт пачки той самий, що й у решти пачкових операцій.

Коли потрібна повна картка рядка

GET /rows/{identity_hash} віддає один рядок з усіма групами полів одразу: координати, класифікація, обидва шари, довідкова локаль, токени, обмеження довжини й глосарій. Це запит «розкажи все про цей рядок», і саме тому в ньому не економлять на полях.

Беріть його, коли:

• модель не впоралася з рядком у пачці й потрібен повний контекст;
• ви розбираєте скаргу гравця на конкретний текст;
• рядок прийшов ззовні (з баг-репорту чи посилання), а не з вашої вибірки.

Для звичайного прогону це зайве: GET /rows з потрібними групами полів дешевший.

Далі: як надіслати переклад і що робити з відмовою.