Multimodal AI

Image Captioning API

Extract descriptive prompts or selling-point text from one or more images.

post/api/skill-api/v1/skills/image-captioning/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/image-captioning/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

typeinteger required

Analysis type. Supported values: 5 (similar-image prompt), 13 (scene prompt), 30 (image-to-video analysis), 69 (apparel selling points), 71 (product selling points), 73 (sales-video script), 89 (video-reclone prompt).

imageUrlListstring[] required

Public image URLs used for analysis. Provide no more than 6 images for modes that accept multiple images.

keywordstring

Optional keyword context.

providerstring

Analysis provider. Supported values: API_PRE_POINT (default), API_LAYOUT_DESC.

refVideoUrlstring

Reference video URL. Required when type is 89.

saleCountrystring

Target sale country code.

targetLanguagestring

Target language for generated text. Used by video-reclone analysis.

durationinteger

Target duration in seconds. Used by video-reclone analysis.

Example request

{
  "type": 71,
  "imageUrlList": [
    "https://example.com/product.jpg"
  ],
  "keyword": "phone case",
  "provider": "API_PRE_POINT"
}

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

Changes

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