Descripción general

​

Acceso a la API

La API está disponible a través de nuestra Consola web. Puedes usar el Workbench para probar la API en el navegador y luego generar claves de API en Configuración de cuenta. Usa espacios de trabajo para segmentar tus claves de API y controlar el gasto por caso de uso.

​

Autenticación

Todas las solicitudes a la API de Anthropic deben incluir un encabezado x-api-key con tu clave de API. Si estás usando los SDK de cliente, establecerás la API al construir un cliente, y luego el SDK enviará el encabezado en tu nombre con cada solicitud. Si integras directamente con la API, necesitarás enviar este encabezado tú mismo.

​

Tipos de contenido

La API de Anthropic siempre acepta JSON en los cuerpos de solicitud y devuelve JSON en los cuerpos de respuesta. Necesitarás enviar el encabezado content-type: application/json en las solicitudes. Si estás usando los SDK de cliente, esto se manejará automáticamente.

​

Límites de tamaño de solicitud

La API tiene un tamaño máximo de solicitud de 32 MB para endpoints estándar, incluyendo la API de mensajes y la API de conteo de tokens. Si excedes este límite, recibirás un error 413 request_too_large de Cloudflare. Los endpoints específicos tienen diferentes límites:

• Endpoints estándar (Mensajes, Conteo de tokens): 32 MB
• API por lotes: 256 MB
• API de archivos: 500 MB

​

Encabezados de respuesta

La API de Anthropic incluye los siguientes encabezados en cada respuesta:

• request-id: Un identificador único global para la solicitud.

• anthropic-organization-id: El ID de organización asociado con la clave de API utilizada en la solicitud.

​

Ejemplos

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"}
    ]
}'

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"}
    ]
}'

pip install anthropic

import anthropic

client = anthropic.Anthropic(
    # por defecto os.environ.get("ANTHROPIC_API_KEY")
    api_key="my_api_key",
)
message = client.messages.create(
    model="claude-opus-4-20250514",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ]
)
print(message.content)

npm install @anthropic-ai/sdk

import Anthropic from '@anthropic-ai/sdk';

const anthropic = new Anthropic({
  apiKey: 'my_api_key', // por defecto process.env["ANTHROPIC_API_KEY"]
});

const msg = await anthropic.messages.create({
  model: "claude-opus-4-20250514",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Hello, Claude" }],
});
console.log(msg);