34.5 Prices, answers kept, and errors

This applies to every hosted Relatude service. Each call is charged to the license's credit account for the service, and every answer carries Credits (what the call cost) and CreditsLeft (what is left). GetOperationsAsync, GetFormatsAsync and GetLanguagesAsync give the prices for free.

Repeated calls. Your server keeps the answers in the last column, so the same call is not sent again. Only what is missing goes to the service: translate a hundred texts with one new, and only that one is sent. An answer from your server says Cached and costs nothing. The hosted services keep answers too, and answer a repeated call at the price they set for that. Pass fresh: true for a new answer, such as another take on a description; it is charged in full.

• CacheType in the image, file and translation settings chooses where your server keeps their answers: Native (the default, a file beside the AI embedding cache), Memory or None. Answers are kept for 90 days.
• db.MaintenanceAsync(MaintenanceAction.ClearAiCache) empties these caches and the embedding cache.
• A store built from code wraps its provider itself: new CachingTranslationProvider(provider, new NativeKvServiceAnswerCache(path)), and likewise CachingImagingProvider and CachingFileToTextProvider.

Errors. A refused call throws a RelatudeServiceException. Its message is the service's own reason, written for whoever configured the installation, and StatusCode says what went wrong:

MayHaveBeenCharged is false for refusals made before anything is charged, and true otherwise. Credits are never given back. The providers retry by themselves only when nothing can have been charged, so no call is paid for twice. Retry a call that may have been charged only if paying twice is acceptable.