Generate products

POST

/products/generate/bulk

curl --request POST \
  --url https://api.semantico.ai/api/v1/products/generate/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "product_ids": [ 101, 102, 103 ], "actions": [ { "action": "description" }, { "action": "name" }, { "action": "categorize" }, { "action": "translate", "translate_all": true } ], "override": true, "full_generation": false }'

• Production

Triggers AI generation for products. Provide an explicit product_ids list, or omit it to apply the same query-string filters as GET /products/. Always runs in the background.

Authorizations

• bearerAuth

Request Body^required

Media typeapplication/json

object

product_ids

Explicit targets. If omitted, the GET /products/ query filters select the targets.

Array<integer>

actions

required

Array<object>

object

action

required

string

Allowed values: description name categorize find_relevant_images find_free_attributes translate custom_section repeat_crawl

code

Required for custom_section — the custom attribute code.

string

translate_all

For translate — translate every translatable field.

boolean

translate_field

string

Allowed values: name description section free_attributes

translate_fields

Array<string>

force_retranslate

boolean

override

Overwrite existing generated content. If false, only fill empty fields.

boolean

default: true

full_generation

Treat the request as a full pipeline run.

boolean

Example

{
  "product_ids": [
    101,
    102,
    103
  ],
  "actions": [
    {
      "action": "description"
    },
    {
      "action": "name"
    },
    {
      "action": "categorize"
    },
    {
      "action": "translate",
      "translate_all": true
    }
  ],
  "override": true,
  "full_generation": false
}

Responses

202

Generation queued

Media typeapplication/json

object

message

string

task_id

string

status

string

total_products

integer

upload_group_id

integer

upload_group_name

string

Example^generated

{
  "message": "example",
  "task_id": "example",
  "status": "example",
  "total_products": 1,
  "upload_group_id": 1,
  "upload_group_name": "example"
}

400

Field-level validation error.

Media typeapplication/json

object

key

additional properties

Array<string>

Example

{
  "barcode": [
    "A product with this barcode already exists."
  ]
}

403

Token is valid but lacks the required permission or subscription.

Media typeapplication/json

object

detail

string

Example^generated

{
  "detail": "example"
}