Mengakses API

API tersedia melalui Console web kami. Anda dapat menggunakan Workbench untuk mencoba API di browser dan kemudian menghasilkan kunci API di Account Settings. Gunakan workspaces untuk memisahkan kunci API Anda dan mengontrol pengeluaran berdasarkan kasus penggunaan.

Autentikasi

Semua permintaan ke Anthropic API harus menyertakan header x-api-key dengan kunci API Anda. Jika Anda menggunakan Client SDK, Anda akan mengatur API saat membuat klien, dan kemudian SDK akan mengirim header atas nama Anda dengan setiap permintaan. Jika mengintegrasikan langsung dengan API, Anda perlu mengirim header ini sendiri.

Jenis konten

Anthropic API selalu menerima JSON dalam badan permintaan dan mengembalikan JSON dalam badan respons. Anda perlu mengirim header content-type: application/json dalam permintaan. Jika Anda menggunakan Client SDK, ini akan ditangani secara otomatis.

Batas ukuran permintaan

API memiliki ukuran permintaan maksimum 32 MB untuk endpoint standar, termasuk Messages API dan Token Counting API. Jika Anda melebihi batas ini, Anda akan menerima error 413 request_too_large dari Cloudflare. Endpoint spesifik memiliki batas yang berbeda:

Header Respons

Anthropic API menyertakan header berikut dalam setiap respons:

  • request-id: Pengenal unik global untuk permintaan.

  • anthropic-organization-id: ID organisasi yang terkait dengan kunci API yang digunakan dalam permintaan.

Contoh

Shell
curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Hello, world"}
    ]
}'