Magick API ユーザーガイド

Claude Messages APIに準拠し、system、tools、画像コンテンツ、ストリーミングイベントをサポート。成功レスポンスはClaudeのネイティブプロトコルです。

ルート：POST /v1/messages
プロトコル形状はClaude Messages APIに準拠
成功レスポンスはClaudeの生のJSONまたはClaudeの生のSSEであり、code / dataを含みません

リクエスト例

curl https://api.magickapi.com/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2025-10-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5-20250929",
    "system": "あなたはプロのAIアシスタントです。",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "こんにちは、世界"
      }
    ]
  }'

成功レスポンス例

{
  "id": "msg_013Zva2CMHLNnXjNJJKqJ2EF",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "こんにちは！私はClaudeです。"
    }
  ],
  "model": "claude-sonnet-4-5-20250929",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 12,
    "output_tokens": 18
  }
}

エラーレスポンス例

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "リクエストパラメータが無効です"
  }
}

認証

`x-api-key`

型：string
必須：はい

`anthropic-version`

型：string
必須：はい

Claude SDKまたはClaude CodeがAnthropicプロトコルに従って通常送信することを推奨します。

よく使うパラメータ

`model`

型：string
必須：はい

`system`

型：string | array

Claudeのシステムプロンプトは独立したパラメータであり、messagesには含めません。

`messages`

型：array
必須：はい

user / assistantロールをサポートします。

`max_tokens`

型：integer

`stream`

型：boolean

trueを渡すと、Claudeの生のSSEイベントストリームが返ります。

`tools` / `tool_choice`

型：array / object

現在のプロジェクトでは、Claudeのネイティブプロトコルに従ってツール関連フィールドを透過的に渡します。

マルチモーダルと拡張機能

テキストコンテンツ：サポート
画像コンテンツ：サポート
ツール呼び出し：サポート
ストリーミング返却：サポート
thinking / output_config / context_management：プロジェクトDTOでサポート済み。Claudeプロトコルのフィールドとして送信可能

互換性に関する注意

Claude Codeを使用する場合は、まず「開発ツール / Claude Code使用ガイド」を参照してください

Claude Messages

目次