Azure认知服务文本分析API中Transaction定义咨询

Hey there! Let’s break down exactly what a transaction means for the Azure Text Analytics API, especially since you’re looking to test the Free tier for sentiment analysis.

Core Definitions to Clear Things Up #

• Transaction: Put simply, a transaction is one single API call you send to the Text Analytics service. Whether you submit a single text block or a batch of multiple text blocks in that one request, it counts as one transaction.
• Record: As you already noted, a record is a single text block limited to 1000 characters. Each record included in an API call eats into your record-based quota.

Answering Your Key Question #

No, a transaction isn’t a text block that can exceed 1000 characters. Here’s the correct breakdown:

• You can’t have a single record longer than 1000 characters—the service will either reject the request or truncate the text (depending on API settings).
• If you have a text longer than 1000 characters, you’ll need to split it into multiple 1000-character records. Submitting all those split records in one API call still counts as one transaction, but it will consume as many records as you split the text into.

Free Tier Quota Breakdown (For Your Use Case) #

For the Free - Web/Container tier you’re planning to use:

• You get 5000 transactions per month: That’s 5000 separate API calls you can make to the service.
• You also get 10000 records per month: This is the total number of 1000-character text blocks you can process across all your transactions.
  Whichever quota you hit first (transactions or records) will pause your free usage for the rest of the month.

Quick example to illustrate:

• If you make 5000 API calls each with 1 record, you’ll use up all your transaction quota and only half of your record quota (5000 out of 10000).
• If you make 1000 API calls each with 10 records, you’ll burn through your entire record quota (1000*10=10000) but only use 1000 of your 5000 available transactions.

内容的提问来源于stack exchange，提问作者cs0815