サンプルまたは匿名化した処方箋画像のみ送信してください。実際の患者情報を含む画像は送信しないでください。

APIドキュメント

処方箋を解析する

Quickstart

YOUR_API_KEY を、コンソールで発行したキーに置き換えて、そのまま実行できます。 画像は /demo の先頭にある架空の処方箋で、ファイルはhttps://ocr.ayiora.com/samples/01-naika-aoyagizaka_scan.jpg です。 リクエストは JSON です。画像は base64 の中身だけで、data URL にはしません。

cURL
curl -fsSL -o sample.jpg https://ocr.ayiora.com/samples/01-naika-aoyagizaka_scan.jpg
curl -sS https://ocr.ayiora.com/api/ocr \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<EOF
{"image":"$(base64 < sample.jpg | tr -d '\n')","mimeType":"image/jpeg"}
EOF

Python 3。requests を入れてから実行します。

Python · requests
import base64
import pathlib
import urllib.request

import requests

urllib.request.urlretrieve(
    "https://ocr.ayiora.com/samples/01-naika-aoyagizaka_scan.jpg",
    "sample.jpg",
)
image = base64.b64encode(pathlib.Path("sample.jpg").read_bytes()).decode("ascii")
response = requests.post(
    "https://ocr.ayiora.com/api/ocr",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"image": image, "mimeType": "image/jpeg"},
    timeout=60,
)
print(response.status_code)
print(response.text)

Node.js 18 以降。quickstart.mjs として保存すると、先頭の await が使えます。

Node.js · fetch
const sampleUrl = "https://ocr.ayiora.com/samples/01-naika-aoyagizaka_scan.jpg";
const sample = Buffer.from(await (await fetch(sampleUrl)).arrayBuffer());

const response = await fetch("https://ocr.ayiora.com/api/ocr", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    image: sample.toString("base64"),
    mimeType: "image/jpeg",
  }),
});

console.log(response.status);
console.log(await response.text());

成功すると HTTP 200 の JSON が返ります。下は同じ架空サンプルの読み取り結果です。meta.engine は ayiora-ocr です。meta.processedAt は応答の時刻、prescription.groups は同じ薬品を RP ごとにまとめた配列、rawText は読み取りの原文なので、例では省いています。

JSON
{
  "patient": {
    "name": "高梨 和彦",
    "kana": "タカナシ カズヒコ",
    "birthDate": "1961-07-08",
    "birthDateAdjustment": null,
    "gender": "male",
    "insurerNumber": "06138713",
    "insuredSymbol": "3207",
    "insuredNumber": "1584",
    "burdenCategory": "被保険者"
  },
  "institution": {
    "name": "青柳坂内科クリニック",
    "code": "2538171",
    "address": "東京都練馬区光が丘9丁目14番2号",
    "phone": "03-0412-7790",
    "department": "",
    "doctorName": "長谷部 孝之",
    "matched": null,
    "candidates": []
  },
  "prescription": {
    "issuedDate": "2026-10-14",
    "dateAdjustment": null,
    "refillCount": 0,
    "items": [
      {
        "drugName": "【般】アムロジピン錠5mg",
        "dosage": "1",
        "unit": "錠",
        "frequency": "1日1回 朝食後",
        "duration": "28日分",
        "generic": true,
        "confidence": 0
      },
      {
        "drugName": "【般】ロスバスタチン錠2.5mg",
        "dosage": "1",
        "unit": "錠",
        "frequency": "1日1回 夕食後",
        "duration": "28日分",
        "generic": true,
        "confidence": 0
      },
      {
        "drugName": "【般】メトホルミン塩酸塩錠250mg",
        "dosage": "2",
        "unit": "錠",
        "frequency": "1日2回 朝夕食後",
        "duration": "28日分",
        "generic": true,
        "confidence": 0
      }
    ]
  },
  "jahis": {
    "source": "ocr",
    "lines": [
      "JAHIS9",
      "1,1,2538171,13,青柳坂内科クリニック",
      "2,,東京都練馬区光が丘9丁目14番2号",
      "3,03-0412-7790,,",
      "5,,,長谷部 孝之",
      "11,,高梨 和彦,タカナシ カズヒコ",
      "12,1",
      "13,19610708",
      "21,1",
      "22,06138713",
      "23,3207,1584,1,00",
      "51,20261014",
      "101,1,1,,28",
      "111,1,1,,1日1回 朝食後,",
      "201,1,1,1,1,,【般】アムロジピン錠5mg,1,1,錠",
      "101,2,1,,28",
      "111,2,1,,1日1回 夕食後,",
      "201,2,1,1,1,,【般】ロスバスタチン錠2.5mg,1,1,錠",
      "101,3,1,,28",
      "111,3,1,,1日2回 朝夕食後,",
      "201,3,1,1,1,,【般】メトホルミン塩酸塩錠250mg,2,1,錠"
    ]
  },
  "meta": {
    "engine": "ayiora-ocr",
    "confidence": 0.9,
    "pageCount": 1
  }
}

jahis.lines を改行でつないだものです。

JAHIS
JAHIS9
1,1,2538171,13,青柳坂内科クリニック
2,,東京都練馬区光が丘9丁目14番2号
3,03-0412-7790,,
5,,,長谷部 孝之
11,,高梨 和彦,タカナシ カズヒコ
12,1
13,19610708
21,1
22,06138713
23,3207,1584,1,00
51,20261014
101,1,1,,28
111,1,1,,1日1回 朝食後,
201,1,1,1,1,,【般】アムロジピン錠5mg,1,1,錠
101,2,1,,28
111,2,1,,1日1回 夕食後,
201,2,1,1,1,,【般】ロスバスタチン錠2.5mg,1,1,錠
101,3,1,,28
111,3,1,,1日2回 朝夕食後,
201,3,1,1,1,,【般】メトホルミン塩酸塩錠250mg,2,1,錠

画像を JSON で送ります。成功すると患者・医療機関・処方と、JAHIS の行が返ります。ホストはこのサイト自身です(例: https://ocr.ayiora.com)。

POST/api/ocr
POST/api/ocr/merge
画像は処理中のみメモリ上で扱い、ディスク・データベース・ログには保存しません。

認証

コンソールで発行したキーを Authorization: Bearer <API_KEY> に入れます。X-Api-Key でも同じです。キーの形は ayk_ で始まります。全文は発行時の一度だけ表示されます。

POST /api/ocr

Content-Type: application/json です。multipart ではありません。

フィールド説明
image 必須base64 本体。data URL ではなく、中身だけです。1ファイル 3.2MB 以下(3,374,904 バイト)。
mimeType 必須image/jpeg / image/png / image/webp / application/pdf

POST /api/ocr/merge

複数ページを1件にします。pages は { image, mimeType } の配列で、並びがページ順です。枚数はページ数ぶん消費します。

レスポンス

成功は 200 の JSON です。主なフィールドは patient、institution(画像から読んだ名称など)、prescription.items[](drugName、dosage、frequency、duration)、jahis.lines、meta.processedAt、meta.engine(ayiora-ocr)です。 薬品コードは、読めたときに yjCode または receiptCode が入ります。同梱サンプルには薬品コードが印字されていないため、例では空です。JAHIS の 201 行のコード欄も、コードが無いときは空欄です。

交付年月日は、読めたとき prescription.issuedDate(YYYY-MM-DD)と JAHIS の 51 行(YYYYMMDD)の両方に、印字された日付のまま入ります。7日より前でも、未来の日付でも、今日には置き換えません。ここでの「今日」は Asia/Tokyo の日付です。prescription.dateAdjustment は次のいずれかです。

  • null — 読めた日付が、今日から7日以内です。
  • older_than_7_days — 読めた日付が7日より前です。たとえば 2025-05-10 です。同梱サンプルの交付日は 2026-10-14 で、取り込む日がそれから7日以内なら null です。
  • future — 読めた日付が未来です。
  • unparsed — 日付として読めません。issuedDate と JAHIS 51 は空です。エンジンが返した文字列は prescription.issuedDateRaw です。
  • empty — 交付年月日が空です。issuedDate と JAHIS 51 は空です。

患者には publicPayerNumber(公費負担者番号)と publicRecipientNumber(受給者番号)が入ります。読めたときだけです。 生年月日は、元号が分かって読めたとき patient.birthDate(YYYY-MM-DD)です。エンジンが era=0 で「4年2月19日」のように数字だけを返したときは元号を推測せず、patient.birthDate は空、patient.birthDateRaw にその文字列、patient.birthDateAdjustment は unparsed です。空のときは empty です。 薬品に「変更不可」の文字があるときは substitutionForbidden が true です。チェック欄だけの印(✔ やレ点)はエンジンがテキストとして返さないため、文字が無いときはフラグを立てません。 【般】の行は印字の一般名のまま generic: true になり、一般名コードがマスタにあれば generalCode だけが入ります。メーカー品の YJ コードには置き換えません。

用法・用量・日数は半角の数字と ASCII です。用法は回数とタイミングのあいだを半角スペース1つで区切ります(1日1回 朝食後、1日2回 朝夕食後)。 患者氏名・患者カナ・保険医氏名は、姓と名のあいだを全角スペースにします(高梨 和彦、タカナシ カズヒコ、榊 由紀子)。印字に空白があるときはそれを残します。空白が落ちていて姓が分かるときだけ補い、分からない姓名は切りません。 カタカナの直後のダッシュは長音「ー」です。rawText も同じ規則です。

成功時のヘッダー: X-Quota-Limit、X-Quota-Remaining、X-RateLimit-Limit、X-RateLimit-Remaining。

エラー

HTTPcode内容
400bad_requestJSON、形式、または 3.2MB を超えるサイズ
401missing_api_keyAPI キーがない
401invalid_api_key無効、または失効
429rate_limited短時間の呼び出し上限。Retry-After が付くことがあります
429quota_exceeded今月の画像枚数の上限
502upstream_error推論側の失敗。この呼び出しは月間枚数に含めません
503service_unavailableサービスが一時的に利用できません

試用枠

  • 会社ドメインの初期枠は月 100 枚。
  • フリーメールの初期枠は月 20 枚。
  • 枠はキー発行時にそのキーへ固定されます。集計は日本時間の暦月で、毎月1日 0:00 に戻ります。コンソールにはそのキーの上限と残り枚数を出します。
  • レート制限は別で、既定 10 リクエスト / 60 秒です。
  • 検証エラーと推論側の失敗は月間枚数に含めません。
  • 上限に達すると、コンソールで会社名と業態を添えて引き上げを依頼できます。自動では増えません。

試用無料・正式価格は近日公開

データの取り扱い

画像は処理中のみメモリ上で扱い、ディスク・データベース・ログには保存しません。 画像のバイト列はログにも残しません。利用ログ(経路、枚数、結果、HTTP ステータス)は 90 日で削除します。画像と読み取り結果はそのログに入れません。