API 文档

将 The Gendai 集成到您的工作流程

我们的 REST API 允许您以编程方式生成专业的产品描述，轻松实现大规模内容创建过程的自动化。

无论您是构建电子商务平台、管理大型产品目录，还是创建自动化工作流程，我们的 API 都提供与我们网络界面相同的强大 AI 功能。免费注册

需要 API 密钥

您需要 API 密钥来使用我们的服务。创建免费账户以获取您的 API 密钥并开始生成描述。

API 概述

The Gendai API 是一个 RESTful 服务，接受 JSON 请求并返回 JSON 响应。所有请求都必须使用您的 API 密钥进行身份验证。

基础 URL

https://thegendai.com/api/v1

身份验证

在请求头中包含您的 API 密钥：

X-API-Key: your_api_key_here

生成产品描述

端点: POST /api/v1/generate-description

请求体

发送包含您的产品信息和生成偏好的 POST 请求：

选项 1：使用图片 URL

{
  "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"
  }
}

选项 2：使用 Base64 图片

{
  "brand_description": "我们创造结合可持续性与风格的高端环保产品",
  "audience": "重视质量和可持续性的环保意识消费者",
  "tone_voice": "专业但易于接近，强调质量和环境效益",
  "languages": ["english", "spanish"],
  "product": {
    "id": "prod_123",
    "name": "竹制水瓶",
    "category": "环保",
    "price": "24.99",
    "image_b64": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
  }
}

支持的语言

API 支持 39+ 种语言的生成。在您的请求中使用语言代码：

• english
• spanish
• french
• catalan
• german
• italian
• portuguese
• dutch
• swedish
• norwegian
• danish
• finnish
• romanian

• polish
• russian
• czech
• slovak
• hungarian
• greek
• turkish
• bulgarian
• croatian
• serbian
• slovenian
• ukrainian
• vietnamese

• indonesian
• tagalog
• chinese
• japanese
• korean
• arabic
• hindi
• thai
• hebrew
• basque
• galician
• welsh
• scottish_gaelic

总计：支持 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"
  }
}

代码示例

以下是流行编程语言的示例：

选项 1：使用图片 URL

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"
    }
  }'

选项 2：使用 Base64 图片

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=="
    }
  }'

选项 1：使用图片 URL

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);

选项 2：使用 Base64 图片

// 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);

选项 1：使用图片 URL

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)

选项 2：使用 Base64 图片

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 工作流集成

这个 N8N 工作流演示了如何将 The Gendai API 集成到您的自动化工作流中。

要求

安装了 N8N 或对 N8N 云的访问权限
The Gendai API 密钥
对 N8N 工作流的基本理解

N8N 工作流 JSON

复制这个 JSON 并使用 "Import from Clipboard" 粘贴到 N8N 中:

@__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": {}
}

设置说明

复制下面的 JSON 工作流
在 N8N 中，点击 "Import from Clipboard"
粘贴 JSON 并导入
用您实际的 API 密钥替换 "YOUR_API_KEY_HERE"
在 "Set Brand Info" 节点中自定义品牌信息
使用手动触发器测试工作流

开始使用

创建免费账户
从您的账户仪表板生成 API 密钥
使用上述示例进行您的第一个 API 请求
开始集成到您的应用程序和工作流程中

速率限制

API 请求受基于您账户计划的速率限制约束。免费账户每天最多可进行 10 次请求。

立即开始使用我们的 API 构建

将 The Gendai 集成到您的工作流程

需要 API 密钥

API 概述

基础 URL

身份验证

生成产品描述

请求体

选项 1：使用图片 URL

选项 2：使用 Base64 图片

支持的语言

响应格式

代码示例

选项 1：使用图片 URL

选项 2：使用 Base64 图片

选项 1：使用图片 URL

选项 2：使用 Base64 图片

选项 1：使用图片 URL

选项 2：使用 Base64 图片

N8N 工作流集成

要求

N8N 工作流 JSON

设置说明

开始使用

速率限制

与任何CSV兼容——任何结构、任何平台，完全兼容。

关于使用AI提升转化的常见问题

准备好看到转化率的可衡量改善了吗？

the gendai

the gendai

无缝多语言AI

30+种语言的完美描述

API 文档

将 The Gendai 集成到您的工作流程

需要 API 密钥

API 概述

基础 URL

身份验证

生成产品描述

请求体

选项 1：使用图片 URL

选项 2：使用 Base64 图片

支持的语言

响应格式

代码示例

选项 1：使用图片 URL

选项 2：使用 Base64 图片

选项 1：使用图片 URL

选项 2：使用 Base64 图片

选项 1：使用图片 URL

选项 2：使用 Base64 图片

N8N 工作流集成

要求

N8N 工作流 JSON

设置说明

开始使用

速率限制

与任何CSV兼容——任何结构、任何平台，完全兼容。

关于使用AI提升转化的常见问题

我多快能看到改善的转化率？

这与使用ChatGPT编写描述有何不同？

我能相信质量会符合我的品牌标准吗？

免费试用具体包括什么？

您如何保证比手动撰写更好的结果？

准备好看到转化率的可衡量改善了吗？

the gendai

the gendai

无缝多语言AI

30+种语言的完美描述