---
title: "Image Conversion"
method: POST
path: "/api/1688/convert-image/v1"
tags: ["1688"]
---

# Image Conversion

`POST /api/1688/convert-image/v1`

## Request

- Base URL: `https://api.justoneapi.com`
- URL: `https://api.justoneapi.com/api/1688/convert-image/v1`
- Auth: none declared

Converts an image URL or JPEG Base64 input into an image reference for a selected 1688 image search endpoint. Use it to prepare external images for visual product sourcing.

## Query parameters

- `token` string, required

## Request body

- object: Image input and the intended 1688 image search target
  - `url` string: Image URL. Supply either url or imgBase64.
  - `imgBase64` string: JPEG image encoded as Base64 without a data URI prefix; decoded size must not exceed 100 KB.
  - `searchApiEndpoint` 'standard' | 'cross_border_v1' | 'cross_border_v2': Image search target for the converted reference.

## Response `200`

OK

- object
  - `code` 0 | 100 | 101 | 202 | 300 | 301 | 302 | 303 | 400 | 404 | 500 | 503 | 600 | 601 | 602, required
  - `message` string, nullable, required
  - `data` unknown, required
  - `recordTime` string, nullable, required
  - `requestId` string
  - `reason` string

## Other responses

- `400`: Invalid request parameters or body
- `401`: Invalid or inactive access token
- `403`: Permission denied
- `429`: Request rate or daily quota limit exceeded
- `500`: Internal server error
- `503`: Service temporarily unavailable

## Changes

- **2026-10-28** `78351643c975`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/justoneapi/apis/openapi-definition/changes/api/1688/convert-image/v1/post.md)

---

[API](https://skmtc.dev/justoneapi/apis/openapi-definition.md) - [All operations](https://skmtc.dev/justoneapi/apis/openapi-definition/llms.txt) - [OpenAPI document](https://skmtc.dev/justoneapi/apis/openapi-definition/revisions/fcdc66b65f81?raw)