Intégrez la génération de descriptions de produits alimentée par l'IA de The Gendai directement dans vos applications et flux de travail. Obtenez votre clé API
Notre API REST vous permet de générer des descriptions de produits professionnelles par programmation, facilitant l'automatisation de votre processus de création de contenu à grande échelle.
Que vous construisiez une plateforme e-commerce, gériez un vaste catalogue de produits ou créiez des flux de travail automatisés, notre API fournit les mêmes capacités d'IA puissantes disponibles dans notre interface web. Inscrivez-vous gratuitement
Vous avez besoin d'une clé API pour utiliser notre service. Créez un compte gratuit pour obtenir votre clé API et commencer à générer des descriptions.
L'API The Gendai est un service RESTful qui accepte les requêtes JSON et retourne des réponses JSON. Toutes les requêtes doivent être authentifiées avec votre clé API.
https://thegendai.com/api/v1
Incluez votre clé API dans l'en-tête de la requête :
X-API-Key: your_api_key_here
Point de terminaison: POST /api/v1/generate-description
Envoyez une requête POST avec les informations de votre produit et les préférences de génération :
{
"brand_description": "Nous créons des produits éco-responsables premium qui allient durabilité et style",
"audience": "Consommateurs soucieux de l'environnement qui valorisent la qualité et la durabilité",
"tone_voice": "Professionnel mais accessible, mettant l'accent sur la qualité et les bénéfices environnementaux",
"specific_guidelines": "Toujours mentionner les matériaux éco-responsables et les bénéfices de durabilité",
"languages": ["english", "spanish", "french"],
"product": {
"id": "prod_123",
"name": "Bouteille d'eau en bambou",
"description": "Bouteille d'eau réutilisable fabriquée en bambou durable",
"category": "Éco-responsable",
"price": "24.99",
"image_url": "https://example.com/product-image.jpg"
}
}
{
"brand_description": "Nous créons des produits éco-responsables premium qui allient durabilité et style",
"audience": "Consommateurs soucieux de l'environnement qui valorisent la qualité et la durabilité",
"tone_voice": "Professionnel mais accessible, mettant l'accent sur la qualité et les bénéfices environnementaux",
"languages": ["english", "spanish"],
"product": {
"id": "prod_123",
"name": "Bouteille d'eau en bambou",
"category": "Éco-responsable",
"price": "24.99",
"image_b64": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
}
}
L'API supporte la génération en 39+ langues. Utilisez les codes de langue dans votre requête :
Les requêtes réussies retournent un objet JSON avec les descriptions générées :
{
"success": true,
"data": {
"product_id": "prod_123",
"product_name": "Bouteille d'eau en bambou",
"descriptions": {
"english": "Découvrez l'hydratation durable avec notre bouteille d'eau en bambou 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": "Bouteille d'eau en bambou",
"description": "Bouteille d'eau réutilisable fabriquée en bambou durable",
"category": "Éco-responsable",
"price": "24.99",
"image_url": "https://example.com/product-image.jpg"
},
"generation_settings": {
"brand_description": "Nous créons des produits éco-responsables premium qui allient durabilité et style",
"audience": "Consommateurs soucieux de l'environnement qui valorisent la qualité et la durabilité",
"tone_voice": "Professionnel mais accessible, mettant l'accent sur la qualité et les bénéfices environnementaux",
"specific_guidelines": "Toujours mentionner les matériaux éco-responsables et les bénéfices de durabilité",
"languages": ["english", "spanish", "french"]
},
"generated_at": "2025-10-17 14:30:00"
}
}
Voici des exemples dans des langages de programmation populaires :
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": "Nous créons des produits éco-responsables premium qui allient durabilité et style",
"audience": "Consommateurs soucieux de l'environnement qui valorisent la qualité et la durabilité",
"tone_voice": "Professionnel mais accessible, mettant l'accent sur la qualité et les bénéfices environnementaux",
"languages": ["english", "spanish"],
"product": {
"name": "Bouteille d'eau en bambou",
"category": "Éco-responsable",
"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": "Nous créons des produits éco-responsables premium qui allient durabilité et style",
"audience": "Consommateurs soucieux de l'environnement qui valorisent la qualité et la durabilité",
"tone_voice": "Professionnel mais accessible, mettant l'accent sur la qualité et les bénéfices environnementaux",
"languages": ["english", "spanish"],
"product": {
"name": "Bouteille d'eau en bambou",
"category": "Éco-responsable",
"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: 'Nous créons des produits éco-responsables premium qui allient durabilité et style',
audience: 'Consommateurs soucieux de l'environnement qui valorisent la qualité et la durabilité',
tone_voice: 'Professionnel mais accessible, mettant l'accent sur la qualité et les bénéfices environnementaux',
languages: ['english', 'spanish'],
product: {
name: 'Bouteille d'eau en bambou',
category: 'Éco-responsable',
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: 'Nous créons des produits éco-responsables premium qui allient durabilité et style',
audience: 'Consommateurs soucieux de l'environnement qui valorisent la qualité et la durabilité',
tone_voice: 'Professionnel mais accessible, mettant l'accent sur la qualité et les bénéfices environnementaux',
languages: ['english', 'spanish'],
product: {
name: 'Bouteille d'eau en bambou',
category: 'Éco-responsable',
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": "Nous créons des produits éco-responsables premium qui allient durabilité et style",
"audience": "Consommateurs soucieux de l'environnement qui valorisent la qualité et la durabilité",
"tone_voice": "Professionnel mais accessible, mettant l'accent sur la qualité et les bénéfices environnementaux",
"languages": ["english", "spanish"],
"product": {
"name": "Bouteille d'eau en bambou",
"category": "Éco-responsable",
"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": "Nous créons des produits éco-responsables premium qui allient durabilité et style",
"audience": "Consommateurs soucieux de l'environnement qui valorisent la qualité et la durabilité",
"tone_voice": "Professionnel mais accessible, mettant l'accent sur la qualité et les bénéfices environnementaux",
"languages": ["english", "spanish"],
"product": {
"name": "Bouteille d'eau en bambou",
"category": "Éco-responsable",
"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' => 'Nous créons des produits éco-responsables premium qui allient durabilité et style',
'audience' => 'Consommateurs soucieux de l'environnement qui valorisent la qualité et la durabilité',
'tone_voice' => 'Professionnel mais accessible, mettant l'accent sur la qualité et les bénéfices environnementaux',
'languages' => ['english', 'spanish'],
'product' => [
'name' => 'Bouteille d'eau en bambou',
'category' => 'Éco-responsable',
'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", "Nous créons des produits éco-responsables premium qui allient durabilité et style");
payload.put("audience", "Consommateurs soucieux de l'environnement qui valorisent la qualité et la durabilité");
payload.put("tone_voice", "Professionnel mais accessible, mettant l'accent sur la qualité et les bénéfices environnementaux");
ArrayNode languages = mapper.createArrayNode();
languages.add("english");
languages.add("spanish");
payload.set("languages", languages);
ObjectNode product = mapper.createObjectNode();
product.put("name", "Bouteille d'eau en bambou");
product.put("category", "Éco-responsable");
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": "Nous créons des produits éco-responsables premium qui allient durabilité et style",
"audience": "Consommateurs soucieux de l'environnement qui valorisent la qualité et la durabilité",
"tone_voice": "Professionnel mais accessible, mettant l'accent sur la qualité et les bénéfices environnementaux",
"languages": ["english", "spanish"],
"product": {
"name": "Bouteille d'eau en bambou",
"category": "Éco-responsable",
"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: 'Nous créons des produits éco-responsables premium qui allient durabilité et style',
audience: 'Consommateurs soucieux de l'environnement qui valorisent la qualité et la durabilité',
tone_voice: 'Professionnel mais accessible, mettant l'accent sur la qualité et les bénéfices environnementaux',
languages: ['english', 'spanish'],
product: {
name: 'Bouteille d'eau en bambou',
category: 'Éco-responsable',
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 = "Nous créons des produits éco-responsables premium qui allient durabilité et style",
audience = "Consommateurs soucieux de l'environnement qui valorisent la qualité et la durabilité",
tone_voice = "Professionnel mais accessible, mettant l'accent sur la qualité et les bénéfices environnementaux",
languages = new[] { "english", "spanish" },
product = new
{
name = "Bouteille d'eau en bambou",
category = "Éco-responsable",
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: "Nous créons des produits éco-responsables premium qui allient durabilité et style",
Audience: "Consommateurs soucieux de l'environnement qui valorisent la qualité et la durabilité",
ToneVoice: "Professionnel mais accessible, mettant l'accent sur la qualité et les bénéfices environnementaux",
Languages: []string{"english", "spanish"},
Product: Product{
Name: "Bouteille d'eau en bambou",
Category: "Éco-responsable",
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)
}
Ce flux de travail N8N démontre comment intégrer l'API The Gendai dans vos flux de travail d'automatisation.
Copiez ce JSON et collez-le dans N8N en utilisant "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 requêtes API sont soumises à des limites de débit basées sur votre plan de compte. Les comptes gratuits peuvent effectuer jusqu'à 10 requêtes par jour.
Téléchargez des fichiers CSV directement depuis Shopify, PrestaShop, Magento, VTEX, WooCommerce, ou n'importe quel système. Aucun formatage requis, aucune configuration technique—juste des résultats instantanés.
Apprenez comment The gendai transforme votre catalogue de produits en une machine à stimuler les ventes qui surpasse constamment les descriptions manuelles. Voyez notre processus en action.
La plupart des clients rapportent des améliorations mesurables dans les 2-3 semaines. Notre IA crée des descriptions qui s'attaquent immédiatement à la psychologie de l'acheteur et surmontent les objections d'achat communes. L'impact sur les ventes devient visible dès que vous remplacez vos descriptions existantes par notre texte optimisé pour conversion.
Commencez votre essai gratuit aujourd'hui et surveillez vos analyses—vous verrez la différence dans le comportement des visiteurs presque immédiatement.
ChatGPT crée du contenu générique. The gendai crée du texte axé ventes. Notre IA est spécifiquement entraînée sur des descriptions eCommerce haute conversion et comprend la psychologie de l'acheteur, les exigences SEO, et l'optimisation de conversion. Nous analysons vos images et spécifications de produits pour mettre en évidence les points de vente que les outils IA génériques manquent.
Comparez par vous-même—téléchargez votre CSV et voyez des descriptions qui persuadent vraiment les clients d'acheter.
Absolument. Notre IA maintient votre voix de marque tout en appliquant des principes de conversion prouvés. Chaque description est conçue pour refléter la proposition de valeur unique de votre produit et faire appel aux émotions et besoins de votre client cible. La qualité est cohérente à travers tout votre catalogue.
Testez notre qualité sans risque—générez des descriptions d'échantillon et voyez comment elles s'alignent avec vos standards de marque.
Votre essai gratuit inclut 10 descriptions complètes de produits dans vos langues choisies, optimisation SEO complète, et texte axé conversion. Aucune carte de crédit requise, aucune limite de temps pour tester les résultats. Vous pouvez mesurer la performance contre vos descriptions actuelles avant de vous engager.
Commencez immédiatement—téléchargez votre CSV et obtenez 10 descriptions que vous pouvez tester A/B contre votre texte actuel.
Notre IA analyse des milliers de descriptions haute conversion et applique des déclencheurs psychologiques prouvés que les rédacteurs manuels manquent souvent. Nous combinons l'analyse visuelle de vos produits avec des modèles de langage optimisés pour conversion. Le résultat est un texte qui surpasse constamment à la fois l'écriture manuelle et les outils IA génériques dans les tests de conversion.
Voyez la différence par vous-même—essayez notre essai gratuit et comparez les taux de conversion avec vos descriptions existantes.
Rejoignez des centaines de boutiques réussies qui convertissent déjà plus de visiteurs en clients avec des descriptions alimentées par l'IA qui vendent vraiment.
Commencez gratuitement, voyez des résultats immédiatement, évoluez quand vous êtes prêt.
Transformez vos conversions—téléchargez votre CSV et commencez gratuitement maintenant!