汎用対話インターフェース（非ストリーミング）

統一された OpenAI Chat Completions 互換エントリポイント。ストリーミングドキュメントと同じルートを使用。成功レスポンスは OpenAI のオリジナル JSON。

ルート：POST /v1/chat/completions
これは別のインターフェースではなく、同じルートに stream: false を指定したものです。
成功レスポンスは OpenAI のオリジナル JSON で、code / data は含まれません。

リクエスト例

curl --request POST \
  --url https://api.magickapi.com/v1/chat/completions \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-5",
    "stream": false,
    "messages": [
      {
        "role": "system",
        "content": "あなたはプロの AI アシスタントです。"
      },
      {
        "role": "user",
        "content": "人工知能の発展の歴史を紹介してください。"
      }
    ]
  }'

成功レスポンス例

{
  "id": "chatcmpl_123",
  "object": "chat.completion",
  "created": 1712345678,
  "model": "gpt-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "人工知能の発展の歴史は通常、20 世紀 50 年代から議論されます。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 20,
    "total_tokens": 48
  }
}

エラーレスポンス例

{
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_request"
  }
}

認証

リクエストヘッダー：Authorization: Bearer YOUR_API_KEY
API Key は Magick API 管理画面で生成されたキーを使用してください。

よく使われるパラメータ

`model`

型：string
必須：はい

`messages`

型：array
必須：はい

OpenAI Chat Completions プロトコルに準拠します。

`stream`

型：boolean
推奨設定：false

完全な結果を一度に取得したい場合は、明示的に false を渡してください。

その他のよく使われるフィールド

temperature
top_p
max_tokens
max_completion_tokens
tools
tool_choice
response_format
reasoning_effort

互換性に関する注意

ストリーミングと非ストリーミングの両方とも POST /v1/chat/completions を使用します。

汎用対話インターフェース（非ストリーミング）

目次