---
title: "Llamadas con curl"
description: "Sin instalar ningún SDK, usa curl para llamar a /v1/messages y /v1/chat/completions de 1折AI, consultar la lista de modelos, probar la caché y ver la salida en streaming."
headingIds: {"Nativo de Anthropic: /v1/messages":"section-1","Compatible con OpenAI: /v1/chat/completions":"section-2","Lista de modelos: /v1/models":"section-3","Salida en streaming":"section-4","Probar la caché":"section-5","Agrega -i al depurar":"section-6"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentación mantenida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fuentes y correcciones](https://1zheai.com/en/editorial/).

¿Encontraste un error? [Contacta con soporte](mailto:support@1zheai.com) indicando la dirección de la página y una descripción. No envíes claves de API ni credenciales de cuenta.

</aside>
curl es la forma más rápida de confirmar si "la clave de API (API key) y la dirección realmente funcionan". Cada ejemplo siguiente se puede copiar directamente; primero coloca la clave de API en una variable de entorno:

```bash
export ONEZHE_API_KEY="sk-你的Key"
```

Se recomienda a los usuarios de Windows ejecutar estos comandos en WSL o Git Bash; la sintaxis para PowerShell se encuentra en [Inicio rápido](/es/docs/quickstart/).

## Nativo de Anthropic: /v1/messages

```bash
curl https://1zheai.com/v1/messages \
  -H "x-api-key: $ONEZHE_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 128,
    "messages": [{"role": "user", "content": "ping"}]
  }'
```

## Compatible con OpenAI: /v1/chat/completions

```bash
curl https://1zheai.com/v1/chat/completions \
  -H "Authorization: Bearer $ONEZHE_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "messages": [{"role": "user", "content": "ping"}]
  }'
```

## Lista de modelos: /v1/models

```bash
curl https://1zheai.com/v1/models \
  -H "Authorization: Bearer $ONEZHE_API_KEY"
```

## Salida en streaming

Agrega `"stream": true` y usa `-N` para desactivar el búfer de curl, para poder ver la respuesta por segmentos:

```bash
curl -N https://1zheai.com/v1/messages \
  -H "x-api-key: $ONEZHE_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 128,
    "stream": true,
    "messages": [{"role": "user", "content": "从一数到五"}]
  }'
```

El formato de los eventos se describe en [Salida en streaming](/es/docs/streaming/).

## Probar la caché

Envía la misma solicitud dos veces seguidas; si el `usage.cache_read_input_tokens` de la segunda respuesta es mayor que 0, significa que hubo un acierto. El texto en `system` debe alcanzar la longitud mínima cacheable del modelo; el script completo se encuentra en [Verificar modelos y uso](/es/docs/verify-model/), y el principio se explica en [Prompt Caching](/es/docs/prompt-caching/).

```bash
curl https://1zheai.com/v1/messages \
  -H "x-api-key: $ONEZHE_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 32,
    "system": [{
      "type": "text",
      "text": "把一段至少 512 token、每次都一样的长文本放在这里",
      "cache_control": {"type": "ephemeral"}
    }],
    "messages": [{"role": "user", "content": "ping"}]
  }'
```

## Agrega -i al depurar

```bash
curl -i https://1zheai.com/v1/models -H "Authorization: Bearer $ONEZHE_API_KEY"
```

`-i` imprimirá el código de estado y las cabeceras de respuesta. El significado de los códigos de estado se encuentra en [Códigos de error y solución de problemas](/es/docs/troubleshooting/).