Nexscope logo
Start free

Multimodal Recognize Image API

REST API and MCP service documentation generated from server-side API definitions. Responses shown here are the direct payload returned by each API execution.

API selector
Multimodal AI

API overview

Analyze and extract information from images using multimodal AI recognition.

Try this API
Endpoint
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/multimodal-recognize-image/run
MCP method
nexscope_multimodal_recognize_image

Authentication

All run endpoints require a user API key. Send it as a bearer token in the Authorization header.

Authorization: Bearer nk_xxxxxxxxxxxxxxxxx
Missing or invalid API keys return an authentication error. Manage keys from .
POSThttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/multimodal-recognize-image/run

Run an API

Request parameters documented by ecommerce.multimodal-recognize-image.

Slugmultimodal-recognize-image
HeadersAuthorization: Bearer nk_...
Content-Type: application/json
Request bodyAPI-specific JSON object.
Response bodyDirect API response payload. No data/result wrapper is added.

Status codes

CodeDescription
200API executed successfully. Body is the direct response payload.
400Request JSON or required API parameters are invalid.
401API key is missing, invalid, or cannot be matched to a user.
5xxAPI execution or upstream service failed.

Example request

curl -X POST https://api.nexscope.ai/api/skill-api/v1/skills/multimodal-recognize-image/run \
  -H "Authorization: Bearer nk_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{   "imageUrl": "https://m.media-amazon.com/images/I/61v6nYvQ7+L._AC_SL1500_.jpg",   "requirement": "Describe the product shown in this image" }'
All categories/ Multimodal AI
POSThttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/multimodal-recognize-image/run

Run this API

Send a JSON request to execute this API and receive the direct response payload.

Open tester

Endpoint

MethodPOST
Pathhttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/multimodal-recognize-image/run
AuthBearer API key
Content-Typeapplication/json

Request body

NameTypeRequiredDescription
imageUrlstringrequired
图片地址（仅支持jpg/jpeg/png/gif/webp/bmp格式），最大长度1000字符
Example: https://m.media-amazon.com/images/I/61v6nYvQ7+L._AC_SL1500_.jpg
requirementstringoptional
用户意图，描述需要从图片中识别或分析的内容，默认值为"描述这张图片里面的内容"，最大长度1000字符

Request example

{
  "imageUrl": "https://m.media-amazon.com/images/I/61v6nYvQ7+L._AC_SL1500_.jpg",
  "requirement": "Describe the product shown in this image"
}

Response body

Returns the documented upstream API response directly without an additional wrapper.

NameTypeRequiredDescription
textstringoptional
图片分析的文本结果
stdoutstringoptional
标准输出内容
statusstringoptional
响应状态标识
typestringoptional
组件类型
costTokenintegeroptional
消耗token
Example: 1
errcodeintegeroptional
Upstream status code returned by the provider.
errmsgstringoptional
Upstream status message returned by the provider.
codestringoptional
Provider-specific status code.
msgstringoptional
Provider-specific status message.
messagestringoptional
Provider-specific message.
titlestringoptional
Provider-specific response title.
sourceTypestringoptional
Provider-specific source platform type.
sourceToolstringoptional
Provider-specific source tool name.
costTimeintegeroptional
Execution time reported by the upstream provider.
pageintegeroptional
Current page returned by the upstream provider.
pageSizeintegeroptional
Page size returned by the upstream provider.
pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
totalPageintegeroptional
Total page count returned by the upstream provider.
dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.

Response example

Direct response payload. No extra wrapper is added.

{
  "costToken": 1
}

Responses

CodeDescription
200API executed successfully. Body is the direct response payload.
400Request JSON or required API parameters are invalid.
401API key is missing, invalid, or cannot be matched to a user.
5xxAPI execution or upstream service failed.

Data source, freshness, and limitations

Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.

Related APIs

Multimodal Generate Image

AI-driven image generation and editing tool for creating high-quality product images.

MCP

Use the MCP endpoint when an agent needs to discover and call API tools with JSON-RPC.

GET /api/skill-api/v1/mcp
POST /api/skill-api/v1/mcp
Authorization: Bearer nk_xxxxxxxxxxxxxxxxx
Content-Type: application/json

Call a tool

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_multimodal_recognize_image",
    "arguments": {
      "imageUrl": "https://m.media-amazon.com/images/I/61v6nYvQ7+L._AC_SL1500_.jpg",
      "requirement": "Describe the product shown in this image"
    }
  }
}

Online test

Execute the current API with your API key and JSON payload.

Try it

Send a real request with the same contract shown in the reference.

Endpoint
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/multimodal-recognize-image/run
MCP method
nexscope_multimodal_recognize_image
cURL
curl -X POST \
  https://claw-callback.nexscope.ai/api/skill-api/v1/skills/multimodal-recognize-image/run \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "imageUrl": "https://m.media-amazon.com/images/I/61v6nYvQ7+L._AC_SL1500_.jpg", "requirement": "Describe the product shown in this image" }'
Response
No response yet. Run the request to see the response here.