Azure OpenAI on startup credits: deployment names, regions, and .env hygiene

A final-year student applied to Microsoft for Startups with a major project and received $1,000 in Azure credits. Without a registered business the higher tiers were unavailable, but the credits were enough to learn and run RAG agents without personal spend. Free compute also made Azure OpenAI feel approachable instead of “enterprise-only.”

If an organization already runs on Azure, Azure OpenAI is often the obvious path—not the complicated detour.

What follows is a practical setup guide, including the naming mistake that commonly burns an afternoon.

Why Azure OpenAI, not only public OpenAI APIs?

Same GPT-class models, different operating model:

• Compliance posture — runs inside the Azure tenant under existing certifications (SOC 2, HIPAA, and similar)
• Native fit — Azure AD, Key Vault, App Service connect without awkward bridges
• Unified cost tracking — spend lives with other Azure bills
• Credits for students/startups — genuine room to experiment

For Azure-centric employers, this is the natural path.

Setting it up

Prerequisites: Azure subscription, Azure OpenAI access (approval is not instant), Python 3.8+, VS Code or similar.

1. Create the resource. Portal → “Azure OpenAI” → Create. Pick subscription, resource group, and region.

Check model availability by region first. Not every model ships everywhere; discovering that after deploy wastes time.

Pricing: Standard S0 (credits cover pay-as-you-go).

2. Deploy a model in Azure AI Foundry. Deployments → Create → pick a base model (for example gpt-4o) → choose a deployment name.

Model name and deployment name differ. The model name selects the base model; the deployment name is the custom label your code must call. Passing gpt-4o where the client expects the deployment label yields confusing 404s.

3. Keys and endpoint. Resource → Keys and Endpoint. Store them in .env, never in source:

AZURE_OPENAI_API_KEY=your-key-here
AZURE_OPENAI_ENDPOINT=https://your-resource-name.openai.azure.com/
AZURE_OPENAI_DEPLOYMENT_NAME=your-deployment-name-here
AZURE_OPENAI_API_VERSION=2024-10-21

Add .env to .gitignore immediately.

4. Install SDKs

pip install openai python-dotenv azure-identity

5. Basic chat completion

import os
from dotenv import load_dotenv
from openai import AzureOpenAI

load_dotenv()client = AzureOpenAI(
    api_key=os.getenv("AZURE_OPENAI_API_KEY"),
    azure_endpoint=os.getenv("AZURE_OPENAI_ENDPOINT"),
    api_version=os.getenv("AZURE_OPENAI_API_VERSION"),
)response = client.chat.completions.create(
    model=os.getenv("AZURE_OPENAI_DEPLOYMENT_NAME"),  # deployment name, not model name
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Explain RAG agents in simple terms."},
    ],
)print(response.choices[0].message.content)

6. Natural next steps. Streaming, function calling, Azure AI Search “bring your own data,” and App Service hosting once the hello-world path is green.

A few things to watch for

• Region mismatches — confirm model availability before creating the resource
• Model vs deployment name — code needs the deployment name
• Hardcoded secrets — .env only; never commit
• API version drift — pin and revisit when SDKs update
• Credit burn — watch token usage while iterating on RAG loops; embeddings plus chat adds up even on “free” credits
• Access approval lag — request Azure OpenAI early in a project timeline

With credits and a correct deployment name, Azure OpenAI stops feeling like a locked enterprise vault and becomes a practical lab for RAG experiments that mirror how many companies already ship.

Treat the first successful completion call as a checkpoint, then immediately exercise a tiny RAG loop: upload one PDF to blob or Search, retrieve three chunks, and require the answer to quote them. That sequence surfaces region, naming, and permission issues faster than polishing a chatbot UI. Keep a spending alert on the resource group so exploratory embedding sweeps cannot silently exhaust the credit balance overnight.