> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inicio rápido de Claude API: envía solicitudes de Messages con CometAPI

> Llama a modelos Claude a través de la API Messages compatible con Anthropic de CometAPI con curl, Python y Node.js.

## Lo que vas a crear

Enviarás una solicitud a `POST /v1/messages`, imprimirás el texto de respuesta de Claude y dejarás el código listo para usar con el SDK de Anthropic o mediante HTTP directo.

## Requisitos previos

* Una clave API de CometAPI almacenada en `COMETAPI_KEY`
* Un model ID de Claude desde la [página Models](/es/overview/models)
* `curl`, Python 3.10+ o Node.js 18+

## Clave API, URL base, autenticación

Usa el endpoint Messages compatible con Anthropic a través de CometAPI:

```text theme={null}
https://api.cometapi.com/v1/messages
```

Autentica las solicitudes HTTP directas con `x-api-key` y el encabezado de versión de la API de Anthropic:

```text theme={null}
x-api-key: $COMETAPI_KEY
anthropic-version: 2023-06-01
```

## Ejemplos de código

Usa las pestañas de abajo para ver ejemplos copiables en cURL, Python y Node.js.

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.cometapi.com/v1/messages \
    -H "Content-Type: application/json" \
    -H "x-api-key: $COMETAPI_KEY" \
    -H "anthropic-version: 2023-06-01" \
    -d '{
      "model": "your-claude-model-id",
      "max_tokens": 256,
      "messages": [
        {
          "role": "user",
          "content": "Reply with one short sentence."
        }
      ]
    }'
  ```

  ```python Python theme={null}
  import os
  import anthropic

  client = anthropic.Anthropic(
      api_key=os.environ["COMETAPI_KEY"],
      base_url="https://api.cometapi.com",
  )

  message = client.messages.create(
      model="your-claude-model-id",
      max_tokens=256,
      messages=[
          {
              "role": "user",
              "content": "Reply with one short sentence.",
          }
      ],
  )

  print(message.content[0].text)
  ```

  ```javascript Node.js theme={null}
  import Anthropic from "@anthropic-ai/sdk";

  const client = new Anthropic({
    apiKey: process.env.COMETAPI_KEY,
    baseURL: "https://api.cometapi.com",
  });

  const message = await client.messages.create({
    model: "your-claude-model-id",
    max_tokens: 256,
    messages: [
      {
        role: "user",
        content: "Reply with one short sentence.",
      },
    ],
  });

  console.log(message.content[0].text);
  ```
</CodeGroup>

## Explicación del flujo

Las solicitudes de Claude Messages son síncronas de forma predeterminada. La API devuelve un objeto message en una sola respuesta HTTP, y tu aplicación lee el primer bloque de contenido de texto.

Usa esta ruta cuando necesites formatos de solicitud específicos de Claude, como arreglos de mensajes de Anthropic, thinking extendido, almacenamiento en caché de prompt o uso de herramientas. Si tu aplicación ya usa el SDK oficial de Anthropic, establece la URL base del SDK en `https://api.cometapi.com` y conserva el formato de solicitud de la API Messages.

## Parámetros comunes

| Parameter    | Use                                                                                       |
| ------------ | ----------------------------------------------------------------------------------------- |
| `model`      | Un model ID de Claude disponible para tu cuenta.                                          |
| `max_tokens` | Presupuesto máximo de Token de respuesta para la respuesta de la API Messages.            |
| `messages`   | Arreglo de mensajes de Anthropic con roles `user` y `assistant`.                          |
| `stream`     | Envía eventos incrementales de mensajes mediante Streaming cuando se establece en `true`. |
| `thinking`   | Habilita el thinking extendido de Claude cuando el modelo seleccionado lo admite.         |

## Solución de problemas / Preguntas frecuentes

<AccordionGroup>
  <Accordion title="La solicitud devuelve 401">
    Confirma que `COMETAPI_KEY` esté configurada en la misma shell o entorno de ejecución que envía la solicitud. No pegues una clave real en los archivos fuente.
  </Accordion>

  <Accordion title="El SDK sigue llamando a Anthropic directamente">
    Confirma que el cliente del SDK configure `base_url` en Python o `baseURL` en Node.js como `https://api.cometapi.com`.
  </Accordion>

  <Accordion title="Qué modelo debo usar">
    Usa un model ID de Claude disponible para tu cuenta. Este inicio rápido no fija un modelo Claude específico porque la disponibilidad cambia según la cuenta y la familia de modelos.
  </Accordion>
</AccordionGroup>

## Próximos pasos

* Usa la [referencia de la API Anthropic Messages](/api/text/anthropic-messages) para ver todos los campos de solicitud y respuesta.
* Consulta la disponibilidad de modelos en [Models](/es/overview/models).
* Configura sesiones locales de programación con la [guía de integración de Claude Code](/es/integrations/claude-code).
* Revisa el comportamiento de reintentos en [Códigos de error y estrategia de reintento](/es/guides/error-codes-and-retry-strategy).