From ddd1bd55c474f079d4e9d90b618f7c107bd8f23e Mon Sep 17 00:00:00 2001 From: tho-hole Date: Fri, 6 Mar 2026 16:19:35 +0100 Subject: [PATCH 1/3] fix: update credit usage details and add refund policy + minor edits --- APIs/openEO/credit_usage.qmd | 23 +++++++++++++---------- 1 file changed, 13 insertions(+), 10 deletions(-) diff --git a/APIs/openEO/credit_usage.qmd b/APIs/openEO/credit_usage.qmd index b6d5bbf7a2..c4e5490ac2 100644 --- a/APIs/openEO/credit_usage.qmd +++ b/APIs/openEO/credit_usage.qmd @@ -9,13 +9,14 @@ To ensure fair distribution of these free cloud resources, each user is allocate :::{.callout-note appearance="simple" icon=false} ## Free Tier -A Copernicus General user** receives 10000(¹) free openEO credits automatically on the first of every month to explore and start using the openEO API.
Users can check their current credit balance in the [openEO Algorithm Plaza](https://marketplace-portal.dataspace.copernicus.eu/billing){target="_blank"} under the 'Billing' tab.
*(¹)Temporary Boost of monthly openEO Credits to 10 000. [Read our news item](https://dataspace.copernicus.eu/news/2024-9-3-temporary-boost-monthly-openeo-credits-10000-granted-user) published on September 3, 2024.* +A Copernicus General user** receives 10000(¹) free openEO credits automatically on the first of every month to explore and start using the openEO API.
Users can check their current credit balance in the [openEO Algorithm Plaza](https://marketplace-portal.dataspace.copernicus.eu/billing){target="_blank"} under the 'Billing' tab.
*(¹)Boost of monthly openEO Credits to 10 000. [Read our news item](https://dataspace.copernicus.eu/news/2024-9-3-temporary-boost-monthly-openeo-credits-10000-granted-user) published on September 3, 2024.* ::: :::{.callout-note appearance="simple" icon=false} ## Scale Up When the provided credits are insufficient, you can purchase extra openEO Cloud Credits through CREODIAS. Discover openEO Credit Packages here: [Visit CREODIAS](https://ecommerce.creodias.eu/vito){target="_blank"}. +Other options for extra credits are discussed [here](https://marketplace-portal.dataspace.copernicus.eu/pages/pricing){target="_blank"}. ::: @@ -42,18 +43,16 @@ When running this example, the batch job reports its usage, which can be monitor ![](./_images/batchjob_metrics.png) -Usage metrics are shown in the OpenEO Web Editor for an example batch job: +Usage metrics are shown in the OpenEO Web Editor for an example batch job, with conversion factors for CDSE backend on March 2026: -* 13,400,773 mb-seconds corresponds to 3.64 GB hours or 3.64 credits -* 5099 CPU seconds corresponds to 1.4 CPU hour, which translates to 2.12 credits +* 13,400,773 mb-seconds corresponds to 3.64 GB hours or 3.9 credits +* 5099 CPU seconds corresponds to 1.4 CPU hour, which translates to 2.3 credits * A fixed cost of 2 credits is charged per batch job for management overhead and storage. -Summing this up, the total comes to 7.76 credits. With the current free tier offering 10,000 credits(¹), quite a few jobs like this can be run! -However, it is important to note that resource consumption (CPU and memory in this case) is not fixed over time. Performance characteristics of a particular cloud can fluctuate depending on the overall load. +Summing this up, the total comes to 8.2 credits. With the current free tier offering 10,000 credits(¹), quite a few jobs like this can be run! +However, it is important to note that resource consumption (CPU and memory in this case) is not fixed over time. Performance characteristics of a particular cloud can fluctuate depending on the overall load. Cloud providers try to avoid this, but generally, they only manage to do so within the limits of a given SLA. The conversion factor from resource usage to credits is subject to change, as it is determined by the backend. -Cloud providers try to avoid this, but generally, they only manage to do so within the limits of a given SLA. - -*(¹)Temporary Boost of monthly openEO Credits to 10 000. [Read our news item](https://dataspace.copernicus.eu/news/2024-9-3-temporary-boost-monthly-openeo-credits-10000-granted-user) published on September 3, 2024.* +*(¹)Boost of monthly openEO Credits to 10 000. [Read our news item](https://dataspace.copernicus.eu/news/2024-9-3-temporary-boost-monthly-openeo-credits-10000-granted-user) published on September 3, 2024.* ## Estimating resource usage @@ -64,6 +63,10 @@ For instance, for a query at a 10m resolution, begin with a 10ha area and simply As shown above, this will usually incur a cost of only a few cents. In the worst case, it might cost a few euros, but this would also indicate that the job takes multiple hours to run. -Once an initial cost for a small area is established, it is possible to extrapolate to a larger area. If simple linear extrapolation shows that a larger job is affordable, proceed with a job on larger areas, like 50ha or up to 100x100km. This will show how the job scales and the associated cost. If at any point the cost appears unreasonable, do not hesitate to reach out via [posting to CDSE Forum](https://forum.dataspace.copernicus.eu/) or via [submitting a request](https://helpcenter.dataspace.copernicus.eu/hc/en-gb/requests/new)! +Once an initial cost for a small area is established, it is possible to extrapolate to a larger area. If simple linear extrapolation shows that a larger job is affordable, proceed with a job on larger areas, like 50ha or up to 100x100km. This will show how the job scales and the associated cost. The relative cost most likely decreases for increasing job sizes. If at any point the cost appears unreasonable, do not hesitate to reach out via [posting to CDSE Forum](https://forum.dataspace.copernicus.eu/) or via [submitting a request](https://helpcenter.dataspace.copernicus.eu/hc/en-gb/requests/new)! For more comprehensive guidelines on large-scale processing, please refer to our documentation [here](./large_scale_processing.qmd). + +## Failing jobs and credit refunds + +If jobs fail due to an error on the provider side, the user can be refunded for the credits used by these jobs. A user can fill in a [refund request form](https://dataspace.copernicus.eu/openeo-refund-request). The form requires the user to provide details about the job(s), such as the job ID, the error message received, and any relevant logs or screenshots. The request will be reviewed by the support team, and if approved, the credits used for that job and similar jobs in the same timeframe will be refunded to the user's account. This is possible for all types of credits except for the free tier credits, which are not refundable. From 9345557c4afff0b1acdb57a2c74138e6babbf069 Mon Sep 17 00:00:00 2001 From: tho-hole Date: Fri, 6 Mar 2026 16:23:18 +0100 Subject: [PATCH 2/3] Added commas as thousand seperator --- APIs/openEO/credit_usage.qmd | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/APIs/openEO/credit_usage.qmd b/APIs/openEO/credit_usage.qmd index c4e5490ac2..1a16662705 100644 --- a/APIs/openEO/credit_usage.qmd +++ b/APIs/openEO/credit_usage.qmd @@ -9,7 +9,7 @@ To ensure fair distribution of these free cloud resources, each user is allocate :::{.callout-note appearance="simple" icon=false} ## Free Tier -A Copernicus General user** receives 10000(¹) free openEO credits automatically on the first of every month to explore and start using the openEO API.
Users can check their current credit balance in the [openEO Algorithm Plaza](https://marketplace-portal.dataspace.copernicus.eu/billing){target="_blank"} under the 'Billing' tab.
*(¹)Boost of monthly openEO Credits to 10 000. [Read our news item](https://dataspace.copernicus.eu/news/2024-9-3-temporary-boost-monthly-openeo-credits-10000-granted-user) published on September 3, 2024.* +A Copernicus General user** receives 10,000(¹) free openEO credits automatically on the first of every month to explore and start using the openEO API.
Users can check their current credit balance in the [openEO Algorithm Plaza](https://marketplace-portal.dataspace.copernicus.eu/billing){target="_blank"} under the 'Billing' tab.
*(¹)Boost of monthly openEO Credits to 10,000. [Read our news item](https://dataspace.copernicus.eu/news/2024-9-3-temporary-boost-monthly-openeo-credits-10000-granted-user) published on September 3, 2024.* ::: @@ -22,7 +22,7 @@ Other options for extra credits are discussed [here](https://marketplace-portal. **Every registered CDSE user by default has the Copernicus General user type. Users can check the typology of their account under the Account info in [Copernicus Data Space Ecosystem Dashboard](https://shapps.dataspace.copernicus.eu/dashboard/#/){target="_blank"} . -Higher quota (credits) is granted for [Collaborative Ground Segment](https://sentinels.copernicus.eu/web/sentinel/missions/collaborative){target="_blank"} users or Copernicus Service users based on their specific usage needs. They receive a total of 20000 credits per month that is replenished at the beginning of each month. +Higher quota (credits) is granted for [Collaborative Ground Segment](https://sentinels.copernicus.eu/web/sentinel/missions/collaborative){target="_blank"} users or Copernicus Service users based on their specific usage needs. They receive a total of 20,000 credits per month that is replenished at the beginning of each month. Copernicus General Account type users can request an upgrade to other user Account types by taking into account the user Account type definitions and eligibility criteria explained in [Which users are eligible for which account types (Quotas)?](https://documentation.dataspace.copernicus.eu/FAQ.html#which-users-are-eligible-for-which-account-types){target="_blank"}. @@ -52,7 +52,7 @@ Usage metrics are shown in the OpenEO Web Editor for an example batch job, with Summing this up, the total comes to 8.2 credits. With the current free tier offering 10,000 credits(¹), quite a few jobs like this can be run! However, it is important to note that resource consumption (CPU and memory in this case) is not fixed over time. Performance characteristics of a particular cloud can fluctuate depending on the overall load. Cloud providers try to avoid this, but generally, they only manage to do so within the limits of a given SLA. The conversion factor from resource usage to credits is subject to change, as it is determined by the backend. -*(¹)Boost of monthly openEO Credits to 10 000. [Read our news item](https://dataspace.copernicus.eu/news/2024-9-3-temporary-boost-monthly-openeo-credits-10000-granted-user) published on September 3, 2024.* +*(¹)Boost of monthly openEO Credits to 10,000. [Read our news item](https://dataspace.copernicus.eu/news/2024-9-3-temporary-boost-monthly-openeo-credits-10000-granted-user) published on September 3, 2024.* ## Estimating resource usage From eb7100e4ba31cbc14ca258295d0d3b2a9bf961c0 Mon Sep 17 00:00:00 2001 From: tho-hole Date: Fri, 6 Mar 2026 16:45:53 +0100 Subject: [PATCH 3/3] Update FAQ with refund form --- FAQ.qmd | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/FAQ.qmd b/FAQ.qmd index 1768873037..113661258d 100644 --- a/FAQ.qmd +++ b/FAQ.qmd @@ -601,7 +601,7 @@ function evaluatePixel(sample) { If you run out of openEO related quotas (e.g. openEO credits) within CDSE:
  • - Note that these quotas are monthly and will be replenished on the first day of every month. + Note that these quotas (i.e. free) are monthly and will be replenished on the first day of every month. Accordingly, if possible, we suggest waiting until the first day of the coming month.
  • @@ -649,7 +649,11 @@ function evaluatePixel(sample) {
- +
+ How can I request a refund for openEO credits? + +

If jobs fail due to an error on the provider side, the user can be refunded for the credits used by these jobs. A user can fill in a refund request form. The form requires the user to provide details about the job(s), such as the job ID and a timeframe of failed jobs. The request will be reviewed by the support team, and if approved, the credits used for that job and similar jobs in the same timeframe will be refunded to the user's account. This is possible for all types of credits except for the free tier credits, which are not refundable.

+
What are typical conversions between processing units and square kilometers?