ホーム API/ツール API 文字認識

文字認識

    文字認識APIは、画像内の文字を読み取るWeb APIです。対象となる画像から文字や単語を抽出し、位置座標や認識精度を示すスコアも併せて得ることができます。

    API
    基本情報
    提供 : REST, SDK(Android™,iOS,Server side JAVA)
    • 審査 : アプリ審査
    利用条件 : あり※1

    ※1「ガイドライン(必読)」に記載の利用条件に予め同意していただく必要がございます。

    ご利用いただくためには「アカウント登録(無料)」が必要です。

    リファレンスを参照するAPI機能名を選択してください

    文章画像認識要求

    スキャナや画面キャプチャで取得した画像(文章画像)から文字領域と単語の取得を行います。
    手書き文字やデザインされた文字には対応していません。認識対応言語は日本語、英語です。

    文章画像認識要求は1つのAPIキーで1日あたり500回まで利用可能です。
    ※利用可能回数は予告無く変更される場合があります。あらかじめご了承ください。
    使用制限を超えた場合、翌日に自動で解除されるまでそのAPIキーで新たな文章画像認識要求リクエストを送信する事はできません。

    テクニカルガイドライン

    本機能の使用後に別途、レスポンスパラメータのjob/@idから認識結果を取得する必要があります。
    文章画像認識結果取得」をご参照ください。

    リクエストURL

    https://api.apigw.smt.docomo.ne.jp/characterRecognition/v1/document

    メソッド : POST
    文字コード : UTF-8

    リクエストヘッダ

    キー 必須 説明
    Content-Type 送信データのMIMEタイプは、下記を指定。
    multipart/form-data

    リクエストクエリパラメータ

    キー 必須 説明
    APIKEY APIにアクセスするアプリの認証に利用する。

    リクエストボディ(multipart/form-data形式)

    キー 必須 説明
    image 文字認識に用いる画像は、以下の条件を満たす画像のみ有効。
    ・JPEGまたはPNG形式の画像データ(透過PNGは対象外)
    ・幅および高さ4096ピクセル以内
    ・推奨文字サイズは縦横サイズ32ピクセル以上
    lang - 認識する言語は、下記のいずれかを指定。
    jpn (省略時)
    eng

    レスポンスヘッダ

    キー 必須 説明
    Content-type - 受信データのMIMEタイプは、下記を返却。
    application/json

    レスポンスボディ(JSON形式)

    キー 必須 説明
    job - 認識ジョブ。
       @id - 認識ジョブの識別ID。
    サンプル値) 4A0485BB09AA43B7B3B600BA52570BC5
    @status - 認識ジョブの現在の状態は、下記のいずれかを返却。
    要求受付済 : queue
    認識処理中 : process
    処理成功 : success
    処理失敗 : failure
    削除済 : deleted
    @queue-time - リクエストの受付時刻(yyyy/mm/dd hh:mm:ss 形式)。
    サンプル値) 2013/10/22 13:11:25
    message - メッセージ。
       @text - 進行状況に関する出力メッセージ。

    リクエストサンプル

    POST https://api.apigw.smt.docomo.ne.jp/characterRecognition/v1/document?APIKEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    
    Content-Type:multipart/form-data; boundary=----WebKitFormBoundaryhwZz6hhFHARN6wAB
    
    ------WebKitFormBoundaryhwZz6hhFHARN6wAB
    Content-Disposition: form-data; name="lang"
    
    jpn
    ------WebKitFormBoundaryhwZz6hhFHARN6wAB
    Content-Disposition: form-data; name="image"; filename="sample.png"
    Content-Type: image/png
    
    画像データ(binary)
    ------WebKitFormBoundaryhwZz6hhFHARN6wAB--
    

    レスポンスサンプル

    Content-Type: application/json
    
    {
        "job":{
            "@id":"4A0485BB09AA43B7B3B600BA52570BC5",
            "@status":"queue",
            "@queue-time":"2013/10/22 13:11:25"
        },
        "message":null
    }
    
    よくあるご質問
    APIなどの各サービスに関するよくある質問を掲載します。
    お問い合わせ
    「docomo Developer support」及び「作ろうスマートフォン/iモードコンテンツ」に関するお問い合わせです。よくあるご質問や技術ブログで解決しない場合は、お問い合わせください。