---
title: "curl での呼び出し"
description: "SDKを一切インストールせずに、curlで1折AIの /v1/messages と /v1/chat/completions を呼び出し、モデル一覧の取得、キャッシュのテスト、ストリーミング出力の確認を行います。"
headingIds: {"Anthropicネイティブ：/v1/messages":"section-1","OpenAI互換：/v1/chat/completions":"section-2","モデル一覧：/v1/models":"section-3","ストリーミング出力":"section-4","キャッシュのテスト":"section-5","トラブルシューティング時は -i を追加":"section-6"}
---

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

ドキュメントは [1ZheAI](https://1zheai.com/en/editorial/#publisher) が管理しています。[出典と訂正](https://1zheai.com/en/editorial/)。

エラーを見つけましたか？ページのアドレスと説明を添えて[サポートに連絡](mailto:support@1zheai.com)してください。API キーやアカウント情報は送信しないでください。

</aside>
curlは「APIキー（API key）とアドレスが実際に通っているか」を確認する最速の方法です。以下のコマンドはすべてそのままコピーして実行できます。まずAPIキーを環境変数に設定します：

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

Windowsユーザーは、これらのコマンドをWSLまたはGit Bashで実行することをお勧めします。PowerShellでの書き方は[クイックスタート](/ja/docs/quickstart/)を参照してください。

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

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

## モデル一覧：/v1/models

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

## ストリーミング出力

`"stream": true`を追加し、`-N`でcurlのバッファリングを無効にすると、逐次返信を確認できます：

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

イベント形式は[ストリーミング出力](/ja/docs/streaming/)を参照してください。

## キャッシュのテスト

同じリクエストを2回連続で送信し、2回目のレスポンスの`usage.cache_read_input_tokens`が0より大きければヒットしたことを意味します。`system`内のテキストはモデルの最小キャッシュ可能長に達している必要があります。完全なスクリプトは[モデルと使用量の確認](/ja/docs/verify-model/)、仕組みは [Prompt Caching](/ja/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"}]
  }'
```

## トラブルシューティング時は -i を追加

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

`-i`はステータスコードとレスポンスヘッダーを出力します。ステータスコードの意味は[エラーコードとトラブルシューティング](/ja/docs/troubleshooting/)を参照してください。