Documentación de la API de Etiquetado de Imágenes con IA - Clasificación y Etiquetado Inteligente de Fotos

Descripción General

La API de Etiquetado de Imágenes con IA es un potente servicio de etiquetado de fotos con IA que genera automáticamente etiquetas, títulos y descripciones inteligentes para las imágenes. Esta API de etiquetado de imágenes aprovecha tecnologías avanzadas de visión por computadora y aprendizaje automático para analizar el contenido de la imagen y proporcionar una generación completa de metadatos. Es perfecta para flujos de trabajo de etiquetado automático de imágenes, gestión de contenidos y clasificación de fotos.

Escenarios de Aplicación

La API de Etiquetado de Imágenes con IA le permite implementar eficientemente el etiquetado de fotos con IA y la generación de metadatos en las siguientes áreas:

• Optimización SEO: Genere automáticamente etiquetas y descripciones relevantes para mejorar la visibilidad en la búsqueda de imágenes.
• Sistemas de Gestión de Contenidos: Agilice la organización de activos digitales con una categorización inteligente.
• Automatización de Redes Sociales: Etiquete automáticamente fotos para mejorar su descubrimiento y engagement.
• Gestión de Productos de E-commerce: Genere etiquetas y descripciones completas de productos para una mejor capacidad de búsqueda.
• Bibliotecas de Activos Digitales: Organice y clasifique grandes colecciones de imágenes con metadatos automatizados.
• Contenido de Blogs y Sitios Web: Mejore el SEO de las imágenes con texto alternativo y leyendas generados automáticamente.
• Integración en Aplicaciones Móviles: Añada capacidades de servicio de etiquetado de fotos inteligente a las aplicaciones móviles.

Claves de API

Para acceder a la API de Etiquetado de Imágenes con IA, primero debe obtener una clave de API válida. Esta clave se utiliza para autenticar sus solicitudes y garantizar un acceso seguro a la API.

Obtener una Clave de API

1. Acceda a la Página de Gestión de Claves de API: Inicie sesión en el sistema y haga clic en su avatar de usuario en la esquina superior derecha. En el menú desplegable, haga clic en "Solicitar API" para abrir la Página de Gestión de Claves de API.

2. Crear una Nueva Clave: Haga clic en "Crear nueva clave", introduzca un nombre para su clave en el diálogo emergente y luego haga clic en "Crear".

3. Copie y Guarde su Clave: Tenga en cuenta que la clave solo se mostrará en su totalidad una vez. Haga clic en el icono de copiar para copiar la clave a su portapapeles y luego haga clic en "Confirmar" para cerrar el diálogo.

Importante: No la comparta con otros ni la exponga en el navegador, en el código del lado del cliente o en cualquier otro lugar inseguro. Mantenga su clave a salvo para evitar accesos no autorizados.

Endpoint de la API

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

Parámetros de la Solicitud

Cabeceras de la Solicitud

Cuerpo de la Solicitud

La API de etiquetado de imágenes acepta la siguiente estructura de solicitud:

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

Idiomas Admitidos

Ejemplo de Solicitud (cURL)

curl --location 'https://api.imagedescriber.app/api/v1/generate_tags' \
--header 'content-type: application/json' \
--header 'authorization: Bearer su_clave_de_api' \
--data '{
    "image":"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQE...", 
    "lang":"es"
}'

Ejemplo de Solicitud (Python)

import requests
import base64

def image_to_base64(image_path):
    """Convierte una imagen a codificación 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="es"):
    """Genera etiquetas de imagen con IA usando la API de Etiquetado de Imágenes con IA"""
    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("Etiquetas generadas:", tags_data["tags"])
        print("Título:", tags_data["title"])
        print("Descripción:", tags_data["description"])
        print("Créditos restantes:", result["data"]["credits"]["remaining"])
    else:
        print(f"Error: {response.status_code}")
        print(response.text)

# Ejemplo de uso
api_key = "su_clave_de_api"
image_path = "su_imagen.jpg"

generate_image_tags(api_key, image_path)

Ejemplo de Solicitud (Next.js)

import fs from 'fs';

// Implementación del lado del servidor
const buffer = await fs.readFileSync("/temp/test.jpg");
const base64Image = buffer.toString('base64');
const imageData = `data:image/jpeg;base64,${base64Image}`;

// Implementación del lado del cliente
const file: File = /* archivo de un input o evento de arrastre */;
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": "es"
};

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

const result = await response.json();
console.log('Etiquetas generadas por IA:', result.data.tags.tags);
console.log('Título generado:', result.data.tags.title);
console.log('Descripción generada:', result.data.tags.description);

Respuesta

Cuerpo de la Respuesta (Respuesta JSON)

El servicio de etiquetado de fotos con IA devuelve una respuesta completa que contiene las etiquetas generadas, el título, la descripción y la información de créditos:

{
  "code": 0,
  "message": "éxito",
  "request_id": "cadena_de_id_de_solicitud_única",
  "data": {
    "tags": {
      "tags": [
        "etiqueta1",
        "etiqueta2",
        ...
      ],
      "title": "Título de imagen conciso y atractivo",
      "description": "Descripción detallada de la imagen"
    },
    "credits": {
      "amount": "créditos consumidos por esta llamada",
      "remaining": "créditos totales restantes después de esta llamada"
    }
  }
}

Límites de Solicitud

Para garantizar la estabilidad y equidad del servicio, cada clave de API está limitada a 5 solicitudes por minuto (300 solicitudes por hora). Las solicitudes que excedan este límite serán rechazadas con el código de error 1004.

Sistema de Créditos

• Cada llamada exitosa a la API de etiquetado automático de imágenes consume 1 crédito.
• El contenido bloqueado por el filtro de seguridad no consume créditos.
• Los errores del sistema no consumen créditos.

¿Cómo obtener más créditos?

Puede visitar la Página de Recarga de Créditos para comprar paquetes de créditos y admitir más llamadas a la API de etiquetado de fotos con IA. Ofrecemos varios paquetes para satisfacer las necesidades de diferentes usuarios.

Manejo de Errores

La siguiente tabla enumera los códigos de error comunes, sus significados y soluciones:

Casos de Uso y Ejemplos de Integración

Mejora del SEO

Use la API de etiquetado de imágenes para generar automáticamente texto alternativo y metadescripciones para las imágenes de su sitio web:

// Mejorar el SEO de la imagen con etiquetas generadas por IA
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;
  
  // Actualizar atributos de la imagen para SEO
  imageElement.alt = description;
  imageElement.title = title;
  imageElement.setAttribute('data-tags', tags.join(', '));
};

Integración con Gestión de Contenidos

Integre el etiquetado de fotos con IA en su flujo de trabajo de CMS:

# Procesar imágenes en lote en un sistema de gestión de contenidos
import os
import requests
from pathlib import Path

def bulk_tag_images(directory_path, api_key):
    """Procesa todas las imágenes en un directorio con etiquetado de IA"""
    image_extensions = ['.jpg', '.jpeg', '.png', '.webp']
    
    for image_path in Path(directory_path).iterdir():
        if image_path.suffix.lower() in image_extensions:
            try:
                # Generar etiquetas para cada imagen
                result = generate_image_tags(api_key, str(image_path))
                
                # Guardar metadatos en un archivo adjunto
                metadata_path = image_path.with_suffix('.json')
                with open(metadata_path, 'w') as f:
                    json.dump(result['data']['tags'], f, indent=2)
                    
                print(f"Procesado: {image_path.name}")
                
            except Exception as e:
                print(f"Error procesando {image_path.name}: {e}")

# Uso
bulk_tag_images("/ruta/a/imagenes", "su_clave_de_api")

Contáctenos

Si tiene alguna pregunta o sugerencia sobre nuestra API de Etiquetado de Imágenes con IA o nuestro servicio de etiquetado de fotos, no dude en contactarnos a través de los siguientes métodos:

• Correo electrónico: [email protected]
• Soporte Técnico: equipo de atención al cliente

¡Comience a usar la API de Etiquetado de Imágenes con IA ahora y libere el poder de la clasificación inteligente de fotos y el etiquetado automático de imágenes!