Llamadas con curl

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.

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:

1
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.

Nativo de Anthropic: /v1/messages

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

Compatible con OpenAI: /v1/chat/completions

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

Lista de modelos: /v1/models

1
curl https://1zheai.com/v1/models \
2
  -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:

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

El formato de los eventos se describe en Salida en 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, y el principio se explica en Prompt Caching.

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

Agrega -i al depurar

1
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.