Ecommerce Content Generation

Product Description Generator

Creates a text-generation task from product copy instructions and image URLs, or queries a known task ID.

post/api/skill-api/v1/skills/product-description-generator/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/product-description-generator/run
  • Auth: HTTP bearer

Headers

X-Nexscope-Http-Status'legacy' | 'semantic'

Use semantic for HTTP error statuses on run and task-result requests. Without this header v1 retains legacy status behavior. The JSON envelope is unchanged; code 0 means success or acceptance, not asynchronous completion.

Request body

operationstring

create (default) or query.

promptstring

Product-copy generation instruction; required by create.

thinkingLevelstring

Reasoning level required by create.

modelstring

Optional supported text-generation model.

memberIdstring

Optional provider member identifier used by create and query.

taskIdstring

Provider task ID returned by create; required by operation=query.

Example request

{
  "operation": "create",
  "thinkingLevel": "minimal",
  "prompt": "Write a product description for a wireless speaker.",
  "imageUrls": []
}

Response

Successful response.

codeinteger required

0 means accepted or successful; nonzero is a platform error.

msgstring nullable required
tsstring required

Epoch milliseconds.

timestring required

Server local time: yyyy-MM-dd HH:mm:ss.

coststring required

Elapsed milliseconds, never credits; -1 outside web requests.

traceIdstring nullable required

Example response

{
  "data": {
    "taskId": "123456789",
    "status": "PROCESSING",
    "content": "Example product description.",
    "promptTokens": 120,
    "completionTokens": 350,
    "totalTokens": 470,
    "costToken": 1
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.