API Documentation

Complete reference for integrating Cension AI's powerful product text generation capabilities into your applications.

Quick Navigation

POST/api/CreateText

Create perfect descriptions, titles, and metadata in any language, all at once. Fully SEO-optimized for each product in your inventory.

Base URL: https://cension-endpoint-container.ambitiousmushroom-5bf5cb04.swedencentral.azurecontainerapps.io

Authentication

We use Bearer Token authentication. You'll need your API key, which is provided once you have an active paying account.

Header Format:

Authorization: Bearer {your_access_token}

Note: Replace {your_access_token} with your actual API key from the Cension dashboard.

Request Parameters

Required ParametersRequired

user_idinteger

Your user ID from the Cension platform.

Default: 0

titlestring

The name/title of the product.

imagestring

An image URL for the product.

field_idsarray

Output field IDs that determine the nature of your text output. Each field has a unique ID found in the Cension platform.

languagestring

The language for the output. Use standard language prefixes, or send "all" for all configured languages.

Optional ParametersOptional

brandstring

Product brand name.

article_numberstring

Article number, EAN, GTIN, etc.

og_idstring

Unique product ID for workspace uploads.

project_idinteger

Project ID from workspace settings.

enable_external_specificationinteger

Enable web scraping for richer product data. 0 = inactive (default), 1 = active.

Default: 0

internal_specificationarray

Extra product data (specs/features) for the AI to use.

Example Request

cURL

curl --location 'https://cension-endpoint-container.ambitiousmushroom-5bf5cb04.swedencentral.azurecontainerapps.io/api/CreateText' \

--header 'Authorization: Bearer <your_access_token>' \

--form 'user_id="123"' \

--form 'title="Blue Cotton T-Shirt"' \

--form 'image="https://example.com/tshirt.jpg"' \

--form 'field_ids[]="desc_field_1"' \

--form 'language="en"'

Response Format

200Success

{
  "apiResponses": [
    {
      "success": true,
      "data": {
        "fieldId": "field-123",
        "text": "Your generated text content here"
      },
      "error": null
    },
    {
      "success": true,
      "data": {
        "fieldId": "field-456",
        "text": "Another generated text content"
      },
      "error": null
    }
  ],
  "specification": "Detailed product specification text here",
  "keywords": [
    "keyword1", 
    "keyword2", 
    "keyword3"
  ]
}