Microsoft Foundry'deki modellere anında erişim (önizleme)

Modellere anında erişim, desteklenen tüm modelleri ada göre çağırmanıza olanak tanır; dağıtım gerekmez. Bir Dökümhane projesi oluşturun, kodlamaya başlayın ve kullanılabilir herhangi bir modeli hemen kullanın.

Prerequisites

• Azure aboneliği. Ücretsiz bir tane oluşturun.
• Microsoft Foundry'ye giriş yapın. Yeni Dökümhane seçeneğinin açık olduğundan emin olun. Bu adımlar Foundry (yeni) için geçerlidir.
• Batı ABD 3'teki bir Foundry projesi (önizleme sırasında anlık erişim için desteklenen tek bölge). Proje oluşturmanız gerekiyorsa bkz. Proje oluşturma.
• Projede veya hesapta Foundry User rolü.

Important

Foundry RBAC rolleri yakın zamanda yeniden adlandırıldı. Foundry User, Foundry Owner, Foundry Hesabı Sahibi ve Foundry Project Manager daha önce Azure Yapay Zeka Kullanıcısı, Azure Yapay Zeka Sahibi, Azure Yapay Zeka Hesabı Sahibi ve Azure Yapay Zeka Project Yöneticisi olarak adlandırıldı. Yeniden adlandırma kullanıma sunulmaya devam ederken bazı yerlerde önceki adları görmeye devam edebilirsiniz. Rol kimlikleri ve temel izinler yeniden adlandırma ile değiştirilmez.

Modelleri anında kullanmaya başlama

Anlık erişim sayesinde iş akışı basittir; kodunuzda desteklenen bir anlık model adı kullanın. Dağıtım gerekmez. Dağıtımlar için zaten kullandığınız API, SDK ve istemci, anlık erişim modelleriyle çalışır. İkinci SDK yok, ayrı istemci yok, yapılandırma değişikliği yok.

Anlık erişim desteği zaman içinde genişlemeye devam eder. Tam küme sık sık değişir. Tam listeyi görmenin yolları için bkz. Desteklenen modeller .

Python

model parametresi için, dağıtılmış model adı yerine "gpt-5-mini" gibi anlık erişim modeli adını kullanın.

import os

from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient

# Format: "https://resource_name.ai.azure.com/api/projects/project_name"
PROJECT_ENDPOINT = os.getenv("AZURE_AI_PROJECT_ENDPOINT", "your_project_endpoint")
MODEL_DEPLOYMENT = os.getenv("MODEL_DEPLOYMENT", "gpt-5-mini")

# Create project and openai clients to call Foundry API
project = AIProjectClient(
    endpoint=PROJECT_ENDPOINT,
    credential=DefaultAzureCredential(),
)
openai = project.get_openai_client()

# Run a responses API call
response = openai.responses.create(
    model=MODEL_DEPLOYMENT,
    input="What is the size of France in square miles?",
)
if not response.output_text or not response.output_text.strip():
    raise RuntimeError("Response output text was empty.")

print(f"Response output: {response.output_text}")

C#

model parametresi için, dağıtılmış model adı yerine "gpt-5-mini" gibi anlık erişim modeli adını kullanın.

using Azure.Identity;
using Azure.AI.Projects;
using Azure.AI.Extensions.OpenAI;
using OpenAI.Responses;

#pragma warning disable OPENAI001

// Format: "https://resource_name.ai.azure.com/api/projects/project_name"
var projectEndpoint = Environment.GetEnvironmentVariable("AZURE_AI_PROJECT_ENDPOINT") ?? "your_project_endpoint";
var modelDeployment = Environment.GetEnvironmentVariable("MODEL_DEPLOYMENT") ?? "gpt-5-mini";

// Create project client to call Foundry API
AIProjectClient projectClient = new(
    endpoint: new Uri(projectEndpoint),
    tokenProvider: new DefaultAzureCredential());

// Run a responses API call
ProjectResponsesClient responseClient = projectClient.ProjectOpenAIClient.GetProjectResponsesClientForModel(modelDeployment);
ResponseResult response = await responseClient.CreateResponseAsync(
    "What is the size of France in square miles?");
string outputText = response.GetOutputText();
if (string.IsNullOrWhiteSpace(outputText))
{
    throw new InvalidOperationException("Response output text was empty.");
}

Console.WriteLine(outputText);

TypeScript

model parametresi için, dağıtılmış model adı yerine "gpt-5-mini" gibi anlık erişim modeli adını kullanın.

import { DefaultAzureCredential } from "@azure/identity";
import { AIProjectClient } from "@azure/ai-projects";

// Format: "https://resource_name.ai.azure.com/api/projects/project_name"
const PROJECT_ENDPOINT = "your_project_endpoint";

async function main(): Promise<void> {
    // Create project and openai clients to call Foundry API
    const project = new AIProjectClient(PROJECT_ENDPOINT, new DefaultAzureCredential());
    const openai = project.getOpenAIClient();

    // Run a responses API call
    const response = await openai.responses.create({
        model: "gpt-5-mini",
        input: "What is the size of France in square miles?",
    });
    console.log(`Response output: ${response.output_text}`);
}

main().catch(console.error);

Java

model parametresi için, dağıtılmış model adı yerine "gpt-5-mini" gibi anlık erişim modeli adını kullanın.

package com.azure.ai.agents;

import com.azure.identity.DefaultAzureCredentialBuilder;
import com.openai.models.responses.Response;
import com.openai.models.responses.ResponseCreateParams;

public class CreateResponse {
    public static void main(String[] args) {
        // Format: "https://resource_name.ai.azure.com/api/projects/project_name"
        String ProjectEndpoint = "your_project_endpoint";

        // Create responses client to call Foundry API
        ResponsesClient responsesClient = new AgentsClientBuilder()
                .credential(new DefaultAzureCredentialBuilder().build())
                .endpoint(ProjectEndpoint)
                .buildResponsesClient();

        // Run a responses API call
        ResponseCreateParams responseRequest = new ResponseCreateParams.Builder()
                .input("What is the size of France in square miles?")
                .model("gpt-5-mini")
                .build();
        Response response = responsesClient.getResponseService().create(responseRequest);
        System.out.println(response.output());
    }
}

REST API

model parametresi için, dağıtılmış model adı yerine "gpt-5-mini" gibi anlık erişim modeli adını kullanın.

Ayrıca YOUR-FOUNDRY-RESOURCE-NAME ifadesini kendi değerlerinizle değiştirin:

curl -X POST https://YOUR-FOUNDRY-RESOURCE-NAME.services.ai.azure.com/api/projects/YOUR-PROJECT-NAME/openai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AZURE_AI_AUTH_TOKEN" \
-d '{
        "model": "gpt-5-mini",
        "input": "What is the size of France in square miles?"
}'

Dökümhane portalı

1. Projenizin Giriş sayfasında Oyun alanında test et'i seçin.
2. Dağıtıma alınmış ve anında erişilebilen modeller arasında geçiş yapmak için playground’daki Model açılır listesini kullanın.

Anlık erişim modelleri için oyun alanı

Anlık erişim modellerinin oyun bahçesine ulaşmak için şu yollardan birini kullanın:

1. Ev'denOyun alanında test et'i seçin.
2. Giriş sayfasındaModelleri keşfet'i seçerek model kataloğuna gidin. Veya, Keşfet>Modeller seçeneğini belirleyin. Her iki yol da kataloğu açar.
3. Model kataloğundan ayrıntılarını görüntülemek için bir anlık erişim modeli seçin.
4. Anlık erişim modeli ayrıntıları sayfasında Oyun alanı aç'ı seçin.
5. Bir playground'da, diğer anlık erişim veya dağıtılmış modellere geçmek için Model açılır listesini kullanın.

Anında erişim neden önemlidir?

• Tek bir dizeyi değiştirerek modelleri değiştirin ; dağıtım oluşturmadan veya silmeden satırdaki model= herhangi bir anlık model adını kullanın.
• Aynı API ve SDK — aynı çağrılar hem anlık erişim hem de dağıtımlar için çalışır.
• Geliştirme araçlarınızla çalışır ; anında erişim, dağıtımlarla aynı şekilde Foundry CLI, VS Code ve CI/CD işlem hatlarıyla tümleştirilir.

Dağıtım süreçleri ortadan kalkmıyor. Ayrılmış aktarım hızı, özel içerik filtreleri, veri yerleşimi veya gelişmiş kurumsal yapılandırmalara ihtiyacınız olduğunda bunlar doğru seçenek olmaya devam eder. Anında erişim, başlangıç deneyimini basitleştirir; böylece dağıtımlar, bir modeli kullanmadan önce aşmanız gereken bir engel değil, zamanla ilerleyerek geçtiğiniz bir aşama hâline gelir.

Desteklenen modeller

Yeni modeller yayımlandıklarında varsayılan olarak anında erişimi destekler. Ürün ekibi, müşteri talebine göre ek modeller için destek almayı göz önünde bulundurmaktadır. Liste zaman içinde büyür ve görebileceğiniz model örnekleri şunlardır:

• chat-gpt-latest
• gpt-5.6-sol
• gpt-5.5
• gpt-5-mini
• gpt-5.3-codex

Anlık erişimi destekleyen tüm modelleri görmek için:

1. Yeni Foundry deneyiminde Batı ABD 3'te bir proje açın,
2. Sağ üst köşede Keşfet'i, ardından sol panelde Modeller'i seçin.
3. Kullanılabilir anlık erişim modellerini görüntülemek için model kataloğunda Geliştirme seçenekleri'nin altında Anında'yı seçin.

Anlık erişim modellerini program aracılığıyla da listeleyebilirsiniz:

SUBSCRIPTION_ID="<your-subscription-id>"
LOCATION="westus3"

az rest --method get \
  --url "https://management.azure.com/subscriptions/$SUBSCRIPTION_ID/providers/Microsoft.CognitiveServices/locations/$LOCATION/models?api-version=2025-06-01" \
  --output json \
| jq -r '(.value // .models // .)[]
  | select((.model.capabilities.instant // "false" | tostring | ascii_downcase) == "true")
  | .model.name' \
| sort -u

Note

Önizleme sırasında, anlık erişim modelleri yalnızca Batı ABD 3'teki projelerde kullanılabilir.

Aboneliğinizin kotası olmasa bile bazı anlık erişim modelleri listede görünebilir. Daha fazla bilgi için Foundry Modelleri için kotalar ve sınırlar bölümüne bakın.

Anlık erişim ve dağıtımlar ne zaman kullanılır?

Scenario	Önerilen yaklaşım
Başlarken, prototip oluşturma veya deneme	Anında erişim
Yayından hemen sonra en son modeli kullanma	Anında erişim
Ayrılmış kapasite veya öngörülebilir aktarım hızı gerekiyor	Deployment
Sağlanan aktarım hızı (PTU) gerektirir	Deployment
Belirli bir bölgede veri yerleşimi gerekiyor	Deployment
Model başına özel içerik filtreleme ilkeleri	Deployment
Model başına özel korumalar	Deployment
Uç noktaya özgü yapılandırma (örneğin, uç nokta başına sürüm kilitleri)	Deployment
Ekipler arasında ayrıntılı kota bölümleme	Deployment
Hassas ayarlanmış modeller	Deployment

Anlık erişim ve dağıtımlar aynı projede birlikte bulunabilir. Hızlı erişim modeliyle başlayabilir ve gereksinimleriniz geliştikçe daha sonra bir dağıtım oluşturabilirsiniz.

Model sürümleri

Varsayılan olarak, anlık erişim modelin en son yeşil sürümünü kullanır. Belirli bir sürüme sabitlemek için sürüm tarihini model adının sonuna kısa çizgiyle ayrılmış bir sonek olarak ekleyin:

model olarak ilettiğiniz şey	Davranış
model-name	En son sürüme yönlendirir
model-name-2025-04-01	Belirli bir sürüme yönlendirir

Sürüm sabitleme isteğe bağlıdır. Uygulamanız kararlılık gerektiriyorsa sürüm son ekini ekleyin. Aksi takdirde, her zaman en son sürümü otomatik olarak alırsınız.

Kota nasıl tüketilir?

Anlık erişim, aboneliğinize atanan model başına genel kota havuzundan gelir. Bu kota, standart dağıtımlar tarafından kullanılan bölgesel kotadan ayrıdır.

• Genel kota ayırmaz veya bölümlemezsiniz; aboneliğinizdeki tüm anlık model kullanımı arasında otomatik olarak paylaştırılabilir.
• Global Standard dağıtımları, genel kotanızın bir kısmını ayırtır. Anlık erişim modelleri kalan kapasiteyi kullanır.
• Diğer dağıtım türleri (Bölgesel Standart, Sağlanan) ayrı bölgesel kota kullanır ve anlık model kapasitenizi etkilemez.
• Anlık model istekleri hız sınırlamasına tabi tutulursa kota artışı talebinde bulunabilir veya ayrılmış kapasiteye sahip bir dağıtım oluşturabilirsiniz.

Genel ve bölgesel kotaların nasıl etkileşimde olduğu hakkında daha fazla bilgi için bkz. Kotaları yönetme ve artırma.

Kurumsal denetimler

Kapasite	Nasıl çalışır?
Belirli modelleri veya sağlayıcıları engelleme	Azure İlkesi tanımları, dağıtımlara uygulandıkları şekilde anında erişim için de geçerlidir
Model sürümüne sabitle	Sürüm son ekini model adına ekleyin (bkz . Model sürümleri)
Anlık erişimi tamamen devre dışı bırakma	Yöneticiler, Azure İlkesi aracılığıyla abonelik düzeyinde anlık erişimi kapatabilir

Hesaptan anlık erişimi kaldırmak için ayarları Bicep veya ARM REST aracılığıyla yapılandırın.

REST API

Hesabınızı şu şekilde güncelleştirin:

PATCH https://management.azure.com/subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.CognitiveServices/accounts/{account}?api-version=2026-01-15-preview
Authorization: Bearer {arm_token}
Content-Type: application/json

Anlık model erişimini etkin bir şekilde kapatmak için bu istek gövdesini kullanın:

{
  "properties": {
    "instant": {
      "raiPolicyName": "Microsoft.DefaultV2",
      "modelAllowList": []
    }
  }
}

Bicep

Mevcut hesap kaynağınızı bir instant blokla güncelleştirin:

resource account 'Microsoft.CognitiveServices/accounts@2026-01-15-preview' = {
  name: accountName
  location: location
  kind: 'AIServices'
  sku: {
    name: 'S0'
  }
  // Keep your existing account properties and add instant settings.
  properties: {
    instant: {
      raiPolicyName: 'Microsoft.DefaultV2'
      modelAllowList: []
    }
  }
}

Important

Tüm anlık erişim modelleri varsayılan korumaları ve içerik filtrelerini kullanır. Ancak, anlık erişim için model başına özel korumalar veya Sorumlu AI (RAI) ilkeleri yapılandıramazsınız. API aracılığıyla hesap düzeyinde bir varsayılan RAI ilkesi ayarlayabilirsiniz, ancak bu ilke tüm anlık erişim modellerine aynı şekilde uygulanır. Tek tek modeller için farklı içerik filtreleme ilkelerine ihtiyacınız varsa bir dağıtım kullanın.

Dağıtım adı çakışmaları

Yeni dağıtımlar mevcut model adıyla eşleşen bir ad kullanamaz. Adı bir model adıyla çakışan mevcut bir dağıtımınız varsa, dağıtıma öncelik verilir ve bu proje içinde o model adı için anlık model erişimi kullanılamaz.

Önizleme sırasındaki sınırlamalar

• Yalnızca Batı ABD 3'te kullanılabilir.
• hassas ayarlı modeller desteklenmez. Hassas ayarlı bir model kullanmak için bir dağıtım oluşturun.
• Korumalar, özel RAI ilkeleri ve içerik filtreleri anlık erişim için yapılandırılamaz.
• Yalnızca Desteklenen modeller bölümünde listelenen modeller uygundur.

İlgili içerik

• Microsoft Foundry Modelleri için dağıtıma genel bakış
• Microsoft Foundry Modelleri için dağıtım türleri
• Dökümhane kaynakları için kotaları yönetme
• Microsoft Foundry başlangıç kılavuzu