Skip to main content

Documentation Index

Fetch the complete documentation index at: https://notes.kodekloud.com/llms.txt

Use this file to discover all available pages before exploring further.

This guide shows how to provision and configure Azure AI Services, choose the appropriate resource type, and connect from applications using REST APIs or language SDKs. It covers portal setup, deployment considerations, authentication, and sample requests so you can get a tested endpoint, keys, and region for development or production.

​
Create an Azure AI resource

To get started, create an Azure AI resource in the Azure portal. Required information includes:
  • Subscription and resource group
  • Deployment region — pick a region close to your users to reduce latency and meet data residency requirements
  • Instance name
  • Pricing tier — some capabilities may offer a free tier for experimentation; otherwise select a plan matching your expected usage
After entering the required fields, click Review + Create to provision the resource.
A presentation slide titled "Setting Up Azure AI Services" showing a screenshot of the Azure portal "Create Azure AI services" form with fields for subscription, resource group, region, name, and pricing tier. The slide has a dark blue background and a small "© Copyright KodeKloud" note in the bottom left.
Tip: Use a descriptive name and consistent tagging for resources to simplify billing, monitoring, and automation. Free tiers are ideal for testing but verify quotas and limits before using in production.

​
Multi-service vs Single-service resources

When creating a resource you can choose between:
  • Multi-service resource: exposes multiple AI capabilities (Language, Vision, Speech, etc.) through a single endpoint and shared keys — simplifies management and billing.
  • Single-service resource: scoped to one capability (for example, a Language-only or Vision-only resource) with its own endpoint and keys — useful for isolation, fine-grained permissions, or separate team ownership.
Use the table below to decide which fits your scenario.
Resource TypeWhen to useBenefits
Multi-serviceSmall teams or consolidated billing; want a single endpoint for multiple AI capabilitiesFewer endpoints/keys, simplified management
Single-serviceSeparate teams, strict access control, or different regions/tiers per capabilityIsolation, granular permissions, independent lifecycle
A presentation slide titled "Setting Up Azure AI Services" that compares resource types. It contrasts a "Multi-service Resource" (single key/endpoint for multiple AI services) with a "Single-service Resource" (one unique key and endpoint per service), with a central "Resource Type" circle.
Choose single-service resources when you need strict separation (for example, the Vision team should not access Speech). Choose multi-service to simplify management and reduce the number of endpoints and keys.

​
Deployment considerations

Plan these factors before provisioning to avoid rework:
  • Subscription & region — compliance, data residency, and latency constraints
  • Pricing & tiers — costs, quotas, and available features differ by tier
  • Security & access — use Azure RBAC, key rotation, and managed identities where possible
A presentation slide titled "Setting Up Azure AI Services." It shows three deployment-consideration cards: "Subscription and Region," "Pricing and Tiers," and "Security and Access," each with a short explanatory note.

​
Endpoints, keys, and locations

After deployment you will obtain:
  • Endpoint — base URL your application calls
  • Keys — typically two API keys for key rotation; either key can be used
  • Location — region hosting the resource (for example, eastus). Some SDKs and REST endpoints require the region value
Example values (format): 
https://ai102-cog.cognitiveservices.azure.com/
eastus
ArtifactDescription
EndpointBase URL for REST and SDK calls
KeysAPI keys for authentication (rotate regularly)
LocationAzure region of the resource; used for some requests or routing
Best practice: rotate keys regularly and prefer Microsoft Entra ID (OAuth bearer tokens) where supported for stronger identity-based authentication. See Microsoft Entra ID docs: https://learn.microsoft.com/en-us/azure/active-directory/

​
Accessing Azure AI Services via REST APIs

REST endpoints provide platform-independent access to Azure AI capabilities. Typical request flow:
  1. Client sends an HTTP request to the service endpoint.
  2. Request contains authentication (API key header or Microsoft Entra ID bearer token).
  3. Request body is JSON following the service schema.
  4. Service returns a structured JSON response with analysis results.
Authentication options:
MethodHeader exampleWhen to use
API keyapi-key: <your-api-key>Simple setup, suitable for server-to-server calls or quick testing
Microsoft Entra ID (OAuth)Authorization: Bearer <access_token>Preferred for production deployments; supports RBAC and managed identities
Example curl request (replace placeholders): 
curl -X POST "https://<your-endpoint>/language/analyze?api-version=2024-01-31" \
  -H "Content-Type: application/json" \
  -H "api-key: <your-api-key>" \
  -d '{
    "kind": "SentimentAnalysis",
    "analysisInput": {
      "documents": [
        { "id": "1", "language": "en", "text": "I love the new product!" }
      ]
    },
    "parameters": {}
  }'
Example JSON response structure: 
{
  "results": {
    "documents": [
      {
        "id": "1",
        "sentiment": "positive",
        "confidenceScores": {
          "positive": 0.99,
          "neutral": 0.01,
          "negative": 0.0
        }
      }
    ],
    "errors": []
  }
}
REST usage benefits:
  • Full control over HTTP behavior and payloads
  • Platform/language agnostic
  • Useful for environments without official SDK support

​
Using SDKs

Official SDKs reduce boilerplate and provide language-native interfaces, automatic retries, and credential handling. SDKs are available for .NET, Python, Node.js, and Java. Benefits of SDKs:
  • Simplified authentication and request construction
  • Native response objects and error types
  • Built-in retry logic and telemetry integration
Example Python (Text Analytics) using the azure-ai-textanalytics SDK: 
from azure.ai.textanalytics import TextAnalyticsClient
from azure.core.credentials import AzureKeyCredential

endpoint = "https://<your-endpoint>/"
key = "<your-api-key>"

client = TextAnalyticsClient(endpoint=endpoint, credential=AzureKeyCredential(key))

documents = ["I had a wonderful day!"]
response = client.analyze_sentiment(documents)

for doc in response:
    print(f"Document sentiment: {doc.sentiment}")
    print(f"Confidence scores: {doc.confidence_scores}")
SDKs are wrappers around REST APIs and are recommended for most development scenarios unless you need direct control of raw HTTP requests.

​
Summary and next steps

You now know how to:
  • Provision an Azure AI resource in the portal
  • Choose between multi-service and single-service resources
  • Plan deployment with region, pricing, and security in mind
  • Retrieve endpoint, keys, and location values
  • Call services via REST or use language SDKs for faster integration
Next step: Provision an AI resource in your Azure subscription, record the endpoint, keys, and region, and run the curl or SDK examples above from a development environment.

Watch Video