Claude di Microsoft Foundry

Panduan ini menunjukkan kepada Anda cara menyiapkan dan melakukan panggilan API ke Claude di Microsoft Foundry menggunakan salah satu SDK klien Anthropic atau permintaan HTTP langsung. Saat Anda mengakses Claude di Microsoft Foundry, Anda ditagih untuk penggunaan Claude di Azure Marketplace. Anda dapat menggunakan model Claude termasuk Claude Fable 5.1, Claude Opus 5, Claude Opus 4.8, dan Claude Sonnet 5, serta fitur seperti "context window" (jendela konteks) 1 juta token, sambil mengelola biaya melalui langganan Azure Anda.

Claude tersedia dalam tipe deployment Global Standard dan US Data Zone Standard di resource Foundry, ditagih dalam Claude Consumption Units melalui Azure Marketplace. Kunjungi harga Claude di Microsoft Foundry untuk detailnya.

Opsi hosting

Model Claude di Microsoft Foundry tersedia dalam dua opsi hosting. Anda memilih opsi hosting saat mengonfigurasi deployment.

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

• Langganan Azure yang aktif
• Akses ke portal Foundry
• Azure CLI yang terinstal (diperlukan untuk contoh cURL Entra ID, opsional untuk lainnya)
• Peran Azure RBAC yang memungkinkan Anda menggunakan resource, seperti Foundry User (sebelumnya Azure AI User) atau Cognitive Services User

Instal SDK

SDK klien Anthropic mendukung Foundry melalui paket atau kelas klien khusus platform. Contoh di halaman ini juga menunjukkan permintaan dengan cURL dan ant CLI. Untuk menyiapkan CLI, lihat quickstart CLI.

pip install -U "anthropic"

# Untuk autentikasi Entra ID, instal juga pustaka Azure Identity
pip install azure-identity

Provisioning

Foundry menggunakan hierarki dua tingkat: resource berisi konfigurasi keamanan dan penagihan Anda, sedangkan deployment adalah instance model yang Anda panggil melalui API. Anda akan terlebih dahulu membuat resource Foundry, lalu membuat satu atau lebih deployment Claude di dalamnya.

Provisioning resource Foundry

Buat resource Foundry, yang diperlukan untuk menggunakan dan mengelola layanan di Azure. Anda dapat mengikuti petunjuk ini untuk membuat resource Foundry. Sebagai alternatif, Anda dapat memulai dengan membuat proyek Foundry, yang mencakup pembuatan resource Foundry.

Untuk melakukan provisioning resource Anda:

1. Buka portal Foundry.
2. Buat resource Foundry baru atau pilih yang sudah ada.
3. Konfigurasikan manajemen akses menggunakan kunci API yang diterbitkan Azure atau Entra ID (sebelumnya Azure Active Directory) untuk kontrol akses berbasis peran.
4. Secara opsional, konfigurasikan resource agar menjadi bagian dari jaringan privat (Azure Virtual Network) untuk membatasi akses jaringan ke resource Anda.
5. Catat nama resource Anda. Anda akan menggunakannya sebagai {resource} di endpoint API (misalnya, https://{resource}.services.ai.azure.com/anthropic/v1/*).

Membuat deployment Foundry

Setelah membuat resource Anda, deploy model Claude agar tersedia untuk panggilan API. Langkah-langkah ini menjelaskan portal Foundry baru (toggle New Foundry aktif):

1. Masuk ke portal Foundry. Dari beranda portal, pilih Discover di navigasi kanan atas, lalu Models di panel kiri untuk membuka katalog model.
2. Cari dan pilih model Claude (misalnya, claude-opus-5). Setiap model muncul sekali di katalog terlepas dari berapa banyak opsi hosting yang didukungnya.
3. Pada kartu model, pilih Deploy, lalu Custom settings untuk membuka panel pengaturan deployment. Jika Anda memilih Default settings, deployment secara otomatis dikonfigurasi sebagai Hosted on Azure untuk model yang tersedia di kedua opsi hosting.
4. Pada deployment Claude pertama Anda, tinjau ketentuan Azure Marketplace, pilih industri, dan pilih Agree and Proceed untuk menerima ketentuan dan berlangganan penawaran Azure Marketplace.
5. Konfigurasikan deployment:
   • Deployment name: Default-nya adalah ID model, tetapi Anda dapat menyesuaikannya (misalnya, my-claude-deployment). Nama deployment tidak dapat diubah setelah dibuat.
   • Region scope: Pilih Global, atau untuk model yang di-hosting di Azure, Data Zone. Memilih Data Zone akan membuat deployment US Data Zone Standard, yang menjaga inferensi tetap berada di Amerika Serikat dan setara dengan mengatur inference_geo: "us" pada Claude API.
   • Model version: Perluas Model version settings dan pilih versi dari menu dropdown Model version. Setiap opsi hosting tercantum sebagai versi model terpisah, diberi label dengan opsi hostingnya (misalnya, versi 1 untuk Hosted on Anthropic, versi 2 untuk Hosted on Azure).
6. Pilih Deploy dan tunggu hingga provisioning selesai.
7. Setelah di-deploy, pilih Build di navigasi kanan atas, lalu Models di panel kiri, dan buka deployment Anda. Tab Details menampilkan Target URI (URL endpoint Anda) dan Key (kunci API Anda).

Jika toggle New Foundry nonaktif, Anda berada di tata letak portal klasik. Di sana, buka Model catalog di panel kiri untuk menemukan dan men-deploy model, dan buka Models + endpoints (di bawah My assets) untuk melihat deployment Anda dan detail endpoint-nya.

Autentikasi

Claude di Microsoft Foundry mendukung dua metode autentikasi: kunci API dan token Entra ID. Kedua metode menggunakan endpoint yang di-hosting Azure dengan format https://{resource}.services.ai.azure.com/anthropic/v1/*.

Autentikasi kunci API

Setelah melakukan provisioning resource Claude Foundry Anda, Anda dapat memperoleh "API key" (kunci API) dari portal Foundry:

1. Di portal Foundry, pilih Build di navigasi kanan atas, lalu Models di panel kiri.
2. Buka deployment Claude Anda dan pilih tab Details.
3. Salin nilai Key (dan catat Target URI untuk endpoint Anda).
4. Gunakan header api-key atau x-api-key dalam permintaan Anda, atau berikan ke SDK.

SDK Foundry memerlukan kunci API dan nama resource atau base URL. SDK C#, Java, PHP, Python, dan TypeScript secara otomatis membaca nilai-nilai ini dari variabel lingkungan berikut jika didefinisikan:

• ANTHROPIC_FOUNDRY_API_KEY - Kunci API Anda
• ANTHROPIC_FOUNDRY_RESOURCE - Nama resource Anda (misalnya, example-resource)
• ANTHROPIC_FOUNDRY_BASE_URL - Alternatif untuk nama resource: base URL lengkap (misalnya, https://example-resource.services.ai.azure.com/anthropic/). SDK C# tidak membaca variabel ini: SDK tersebut selalu menyusun base URL dari nama resource.

Contoh menggunakan kunci API:

import os
from anthropic import AnthropicFoundry

client = AnthropicFoundry(
    api_key=os.environ.get("ANTHROPIC_FOUNDRY_API_KEY"),
    resource="example-resource",  # your resource name
)

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content)

Autentikasi Microsoft Entra

Autentikasi Entra ID memungkinkan Anda mengelola akses dengan Azure RBAC, berintegrasi dengan manajemen identitas organisasi Anda, dan menghindari penanganan kunci API secara manual. Untuk menggunakan token Entra ID:

1. Aktifkan autentikasi Microsoft Entra ID untuk resource Foundry Anda.
2. Peroleh access token dari Entra ID.
3. Gunakan token tersebut dalam header Authorization: Bearer {TOKEN}.

Contoh menggunakan Entra ID:

from anthropic import AnthropicFoundry
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

# Dapatkan token Microsoft Entra ID menggunakan pola token provider
token_provider = get_bearer_token_provider(
    DefaultAzureCredential(), "https://ai.azure.com/.default"
)

# Buat klien dengan autentikasi Entra ID
client = AnthropicFoundry(
    resource="example-resource",  # your resource name
    azure_ad_token_provider=token_provider,  # Use token provider for Entra ID auth
)

# Buat permintaan
message = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content)

ID permintaan korelasi

Foundry menyertakan pengidentifikasi permintaan dalam header respons HTTP untuk debugging dan tracing. Saat menghubungi dukungan, berikan nilai request-id dan apim-request-id (Azure API Management) untuk membantu tim menemukan dan menyelidiki permintaan Anda dengan cepat di sistem Anthropic maupun Azure.

Dukungan fitur

Claude di Microsoft Foundry mendukung sebagian besar fitur Claude. Anda dapat menemukan semua fitur yang saat ini didukung di Ikhtisar fitur.

Jendela konteks

Claude Fable 5.1, Claude Fable 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5, dan Claude Sonnet 4.6 memiliki jendela konteks 1 juta token di Microsoft Foundry. Model Claude lainnya, termasuk Claude Sonnet 4.5, memiliki jendela konteks 200 ribu token.

Fitur Claude yang tidak didukung untuk Claude di Microsoft Foundry

• Admin API
• Alat advisor
• Claude Managed Agents
• Compliance API
• Models API
• Message Batches API
• Fallback sisi server (parameter fallbacks; gunakan pola fallback sisi klien sebagai gantinya)
• Toolset computer use dan browser use (computer_toolset_20260801 dan browser_toolset_20260801 saat ini belum tersedia di Microsoft Foundry; versi beta alat computer use tetap tersedia)

Fitur tambahan yang tidak didukung saat di-hosting di Azure

Fitur-fitur berikut tersedia untuk deployment yang di-hosting di Anthropic tetapi tidak didukung untuk deployment yang di-hosting di Azure:

• Eksekusi kode
• Versi alat web search dan web fetch yang lebih baru dari web_search_20250305 dan web_fetch_20250910. Deployment yang di-hosting di Azure hanya mendukung versi dasar ini, sehingga pemfilteran dinamis, penyertaan respons, dan bypass cache tidak tersedia.
• Agent Skills
• Pemanggilan alat terprogram
• Files API

Permintaan yang menggunakan fitur-fitur ini terhadap deployment yang di-hosting di Azure akan mengembalikan error 400 Bad Request sesuai desain. Claude Code mendeteksi deployment yang di-hosting di Azure dan secara otomatis menyesuaikan set fiturnya.

Respons API

Respons API dari Claude di Microsoft Foundry mengikuti format respons Claude API standar. Ini mencakup objek usage dalam body respons, yang memberikan informasi konsumsi token terperinci untuk permintaan Anda. Objek usage konsisten di semua platform (Claude API, Amazon Bedrock, Claude Platform on AWS, Foundry, dan Google Cloud).

Untuk detail tentang header respons khusus Foundry, lihat ID permintaan korelasi.

ID model API dan deployment

Istilah siklus hidup (Deprecated, Retired) didefinisikan di Penghentian model. Microsoft Foundry mengikuti jadwal siklus hidup Claude API.

Model Claude berikut tersedia melalui Foundry:

Secara default, nama deployment sama dengan ID model yang ditampilkan pada tabel di atas. Namun, Anda dapat membuat deployment kustom dengan nama berbeda di portal Foundry untuk mengelola konfigurasi, versi, atau batas laju yang berbeda. Gunakan nama deployment (tidak harus ID model) dalam permintaan API Anda.

Penagihan

Claude di Microsoft Foundry ditagih melalui Azure Marketplace. Penggunaan dinyatakan dalam Claude Consumption Units (CCU), diukur per jam, dan ditagihkan bulanan di akhir periode pada tagihan Azure Anda. CCU bukan kredit prabayar. Tidak ada saldo atau komitmen CCU.

Untuk harga CCU, mekanisme konversi, dan tarif token per model, lihat harga Claude di Microsoft Foundry.

Migrasi antar opsi hosting

Untuk memindahkan deployment yang ada dari satu opsi hosting ke opsi lainnya:

1. Buat deployment baru dari versi hosting lain model tersebut (Hosted on Azure atau Hosted on Anthropic). Ini dapat berada di resource Foundry yang sama, atau yang baru.
2. Perbarui aplikasi Anda untuk memberikan nama deployment baru dalam parameter model.
3. Hapus deployment lama setelah lalu lintas berpindah.

Jika deployment baru berada di resource Foundry yang sama, URL endpoint dan autentikasi Anda tidak berubah. Jika Anda membuat resource baru, perbarui endpoint dan kredensial aplikasi Anda agar mengarah ke resource tersebut.

Pemantauan dan logging

Azure menyediakan pemantauan dan logging untuk penggunaan Claude Anda melalui pola Azure standar:

• Azure Monitor: Lacak penggunaan API, latensi, dan tingkat error
• Azure Log Analytics: Kueri dan analisis log permintaan/respons
• Cost Management: Pantau dan perkirakan biaya yang terkait dengan penggunaan Claude

Anthropic merekomendasikan untuk mencatat aktivitas Anda setidaknya dalam basis bergulir 30 hari untuk memahami pola penggunaan dan menyelidiki potensi masalah apa pun.

Pemecahan masalah

Error autentikasi

Error: 401 Unauthorized atau Invalid API key

• Solusi: Verifikasi bahwa kunci API Anda benar. Anda dapat menemukannya di portal Foundry pada tab Details deployment Anda (di bawah Build > Models).
• Solusi: Jika menggunakan Microsoft Entra ID, pastikan access token Anda valid dan belum kedaluwarsa. Token biasanya kedaluwarsa setelah 1 jam.

Error: 403 Forbidden

• Solusi: Akun Azure Anda mungkin tidak memiliki izin yang diperlukan. Pastikan Anda memiliki peran Azure RBAC yang sesuai (misalnya, Foundry User (sebelumnya Azure AI User) atau Cognitive Services User).

Pembatasan laju

Error: 429 Too Many Requests

• Solusi: Anda telah melampaui batas laju Anda. Terapkan logika exponential backoff dan retry dalam aplikasi Anda.
• Solusi: Pertimbangkan untuk meminta peningkatan batas laju melalui portal Azure atau dukungan Azure.

Header batas laju

Foundry tidak menyertakan header batas laju standar Anthropic (anthropic-ratelimit-tokens-limit, anthropic-ratelimit-tokens-remaining, anthropic-ratelimit-tokens-reset, anthropic-ratelimit-input-tokens-limit, anthropic-ratelimit-input-tokens-remaining, anthropic-ratelimit-input-tokens-reset, anthropic-ratelimit-output-tokens-limit, anthropic-ratelimit-output-tokens-remaining, dan anthropic-ratelimit-output-tokens-reset) dalam respons. Kelola pembatasan laju melalui alat pemantauan Azure sebagai gantinya.

Error model dan deployment

Error: Model not found atau Deployment not found

• Solusi: Verifikasi bahwa Anda menggunakan nama deployment yang benar. Jika Anda belum membuat deployment kustom, gunakan ID model default (misalnya, claude-opus-5).
• Solusi: Pastikan model/deployment tersedia di region Azure Anda.

Error: Invalid model parameter

• Solusi: Parameter model harus berisi nama deployment Anda, yang dapat disesuaikan di portal Foundry. Verifikasi bahwa deployment ada dan dikonfigurasi dengan benar.

Langkah selanjutnya

Sumber daya tambahan