Volver al inicio

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:

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.
API para el etiquetado automático de imágenes
  1. 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".
Claves de API para el etiquetado de fotos con IA
  1. 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

¿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:

Detalles del formato de imagen

Los formatos de imagen actualmente admitidos incluyen: JPG, JPEG, PNG, WebP. El tamaño máximo de la imagen es de 4MB.

Mejores Prácticas para el Etiquetado de Imágenes con IA

  • Alta Resolución: Use imágenes claras y de alta resolución para una mejor precisión de las etiquetas de foto con IA.
  • Buena Iluminación: Las imágenes bien iluminadas producen etiquetas y descripciones más precisas.
  • Sujeto Claro: Las imágenes con sujetos y objetos distintos generan etiquetas más relevantes.
  • Formatos Admitidos: Cíñase a los formatos admitidos (JPG, PNG, WebP) para obtener resultados óptimos.

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:

¡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!