メインコンテンツへスキップ

はじめに

Image2Text は Ace Data Cloud が提供するキャプチャサービスで、画像キャプチャの認識を行います。Ace Data Cloud の統一 API を通じて、Python で Image2Text を素早く統合し、画像キャプチャ認識、Base64 入力、URL 入力などの機能を実現できます。

前提条件

  • Ace Data Cloud のアカウントを持ち、API トークンを取得していること
  • Python 3.7 以上の環境
  • requests ライブラリのインストール:pip install requests

基本的な使い方

Image2Text API のメインエンドポイントは以下です:
POST https://api.acedata.cloud/captcha/recognition/image2text
完全な Python コード例:
import requests

url = "https://api.acedata.cloud/captcha/recognition/image2text"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..."
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
YOUR_API_TOKEN は Ace Data Cloud プラットフォームで取得した実際のトークンに置き換えてください。

レスポンスの処理

呼び出しが成功すると、API は JSON 形式のデータを返します。HTTP ステータスコードを確認することを推奨します:
if response.status_code == 200:
    result = response.json()
    print("呼び出し成功:", result)
else:
    print(f"呼び出し失敗、ステータスコード: {response.status_code}")
    print(response.text)

応用的な使い方

非同期タスクをサポートする API では、コールバック URL を通じて結果を取得できます:
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# 結果はコールバック URL を通じてあなたのサーバーにプッシュされます

エラー処理

よくあるエラーコード:
ステータスコード説明
401認証失敗、API トークンを確認してください
403残高不足またはアクセス権限なし
429リクエスト頻度超過
500サーバー内部エラー

次のステップ