APIドキュメント
処方箋を解析する
Quickstart
YOUR_API_KEY を、コンソールで発行したキーに置き換えて、そのまま実行できます。 画像は /demo の先頭にある架空の処方箋で、ファイルはhttps://ocr.ayiora.com/samples/01-naika-aoyagizaka_scan.jpg です。 リクエストは JSON です。画像は base64 の中身だけで、data URL にはしません。
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"}
EOFPython 3。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 が使えます。
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 は読み取りの原文なので、例では省いています。
{
"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 を改行でつないだものです。
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)。
/api/ocr/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。
エラー
| HTTP | code | 内容 |
|---|---|---|
| 400 | bad_request | JSON、形式、または 3.2MB を超えるサイズ |
| 401 | missing_api_key | API キーがない |
| 401 | invalid_api_key | 無効、または失効 |
| 429 | rate_limited | 短時間の呼び出し上限。Retry-After が付くことがあります |
| 429 | quota_exceeded | 今月の画像枚数の上限 |
| 502 | upstream_error | 推論側の失敗。この呼び出しは月間枚数に含めません |
| 503 | service_unavailable | サービスが一時的に利用できません |
試用枠
- 会社ドメインの初期枠は月 100 枚。
- フリーメールの初期枠は月 20 枚。
- 枠はキー発行時にそのキーへ固定されます。集計は日本時間の暦月で、毎月1日 0:00 に戻ります。コンソールにはそのキーの上限と残り枚数を出します。
- レート制限は別で、既定 10 リクエスト / 60 秒です。
- 検証エラーと推論側の失敗は月間枚数に含めません。
- 上限に達すると、コンソールで会社名と業態を添えて引き上げを依頼できます。自動では増えません。
試用無料・正式価格は近日公開
データの取り扱い
画像は処理中のみメモリ上で扱い、ディスク・データベース・ログには保存しません。 画像のバイト列はログにも残しません。利用ログ(経路、枚数、結果、HTTP ステータス)は 90 日で削除します。画像と読み取り結果はそのログに入れません。