curl での呼び出し

ドキュメントは 1ZheAI が管理しています。出典と訂正。

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

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

bash

export ONEZHE_API_KEY="sk-你的Key"

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

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

イベント形式はストリーミング出力を参照してください。

キャッシュのテスト

同じリクエストを2回連続で送信し、2回目のレスポンスのusage.cache_read_input_tokensが0より大きければヒットしたことを意味します。system内のテキストはモデルの最小キャッシュ可能長に達している必要があります。完全なスクリプトはモデルと使用量の確認、仕組みは 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はステータスコードとレスポンスヘッダーを出力します。ステータスコードの意味はエラーコードとトラブルシューティングを参照してください。