Integra la generazione di descrizioni prodotti alimentata dall'AI di The Gendai direttamente nelle tue applicazioni e flussi di lavoro. Ottieni la tua chiave API
La nostra API REST ti permette di generare descrizioni prodotti professionali programmaticamente, facilitando l'automazione del tuo processo di creazione contenuti su larga scala.
Che tu stia costruendo una piattaforma e-commerce, gestendo un grande catalogo prodotti o creando flussi di lavoro automatizzati, la nostra API fornisce le stesse potenti capacità AI disponibili nella nostra interfaccia web. Registrati gratuitamente
Hai bisogno di una chiave API per utilizzare il nostro servizio. Crea un account gratuito per ottenere la tua chiave API e iniziare a generare descrizioni.
L'API di The Gendai è un servizio RESTful che accetta richieste JSON e restituisce risposte JSON. Tutte le richieste devono essere autenticate con la tua chiave API.
https://thegendai.com/api/v1
Includi la tua chiave API nell'header della richiesta:
X-API-Key: your_api_key_here
Endpoint: POST /api/v1/generate-description
Invia una richiesta POST con le informazioni del tuo prodotto e le preferenze di generazione:
{
"brand_description": "Creiamo prodotti eco-sostenibili premium che combinano sostenibilità con stile",
"audience": "Consumatori attenti all'ambiente che apprezzano qualità e sostenibilità",
"tone_voice": "Professionale ma accessibile, enfatizzando qualità e benefici ambientali",
"specific_guidelines": "Menziona sempre materiali eco-sostenibili e benefici della sostenibilità",
"languages": ["english", "spanish", "french"],
"product": {
"id": "prod_123",
"name": "Bottiglia d'acqua in bambù",
"description": "Bottiglia d'acqua riutilizzabile realizzata in bambù sostenibile",
"category": "Eco-sostenibile",
"price": "24.99",
"image_url": "https://example.com/product-image.jpg"
}
}
{
"brand_description": "Creiamo prodotti eco-sostenibili premium che combinano sostenibilità con stile",
"audience": "Consumatori attenti all'ambiente che apprezzano qualità e sostenibilità",
"tone_voice": "Professionale ma accessibile, enfatizzando qualità e benefici ambientali",
"languages": ["english", "spanish"],
"product": {
"id": "prod_123",
"name": "Bottiglia d'acqua in bambù",
"category": "Eco-sostenibile",
"price": "24.99",
"image_b64": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
}
}
L'API supporta la generazione in 39+ lingue. Usa i codici lingua nella tua richiesta:
Le richieste riuscite restituiscono un oggetto JSON con descrizioni generate:
{
"success": true,
"data": {
"product_id": "prod_123",
"product_name": "Bottiglia d'acqua in bambù",
"descriptions": {
"english": "Scopri l'idratazione sostenibile con la nostra bottiglia d'acqua in 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": "Bottiglia d'acqua in bambù",
"description": "Bottiglia d'acqua riutilizzabile realizzata in bambù sostenibile",
"category": "Eco-sostenibile",
"price": "24.99",
"image_url": "https://example.com/product-image.jpg"
},
"generation_settings": {
"brand_description": "Creiamo prodotti eco-sostenibili premium che combinano sostenibilità con stile",
"audience": "Consumatori attenti all'ambiente che apprezzano qualità e sostenibilità",
"tone_voice": "Professionale ma accessibile, enfatizzando qualità e benefici ambientali",
"specific_guidelines": "Menziona sempre materiali eco-sostenibili e benefici della sostenibilità",
"languages": ["english", "spanish", "french"]
},
"generated_at": "2025-10-17 14:30:00"
}
}
Ecco esempi nei linguaggi di programmazione più popolari:
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": "Creiamo prodotti eco-sostenibili premium che combinano sostenibilità con stile",
"audience": "Consumatori attenti all'ambiente che apprezzano qualità e sostenibilità",
"tone_voice": "Professionale ma accessibile, enfatizzando qualità e benefici ambientali",
"languages": ["english", "spanish"],
"product": {
"name": "Bottiglia d'acqua in bambù",
"category": "Eco-sostenibile",
"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": "Creiamo prodotti eco-sostenibili premium che combinano sostenibilità con stile",
"audience": "Consumatori attenti all'ambiente che apprezzano qualità e sostenibilità",
"tone_voice": "Professionale ma accessibile, enfatizzando qualità e benefici ambientali",
"languages": ["english", "spanish"],
"product": {
"name": "Bottiglia d'acqua in bambù",
"category": "Eco-sostenibile",
"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: 'Creiamo prodotti eco-sostenibili premium che combinano sostenibilità con stile',
audience: 'Consumatori attenti all'ambiente che apprezzano qualità e sostenibilità',
tone_voice: 'Professionale ma accessibile, enfatizzando qualità e benefici ambientali',
languages: ['english', 'spanish'],
product: {
name: 'Bottiglia d'acqua in bambù',
category: 'Eco-sostenibile',
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: 'Creiamo prodotti eco-sostenibili premium che combinano sostenibilità con stile',
audience: 'Consumatori attenti all'ambiente che apprezzano qualità e sostenibilità',
tone_voice: 'Professionale ma accessibile, enfatizzando qualità e benefici ambientali',
languages: ['english', 'spanish'],
product: {
name: 'Bottiglia d'acqua in bambù',
category: 'Eco-sostenibile',
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": "Creiamo prodotti eco-sostenibili premium che combinano sostenibilità con stile",
"audience": "Consumatori attenti all'ambiente che apprezzano qualità e sostenibilità",
"tone_voice": "Professionale ma accessibile, enfatizzando qualità e benefici ambientali",
"languages": ["english", "spanish"],
"product": {
"name": "Bottiglia d'acqua in bambù",
"category": "Eco-sostenibile",
"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": "Creiamo prodotti eco-sostenibili premium che combinano sostenibilità con stile",
"audience": "Consumatori attenti all'ambiente che apprezzano qualità e sostenibilità",
"tone_voice": "Professionale ma accessibile, enfatizzando qualità e benefici ambientali",
"languages": ["english", "spanish"],
"product": {
"name": "Bottiglia d'acqua in bambù",
"category": "Eco-sostenibile",
"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' => 'Creiamo prodotti eco-sostenibili premium che combinano sostenibilità con stile',
'audience' => 'Consumatori attenti all'ambiente che apprezzano qualità e sostenibilità',
'tone_voice' => 'Professionale ma accessibile, enfatizzando qualità e benefici ambientali',
'languages' => ['english', 'spanish'],
'product' => [
'name' => 'Bottiglia d'acqua in bambù',
'category' => 'Eco-sostenibile',
'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", "Creiamo prodotti eco-sostenibili premium che combinano sostenibilità con stile");
payload.put("audience", "Consumatori attenti all'ambiente che apprezzano qualità e sostenibilità");
payload.put("tone_voice", "Professionale ma accessibile, enfatizzando qualità e benefici ambientali");
ArrayNode languages = mapper.createArrayNode();
languages.add("english");
languages.add("spanish");
payload.set("languages", languages);
ObjectNode product = mapper.createObjectNode();
product.put("name", "Bottiglia d'acqua in bambù");
product.put("category", "Eco-sostenibile");
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": "Creiamo prodotti eco-sostenibili premium che combinano sostenibilità con stile",
"audience": "Consumatori attenti all'ambiente che apprezzano qualità e sostenibilità",
"tone_voice": "Professionale ma accessibile, enfatizzando qualità e benefici ambientali",
"languages": ["english", "spanish"],
"product": {
"name": "Bottiglia d'acqua in bambù",
"category": "Eco-sostenibile",
"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: 'Creiamo prodotti eco-sostenibili premium che combinano sostenibilità con stile',
audience: 'Consumatori attenti all'ambiente che apprezzano qualità e sostenibilità',
tone_voice: 'Professionale ma accessibile, enfatizzando qualità e benefici ambientali',
languages: ['english', 'spanish'],
product: {
name: 'Bottiglia d'acqua in bambù',
category: 'Eco-sostenibile',
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 = "Creiamo prodotti eco-sostenibili premium che combinano sostenibilità con stile",
audience = "Consumatori attenti all'ambiente che apprezzano qualità e sostenibilità",
tone_voice = "Professionale ma accessibile, enfatizzando qualità e benefici ambientali",
languages = new[] { "english", "spanish" },
product = new
{
name = "Bottiglia d'acqua in bambù",
category = "Eco-sostenibile",
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: "Creiamo prodotti eco-sostenibili premium che combinano sostenibilità con stile",
Audience: "Consumatori attenti all'ambiente che apprezzano qualità e sostenibilità",
ToneVoice: "Professionale ma accessibile, enfatizzando qualità e benefici ambientali",
Languages: []string{"english", "spanish"},
Product: Product{
Name: "Bottiglia d'acqua in bambù",
Category: "Eco-sostenibile",
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)
}
Questo workflow N8N dimostra come integrare l'API The Gendai nei tuoi workflow di automazione.
Copia questo JSON e incollalo in 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": {}
}
Le richieste API sono soggette a limiti di velocità basati sul tuo piano account. Gli account gratuiti possono effettuare fino a 10 richieste al giorno.
Carica file CSV direttamente da Shopify, PrestaShop, Magento, VTEX, WooCommerce, o qualsiasi sistema. Nessuna formattazione richiesta, nessuna configurazione tecnica—solo risultati istantanei.
Impara come The gendai trasforma il tuo catalogo prodotti in una macchina che guida vendite che costantemente supera le descrizioni manuali. Vedi il nostro processo in azione.
La maggior parte dei clienti riporta miglioramenti misurabili entro 2-3 settimane. La nostra AI crea descrizioni che affrontano immediatamente la psicologia dell'acquirente e superano obiezioni di acquisto comuni. L'impatto sulle vendite diventa visibile non appena sostituisci le tue descrizioni esistenti con il nostro testo ottimizzato per conversione.
Inizia la tua prova gratuita oggi e monitora le tue analytics—vedrai la differenza nel comportamento dei visitatori quasi immediatamente.
ChatGPT crea contenuto generico. The gendai crea testo focalizzato vendite. La nostra AI è specificamente addestrata su descrizioni eCommerce ad alta conversione e comprende psicologia acquirenti, requisiti SEO, e ottimizzazione conversione. Analizziamo le tue immagini prodotti e specifiche per evidenziare punti vendita che strumenti AI generici mancano.
Confronta tu stesso—carica il tuo CSV e vedi descrizioni che persuadono davvero i clienti ad acquistare.
Assolutamente. La nostra AI mantiene la voce del tuo brand applicando principi di conversione dimostrati. Ogni descrizione è creata per riflettere la proposta di valore unica del tuo prodotto e appellarsi alle emozioni e bisogni del tuo cliente target. La qualità è consistente attraverso tutto il tuo catalogo.
Testa la nostra qualità senza rischi—genera descrizioni campione e vedi come si allineano con gli standard del tuo brand.
La tua prova gratuita include 10 descrizioni prodotti complete nelle lingue che scegli, ottimizzazione SEO completa, e testo focalizzato conversione. Nessuna carta di credito richiesta, nessun limite di tempo per testare i risultati. Puoi misurare le performance contro le tue descrizioni attuali prima di impegnarti.
Inizia immediatamente—carica il tuo CSV e ottieni 10 descrizioni che puoi testare A/B contro il tuo testo attuale.
La nostra AI analizza migliaia di descrizioni ad alta conversione e applica trigger psicologici dimostrati che scrittori manuali spesso mancano. Combiniamo analisi visiva dei tuoi prodotti con pattern linguistici ottimizzati per conversione. Il risultato è testo che supera costantemente sia scrittura manuale che strumenti AI generici nei test di conversione.
Vedi la differenza tu stesso—prova la nostra prova gratuita e confronta tassi di conversione con le tue descrizioni esistenti.
Unisciti a centinaia di negozi di successo che già convertono più visitatori in clienti con descrizioni alimentate da AI che vendono davvero.
Inizia gratis, vedi risultati immediatamente, scala quando sei pronto.
Trasforma le tue conversioni—carica il tuo CSV e inizia gratis ora!