チュートリアル

Claude Opus 5.5 API：すぐに実行できる curl と Python クイックスタート

Sep 29, 2026

Claude Opus 5.5 は Anthropic 最新のエージェント型コーディングと長文脈推論モデルであり、hiapi はそれがプラットフォームに公開された当日に接続を完了しました。hiapi の画像・動画・音声モデルとは異なり——それらのモデルは非同期の POST /v1/tasks → ポーリング方式を経由します——Claude Opus 5.5 は純粋なテキスト対話モデルであるため、/v1/chat/completions に同期的なリクエストを 1 つ送るだけで呼び出せます。本ガイドでは、すぐに実行できる curl 呼び出し、同じ呼び出しの Python 版、そして本番導入前に知っておくべき詳細（推論強度、ストリーミング出力、エラー処理）を提供します。

準備

hiapi アカウントと API キー。 API Keys ページで作成できます——Claude Opus 5.5 を含むすべての hiapi モデルは同じキーを共有します。
SDK のインストールは不要です。Claude Opus 5.5 は hiapi の OpenAI 互換 Chat Completions 形式を使用するため、どの HTTP クライアント（curl、requests、fetch）でもすぐに利用できます。

最小限の動作するリクエスト（curl）

curl -X POST "https://api.hiapi.ai/v1/chat/completions" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "messages": [
      { "role": "user", "content": "Give me three tips for reviewing a Python pull request." }
    ],
    "stream": false
  }'

モデル id をそのまま渡します——ルーティングサフィックスもプロバイダー識別子のプレフィックスも不要です。呼び出しが成功すると標準的なチャット補完オブジェクトが返されます：

{
  "id": "msg_...",
  "object": "chat.completion",
  "model": "claude-opus-5-5",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "1. ..." },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 13,
    "completion_tokens": 42,
    "total_tokens": 55,
    "usage_semantic": "openai",
    "usage_source": "anthropic"
  }
}

回答は choices[0].message.content から読み取ります——ここにはポーリングすべき output[0].url も、追跡すべきタスク id もありません。

Python での同じ流れ

import requests

response = requests.post(
    "https://api.hiapi.ai/v1/chat/completions",
    headers={
        "Authorization": "Bearer sk-YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "claude-opus-5-5",
        "messages": [
            {"role": "user", "content": "Give me three tips for reviewing a Python pull request."}
        ],
        "stream": False,
    },
)
response.raise_for_status()
data = response.json()
print(data["choices"][0]["message"]["content"])

このエンドポイントは OpenAI Chat Completions の転送形式を使用しているため、同じリクエストボディ構造は任意の言語の任意の HTTP クライアントでそのまま使えます——ベース URL と Bearer キー以外に、hiapi 固有で学ぶべきことは何もありません。

推論強度、思考、ストリーミング出力

Claude Opus 5.5 の拡張思考は常に有効です——無効化することも、トークンバジェットを手動で指定することもできません。制御できるのはモデルがどれだけ推論するかであり、それは output_config.effort を通じて行います：

{
  "model": "claude-opus-5-5",
  "messages": [{ "role": "user", "content": "..." }],
  "output_config": { "effort": "medium" }
}

effort は low、medium（このフィールドを省略した場合のデフォルト）、high、xhigh、max を受け付けます——高速・低コストの回答から、深く慎重な回答へと段階的に移行します。レスポンスの message にはモデルの内部思考の軌跡を保持する reasoning_details 配列が含まれます。単純な単発の呼び出しではこれを安全に無視し、message.content だけを読めば問題ありません。

長い回答の場合、完全なレスポンスを待つ代わりに "stream": true を設定してインクリメンタル出力を取得します：

curl -N https://api.hiapi.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-5-5","messages":[{"role":"user","content":"..."}],"stream":true}'

各データチャンクは data: {...} の 1 行で、形式は chat.completion.chunk、インクリメンタルテキストは choices[0].delta.content にあります。finish_reason が空でないデータチャンク（通常は "stop"）を受け取るまでデータチャンクを読み続けます——それがレスポンスの終わりです。

Claude Opus 5.5 はツール/関数呼び出しにも対応しており、100 万トークンのコンテキストウィンドウと最大 12.8 万トークンの出力を備えているため、短い質疑応答だけでなく、大規模なコードベースや長いドキュメントのタスクにも適しています。

本番環境での注意事項

認証エラーは 400 ではなく 401 を返します。 キーが欠落しているか無効な場合は次のように返されます：
```
{ "error": { "code": "permission_denied", "message": "This API key is invalid...", "type": "hiapi_error", "request_id": "..." } }
```
HTTP 401 を明確にチェックし、サポートへの問い合わせが必要な場合は request_id を提供してください——このエラーのその他の原因については、無効な API キーのトラブルシューティングガイドを参照してください。
ここにはコールバック/Webhook オプションはありません。 この方式は hiapi の非同期タスクベースのモデル（画像、動画、音声）に適用されます。Chat Completions はリクエスト/レスポンスのみをサポートするため、単一のブロッキング呼び出し以外では stream: true が唯一の選択肢です。
この呼び出しは本質的に冪等です——タスク id が誤って重複作成されることはないため、同じプロンプトを再実行することを許容できる限り、タイムアウト時のリトライは安全です。
レート制限に注意してください、特に高並列のワークロードでは。バックオフ戦略については429 レート制限エラーの対処方法を参照してください。
トークン価格（入力、出力、キャッシュトークンがそれぞれ課金されます）は Claude Opus 5.5 モデルページと料金ページで継続的に更新されています——課金ロジックに数値をハードコードせず、これらのページから読み取るようにしてください。

Claude Opus 5.5 モデルページ——完全な仕様表とリアルタイムの料金
Claude Sonnet 4.6 API ガイド——同じ Chat Completions 形式で、より軽量で高速な Claude の選択肢
Python で OpenAI 互換プロキシを構築する——複数のチャットモデルを単一の内部 API の背後でプロキシする場合に役立ちます
API キーの管理

よくある質問

Claude Opus 5.5 API はストリーミング出力をサポートしていますか？ はい——"stream": true を設定し、上記のとおり data: {...} データチャンクを読み取ります。

本番環境で Claude Opus 5.5 を呼び出すには API キーが必要ですか？ 必要です。すべてのリクエストに Authorization: Bearer sk-<your key> を含める必要があります。本番 API はキーなし、または匿名でのアクセスを提供していません。

トークンを節約するために Claude Opus 5.5 の思考を無効にできますか？ できません。このモデルの思考は常に有効です。制御できるのは output_config.effort レベル（low から max まで）のみで、速度/コストと深度のトレードオフを調整します。

Claude Opus 5.5 は hiapi の画像モデルのように /v1/tasks を通じて呼び出しますか？ いいえ。hiapi の画像、動画、音声モデルのみが非同期タスクとポーリング方式を使用します。Claude Opus 5.5 はテキストモデルであり、/v1/chat/completions を使用して、同じレスポンスで回答を返します。

コンテキストウィンドウと最大出力長はどのくらいですか？ 100 万トークンのコンテキスト、最大 12.8 万トークンの出力——リポジトリ全体や長いドキュメントのプロンプトにも十分対応できます。

Claude Opus 5.5 はツール/関数呼び出しをサポートしていますか？ はい、ストリーミング出力と OpenAI 互換のメッセージ形式の両方をサポートしています。