Okamžitý přístup k modelům v Microsoft Foundry (Preview)

Okamžitý přístup k modelům umožňuje volat libovolný podporovaný model podle názvu – nevyžaduje se žádné nasazení. Vytvořte projekt Foundry, začněte psát kód a okamžitě používat jakýkoli dostupný model.

Předpoklady

• Předplatné služby Azure. Vytvořte si ho zdarma.
• Přihlaste se k Microsoft Foundry. Ujistěte se, že je zapnutý přepínač New Foundry . Tyto kroky se týkají nové verze aplikace Foundry.
• Projekt Foundry v West US 3 (jediná podporovaná oblast pro okamžitý přístup ve verzi Preview). Pokud potřebujete vytvořit projekt, přečtěte si téma Vytvoření projektu.
• Role uživatele Foundry v projektu nebo účtu.

Important

Nedávno byly přejmenovány role Foundry RBAC. Foundry User, Foundry Owner, Foundry Account Owner a Foundry Project Manager se dříve nazývaly Uživatel Azure AI, Vlastník Azure AI, Vlastník účtu Azure AI a Správce projektů Azure AI. Během zavádění přejmenování se stále můžou zobrazovat předchozí názvy na některých místech. ID rolí a základní oprávnění se při přejmenování nezmění.

Okamžité použití modelů

S okamžitým přístupem je pracovní postup jednoduchý – v kódu použijte podporovaný název okamžitého modelu. Není potřeba žádné nasazení. Stejné rozhraní API, sada SDK a klient, které už používáte pro nasazení, funguje s modely okamžitého přístupu. Žádná druhá sada SDK, žádné samostatného klienta, žádné změny konfigurace.

Podpora okamžitého přístupu se v průběhu času stále rozšiřuje. Přesná sada se často mění. Pokud chcete zobrazit úplný seznam, podívejte se na podporované modely .

Python

model Jako parametr použijte název modelu okamžitého přístupu, například "gpt-5-mini"místo názvu nasazeného modelu.

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

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

# 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="gpt-5-mini",
    input="What is the size of France in square miles?",
)
print(f"Response output: {response.output_text}")

C#

model Jako parametr použijte název modelu okamžitého přístupu, například "gpt-5-mini"místo názvu nasazeného modelu.

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 = "your_project_endpoint";

// 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("gpt-5-mini"); 
ResponseResult response = await responseClient.CreateResponseAsync(
    "What is the size of France in square miles?");
Console.WriteLine(response.GetOutputText());

TypeScript

model Jako parametr použijte název modelu okamžitého přístupu, například "gpt-5-mini"místo názvu nasazeného modelu.

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 Jako parametr použijte název modelu okamžitého přístupu, například "gpt-5-mini"místo názvu nasazeného modelu.

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 Jako parametr použijte název modelu okamžitého přístupu, například "gpt-5-mini"místo názvu nasazeného modelu.

Nahraďte YOUR-FOUNDRY-RESOURCE-NAME také svými hodnotami:

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.1-mini",
        "input": "What is the size of France in square miles?"
}'

Portál Foundry

1. Na domovské stránce projektu vyberte Test v dětském hřišti.
2. Pomocí rozevíracího seznamu Model v dětském hřišti můžete přepínat mezi nasazenými a okamžitými modely přístupu.

Testovací prostředí pro modely s okamžitým přístupem

K dosažení dětského hřiště pro modely okamžitého přístupu použijte jednu z těchto cest:

1. Na domovské stránce vyberte Test v dětském hřišti.
2. Na domovské stránce vyberte Prozkoumat modely a přejděte do katalogu modelů. Nebo vyberte Objevit>Modely. Obě cesty otevřou katalog.
3. V katalogu modelů vyberte model okamžitého přístupu a zobrazte jeho podrobnosti.
4. Na stránce s podrobnostmi o modelu okamžitého přístupu vyberte Otevřít dětské hřiště.
5. V Playgroundu použijte rozbalovací nabídku Model a přepněte se na jiné modely s okamžitým přístupem nebo na nasazené modely.

Proč je důležitý okamžitý přístup

• Přepínejte mezi modely změnou jediného řetězce — v řádku model= použijte název libovolného instantního modelu, aniž byste vytvářeli nebo odstraňovali nasazení.
• Stejné rozhraní API a sada SDK – stejná volání fungují pro okamžitý přístup i nasazení.
• Funguje s vašimi vývojářskými nástroji — okamžitý přístup se integruje s Foundry CLI, VS Code a CI/CD pipeline stejným způsobem jako nasazení.

Nasazení nikam nemizí. Zůstávají správnou volbou, pokud potřebujete vyhrazenou propustnost, vlastní filtry obsahu, rezidenci dat nebo pokročilé podnikové konfigurace. Okamžitý přístup zjednodušuje začátky práce s modelem, takže nasazení se stává něčím, k čemu se postupně propracujete, nikoli překážkou, kterou musíte překonat, než budete moct model použít.

Podporované modely

Nové modely ve výchozím nastavení podporují okamžitý přístup při jejich vydání. Produktový tým zvažuje podporu dalších modelů podle poptávky zákazníků. Seznam postupně roste a mezi příklady modelů, které se můžou zobrazit, patří:

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

Zobrazení všech modelů, které podporují okamžitý přístup:

1. Otevřete projekt v West US 3 v novém rozhraní Foundry,
2. V pravém horním navigačním panelu vyberte Zjistit a pak modely v levém podokně.
3. V katalogu modelů vyberte možnost Okamžité v části Možnosti vývoje a zobrazte dostupné modely okamžitého přístupu.

Modely okamžitého přístupu můžete vypsat také programově:

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

Ve verzi Preview jsou modely okamžitého přístupu k dispozici pouze v projektech v oblasti USA – západ 3 .

Některé modely okamžitého přístupu se můžou zobrazit v seznamu, i když pro ně vaše předplatné nemá kvótu. Další informace najdete v tématu Kvóty a omezení pro modely Foundry.

Kdy použít okamžitý přístup vs. nasazení

Scenario	Doporučený přístup
Začátky, prototypování nebo experimentování	Okamžitý přístup
Okamžité použití nejnovějšího modelu po vydání	Okamžitý přístup
Potřebujete rezervovanou kapacitu nebo předvídatelnou propustnost.	Deployment
Vyžadovat zřízenou propustnost (PTU)	Deployment
Potřebujete rezidenci dat v konkrétní oblasti.	Deployment
Vlastní zásady filtrování obsahu pro každý model	Deployment
Vlastní omezení pro každý model	Deployment
Konfigurace specifická pro jednotlivé koncové body (například uzamčení verzí pro každý koncový bod)	Deployment
Podrobné rozdělení kvót mezi týmy	Deployment
Jemně vyladěné modely	Deployment

Okamžitý přístup a nasazení můžou existovat ve stejném projektu. Jakmile se vaše požadavky vyvíjejí, můžete začít s modelem okamžitého přístupu a vytvořit nasazení později.

Verze modelů

Ve výchozím nastavení okamžitý přístup používá nejnovější průběžně aktualizovanou verzi modelu. Pokud chcete připnout ke konkrétní verzi, připojte datum verze k názvu modelu jako příponu spojovníku:

Co předáte jako model	Chování
model-name	Postupy přechodu k nejnovější verzi
model-name-2025-04-01	Trasy do této konkrétní verze

Připnutí verze je volitelné. Pokud vaše aplikace vyžaduje stabilitu, uveďte příponu verze. V opačném případě vždy získáte nejnovější verzi automaticky.

Jak se kvóta spotřebovává

Okamžitý přístup vychází z globálního fondu kvót podle modelu přiřazeného k vašemu předplatnému. Tato kvóta je oddělená od místní kvóty používané standardními nasazeními.

• Globální kvótu nepřidělujete ani nerozdělujete — sdílí se automaticky napříč veškerým využitím okamžitých modelů v rámci vašeho předplatného.
• Nasazení Global Standard rezervují část vaší globální kvóty. Modely okamžitého přístupu využívají libovolnou kapacitu.
• Jiné typy nasazení (Regional Standard, Provisioned) používají samostatnou regionální kvótu a nemají vliv na vaši okamžitou kapacitu modelu.
• Pokud jsou omezené požadavky na okamžitý model, můžete požádat o navýšení kvóty nebo vytvořit nasazení s rezervovanou kapacitou.

Další podrobnosti o interakci globálních a regionálních kvót najdete v tématu Správa a zvýšení kvót.

Podnikové ovládací prvky

Schopnost	Jak to funguje
Blokování konkrétních modelů nebo poskytovatelů	Definice Azure Policy se vztahují na okamžitý přístup stejně jako na nasazení.
Připnout k verzi modelu	Připojte k názvu modelu příponu verze (viz verze modelu)
Úplné zakázání okamžitého přístupu	Správci můžou prostřednictvím Azure Policy vypnout okamžitý přístup na úrovni předplatného.

Pokud chcete z účtu odebrat okamžitý přístup, nakonfigurujte nastavení prostřednictvím Bicep nebo REST ARM.

REST API

Aktualizujte svůj účet pomocí:

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

Pomocí tohoto textu požadavku efektivně vypněte okamžitý přístup k modelu:

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

Bicep

Aktualizujte prostředek existujícího účtu pomocí bloku instant:

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

Všechny modely okamžitého přístupu používají výchozí mantinely a filtry obsahu. Pro okamžitý přístup ale nemůžete nakonfigurovat vlastní mantinely ani zásady zodpovědné umělé inteligence (RAI) pro jednotlivé modely. Výchozí zásadu RAI můžete nastavit na úrovni účtu prostřednictvím rozhraní API, ale tato zásada platí jednotně pro všechny modely okamžitého přístupu. Pokud potřebujete jiné zásady filtrování obsahu pro jednotlivé modely, použijte nasazení.

Kolize názvů nasazení

Nová nasazení nemůžou použít název, který odpovídá existujícímu názvu modelu. Pokud máte existující nasazení, jehož název se shoduje s názvem modelu, má toto nasazení přednost a okamžitý přístup k modelu pod tímto názvem není v tomto projektu k dispozici.

Omezení ve verzi Preview

• K dispozici pouze v Západní USA 3.
• Jemně vyladěné modely se nepodporují. Chcete-li použít doladěný model, vytvořte nasazení.
• Mantinely, vlastní zásady RAI a filtry obsahu nejsou konfigurovatelné pro okamžitý přístup.
• Nárok mají pouze modely uvedené v podporovaných modelech .

Související obsah

• Přehled nasazení pro modely Microsoft Foundry
• Typy nasazení pro modely Microsoft Foundry
• Správa kvót pro prostředky Foundry
• Rychlý úvod k Microsoft Foundry