Subscribe on AWS Marketplace

Subscribe to a Deepgram SageMaker product through the AWS Marketplace console or API, find the Model Package ARN, and manage private offers.

Before you can deploy Deepgram on Amazon SageMaker AI, you must subscribe to the product in the AWS Marketplace. Subscribing creates a billing agreement but does not start any charges — you are not billed for the product until you deploy an Amazon SageMaker AI Endpoint resource.

Subscribe through the console or the Marketplace API, then note the Model Package ARN you will pass to Deploy Deepgram on Amazon SageMaker or Deploy with Terraform.

Prerequisites

  • An AWS account
  • AWS IAM permissions to SageMaker and Marketplace
  • The Deepgram product you want to deploy. See Supported Products.

Subscribe through the AWS Marketplace console

1

Login to the AWS Management Console for the account you’d like to deploy in

3

Click on the Deepgram product you’re interested in deploying (eg. Deepgram Voice AI- Nova-3 Monolingual Speech-to-Text (STT) Streaming)

4

Click on the View Purchase Options button

5

Ensure the Offer Type of Public Offer is selected (if required)

6

Scroll down and click the Subscribe button

Once the subscription is active, continue to Find the Model Package ARN.

Subscribe through the Marketplace API

If you provision infrastructure as code, you can subscribe to a Deepgram SageMaker product entirely through the AWS Marketplace API instead of the console. This section is an alternative to subscribing through the console — use whichever method fits your workflow, then continue to Find the Model Package ARN.

The steps below use the AWS CLI, but AWS also publishes SDKs for many languages — including Python (Boto3), Node.js, Java, Go, and .NET — that expose the same Marketplace Discovery and Agreement Service APIs. Use whichever SDK fits your stack to build your own subscription automations and scripts.

Subscribing creates a billing agreement on your AWS account. You are not charged until you deploy a SageMaker Endpoint and send it traffic — the usage-based pricing term has no upfront cost — but AcceptAgreementRequest (the last step below) is not a dry run. It creates a real, active agreement.

Additional permissions

The AWSMarketplaceManageSubscriptions policy referenced in Prerequisites covers product discovery (SearchListings, GetOffer, GetOfferTerms, ListPurchaseOptions, and similar) but does not include the AWS Marketplace Agreement Service actions this flow also needs: CreateAgreementRequest, AcceptAgreementRequest, DescribeAgreement, SearchAgreements, and GetAgreementTerms. Either attach AWSMarketplaceFullAccess or add those five actions to a custom policy alongside AWSMarketplaceManageSubscriptions.

1

Find the product ID

List Deepgram’s SageMaker-deployable products, filtered by fulfillment type and seller:

aws marketplace-discovery search-listings \
--region us-east-1 \
--filters '[
{"filterType": "FULFILLMENT_OPTION_TYPE", "filterValues": ["SAGEMAKER_MODEL"]},
{"filterType": "PUBLISHER", "filterValues": ["6efa21f9-9a33-4cae-ba44-756436fa71dd"]}
]' \
--query 'listingSummaries[].{name:listingName,productId:associatedEntities[0].product.productId}'
[
{
"name": "Deepgram Voice AI Nova-3 Monolingual Speech-to-Text (STT) Streaming",
"productId": "prod-tnv5pm6nlcm44"
},
{
"name": "Deepgram Voice AI- Aura-2 Text-to-Speech- English",
"productId": "prod-..."
}
]

6efa21f9-9a33-4cae-ba44-756436fa71dd is Deepgram’s AWS Marketplace seller profile ID. Note the productId for the listing you want to deploy (eg. prod-tnv5pm6nlcm44 for Nova-3 Monolingual Streaming).

Calls the SearchListings action of the AWS Marketplace Discovery API.

2

Find the standard offer for that product

aws marketplace-discovery list-purchase-options \
--region us-east-1 \
--filters '[{"filterType": "PRODUCT_ID", "filterValues": ["prod-tnv5pm6nlcm44"]}]' \
--query 'purchaseOptions[].{offerId:purchaseOptionId,name:purchaseOptionName,badges:badges}'

This can return more than one purchase option — for example, a private offer your account manager extended to you, alongside the standard public offer. The standard public offer has no PRIVATE_PRICING badge and no custom purchaseOptionName (AWS labels it "Offer created on <timestamp>"). Use a private offer’s ID instead if your account has negotiated pricing.

Calls the ListPurchaseOptions action of the AWS Marketplace Discovery API.

3

Get the offer's proposal ID and pricing model

aws marketplace-discovery get-offer --region us-east-1 --offer-id <offer-id-from-previous-step>

Note the agreementProposalId and pricingModel.pricingModelType from the response — you need both for the next steps.

Calls the GetOffer action of the AWS Marketplace Discovery API.

4

Get the offer's terms

aws marketplace-discovery get-offer-terms --region us-east-1 --offer-id <offer-id>

The response lists one or more terms, each with an id. For a USAGE-priced Deepgram SageMaker product, expect LegalTerm, SupportTerm, and UsageBasedPricingTerm — collect all three id values. Deepgram’s public SageMaker listings also include a FreeTrialPricingTerm (14 days); collect its id too if you want to claim the trial. See Required terms by pricing model if the offer uses a different pricing model.

Calls the GetOfferTerms action of the AWS Marketplace Discovery API.

5

Generate a quote

aws marketplace-agreement create-agreement-request \
--region us-east-1 \
--agreement-proposal-identifier <agreementProposalId-from-step-3> \
--intent NEW \
--requested-terms '[
{"id": "<LegalTerm id>"},
{"id": "<SupportTerm id>"},
{"id": "<UsageBasedPricingTerm id>"},
{"id": "<FreeTrialPricingTerm id>"}
]'

Returns an agreementRequestId and a chargeSummary. For usage-based pricing, newAgreementValue is "0.00" — you’re only quoted for the mandatory terms, not future usage.

Calls the CreateAgreementRequest action of the AWS Marketplace Agreement Service API.

FreeTrialPricingTerm can be accepted only once per product. If your account has already used the trial for this product, omit that term’s id from requestedTerms — including it again returns a ValidationException. If your account already has an active agreement for this product at all, the whole call fails with ValidationException / UNSUPPORTED_ACTION (“This action is not supported when an active agreement exists on the same resourceId”). Check first with the SearchAgreements action: aws marketplace-agreement search-agreements --region us-east-1 --catalog AWSMarketplace --filters '[{"name":"PartyType","values":["Acceptor"]},{"name":"AgreementType","values":["PurchaseAgreement"]},{"name":"ResourceIdentifier","values":["<productId>"]}]' — if an agreement with "status": "ACTIVE" already exists, you’re already subscribed; skip to Find the Model Package ARN.

6

Accept the quote to subscribe

aws marketplace-agreement accept-agreement-request \
--region us-east-1 \
--agreement-request-id <agreementRequestId-from-previous-step>

Returns the new agreementId. This is the subscribe action — it’s equivalent to clicking Subscribe in the console.

Calls the AcceptAgreementRequest action of the AWS Marketplace Agreement Service API.

7

Confirm the subscription is active

aws marketplace-agreement describe-agreement --region us-east-1 --agreement-id <agreementId>

status moves from ACTIVE immediately, but the underlying entitlement can take a few minutes to provision — the same delay you’d see waiting on the console’s subscription page. Poll aws marketplace-agreement get-agreement-entitlements --region us-east-1 --agreement-id <agreementId> until it clears PENDING/PROVISIONING_IN_PROGRESS before continuing to Find the Model Package ARN.

Calls the DescribeAgreement and GetAgreementEntitlements actions of the AWS Marketplace Agreement Service API.

Find the Model Package ARN

The AWS CLI, Boto3, and Terraform deployment paths all reference the Model Package ARN for the product version and AWS Region you plan to deploy. The AWS Marketplace surfaces the ARN through the CLI configuration view.

1

In the AWS Management Console, navigate to the AWS Marketplace Manage subscriptions console

2

On the Active subscriptions tab, find the subscription for the Deepgram product you want to deploy (eg. Deepgram Voice AI- Nova-3 Monolingual Speech-to-Text (STT) Streaming)

3

Click the Configure button in the Actions column on the right-hand side

4

In the Setup box, under Service, choose AWS command line interface (CLI)

5

Under the Version header, select the product version from the dropdown. If the listing has more than one version, read the version name and the release notes to understand the set of languages (or features) each version provides, and choose the version that matches your needs

6

Scroll down. On the right-hand side of the page, a list of Model ARNs is shown. Note the correct Model Package ARN for the AWS Region you plan to deploy to

Private offers

If you have received a SageMaker private offer for a management account of an AWS organization, you may use AWS License Manager to grant usage of the SageMaker private offer to member accounts within your AWS organization as a Marketplace license entitlement after accepting the offer in the payer account. If you choose not to centrally manage license entitlements with AWS License Manager, you will need to accept the private offer in each linked account individually after you have accepted the offer in the payer account to be able to launch a SageMaker Endpoint with private pricing in the linked account.

For pricing and how to request a private offer, see Private offers on the overview page.

Switch offers

Only one offer (public or private) can be subscribed to for each SageMaker product listing at any one time. If you already have a subscription for a listing and try to subscribe to a different offer for it (for example, subscribing to a new private offer when you previously subscribed to the public offer), the Accept offer button is greyed out and an Existing subscription detected warning (“You already have a subscription for this product.”) may appear at the top of the page. To switch offers, cancel the existing subscription first:

1

In the warning message, click View Subscription to open the Manage subscriptions page of the AWS Marketplace console.

2

Find the product you’re already subscribed to in the table. Click the hyperlinked agreement ID shown next to the product name.

3

Click the Actions dropdown, then click Cancel subscription and confirm the cancellation.

4

Once the subscription is cancelled, subscribe to the new offer.

Next steps