Chamadas com curl

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.

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:

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

Nativo do 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
  }'

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

Saída em streaming

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

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
  }'

O formato dos eventos está em Saída em 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 e o princípio em 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
  }'

Ao depurar, adicione -i

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