---
title: "Chamadas com curl"
description: "Sem instalar nenhum SDK, use curl para chamar /v1/messages e /v1/chat/completions da 1折AI, consultar a lista de modelos, testar o cache e ver a saída em streaming."
headingIds: {"Nativo do Anthropic: /v1/messages":"section-1","Compatível com OpenAI: /v1/chat/completions":"section-2","Lista de modelos: /v1/models":"section-3","Saída em streaming":"section-4","Testar o cache":"section-5","Ao depurar, adicione -i":"section-6"}
---

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

Documentação mantida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fontes e correções](https://1zheai.com/en/editorial/).

Encontrou um erro? [Contate o suporte](mailto:support@1zheai.com) com o endereço da página e uma descrição. Não envie chaves de API ou credenciais de conta.

</aside>
curl é a maneira mais rápida de confirmar se "a chave de API (API key) e o endereço realmente funcionam". Cada exemplo abaixo pode ser copiado diretamente; primeiro coloque a chave de API em uma variável de ambiente:

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

Usuários do Windows são recomendados a executar estes comandos no WSL ou no Git Bash; a sintaxe para PowerShell está em [Início rápido](/pt/docs/quickstart/).

## Nativo do 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"}]
  }'
```

## Compatível com 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"
```

## Saída em streaming

Adicione `"stream": true` e use `-N` para desativar o buffer do curl, a fim de ver as respostas segmentadas:

```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": "从一数到五"}]
  }'
```

O formato dos eventos está em [Saída em streaming](/pt/docs/streaming/).

## Testar o cache

Envie a mesma requisição duas vezes seguidas; se o `usage.cache_read_input_tokens` da segunda resposta for maior que 0, houve cache hit. O texto em `system` precisa atingir o comprimento mínimo cacheável do modelo; o script completo está em [Verificar modelos e uso](/pt/docs/verify-model/) e o princípio em [Prompt Caching](/pt/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"}]
  }'
```

## Ao depurar, adicione -i

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

`-i` imprimirá o código de status e os cabeçalhos da resposta. O significado dos códigos de status está em [Códigos de erro e depuração](/pt/docs/troubleshooting/).