Интегрирайте генерирането на описания на продукти с изкуствен интелект на The Gendai директно във вашите приложения и работни процеси. Вземете вашия API ключ
Нашето REST API ви позволява да генерирате професионални описания на продукти програмно, което улеснява автоматизацията на вашия процес за създаване на съдържание в мащаб.
Независимо дали изграждате платформа за електронна търговия, управлявате голям каталог с продукти или създавате автоматизирани работни процеси, нашето API предоставя същите мощни възможности на изкуствения интелект, достъпни в нашия уеб интерфейс. Регистрирайте се безплатно
Имате нужда от API ключ, за да използвате нашата услуга. Създайте безплатен профил, за да получите вашия API ключ и да започнете да генерирате описания.
The Gendai API е RESTful услуга, която приема JSON заявки и връща JSON отговори. Всички заявки трябва да бъдат удостоверени с вашия API ключ.
https://thegendai.com/api/v1
Включете вашия API ключ в заглавката на заявката:
X-API-Key: your_api_key_here
Крайна точка: POST /api/v1/generate-description
Изпратете POST заявка с информацията за вашия продукт и предпочитанията за генериране:
{
"brand_description": "Създаваме висококачествени екологични продукти, които съчетават устойчивост със стил",
"audience": "Екологично съзнателни потребители, които ценят качеството и устойчивостта",
"tone_voice": "Професионален, но достъпен, акцентиращ върху качеството и екологичните ползи",
"specific_guidelines": "Винаги споменавайте екологичните материали и ползите за устойчивостта",
"languages": ["english", "spanish", "french"],
"product": {
"id": "prod_123",
"name": "Бутилка за вода от бамбук",
"description": "Многократно използваема бутилка за вода, изработена от устойчив бамбук",
"category": "Екологичен",
"price": "24.99",
"image_url": "https://example.com/product-image.jpg"
}
}
{
"brand_description": "Създаваме висококачествени екологични продукти, които съчетават устойчивост със стил",
"audience": "Екологично съзнателни потребители, които ценят качеството и устойчивостта",
"tone_voice": "Професионален, но достъпен, акцентиращ върху качеството и екологичните ползи",
"languages": ["english", "spanish"],
"product": {
"id": "prod_123",
"name": "Бутилка за вода от бамбук",
"category": "Екологичен",
"price": "24.99",
"image_b64": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
}
}
API поддържа генериране на 39+ езика. Използвайте кодовете на езиците във вашата заявка:
Успешните заявки връщат JSON обект с генерирани описания:
{
"success": true,
"data": {
"product_id": "prod_123",
"product_name": "Бутилка за вода от бамбук",
"descriptions": {
"english": "Откройте устойчивата хидратация с нашата висококачествена бутилка за вода от бамбук...",
"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": "Бутилка за вода от бамбук",
"description": "Многократно използваема бутилка за вода, изработена от устойчив бамбук",
"category": "Екологичен",
"price": "24.99",
"image_url": "https://example.com/product-image.jpg"
},
"generation_settings": {
"brand_description": "Създаваме висококачествени екологични продукти, които съчетават устойчивост със стил",
"audience": "Екологично съзнателни потребители, които ценят качеството и устойчивостта",
"tone_voice": "Професионален, но достъпен, акцентиращ върху качеството и екологичните ползи",
"specific_guidelines": "Винаги споменавайте екологичните материали и ползите за устойчивостта",
"languages": ["english", "spanish", "french"]
},
"generated_at": "2025-10-17 14:30:00"
}
}
Ето примери на популярни програмни езици:
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": "Създаваме висококачествени екологични продукти, които съчетават устойчивост със стил",
"audience": "Екологично съзнателни потребители, които ценят качеството и устойчивостта",
"tone_voice": "Професионален, но достъпен, акцентиращ върху качеството и екологичните ползи",
"languages": ["english", "spanish"],
"product": {
"name": "Бутилка за вода от бамбук",
"category": "Екологичен",
"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": "Създаваме висококачествени екологични продукти, които съчетават устойчивост със стил",
"audience": "Екологично съзнателни потребители, които ценят качеството и устойчивостта",
"tone_voice": "Професионален, но достъпен, акцентиращ върху качеството и екологичните ползи",
"languages": ["english", "spanish"],
"product": {
"name": "Бутилка за вода от бамбук",
"category": "Екологичен",
"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: 'Създаваме висококачествени екологични продукти, които съчетават устойчивост със стил',
audience: 'Екологично съзнателни потребители, които ценят качеството и устойчивостта',
tone_voice: 'Професионален, но достъпен, акцентиращ върху качеството и екологичните ползи',
languages: ['english', 'spanish'],
product: {
name: 'Бутилка за вода от бамбук',
category: 'Екологичен',
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: 'Създаваме висококачествени екологични продукти, които съчетават устойчивост със стил',
audience: 'Екологично съзнателни потребители, които ценят качеството и устойчивостта',
tone_voice: 'Професионален, но достъпен, акцентиращ върху качеството и екологичните ползи',
languages: ['english', 'spanish'],
product: {
name: 'Бутилка за вода от бамбук',
category: 'Екологичен',
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": "Създаваме висококачествени екологични продукти, които съчетават устойчивост със стил",
"audience": "Екологично съзнателни потребители, които ценят качеството и устойчивостта",
"tone_voice": "Професионален, но достъпен, акцентиращ върху качеството и екологичните ползи",
"languages": ["english", "spanish"],
"product": {
"name": "Бутилка за вода от бамбук",
"category": "Екологичен",
"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": "Създаваме висококачествени екологични продукти, които съчетават устойчивост със стил",
"audience": "Екологично съзнателни потребители, които ценят качеството и устойчивостта",
"tone_voice": "Професионален, но достъпен, акцентиращ върху качеството и екологичните ползи",
"languages": ["english", "spanish"],
"product": {
"name": "Бутилка за вода от бамбук",
"category": "Екологичен",
"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' => 'Създаваме висококачествени екологични продукти, които съчетават устойчивост със стил',
'audience' => 'Екологично съзнателни потребители, които ценят качеството и устойчивостта',
'tone_voice' => 'Професионален, но достъпен, акцентиращ върху качеството и екологичните ползи',
'languages' => ['english', 'spanish'],
'product' => [
'name' => 'Бутилка за вода от бамбук',
'category' => 'Екологичен',
'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", "Създаваме висококачествени екологични продукти, които съчетават устойчивост със стил");
payload.put("audience", "Екологично съзнателни потребители, които ценят качеството и устойчивостта");
payload.put("tone_voice", "Професионален, но достъпен, акцентиращ върху качеството и екологичните ползи");
ArrayNode languages = mapper.createArrayNode();
languages.add("english");
languages.add("spanish");
payload.set("languages", languages);
ObjectNode product = mapper.createObjectNode();
product.put("name", "Бутилка за вода от бамбук");
product.put("category", "Екологичен");
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": "Създаваме висококачествени екологични продукти, които съчетават устойчивост със стил",
"audience": "Екологично съзнателни потребители, които ценят качеството и устойчивостта",
"tone_voice": "Професионален, но достъпен, акцентиращ върху качеството и екологичните ползи",
"languages": ["english", "spanish"],
"product": {
"name": "Бутилка за вода от бамбук",
"category": "Екологичен",
"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: 'Създаваме висококачествени екологични продукти, които съчетават устойчивост със стил',
audience: 'Екологично съзнателни потребители, които ценят качеството и устойчивостта',
tone_voice: 'Професионален, но достъпен, акцентиращ върху качеството и екологичните ползи',
languages: ['english', 'spanish'],
product: {
name: 'Бутилка за вода от бамбук',
category: 'Екологичен',
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 = "Създаваме висококачествени екологични продукти, които съчетават устойчивост със стил",
audience = "Екологично съзнателни потребители, които ценят качеството и устойчивостта",
tone_voice = "Професионален, но достъпен, акцентиращ върху качеството и екологичните ползи",
languages = new[] { "english", "spanish" },
product = new
{
name = "Бутилка за вода от бамбук",
category = "Екологичен",
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: "Създаваме висококачествени екологични продукти, които съчетават устойчивост със стил",
Audience: "Екологично съзнателни потребители, които ценят качеството и устойчивостта",
ToneVoice: "Професионален, но достъпен, акцентиращ върху качеството и екологичните ползи",
Languages: []string{"english", "spanish"},
Product: Product{
Name: "Бутилка за вода от бамбук",
Category: "Екологичен",
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)
}
Този N8N работен процес демонстрира как да интегрирате The Gendai API във вашите автоматизирани работни процеси.
Копирайте този JSON и го поставете в N8N използвайки "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": {}
}
API заявките са обект на ограничения на скоростта въз основа на вашия план за профил. Безплатните профили могат да правят до 10 заявки на ден.
Качете CSV файлове директно от Shopify, PrestaShop, Magento, VTEX, WooCommerce или всяка система. Не е нужно форматиране, не е нужна техническа настройка—само мигновени резултати.
Научете как The gendai трансформира продуктовия ви каталог в машина за генериране на продажби, която последователно надминава ръчните описания. Вижте нашия процес в действие.
Повечето клиенти отчитат измерими подобрения в рамките на 2-3 седмици. Нашият AI създава описания, които незабавно се справят с психологията на купувачите и преодоляват общите възражения при покупка. Влиянието върху продажбите става видимо веднага щом замените съществуващите си описания с нашия конверсионно оптимизиран копи.
Започнете безплатния си пробен период днес и наблюдавайте анализите си—ще видите разликата в поведението на посетителите почти веднага.
ChatGPT създава генерично съдържание. The gendai създава продажбоориентиран копи. Нашият AI е обучен специално върху висококонвертиращи eCommerce описания и разбира психологията на купувачите, SEO изисквания и оптимизация на конверсии. Анализираме изображенията на продуктите ви и спецификациите, за да подчертаем продажни точки, които генеричните AI инструменти пропускат.
Сравнете сами—качете CSV файла си и вижте описания, които действително убеждават клиентите да купуват.
Абсолютно. Нашият AI поддържа гласа на вашата марка, като същевременно прилага доказани принципи за конверсия. Всяко описание е изработено да отразява уникалното ценностно предложение на продукта ви и да привлича емоциите и нуждите на целевия ви клиент. Качеството е последователно в целия ви каталог.
Тествайте качеството ни без риск—генерирайте примерни описания и вижте как се съгласуват със стандартите на вашата марка.
Вашият безплатен пробен период включва 10 пълни описания на продукти на избрания от вас език, пълна SEO оптимизация и конверсионно ориентиран копи. Не е нужна кредитна карта, няма ограничения по време за тестване на резултатите. Можете да измерите ефективността спрямо текущите си описания преди да се ангажирате.
Започнете веднага—качете CSV файла си и получете 10 описания, които можете да тествате A/B спрямо текущия си копи.
Нашият AI анализира хиляди висококонвертиращи описания и прилага доказани психологически тригери, които ръчните писатели често пропускат. Комбинираме визуален анализ на продуктите ви с конверсионно оптимизирани езикови модели. Резултатът е копи, който последователно надминава както ръчното писане, така и генеричните AI инструменти при тестове за конверсия.
Вижте разликата сами—опитайте нашия безплатен пробен период и сравнете процентите на конверсия със съществуващите си описания.
Присъединете се към стотици успешни магазини, които вече конвертират повече посетители в клиенти с AI описания, които действително продават.
Започнете безплатно, вижте резултати веднага, мащабирайте когато сте готови.
Трансформирайте конверсиите си—качете CSV файла си и започнете безплатно сега!