By default, the file conversion feature provided by Agora Interactive Whiteboard processes one file conversion request per second, that is, the queries per second (QPS) value equals 1, and billing for this feature is based on the number of pages successfully converted.
If the default QPS value does meet your needs because your whiteboard project requires a larger number of concurrent conversion requests per second, you can contact sales@agora.io to adjust the project's QPS configurations and start QPS-based billing.
When contacting sales@agora.io to configure QPS-based billing, you need to provide the following information:
The App Identifier of the whiteboard project whose QPS needs to be adjusted. For details, see Get security credentials for your whiteboard project.
The applicable data center. Make sure you have enabled the file conversion feature in this data center. For details, see Enable whiteboard server-side features.
If the file conversion feature is enabled in multiple data centers under the whiteboard project, switching to QPS-based billing for one data center switches all the others to QPS-based billing as well, with a QPS value of 1. If you do not need the file conversion feature in any of the other data centers, you can avoid the additional charges by disabling the file conversion feature in those data centers. If the other data centers do use the file conversion feature, however, note that you can configure the QPS for those data centers separately.
The daily QPS requirements for file-to-image, which must be a positive integer.
The daily QPS requirements for file-to-web-page, which must be a positive integer.
The date you want the new QPS limit to take effect.
Once a new QPS configuration is completed, it normally takes effect within an hour.
Agora supports adjusting the QPS as needed. Note that a day's notice is required to modify a QPS configuration, so if you anticipate a surge in your project's concurrent file conversion requests, be sure to plan accordingly.
Each month, Agora calculates the charges for each whiteboard project that adopts QPS-based billing by adding together the monthly average QPS for each type of conversion and multiplying the sum by the unit price, as shown in the following table:
File conversion | Monthly average QPS① | Unit price | Pricing |
---|---|---|---|
File conversion to image | Sum of daily QPS/number of calendar days in the month | US$ 89/QPS | Sum of monthly average QPS × 89 |
File conversion to web page | Sum of daily QPS/number of calendar days in the month |
① Decimals are rounded off when calculating the monthly average QPS.
Note the following considerations::
Suppose that you have enabled the file conversion feature in the Hangzhou data center for whiteboard project A, and that the file conversion feature in other data centers for the same project remains disabled. You expect a surge in concurrent file conversion requests from said project. Therefore, you send the following information to sales@agora.io to request adjustments to the project's QPS configurations:
After the new configuration takes effect, the QPS-based billing charges for file conversion for the project for the month of April are as follows:
File conversion | Daily QPS | Number of days of the month | Monthly average QPS | Unit price | Pricing |
---|---|---|---|---|---|
File conversion to image | 5 | 30 | (5 × 30)/30 = 5 | US$ 89/QPS | (5 + 10 ) × 89 = US$ 1,335 |
File conversion to web page | 10 | 30 | (10 × 30)/30 = 10 |
Now suppose that this QPS configuration soon proves to be insufficient for your business needs, so you contact sales@agora.io once again to increase the QPS value for file conversion to images from 5 to 11, and you request that this change take effect on April 11.
In this case, Agora takes the changing value of QPS value into account when calculating the charges for file conversion for the project for the month of April, as follows:
File conversion | Daily QPS | Number of days of the month | Monthly average QPS | Unit price | Pricing |
---|---|---|---|---|---|
File conversion to image |
|
30 | (5 × 10 + 11 × 20)/30 = 9 | US$ 89/QPS | US$ (9 + 10 ) × 89 = 1,691 yuan |
File conversion to web page | 10 | 30 | (10 × 30)/30 = 10 |
If you decide to apply for QPS-based billing for the file conversion of your whiteboard project, note the following considerations: