@spec similarity_comparison(
  ArchAstro.Client.t(),
  ArchAstro.Types.Operations.PostApiV1AiEmbeddingSimilarityComparison.Input.t()
) ::
  {:ok,
   ArchAstro.Types.Operations.PostApiV1AiEmbeddingSimilarityComparison.Response.t()}
  | {:error, ArchAstro.Error.reason()}

Compare the embedding similarity of two texts

Embeds both texts in one synchronous request using the platform's default embedding model, then returns their cosine similarity. The score uses the same 1 - cosine_distance convention as context retrieval. A score near 1.0 indicates similar vector direction; lower scores indicate less similar text. This endpoint is intended for authenticated users interactively exploring how the platform's retrieval similarity behaves.

Successful response