Integra la generació de descripcions de productes amb IA de The Gendai directament a les teves aplicacions i fluxos de treball. Obté la teva clau API
La nostra API REST et permet generar descripcions de productes professionals programàticament, facilitant l'automatització del teu procés de creació de contingut a escala.
Tant si estàs construint una plataforma de comerç electrònic, gestionant un catàleg de productes gran, o creant fluxos de treball automatitzats, la nostra API proporciona les mateixes capacitats d'IA potents disponibles a la nostra interfície web. Registra't gratuïtament
Necessites una clau API per utilitzar el nostre servei. Crea un compte gratuït per obtenir la teva clau API i començar a generar descripcions.
L'API de The Gendai és un servei RESTful que accepta sol·licituds JSON i retorna respostes JSON. Totes les sol·licituds han d'estar autenticades amb la teva clau API.
https://thegendai.com/api/v1
Inclou la teva clau API a la capçalera de la sol·licitud:
X-API-Key: your_api_key_here
Endpoint: POST /api/v1/generate-description
Envia una sol·licitud POST amb la informació del teu producte i preferències de generació:
{
"brand_description": "Creem productes ecològics premium que combinen sostenibilitat amb estil",
"audience": "Consumidors conscients del medi ambient que valoren la qualitat i la sostenibilitat",
"tone_voice": "Professional però accessible, emfatitzant qualitat i beneficis ambientals",
"specific_guidelines": "Sempre esmentar materials ecològics i beneficis de sostenibilitat",
"languages": ["english", "spanish", "french"],
"product": {
"id": "prod_123",
"name": "Ampolla d'aigua de bambú",
"description": "Ampolla d'aigua reutilitzable feta de bambú sostenible",
"category": "Ecològic",
"price": "24.99",
"image_url": "https://example.com/product-image.jpg"
}
}
{
"brand_description": "Creem productes ecològics premium que combinen sostenibilitat amb estil",
"audience": "Consumidors conscients del medi ambient que valoren la qualitat i la sostenibilitat",
"tone_voice": "Professional però accessible, emfatitzant qualitat i beneficis ambientals",
"languages": ["english", "spanish"],
"product": {
"id": "prod_123",
"name": "Ampolla d'aigua de bambú",
"category": "Ecològic",
"price": "24.99",
"image_b64": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
}
}
L'API suporta generació en més de 39 idiomes. Utilitza els codis d'idioma a la teva sol·licitud:
Les sol·licituds exitoses retornen un objecte JSON amb descripcions generades:
{
"success": true,
"data": {
"product_id": "prod_123",
"product_name": "Ampolla d'aigua de bambú",
"descriptions": {
"english": "Descobreix la hidratació sostenible amb la nostra ampolla d'aigua 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": "Ampolla d'aigua de bambú",
"description": "Ampolla d'aigua reutilitzable feta de bambú sostenible",
"category": "Ecològic",
"price": "24.99",
"image_url": "https://example.com/product-image.jpg"
},
"generation_settings": {
"brand_description": "Creem productes ecològics premium que combinen sostenibilitat amb estil",
"audience": "Consumidors conscients del medi ambient que valoren la qualitat i la sostenibilitat",
"tone_voice": "Professional però accessible, emfatitzant qualitat i beneficis ambientals",
"specific_guidelines": "Sempre esmentar materials ecològics i beneficis de sostenibilitat",
"languages": ["english", "spanish", "french"]
},
"generated_at": "2025-10-17 14:30:00"
}
}
Aquí tens exemples en llenguatges de programació populars:
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": "Creem productes ecològics premium que combinen sostenibilitat amb estil",
"audience": "Consumidors conscients del medi ambient que valoren la qualitat i la sostenibilitat",
"tone_voice": "Professional però accessible, emfatitzant qualitat i beneficis ambientals",
"languages": ["english", "spanish"],
"product": {
"name": "Ampolla d'aigua de bambú",
"category": "Ecològic",
"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": "Creem productes ecològics premium que combinen sostenibilitat amb estil",
"audience": "Consumidors conscients del medi ambient que valoren la qualitat i la sostenibilitat",
"tone_voice": "Professional però accessible, emfatitzant qualitat i beneficis ambientals",
"languages": ["english", "spanish"],
"product": {
"name": "Ampolla d'aigua de bambú",
"category": "Ecològic",
"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: 'Creem productes ecològics premium que combinen sostenibilitat amb estil',
audience: 'Consumidors conscients del medi ambient que valoren la qualitat i la sostenibilitat',
tone_voice: 'Professional però accessible, emfatitzant qualitat i beneficis ambientals',
languages: ['english', 'spanish'],
product: {
name: 'Ampolla d'aigua de bambú',
category: 'Ecològic',
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: 'Creem productes ecològics premium que combinen sostenibilitat amb estil',
audience: 'Consumidors conscients del medi ambient que valoren la qualitat i la sostenibilitat',
tone_voice: 'Professional però accessible, emfatitzant qualitat i beneficis ambientals',
languages: ['english', 'spanish'],
product: {
name: 'Ampolla d'aigua de bambú',
category: 'Ecològic',
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": "Creem productes ecològics premium que combinen sostenibilitat amb estil",
"audience": "Consumidors conscients del medi ambient que valoren la qualitat i la sostenibilitat",
"tone_voice": "Professional però accessible, emfatitzant qualitat i beneficis ambientals",
"languages": ["english", "spanish"],
"product": {
"name": "Ampolla d'aigua de bambú",
"category": "Ecològic",
"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": "Creem productes ecològics premium que combinen sostenibilitat amb estil",
"audience": "Consumidors conscients del medi ambient que valoren la qualitat i la sostenibilitat",
"tone_voice": "Professional però accessible, emfatitzant qualitat i beneficis ambientals",
"languages": ["english", "spanish"],
"product": {
"name": "Ampolla d'aigua de bambú",
"category": "Ecològic",
"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' => 'Creem productes ecològics premium que combinen sostenibilitat amb estil',
'audience' => 'Consumidors conscients del medi ambient que valoren la qualitat i la sostenibilitat',
'tone_voice' => 'Professional però accessible, emfatitzant qualitat i beneficis ambientals',
'languages' => ['english', 'spanish'],
'product' => [
'name' => 'Ampolla d'aigua de bambú',
'category' => 'Ecològic',
'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", "Creem productes ecològics premium que combinen sostenibilitat amb estil");
payload.put("audience", "Consumidors conscients del medi ambient que valoren la qualitat i la sostenibilitat");
payload.put("tone_voice", "Professional però accessible, emfatitzant qualitat i beneficis ambientals");
ArrayNode languages = mapper.createArrayNode();
languages.add("english");
languages.add("spanish");
payload.set("languages", languages);
ObjectNode product = mapper.createObjectNode();
product.put("name", "Ampolla d'aigua de bambú");
product.put("category", "Ecològic");
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": "Creem productes ecològics premium que combinen sostenibilitat amb estil",
"audience": "Consumidors conscients del medi ambient que valoren la qualitat i la sostenibilitat",
"tone_voice": "Professional però accessible, emfatitzant qualitat i beneficis ambientals",
"languages": ["english", "spanish"],
"product": {
"name": "Ampolla d'aigua de bambú",
"category": "Ecològic",
"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: 'Creem productes ecològics premium que combinen sostenibilitat amb estil',
audience: 'Consumidors conscients del medi ambient que valoren la qualitat i la sostenibilitat',
tone_voice: 'Professional però accessible, emfatitzant qualitat i beneficis ambientals',
languages: ['english', 'spanish'],
product: {
name: 'Ampolla d'aigua de bambú',
category: 'Ecològic',
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 = "Creem productes ecològics premium que combinen sostenibilitat amb estil",
audience = "Consumidors conscients del medi ambient que valoren la qualitat i la sostenibilitat",
tone_voice = "Professional però accessible, emfatitzant qualitat i beneficis ambientals",
languages = new[] { "english", "spanish" },
product = new
{
name = "Ampolla d'aigua de bambú",
category = "Ecològic",
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: "Creem productes ecològics premium que combinen sostenibilitat amb estil",
Audience: "Consumidors conscients del medi ambient que valoren la qualitat i la sostenibilitat",
ToneVoice: "Professional però accessible, emfatitzant qualitat i beneficis ambientals",
Languages: []string{"english", "spanish"},
Product: Product{
Name: "Ampolla d'aigua de bambú",
Category: "Ecològic",
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)
}
Aquest flux de treball N8N demostra com integrar l'API de The Gendai en els teus fluxos de treball d'automatització.
Copia aquest JSON i enganxa'l a N8N utilitzant "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": {}
}
Les sol·licituds API estan subjectes a límits de velocitat basats en el teu pla de compte. Els comptes gratuïts poden fer fins a 10 sol·licituds per dia.
Carrega fitxers CSV directament des de Shopify, PrestaShop, Magento, VTEX, WooCommerce, o qualsevol sistema. No cal format, no cal configuració tècnica—només resultats instantanis.
Aprèn com The gendai transforma el teu catàleg de productes en una màquina d'impulsar vendes que constantment supera les descripcions manual. Veu el nostre procés en acció.
La majoria de clients reporten millores mesurables en 2-3 setmanes. La nostra IA crea descripcions que immediatament aborden la psicologia del comprador i superen objeccions comunes de compra. L'impacte en vendes es fa visible tan aviat com reemplaces les teves descripcions existents amb el nostre text optimitzat per conversió.
Comença la teva prova gratuïta avui i monitora les teves analítiques—veuràs la diferència en el comportament dels visitants gairebé immediatament.
ChatGPT crea contingut genèric. The gendai crea text enfocat a vendes. La nostra IA està entrenada específicament en descripcions eCommerce d'alta conversió i entén psicologia del comprador, requisits SEO, i optimització de conversió. Analitzem les teves imatges i especificacions de productes per destacar punts de venda que les eines IA genèriques passen per alt.
Compara tu mateix—carrega el teu CSV i veu descripcions que realment persuadeixen els clients a comprar.
Absolutament. La nostra IA manté la veu de la teva marca mentre aplica principis de conversió provats. Cada descripció està creada per reflectir la proposta de valor única del teu producte i atraure les emocions i necessitats del teu client objectiu. La qualitat és consistent a través de tot el teu catàleg.
Prova la nostra qualitat sense risc—genera descripcions de mostra i veu com s'alineen amb els estàndards de la teva marca.
La teva prova gratuïta inclou 10 descripcions completes de productes en els idiomes que triïs, optimització SEO completa, i text enfocat a conversió. No cal targeta de crèdit, no hi ha límits de temps per provar els resultats. Pots mesurar el rendiment contra les teves descripcions actuals abans de comprometre't.
Comença immediatament—carrega el teu CSV i obté 10 descripcions que pots fer proves A/B contra el teu text actual.
La nostra IA analitza milers de descripcions d'alta conversió i aplica activadors psicològics provats que els escriptors manuals sovint passen per alt. Combinem anàlisi visual dels teus productes amb patrons de llenguatge optimitzats per conversió. El resultat és text que consistentment supera tant l'escriptura manual com les eines IA genèriques en proves de conversió.
Veu la diferència tu mateix—prova la nostra prova gratuïta i compara taxes de conversió amb les teves descripcions existents.
Uneix-te a centenars de botigues exitoses que ja converteixen més visitants en clients amb descripcions basades en IA que realment venen.
Comença gratis, veu resultats immediatament, escala quan estiguis llest.
Transforma les teves conversions—carrega el teu CSV i comença gratis ara!