AI画像タグ付けAPIドキュメント - インテリジェントな写真タギングと分類

概要

AI画像タグ付けAPIは、画像に対してインテリジェントなタグ、タイトル、説明を自動生成する強力なAI写真タギングサービスです。この画像の自動タグ付けAPIは、高度なコンピュータビジョンと機械学習技術を活用して画像コンテンツを分析し、包括的なメタデータを生成します。自動画像タギング、コンテンツ管理、写真分類のワークフローに最適です。

利用シーン

AI画像タグ付けAPIは、以下の分野でAI写真タギングとメタデータ生成を効率的に実装することを可能にします。

SEO最適化: 関連性の高いタグと説明を自動生成し、画像検索での視認性を向上させます。
コンテンツ管理システム: インテリジェントなカテゴリ分類により、デジタル資産の整理を効率化します。
ソーシャルメディアの自動化: 写真に自動でタグを付け、発見されやすさとエンゲージメントを向上させます。
Eコマースの商品管理: 包括的な商品タグと説明を生成し、検索性を高めます。
デジタル資産ライブラリ: 自動化されたメタデータで、大規模な画像コレクションを整理・分類します。
ブログやウェブサイトのコンテンツ: 自動生成されるaltテキストとキャプションで、画像のSEOを強化します。
モバイルアプリへの統合: モバイルアプリケーションにインテリジェントな写真タギングサービス機能を追加します。

APIキー

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

APIキーの取得方法

APIキー管理ページへのアクセス: システムにログインし、右上隅のユーザーアバターをクリックします。ドロップダウンメニューで「APIを申請」をクリックして、APIキー管理ページを開きます。

新しいキーの作成: 「新しいキーを作成」をクリックし、ポップアップダイアログにキーの名前を入力してから、「作成」をクリックします。

キーのコピーと保管: キーは一度しか完全な形で表示されないことに注意してください。 コピーアイコンをクリックしてキーをクリップボードにコピーし、「確認」をクリックしてダイアログを閉じます。

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

APIエンドポイント

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

リクエストパラメータ

リクエストヘッダー

リクエストボディ

画像の自動タグ付けAPIは、以下のリクエスト構造を受け付けます。

{
  "image": "data:image/jpeg;base64,{image_base64_data}",
  "lang": "ja"
}

サポート言語

リクエスト例 (cURL)

curl --location 'https://api.imagedescriber.app/api/v1/generate_tags' \
--header 'content-type: application/json' \
--header 'authorization: Bearer あなたのAPIキー' \
--data '{
    "image":"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQE...", 
    "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_tags(api_key, image_path, lang="ja"):
    """AI画像タグ付けAPIを使用してAI画像タグを生成"""
    url = "https://api.imagedescriber.app/api/v1/generate_tags"
    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}",
        "lang": lang
    }

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

    if response.status_code == 200:
        result = response.json()
        tags_data = result["data"]["tags"]
        print("生成されたタグ:", tags_data["tags"])
        print("タイトル:", tags_data["title"])
        print("説明:", tags_data["description"])
        print("残りのクレジット:", result["data"]["credits"]["remaining"])
    else:
        print(f"エラー: {response.status_code}")
        print(response.text)

# 使用例
api_key = "あなたのAPIキー"
image_path = "あなたの画像.jpg"

generate_image_tags(api_key, image_path)

リクエスト例 (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,
  "lang": "ja"
};

const response = await fetch('https://api.imagedescriber.app/api/v1/generate_tags', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer {あなたのAPIキー}'
  },
  body: JSON.stringify(body),
});

const result = await response.json();
console.log('AIが生成したタグ:', result.data.tags.tags);
console.log('生成されたタイトル:', result.data.tags.title);
console.log('生成された説明:', result.data.tags.description);

レスポンス

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

AI写真タギングサービスは、生成されたタグ、タイトル、説明、クレジット情報を含む包括的なレスポンスを返します。

{
  "code": 0,
  "message": "成功",
  "request_id": "一意のリクエストID文字列",
  "data": {
    "tags": {
      "tags": [
        "タグ1",
        "タグ2",
        ...
      ],
      "title": "簡潔で魅力的な画像タイトル",
      "description": "画像の詳細な説明"
    },
    "credits": {
      "amount": "この呼び出しで消費されたクレジット",
      "remaining": "この呼び出し後の残りの合計クレジット"
    }
  }
}

リクエスト制限

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

クレジットシステム

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

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

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

エラー処理

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

画像形式の詳細

現在サポートされている画像形式は、JPG、JPEG、PNG、WebPです。最大画像サイズは4MBです。

AI画像タグ付けのベストプラクティス

高解像度: より正確なAI写真タグを得るために、鮮明で高解像度の画像を使用してください。
良好な照明: 明るい画像は、より正確なタグと説明を生成します。
明確な被写体: 被写体やオブジェクトがはっきりしている画像は、より関連性の高いタグを生成します。
サポートされている形式: 最適な結果を得るために、サポートされている形式（JPG、PNG、WebP）を使用してください。

ユースケースと統合例

SEO強化

画像の自動タグ付けAPIを使用して、ウェブサイトの画像のaltテキストとメタディスクリプションを自動生成します。

// AI生成タグで画像のSEOを強化
const enhanceImageSEO = async (imageElement, apiKey) => {
  const canvas = document.createElement('canvas');
  const ctx = canvas.getContext('2d');
  canvas.width = imageElement.width;
  canvas.height = imageElement.height;
  ctx.drawImage(imageElement, 0, 0);
  
  const base64Image = canvas.toDataURL('image/jpeg');
  
  const response = await fetch('/api/v1/generate_tags', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${apiKey}`
    },
    body: JSON.stringify({ image: base64Image })
  });
  
  const result = await response.json();
  const { tags, title, description } = result.data.tags;
  
  // SEOのために画像の属性を更新
  imageElement.alt = description;
  imageElement.title = title;
  imageElement.setAttribute('data-tags', tags.join(', '));
};

コンテンツ管理との統合

AI写真タギングをCMSワークフローに統合します。

# コンテンツ管理システムで画像をまとめて処理
import os
import requests
from pathlib import Path

def bulk_tag_images(directory_path, api_key):
    """ディレクトリ内のすべての画像をAIタギングで処理"""
    image_extensions = ['.jpg', '.jpeg', '.png', '.webp']
    
    for image_path in Path(directory_path).iterdir():
        if image_path.suffix.lower() in image_extensions:
            try:
                # 各画像にタグを生成
                result = generate_image_tags(api_key, str(image_path))
                
                # メタデータを付随ファイルに保存
                metadata_path = image_path.with_suffix('.json')
                with open(metadata_path, 'w') as f:
                    json.dump(result['data']['tags'], f, indent=2)
                    
                print(f"処理済み: {image_path.name}")
                
            except Exception as e:
                print(f"{image_path.name} の処理中にエラーが発生しました: {e}")

# 使用法
bulk_tag_images("/path/to/images", "あなたのAPIキー")

お問い合わせ

当社のAI画像タグ付けAPIまたは写真タギングサービスに関するご質問やご提案がございましたら、以下の方法でお気軽にお問い合わせください。

Eメール: support@imagedescriber.app
テクニカルサポート: カスタマーサポートチーム

今すぐAI画像タグ付けAPIを使い始めて、インテリジェントな写真分類と自動画像タギングの力を解き放ちましょう！