Інтегруйте генерацію описів товарів на основі ШІ від The Gendai безпосередньо у ваші додатки та робочі процеси. Отримайте ваш API ключ
Наш REST API дозволяє програмно генерувати професійні описи товарів, спрощуючи автоматизацію вашого процесу створення контенту у великому масштабі.
Чи будуєте ви платформу електронної комерції, керуєте великим каталогом товарів чи створюєте автоматизовані робочі процеси, наш API надає ті ж потужні можливості ШІ, доступні в нашому веб-інтерфейсі. Зареєструйтеся безкоштовно
Вам потрібен API ключ для використання нашого сервісу. Створіть безкоштовний обліковий запис, щоб отримати ваш API ключ і почати генерувати описи.
API The Gendai — це 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 спеціально навчений на високо конвертуючих описах електронної комерції та розуміє психологію покупців, SEO вимоги та оптимізацію конверсії. Ми аналізуємо зображення та специфікації ваших товарів, щоб виділити продажні точки, які пропускають загальні AI інструменти.
Порівняйте самі—завантажте свій CSV та побачте описи, що справді переконують клієнтів купувати.
Абсолютно. Наш AI підтримує голос вашого бренду, застосовуючи доведені принципи конверсії. Кожен опис створений для відображення унікальної ціннісної пропозиції вашого товару та привернення емоцій і потреб вашого цільового клієнта. Якість послідовна по всьому вашому каталогу.
Протестуйте нашу якість без ризику—генеруйте зразкові описи та подивіться, як вони відповідають стандартам вашого бренду.
Ваша безкоштовна пробна версія включає 10 повних описів товарів вашими обраними мовами, повну SEO оптимізацію та конверсійно-орієнтований контент. Кредитна картка не потрібна, немає часових обмежень на тестування результатів. Ви можете виміряти продуктивність порівняно з поточними описами перед зобов'язанням.
Почніть миттєво—завантажте свій CSV та отримайте 10 описів, які ви можете A/B тестувати порівняно з поточним контентом.
Наш AI аналізує тисячі високо конвертуючих описів та застосовує доведені психологічні тригери, які ручні письменники часто пропускають. Ми поєднуємо візуальний аналіз ваших товарів з конверсійно-оптимізованими мовними шаблонами. Результат—контент, що постійно перевершує як ручне написання, так і загальні AI інструменти в тестах конверсії.
Побачте різницю самі—спробуйте нашу безкоштовну пробну версію та порівняйте показники конверсії з існуючими описами.
Приєднуйтеся до сотень успішних магазинів, що вже конвертують більше відвідувачів у клієнтів з описами на базі AI, що справді продають.
Почніть безкоштовно, побачте результати миттєво, масштабуйтеся коли готові.
Трансформуйте свої конверсії—завантажте свій CSV та почніть безкоштовно зараз!