Image Describer API ドキュメント - AI画像説明生成

概要

Image Describer API は、提供された画像とプロンプトに基づいて、正確、詳細、かつ洞察に満ちた画像の説明をインテリジェントに生成する強力な画像説明生成ツールです。このAI駆動型画像認識APIは、画像コンテンツを理解・分析し、プロンプトに応じて対応するテキスト説明を生成します。画像理解、画像分析、画像コンテンツ生成を含むさまざまなシナリオに広く適用でき、画像質問応答や画像からテキストへの変換を簡単に実装できます。

応用シナリオ

Image Describer API は、以下の分野で画像理解とコンテンツ生成を効率的に実行するのに役立ちます。

• データチャート分析: チャートデータを自動的に解釈し、統計分析レポートを生成します。
• アートワーク評価: アートワークの専門的な評価と解釈を提供します。
• ブログ記事生成: 画像に基づいて段落または記事全体を生成します。
• オブジェクト認識: 画像内のオブジェクトを識別し、オブジェクト名、属性、潜在的な用途などの詳細情報を提供します。
• 画像質問応答: 「写真には何が写っていますか？」や「この人は何をしていますか？」などの質問をすることで、画像コンテンツに関する詳細情報を取得します。
• 教育アプリケーション: 植物や動物の画像の識別、歴史的な写真の説明など、教育を支援します。
• Eコマース: 製品説明を自動的に生成し、製品情報の充実度を高めます。

APIキー

Image Describer API にアクセスするには、まず有効なAPIキーを取得する必要があります。このキーは、リクエストを認証し、APIへの安全なアクセスを保証するために使用されます。

APIキーの取得

1. APIキー管理ページにアクセス: システムにログインし、右上隅にあるユーザーアバターをクリックします。ドロップダウンメニューで、「APIの申請」をクリックして、APIキー管理ページを開きます。
2. 新しいキーを作成: 「新しいキーを作成」をクリックし、ポップアップダイアログにキーの名前を入力して、「作成」をクリックします。
3. キーをコピーして保存: キーは一度だけ完全に表示されることに注意してください。 コピーアイコンをクリックしてキーをクリップボードにコピーし、「確認」をクリックしてダイアログを閉じます。

重要: 他人と共有したり、ブラウザ、クライアント側コード、またはその他の安全でない場所に公開したりしないでください。不正アクセスを防ぐために、キーを安全に保管してください。

APIエンドポイント

POST https://api.imagedescriber.app/api/v1/generate_content

リクエストパラメータ

リクエストヘッダー

リクエストボディ

{
  "image": "data:image/jpeg;base64,{image_base64_data}",
  "prompt": "これは何の物体ですか？考えられる用途を説明してください。",
  "lang": "ja"
}

サポートされている言語

リクエスト例 (cURL)

curl --location 'https://api.imagedescriber.app/api/v1/generate_content' \
--header 'content-type: application/json' \
--header 'authorization: Bearer your_api_key' \
--data '{
    "image":"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQE...",
    "prompt":"これは何の物体ですか？考えられる用途を説明してください。",
    "lang":"ja"
}'

リクエスト例 (Python)

import requests
import base64

def image_to_base64(image_path):
  """画像をBase64エンコーディングに変換"""
  with open(image_path, "rb") as image_file:
    encoded_string = base64.b64encode(image_file.read()).decode("utf-8")
  return encoded_string

def generate_image_description(api_key, image_path, prompt, lang="ja"):
  """Image Describer APIを使用して画像の説明を生成"""
  url = "https://api.imagedescriber.app/api/v1/generate_content"
  headers = {
      "content-type": "application/json",
      "authorization": f"Bearer {api_key}"
  }
  
  image_base64_data = image_to_base64(image_path)
  payload = {
      "image": f"data:image/jpeg;base64,{image_base64_data}",
      "prompt": prompt,
      "lang": lang
  }

  response = requests.post(url, headers=headers, json=payload)

  if response.status_code == 200:
      result = response.json()
      print(result["data"]["content"])
  else:
    print(f"エラー: {response.status_code}")
    print(response.text)

# 使用例
api_key = "your_api_key"
image_path = "your_image.jpg"
prompt = "これは何の物体ですか？考えられる用途を説明してください。"

generate_image_description(api_key, image_path, prompt, lang="ja")

リクエスト例 (Next.js)

import fs from 'fs';

// サーバーサイドの実装
const buffer = await fs.readFileSync("/temp/test.jpg");
const base64Image = buffer.toString('base64');
const imageData = `data:image/jpeg;base64,${base64Image}`;

// クライアントサイドの実装
const file:File = /* inputまたはドロップイベントからのファイル */;
const arrayBuffer = await file.arrayBuffer();
const bytes = new Uint8Array(arrayBuffer);
const base64Image = btoa(String.fromCharCode.apply(null, bytes as any));
const imageData = `data:${file.type};base64,${base64Image}`;

const body = {
  "image": imageData,
  "prompt": "画像を詳細に説明してください",
  "lang": "ja"
};

const response = await fetch('https://api.imagedescriber.app/api/v1/generate_content', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer {your_api_key}'
    },
    body: JSON.stringify(body),
});

const result = await response.json();
console.log(result);

レスポンス

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

APIは、完全なレスポンスを単一のJSONオブジェクトで返すようになりました。dataオブジェクト内のcontentフィールドには、生成された画像の説明がMarkdown形式で含まれています。

{
  "code": 0,
  "message": "成功",
  "request_id": "一意のリクエストID文字列",
  "data": {
    "content": "Markdown形式で生成されたコンテンツ"
  }
}

リクエスト制限

サービスの安定性と公平性を確保するため、各APIキーは**1分あたり5リクエスト（1時間あたり300リクエスト）**に制限されています。この制限を超えるリクエストは、エラーコード1004で拒否されます。

クレジットシステム

• API呼び出しが成功するたびに、1クレジットが消費されます。
• セキュリティフィルターによってブロックされたコンテンツは、クレジットを消費しません。
• システムエラーはクレジットを消費しません。

クレジットを追加するには？

より多くのAPI呼び出しをサポートするために、クレジットチャージページにアクセスして、クレジットパッケージを購入できます。さまざまなユーザーのニーズを満たすために、さまざまなパッケージを提供しています。

エラー処理

次の表は、一般的なエラーコード、その意味、および解決策を示しています。

お問い合わせ

ご質問やご提案がございましたら、以下の方法でお気軽にお問い合わせください。

• メール: [email protected]
• テクニカルサポート: カスタマーサポートチーム

今すぐImage Describer APIの使用を開始し、画像理解の無限の可能性を解き放ちましょう！