Integra la generación de descripciones de productos con IA de The Gendai directamente en tus aplicaciones y flujos de trabajo. Obtén tu clave API
Nuestra API REST te permite generar descripciones de productos profesionales programáticamente, facilitando la automatización de tu proceso de creación de contenido a escala.
Ya sea que estés construyendo una plataforma de comercio electrónico, gestionando un catálogo de productos grande, o creando flujos de trabajo automatizados, nuestra API proporciona las mismas capacidades de IA potentes disponibles en nuestra interfaz web. Regístrate gratis
Necesitas una clave API para usar nuestro servicio. Crea una cuenta gratuita para obtener tu clave API y comenzar a generar descripciones.
La API de The Gendai es un servicio RESTful que acepta solicitudes JSON y devuelve respuestas JSON. Todas las solicitudes deben estar autenticadas con tu clave API.
https://thegendai.com/api/v1
Incluye tu clave API en la cabecera de la solicitud:
X-API-Key: your_api_key_here
Endpoint: POST /api/v1/generate-description
Envía una solicitud POST con la información de tu producto y preferencias de generación:
{
"brand_description": "Creamos productos ecológicos premium que combinan sostenibilidad con estilo",
"audience": "Consumidores conscientes del medio ambiente que valoran la calidad y sostenibilidad",
"tone_voice": "Profesional pero accesible, enfatizando calidad y beneficios ambientales",
"specific_guidelines": "Siempre mencionar materiales ecológicos y beneficios de sostenibilidad",
"languages": ["english", "spanish", "french"],
"product": {
"id": "prod_123",
"name": "Botella de Agua de Bambú",
"description": "Botella de agua reutilizable hecha de bambú sostenible",
"category": "Ecológico",
"price": "24.99",
"image_url": "https://example.com/product-image.jpg"
}
}
{
"brand_description": "Creamos productos ecológicos premium que combinan sostenibilidad con estilo",
"audience": "Consumidores conscientes del medio ambiente que valoran la calidad y sostenibilidad",
"tone_voice": "Profesional pero accesible, enfatizando calidad y beneficios ambientales",
"languages": ["english", "spanish"],
"product": {
"id": "prod_123",
"name": "Botella de Agua de Bambú",
"category": "Ecológico",
"price": "24.99",
"image_b64": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
}
}
La API soporta generación en más de 39 idiomas. Usa los códigos de idioma en tu solicitud:
Las solicitudes exitosas devuelven un objeto JSON con descripciones generadas:
{
"success": true,
"data": {
"product_id": "prod_123",
"product_name": "Botella de Agua de Bambú",
"descriptions": {
"english": "Descubre la hidratación sostenible con nuestra Botella de Agua de Bambú premium...",
"spanish": "Descubre la hidratación sostenible con nuestra Botella de Agua de Bambú premium...",
"french": "Découvrez l'hydratation durable avec notre Bouteille d'Eau en Bambou premium..."
},
"original_product": {
"id": "prod_123",
"name": "Botella de Agua de Bambú",
"description": "Botella de agua reutilizable hecha de bambú sostenible",
"category": "Ecológico",
"price": "24.99",
"image_url": "https://example.com/product-image.jpg"
},
"generation_settings": {
"brand_description": "Creamos productos ecológicos premium que combinan sostenibilidad con estilo",
"audience": "Consumidores conscientes del medio ambiente que valoran la calidad y sostenibilidad",
"tone_voice": "Profesional pero accesible, enfatizando calidad y beneficios ambientales",
"specific_guidelines": "Siempre mencionar materiales ecológicos y beneficios de sostenibilidad",
"languages": ["english", "spanish", "french"]
},
"generated_at": "2025-10-17 14:30:00"
}
}
Aquí tienes ejemplos en lenguajes de programación populares:
curl -X POST "https://thegendai.com/api/v1/generate-description" \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key_here" \
-d '{
"brand_description": "Creamos productos ecológicos premium que combinan sostenibilidad con estilo",
"audience": "Consumidores conscientes del medio ambiente que valoran la calidad y sostenibilidad",
"tone_voice": "Profesional pero accesible, enfatizando calidad y beneficios ambientales",
"languages": ["english", "spanish"],
"product": {
"name": "Botella de Agua de Bambú",
"category": "Ecológico",
"price": "24.99",
"image_url": "https://example.com/product-image.jpg"
}
}'
curl -X POST "https://thegendai.com/api/v1/generate-description" \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key_here" \
-d '{
"brand_description": "Creamos productos ecológicos premium que combinan sostenibilidad con estilo",
"audience": "Consumidores conscientes del medio ambiente que valoran la calidad y sostenibilidad",
"tone_voice": "Profesional pero accesible, enfatizando calidad y beneficios ambientales",
"languages": ["english", "spanish"],
"product": {
"name": "Botella de Agua de Bambú",
"category": "Ecológico",
"price": "24.99",
"image_b64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
}
}'
const response = await fetch('https://thegendai.com/api/v1/generate-description', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'your_api_key_here'
},
body: JSON.stringify({
brand_description: 'Creamos productos ecológicos premium que combinan sostenibilidad con estilo',
audience: 'Consumidores conscientes del medio ambiente que valoran la calidad y sostenibilidad',
tone_voice: 'Profesional pero accesible, enfatizando calidad y beneficios ambientales',
languages: ['english', 'spanish'],
product: {
name: 'Botella de Agua de Bambú',
category: 'Ecológico',
price: '24.99',
image_url: 'https://example.com/product-image.jpg'
}
})
});
const data = await response.json();
console.log(data);
// Convert file to base64
function fileToBase64(file) {
return new Promise((resolve, reject) => {
const reader = new FileReader();
reader.readAsDataURL(file);
reader.onload = () => resolve(reader.result.split(',')[1]);
reader.onerror = error => reject(error);
});
}
// Usage with file input
const fileInput = document.getElementById('imageFile');
const file = fileInput.files[0];
const base64Image = await fileToBase64(file);
const response = await fetch('https://thegendai.com/api/v1/generate-description', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'your_api_key_here'
},
body: JSON.stringify({
brand_description: 'Creamos productos ecológicos premium que combinan sostenibilidad con estilo',
audience: 'Consumidores conscientes del medio ambiente que valoran la calidad y sostenibilidad',
tone_voice: 'Profesional pero accesible, enfatizando calidad y beneficios ambientales',
languages: ['english', 'spanish'],
product: {
name: 'Botella de Agua de Bambú',
category: 'Ecológico',
price: '24.99',
image_b64: base64Image
}
})
});
const data = await response.json();
console.log(data);
import requests
url = "https://thegendai.com/api/v1/generate-description"
headers = {
"Content-Type": "application/json",
"X-API-Key": "your_api_key_here"
}
data = {
"brand_description": "Creamos productos ecológicos premium que combinan sostenibilidad con estilo",
"audience": "Consumidores conscientes del medio ambiente que valoran la calidad y sostenibilidad",
"tone_voice": "Profesional pero accesible, enfatizando calidad y beneficios ambientales",
"languages": ["english", "spanish"],
"product": {
"name": "Botella de Agua de Bambú",
"category": "Ecológico",
"price": "24.99",
"image_url": "https://example.com/product-image.jpg"
}
}
response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
import requests
import base64
# Read and encode image file
def encode_image_to_base64(image_path):
with open(image_path, "rb") as image_file:
return base64.b64encode(image_file.read()).decode('utf-8')
url = "https://thegendai.com/api/v1/generate-description"
headers = {
"Content-Type": "application/json",
"X-API-Key": "your_api_key_here"
}
# Encode the image
image_b64 = encode_image_to_base64("path/to/your/image.jpg")
data = {
"brand_description": "Creamos productos ecológicos premium que combinan sostenibilidad con estilo",
"audience": "Consumidores conscientes del medio ambiente que valoran la calidad y sostenibilidad",
"tone_voice": "Profesional pero accesible, enfatizando calidad y beneficios ambientales",
"languages": ["english", "spanish"],
"product": {
"name": "Botella de Agua de Bambú",
"category": "Ecológico",
"price": "24.99",
"image_b64": image_b64
}
}
response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
<?php
$url = "https://thegendai.com/api/v1/generate-description";
$headers = [
'Content-Type: application/json',
'X-API-Key: your_api_key_here'
];
$data = [
'brand_description' => 'Creamos productos ecológicos premium que combinan sostenibilidad con estilo',
'audience' => 'Consumidores conscientes del medio ambiente que valoran la calidad y sostenibilidad',
'tone_voice' => 'Profesional pero accesible, enfatizando calidad y beneficios ambientales',
'languages' => ['english', 'spanish'],
'product' => [
'name' => 'Botella de Agua de Bambú',
'category' => 'Ecológico',
'price' => '24.99',
'image_url' => 'https://example.com/product-image.jpg'
]
];
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($httpCode === 200) {
$result = json_decode($response, true);
print_r($result);
} else {
echo "Error: " . $response;
}
?>
import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.node.ObjectNode;
import com.fasterxml.jackson.databind.node.ArrayNode;
public class TheGendaiAPIClient {
private static final String API_URL = "https://thegendai.com/api/v1/generate-description";
private static final String API_KEY = "your_api_key_here";
public static void main(String[] args) throws IOException, InterruptedException {
HttpClient client = HttpClient.newHttpClient();
ObjectMapper mapper = new ObjectMapper();
// Create request payload
ObjectNode payload = mapper.createObjectNode();
payload.put("brand_description", "Creamos productos ecológicos premium que combinan sostenibilidad con estilo");
payload.put("audience", "Consumidores conscientes del medio ambiente que valoran la calidad y sostenibilidad");
payload.put("tone_voice", "Profesional pero accesible, enfatizando calidad y beneficios ambientales");
ArrayNode languages = mapper.createArrayNode();
languages.add("english");
languages.add("spanish");
payload.set("languages", languages);
ObjectNode product = mapper.createObjectNode();
product.put("name", "Botella de Agua de Bambú");
product.put("category", "Ecológico");
product.put("price", "24.99");
product.put("image_url", "https://example.com/product-image.jpg");
payload.set("product", product);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(API_URL))
.header("Content-Type", "application/json")
.header("X-API-Key", API_KEY)
.POST(HttpRequest.BodyPublishers.ofString(mapper.writeValueAsString(payload)))
.build();
HttpResponse<String> response = client.send(request,
HttpResponse.BodyHandlers.ofString());
if (response.statusCode() == 200) {
System.out.println("Success: " + response.body());
} else {
System.err.println("Error: " + response.body());
}
}
}
#!/bin/bash
# Configuration
API_URL="https://thegendai.com/api/v1/generate-description"
API_KEY="your_api_key_here"
# JSON payload
PAYLOAD='{
"brand_description": "Creamos productos ecológicos premium que combinan sostenibilidad con estilo",
"audience": "Consumidores conscientes del medio ambiente que valoran la calidad y sostenibilidad",
"tone_voice": "Profesional pero accesible, enfatizando calidad y beneficios ambientales",
"languages": ["english", "spanish"],
"product": {
"name": "Botella de Agua de Bambú",
"category": "Ecológico",
"price": "24.99",
"image_url": "https://example.com/product-image.jpg"
}
}'
# Make the API request
response=$(curl -s -w "HTTPSTATUS:%{http_code}" \
-X POST "$API_URL" \
-H "Content-Type: application/json" \
-H "X-API-Key: $API_KEY" \
-d "$PAYLOAD")
# Extract HTTP status code and body
http_code=$(echo "$response" | tr -d '\n' | sed -e 's/.*HTTPSTATUS://')
body=$(echo "$response" | sed -e 's/HTTPSTATUS\:.*//g')
# Check response
if [ "$http_code" -eq 200 ]; then
echo "Success:"
echo "$body" | jq '.'
else
echo "Error (HTTP $http_code):"
echo "$body"
fi
require 'net/http'
require 'json'
require 'uri'
class TheGendaiAPIClient
API_URL = "https://thegendai.com/api/v1/generate-description"
def initialize(api_key)
@api_key = api_key
end
def generate_description(brand_description:, audience:, tone_voice:, languages:, product:)
uri = URI(API_URL)
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true if uri.scheme == 'https'
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['X-API-Key'] = @api_key
payload = {
brand_description: brand_description,
audience: audience,
tone_voice: tone_voice,
languages: languages,
product: product
}
request.body = payload.to_json
response = http.request(request)
case response.code.to_i
when 200
JSON.parse(response.body)
else
raise "API Error (#{response.code}): #{response.body}"
end
end
end
# Usage example
client = TheGendaiAPIClient.new('your_api_key_here')
begin
result = client.generate_description(
brand_description: 'Creamos productos ecológicos premium que combinan sostenibilidad con estilo',
audience: 'Consumidores conscientes del medio ambiente que valoran la calidad y sostenibilidad',
tone_voice: 'Profesional pero accesible, enfatizando calidad y beneficios ambientales',
languages: ['english', 'spanish'],
product: {
name: 'Botella de Agua de Bambú',
category: 'Ecológico',
price: '24.99',
image_url: 'https://example.com/product-image.jpg'
}
)
puts "Success: #{result}"
rescue => e
puts "Error: #{e.message}"
end
using System;
using System.Net.Http;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;
public class TheGendaiApiClient
{
private readonly HttpClient _httpClient;
private readonly string _apiKey;
private const string ApiUrl = "https://thegendai.com/api/v1/generate-description";
public TheGendaiApiClient(string apiKey)
{
_apiKey = apiKey;
_httpClient = new HttpClient();
_httpClient.DefaultRequestHeaders.Add("X-API-Key", _apiKey);
}
public async Task<string> GenerateDescriptionAsync()
{
var payload = new
{
brand_description = "Creamos productos ecológicos premium que combinan sostenibilidad con estilo",
audience = "Consumidores conscientes del medio ambiente que valoran la calidad y sostenibilidad",
tone_voice = "Profesional pero accesible, enfatizando calidad y beneficios ambientales",
languages = new[] { "english", "spanish" },
product = new
{
name = "Botella de Agua de Bambú",
category = "Ecológico",
price = "24.99",
image_url = "https://example.com/product-image.jpg"
}
};
var jsonContent = JsonSerializer.Serialize(payload);
var content = new StringContent(jsonContent, Encoding.UTF8, "application/json");
try
{
var response = await _httpClient.PostAsync(ApiUrl, content);
if (response.IsSuccessStatusCode)
{
return await response.Content.ReadAsStringAsync();
}
else
{
var errorContent = await response.Content.ReadAsStringAsync();
throw new Exception($"API Error ({response.StatusCode}): {errorContent}");
}
}
catch (HttpRequestException ex)
{
throw new Exception($"Request failed: {ex.Message}");
}
}
public void Dispose()
{
_httpClient?.Dispose();
}
}
// Usage example
class Program
{
static async Task Main(string[] args)
{
var client = new TheGendaiApiClient("your_api_key_here");
try
{
string result = await client.GenerateDescriptionAsync();
Console.WriteLine($"Success: {result}");
}
catch (Exception ex)
{
Console.WriteLine($"Error: {ex.Message}");
}
finally
{
client.Dispose();
}
}
}
package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
)
type Product struct {
Name string `json:"name"`
Category string `json:"category"`
Price string `json:"price"`
ImageURL string `json:"image_url"`
}
type APIRequest struct {
BrandDescription string `json:"brand_description"`
Audience string `json:"audience"`
ToneVoice string `json:"tone_voice"`
Languages []string `json:"languages"`
Product Product `json:"product"`
}
type APIResponse struct {
Success bool `json:"success"`
Data interface{} `json:"data"`
Error string `json:"error,omitempty"`
}
func generateDescription(apiKey string) (*APIResponse, error) {
const apiURL = "https://thegendai.com/api/v1/generate-description"
// Create request payload
reqData := APIRequest{
BrandDescription: "Creamos productos ecológicos premium que combinan sostenibilidad con estilo",
Audience: "Consumidores conscientes del medio ambiente que valoran la calidad y sostenibilidad",
ToneVoice: "Profesional pero accesible, enfatizando calidad y beneficios ambientales",
Languages: []string{"english", "spanish"},
Product: Product{
Name: "Botella de Agua de Bambú",
Category: "Ecológico",
Price: "24.99",
ImageURL: "https://example.com/product-image.jpg",
},
}
// Marshal to JSON
jsonData, err := json.Marshal(reqData)
if err != nil {
return nil, fmt.Errorf("failed to marshal request: %w", err)
}
// Create HTTP request
req, err := http.NewRequest("POST", apiURL, bytes.NewBuffer(jsonData))
if err != nil {
return nil, fmt.Errorf("failed to create request: %w", err)
}
// Set headers
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-API-Key", apiKey)
// Make request
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
return nil, fmt.Errorf("failed to make request: %w", err)
}
defer resp.Body.Close()
// Read response
body, err := io.ReadAll(resp.Body)
if err != nil {
return nil, fmt.Errorf("failed to read response: %w", err)
}
// Parse response
var apiResp APIResponse
if err := json.Unmarshal(body, &apiResp); err != nil {
return nil, fmt.Errorf("failed to parse response: %w", err)
}
if resp.StatusCode != 200 {
return nil, fmt.Errorf("API error (%d): %s", resp.StatusCode, apiResp.Error)
}
return &apiResp, nil
}
func main() {
apiKey := "your_api_key_here"
result, err := generateDescription(apiKey)
if err != nil {
fmt.Printf("Error: %v\n", err)
return
}
fmt.Printf("Success: %+v\n", result)
}
Este flujo de trabajo N8N demuestra cómo integrar la API de The Gendai en tus flujos de trabajo de automatización.
Copia este JSON y pégalo en N8N usando "Import from Clipboard":
@__raw_block_0__{{ url('/') }}/api/v1/generate-description",
"sendHeaders": true,
"headerParameters": {
"parameters": [
{
"name": "Content-Type",
"value": "application/json"
},
{
"name": "X-API-Key",
"value": "YOUR_API_KEY_HERE"
}
]
},
"sendBody": true,
"jsonBody": "={{ $json.api_payload }}",
"options": {}
},
"id": "api-call",
"name": "Generate Descriptions",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4.2,
"position": [900, 300]
}
],
"connections": {
"Manual Trigger": {
"main": [
[
{
"node": "Set Brand Info",
"type": "main",
"index": 0
}
]
]
},
"Set Brand Info": {
"main": [
[
{
"node": "Prepare API Call",
"type": "main",
"index": 0
}
]
]
},
"Prepare API Call": {
"main": [
[
{
"node": "Generate Descriptions",
"type": "main",
"index": 0
}
]
]
}
},
"pinData": {}
}
Las solicitudes API están sujetas a límites de velocidad basados en tu plan de cuenta. Las cuentas gratuitas pueden hacer hasta 10 solicitudes por día.
Sube archivos CSV directamente desde Shopify, PrestaShop, Magento, VTEX, WooCommerce, o cualquier sistema. No requiere formato, no requiere configuración técnica—solo resultados instantáneos.
Aprende cómo The gendai transforma tu catálogo de productos en una máquina de impulsar ventas que constantemente supera las descripciones manuales. Ve nuestro proceso en acción.
La mayoría de clientes reportan mejoras medibles en 2-3 semanas. Nuestra IA crea descripciones que inmediatamente abordan la psicología del comprador y superan objeciones comunes de compra. El impacto en ventas se hace visible tan pronto como reemplazas tus descripciones existentes con nuestro texto optimizado para conversión.
Comienza tu prueba gratuita hoy y monitorea tus analíticas—verás la diferencia en el comportamiento de los visitantes casi inmediatamente.
ChatGPT crea contenido genérico. The gendai crea texto enfocado a ventas. Nuestra IA está entrenada específicamente en descripciones eCommerce de alta conversión y entiende psicología del comprador, requisitos SEO, y optimización de conversión. Analizamos tus imágenes y especificaciones de productos para destacar puntos de venta que las herramientas IA genéricas pasan por alto.
Compara tú mismo—sube tu CSV y ve descripciones que realmente persuaden a los clientes a comprar.
Absolutamente. Nuestra IA mantiene la voz de tu marca mientras aplica principios de conversión probados. Cada descripción está creada para reflejar la propuesta de valor única de tu producto y atraer las emociones y necesidades de tu cliente objetivo. La calidad es consistente a través de todo tu catálogo.
Prueba nuestra calidad sin riesgo—genera descripciones de muestra y ve cómo se alinean con los estándares de tu marca.
Tu prueba gratuita incluye 10 descripciones completas de productos en los idiomas que elijas, optimización SEO completa, y texto enfocado a conversión. No requiere tarjeta de crédito, no hay límites de tiempo para probar los resultados. Puedes medir el rendimiento contra tus descripciones actuales antes de comprometerte.
Comienza inmediatamente—sube tu CSV y obtén 10 descripciones que puedes probar A/B contra tu texto actual.
Nuestra IA analiza miles de descripciones de alta conversión y aplica activadores psicológicos probados que los escritores manuales a menudo pasan por alto. Combinamos análisis visual de tus productos con patrones de lenguaje optimizados para conversión. El resultado es texto que consistentemente supera tanto la escritura manual como las herramientas IA genéricas en pruebas de conversión.
Ve la diferencia tú mismo—prueba nuestra prueba gratuita y compara tasas de conversión con tus descripciones existentes.
Únete a cientos de tiendas exitosas que ya convierten más visitantes en clientes con descripciones basadas en IA que realmente venden.
Comienza gratis, ve resultados inmediatamente, escala cuando estés listo.
¡Transforma tus conversiones—sube tu CSV y comienza gratis ahora!