Skip to main content
Deepgram's Docs

Search documentation

Type to search this documentation.

On this pageOverview

Subscribe on AWS Marketplace

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

Section titled “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

Section titled “Subscribe through the AWS Marketplace console”

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

  2. Navigate to the AWS Marketplace console, pre-filtered for Deepgram SageMaker Model products

  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

Section titled “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.

Additional permissions

Section titled “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:

    Bash
    JSON
    [
  {
    "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

    Bash

    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

    Bash

    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

    Bash

    The response has an offerTerms array. Each entry is a one-key object whose key names the term kind — legalTerm, supportTerm, usageBasedPricingTerm, freeTrialPricingTerm — and whose inner object carries the term’s id and type:

    JSON
    {
  "offerTerms": [
    {"legalTerm": {"id": "...", "type": "LegalTerm", "documents": [...]}},
    {"supportTerm": {"id": "...", "type": "SupportTerm", "refundPolicy": "..."}},
    {"usageBasedPricingTerm": {"id": "...", "type": "UsageBasedPricingTerm", "rateCards": [...]}},
    {"freeTrialPricingTerm": {"id": "...", "type": "FreeTrialPricingTerm", "duration": "P14D"}}
  ]
}

    For a USAGE-priced Deepgram SageMaker product, expect LegalTerm, SupportTerm, and UsageBasedPricingTerm — collect all three id values (for example, aws marketplace-discovery get-offer-terms ... --query 'offerTerms[].*.id'). 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

    Bash

    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.

  6. Accept the quote to subscribe

    Bash

    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

    Bash

    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

Section titled “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

Programmatic alternative

Section titled “Programmatic alternative”

The deepgram-devs/dg-sagemaker repository includes a script that resolves the Model Package ARN for a product, version, and Region from the command line. It requires uv and AWS credentials for the subscribed account:

Bash

The script prints the ARN together with the version’s SupportedRealtimeInferenceInstanceTypes, so you can confirm your planned instance types before deploying. Pass --list-versions to see the available versions of a product first.

Private offers

Section titled “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

Section titled “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

Section titled “Next steps”
Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu