Claude di Microsoft Foundry

Panduan ini menunjukkan 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 terbaru, termasuk Claude Opus 5, Claude Opus 4.8, dan Claude Sonnet 5, serta fitur seperti 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 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



Menginstal SDK

SDK klien Anthropic mendukung Foundry melalui paket atau kelas klien khusus platform. Contoh di halaman ini juga menunjukkan permintaan dengan cURL dan CLI ant. Untuk menyiapkan CLI, lihat Panduan cepat 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.



Melakukan provisioning resource Foundry

Buat resource Foundry, yang diperlukan untuk menggunakan dan mengelola layanan di Azure. Anda dapat mengikuti instruksi ini untuk membuat resource Foundry. Sebagai alternatif, Anda dapat memulai dengan membuat proyek Foundry, yang melibatkan 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, 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 halaman 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 satu kali 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 menyetujui ketentuan dan berlangganan penawaran Azure Marketplace.
5. Konfigurasikan deployment:
   • Deployment name: Secara default menggunakan 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-host 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 hosting-nya (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-host Azure dalam format https://{resource}.services.ai.azure.com/anthropic/v1/*.



Autentikasi kunci API

Setelah melakukan provisioning resource Claude Foundry Anda, Anda dapat memperoleh 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 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 membangun 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. Dapatkan access token dari Entra ID.
3. Gunakan token di 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 di header respons HTTP untuk debugging dan pelacakan. 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 seluruh sistem Anthropic dan 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, 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
• Advisor tool
• Claude Managed Agents
• Compliance API
• Models API
• Message Batches API
• Fallback sisi server (parameter fallbacks; gunakan pola fallback sisi klien sebagai gantinya)



Fitur tambahan yang tidak didukung saat di-host di Azure

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

• Structured outputs
• Alat sisi server (web search, web fetch, code execution, dan tool search)
• MCP connector
• Agent Skills
• Programmatic tool calling
• Files API

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



Respons API

Respons API dari Claude di Microsoft Foundry mengikuti format respons Claude API standar. Ini termasuk objek usage di body respons, yang menyediakan informasi konsumsi token terperinci untuk permintaan Anda. Objek usage konsisten di semua platform (Claude API, Amazon Bedrock, Claude Platform di 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 Deprekasi model. Microsoft Foundry mengikuti jadwal siklus hidup Claude API.

Model Claude berikut tersedia melalui Foundry:

Secara default, nama deployment cocok dengan ID model yang ditampilkan di tabel sebelumnya. 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 menagih melalui Azure Marketplace. Penggunaan dinyatakan dalam Claude Consumption Units (CCU), diukur per jam, dan ditagih bulanan di belakang 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 model yang lain (Hosted on Azure atau Hosted on Anthropic). Ini dapat berada di resource Foundry yang sama, atau yang baru.
2. Perbarui aplikasi Anda untuk meneruskan nama deployment baru di parameter model.
3. Hapus deployment lama setelah lalu lintas dipindahkan.

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 secara bergulir 30 hari untuk memahami pola penggunaan dan menyelidiki potensi masalah.



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 di 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