API de Claude Opus 5.5: guía de inicio rápido con curl y Python listos para ejecutar

Claude Opus 5.5 es el modelo más reciente de Anthropic para programación agéntica y razonamiento de contexto largo, y hiapi completó su integración el mismo día en que se lanzó en la plataforma. A diferencia de los modelos de imagen, vídeo y audio de hiapi —que siguen el patrón asíncrono POST /v1/tasks → sondeo—, Claude Opus 5.5 es un modelo de conversación puramente textual, por lo que basta con enviar una petición síncrona a /v1/chat/completions para invocarlo. Esta guía ofrece una llamada curl lista para ejecutar, la versión en Python de esa misma llamada y los detalles de producción que conviene conocer antes del lanzamiento (intensidad de razonamiento, salida en streaming y manejo de errores).

Preparación

• Una cuenta de hiapi y una clave de API. Puedes crearla en la página API Keys; todos los modelos de hiapi, incluido Claude Opus 5.5, comparten la misma clave.
• No hace falta instalar ningún SDK. Claude Opus 5.5 usa el formato Chat Completions compatible con OpenAI de hiapi, así que cualquier cliente HTTP (curl, requests, fetch) funciona sin configuración adicional.

Petición mínima funcional (curl)

curl -X POST "https://api.hiapi.ai/v1/chat/completions" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "messages": [
      { "role": "user", "content": "Give me three tips for reviewing a Python pull request." }
    ],
    "stream": false
  }'

El id del modelo se pasa directamente: no hace falta ningún sufijo de enrutamiento ni prefijo de proveedor. Una llamada correcta devuelve el objeto estándar de chat completion:

{
  "id": "msg_...",
  "object": "chat.completion",
  "model": "claude-opus-5-5",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "1. ..." },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 13,
    "completion_tokens": 42,
    "total_tokens": 55,
    "usage_semantic": "openai",
    "usage_source": "anthropic"
  }
}

Lee la respuesta en choices[0].message.content: aquí no hay ningún output[0].url que sondear ni ningún id de tarea que seguir.

El mismo flujo en Python

import requests

response = requests.post(
    "https://api.hiapi.ai/v1/chat/completions",
    headers={
        "Authorization": "Bearer sk-YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "claude-opus-5-5",
        "messages": [
            {"role": "user", "content": "Give me three tips for reviewing a Python pull request."}
        ],
        "stream": False,
    },
)
response.raise_for_status()
data = response.json()
print(data["choices"][0]["message"]["content"])

Como el endpoint usa el formato de transporte de OpenAI Chat Completions, la misma estructura de cuerpo de petición puede reutilizarse tal cual en cualquier cliente HTTP y en cualquier lenguaje: aparte de la URL base y la clave Bearer, no hay nada específico de hiapi que aprender.

Intensidad de razonamiento, pensamiento y salida en streaming

El pensamiento extendido de Claude Opus 5.5 está siempre activado: no puedes desactivarlo ni especificar manualmente un presupuesto de tokens. Lo que sí puedes controlar es cuánto razona el modelo, mediante output_config.effort:

{
  "model": "claude-opus-5-5",
  "messages": [{ "role": "user", "content": "..." }],
  "output_config": { "effort": "medium" }
}

effort acepta low, medium (el valor predeterminado cuando se omite el campo), high, xhigh o max, pasando progresivamente de respuestas rápidas y económicas a respuestas profundas y meditadas. El message de la respuesta incluye un array reasoning_details que guarda el rastro de pensamiento interno del modelo; para llamadas puntuales sencillas puedes ignorarlo sin problema y leer solo message.content.

Para respuestas largas, establece "stream": true para recibir la salida de forma incremental en lugar de esperar a la respuesta completa:

curl -N https://api.hiapi.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-5-5","messages":[{"role":"user","content":"..."}],"stream":true}'

Cada bloque de datos es una línea data: {...} con formato chat.completion.chunk, y el texto incremental se encuentra en choices[0].delta.content. Sigue leyendo bloques hasta recibir uno con finish_reason no vacío (normalmente "stop"); ese es el final de la respuesta.

Claude Opus 5.5 también admite llamadas a herramientas/funciones, cuenta con una ventana de contexto de 1 millón de tokens y una salida de hasta 128 000 tokens, por lo que resulta adecuado para tareas con grandes bases de código o documentos extensos, no solo para preguntas y respuestas breves.

Consideraciones para producción

• Los errores de autenticación devuelven 401, no 400. Cuando la clave falta o no es válida se devuelve:

  { "error": { "code": "permission_denied", "message": "This API key is invalid...", "type": "hiapi_error", "request_id": "..." } }
  

  Comprueba específicamente el HTTP 401 y proporciona el request_id cuando necesites contactar con soporte; para otras causas de este error, consulta la guía completa de solución de problemas de claves de API no válidas.

• Aquí no hay opción de callback/Webhook. Ese modo se aplica a los modelos de hiapi basados en tareas asíncronas (imagen, vídeo y audio); Chat Completions solo admite petición/respuesta, así que stream: true es tu única alternativa a una llamada bloqueante única.

• Esta llamada es idempotente por naturaleza: no se crea por accidente ningún id de tarea duplicado, por lo que reintentar tras un tiempo de espera agotado es seguro siempre que puedas aceptar volver a ejecutar el mismo prompt.

• Vigila los límites de velocidad, sobre todo con cargas de trabajo de alta concurrencia; para las estrategias de retroceso, consulta cómo manejar el error 429 de límite de velocidad.

• El precio por token (los tokens de entrada, de salida y de caché se facturan por separado) se actualiza continuamente en la página del modelo Claude Opus 5.5 y en la página de precios; no codifiques cifras fijas en tu lógica de facturación, léelas desde esas páginas.

Lectura adicional

• Página del modelo Claude Opus 5.5: tabla completa de especificaciones y precios en tiempo real
• Guía de la API de Claude Sonnet 4.6: una opción de Claude más ligera y rápida con el mismo formato Chat Completions
• Crear un proxy compatible con OpenAI en Python: útil si quieres poner varios modelos de chat detrás de una única API interna
• Gestiona tus claves de API

Preguntas frecuentes

¿La API de Claude Opus 5.5 admite salida en streaming? Sí: establece "stream": true y lee los bloques data: {...} como se describe arriba.

¿Se necesita una clave de API para llamar a Claude Opus 5.5 en producción? Sí. Cada petición debe incluir Authorization: Bearer sk-<your key>; la API de producción no ofrece acceso sin clave ni anónimo.

¿Puedo desactivar el pensamiento de Claude Opus 5.5 para ahorrar tokens? No. El pensamiento de este modelo está siempre activado; lo único que puedes controlar es el nivel de output_config.effort (de low a max), que equilibra velocidad/coste frente a profundidad.

¿Claude Opus 5.5 se invoca mediante /v1/tasks como los modelos de imagen de hiapi? No. Solo los modelos de imagen, vídeo y audio de hiapi usan el patrón de tareas asíncronas con sondeo. Claude Opus 5.5 es un modelo de texto, usa /v1/chat/completions y devuelve la respuesta en la misma respuesta.

¿Cuál es la ventana de contexto y la longitud máxima de salida? 1 millón de tokens de contexto y hasta 128 000 tokens de salida, suficiente para prompts de repositorios completos o documentos extensos.

¿Claude Opus 5.5 admite llamadas a herramientas/funciones? Sí, junto con salida en streaming y el formato de mensajes compatible con OpenAI.