> Agent-readable docs index: /llms.txt. Fetch only the needed Markdown pages first; use /docs.zip only for broad search after checking /docs-manifest.json or /docs.zip.sha256.

# 画像

画像関連のAPIです。

アップロードURL生成と患者画像登録機能を提供します。

<details>
<summary>主要概念</summary>
<dl>
<dt>presigned URL</dt>
<dd><strong>定義:</strong> 画像ファイルをアップロードするために発行される一時的なアップロードURLです。<br /><strong>説明:</strong> KOS APIにファイルを直接送信するのではなく、レスポンスのURLに画像バイナリを<code>PUT</code>リクエストでアップロードします。発行されたURLは5分間有効です。</dd>
<dt>患者画像</dt>
<dd><strong>定義:</strong> 患者に紐付けて管理する画像ファイル情報です。<br /><strong>説明:</strong> ファイルアップロード後、ファイル名・患者ID・画像の出典・撮影日時などを送信して患者画像として登録します。</dd>
<dt>画像の出典</dt>
<dd><strong>定義:</strong> 画像がどこで生成されたかを区別する値です。<br /><strong>説明:</strong> 院内撮影・患者撮影・同意書・ペンカルテのように、画像の発生コンテキストを示します。</dd>
<dt>撮影機器コード</dt>
<dd><strong>定義:</strong> 画像を撮影した機器を示すコードです。<br /><strong>説明:</strong> クリニックで管理する機器コードと紐付けて、画像の撮影機器を識別する際に使用します。</dd>
<dt>画像分類コード</dt>
<dd><strong>定義:</strong> 業務基準で画像を分類するコードです。<br /><strong>説明:</strong> 経過写真・カウンセリング資料のように、クリニックで定義した画像分類体系に従って画像を整理する際に使用します。</dd>
<dt>画像フォルダパス</dt>
<dd><strong>定義:</strong> 画像が属するフォルダの場所を示すパスです。<br /><strong>説明:</strong> スラッシュ（<code>/</code>）でサブフォルダを区切り、患者画像をフォルダ構造で管理できます。</dd>
</dl>
</details>


## エンドポイント

- [画像アップロードURL発行](/ja/docs/openapi/generate-uploading-image-url.md): `POST /image/open/v1/commands/generate-uploading-url`
- [患者画像登録](/ja/docs/openapi/register-visitor-images.md): `POST /image/open/v1/commands/register-visitor-images`