This page answers frequently asked questions about Dialogflow's API versions (V1, V2, V2 BETA), Dialogflow Editions (Standard & Enterprise), and pricing:
Versions FAQs: Dialogflow API V1, V2 and V2 BETA
What's new with Dialogflow API V2?
Dialogflow API V2 is the new iteration of our developer API. The new API integrates Google Cloud Speech-to-Text, enabling developers to send audio directly to Dialogflow for combined speech recognition and natural language understanding.
API V2 supports exporting, importing, and restoring agents through API calls for improved integration with developers’ change management processes. We’ve also added support for gRPC, a high-performance RPC framework that improves performance, scalability, and integration.
Which API version am I currently using?
The Dialogflow API version is configured separately for each agent. To see which API version is in use for a given agent, or to switch to another version, visit the General tab of the Settings page for that agent in the Dialogflow Console.
Is Dialogflow’s fulfillment affected by API version changes?
Yes. The fulfillment request and response formats have changed between API V1 and V2. Check out the API V2 migration guide for more information.
What happens to my agent if I already migrated to Dialogflow's V2 BETA?
Dialogflow agents that were on API V2 BETA prior to the introduction of API V2 Generally Available (GA) version will remain on API V2 BETA version. You can move from API V2 BETA to V2 GA in your agent settings. Please note that there are differences in behavior between API V2 GA and V2 BETA. Check the API V2 BETA to V2 migration guide for more information
What is the difference between Dialogflow V2 and V2 BETA?
API V2 GA is stable, will not make any backwards incompatible changes without at least 12 months notice, and is designed for production use. API V2 BETA is updated with Dialogflow's newest features while they are still in development. API V2 BETA might be changed in backward-incompatible ways, is not subject to any SLA or deprecation policy, and is not intended for production use.
What happens when I create a new agent?
API V2 is the default API version for new agents.
Can I switch my agent back to API V1 from V2?
You can switch an agent between API versions in the General tab of the agent’s Settings page, in the Dialogflow Console.
How can I try out Dialogflow API V2?
All newly created agents use API V2 by default. If you have an existing agent, you can switch it to API V2 in the General tab of the Settings page for that agent in the Dialogflow Console.
If my agent integrates with Action on Google and Google Assistant, should I move to the new API?
Yes. The newest version (V2) of the Actions on Google client library supports API V2 fulfillment. If you're using fulfillment, make sure to update to the latest version (V2) because previous versions of the Actions on Google client library do not support Dialogflow's API V2 fulfillment. For help on how to migrate from V1 to V2 of the Actions on Google client library see this migration guide.
Should I create my new project with API V2?
Yes. New Dialogflow agents use API V2 by default. Unless you require new features only available in API V2 BETA, we recommend using API V2 for all new project and production agents.
Will API V1 continue to be supported?
V1 of Dialogflow's API will be deprecated on October 23, 2019. Use the following guides to migrate to V2 of the Dialogflow API:
Editions FAQ: Standard and Enterprise
What is Dialogflow Standard Edition?
Dialogflow Standard Edition provides you with free usage of Dialogflow's user interface and APIs, with technical support provided by the community. Dialogflow Standard Edition supports all API versions of Dialogflow. Standard edition comes with default usage limits to prevent misuse. For more information, see the pricing page.
What is Dialogflow Enterprise Edition?
Dialogflow Enterprise Edition is a new service that is available as part of the Google Cloud Platform (GCP). Enterprise Edition provides unlimited text and voice interactions, higher default usage limits, and technical support from Google Cloud, and is billed per interaction according to the pricing guide. Dialogflow Enterprise Edition requires the use of Dialogflow API V2 or V2 BETA.
Which Dialogflow Edition is right for me?
Dialogflow Enterprise Edition is the recommended option for businesses as it provides Google Cloud Platform's enterprise-grade reliability guarantees, compliance, and customer support. For more information about different editions, see Dialogflow Editions.
Dialogflow Standard Edition is a good option for developers getting started with Dialogflow.
Do I have to pay if I use the Google Assistant (Actions on Google) integration?
While use of the Dialogflow Standard Edition is free, there are limits on the amount of requests that you can make. For details, see Quotas & Limits.
If you are using Enterprise Edition, Google Assistant requests are counted as text interaction queries and are eligible to be covered under the SLA.
Is Dialogflow Standard Edition free?
Yes. Default usage limits are in place to prevent misuse.
Do I have to switch to the Enterprise Edition if I hit a certain level of traffic?
If you exceed the limit of audio queries (audio files or streams sent to Dialogflow for transcription and querying through Dialogflow), you must migrate to the Enterprise edition to increase your audio query quota.