Get Upload URL

GET

https://api.sellerpic.ai/v1/api/upload/url

The format query parameter is required and must be one of the allowed image formats: jpg, jpeg, png, or webp.

The response contains two critical fields:
imageUrl：

Validity: 30 minutes (from generation time)

Usage: Perform a PUT request to this URL to upload your file ，See Upload File

fileKey： This value will be required when creating the task later.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.sellerpic.ai/v1/api/upload/url?format' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json'

Response Example

200 - Example 1

{
  "code": 0,
  "data": {
    "fileKey": "string",
    "imageUrl": "string"
  },
  "msg": "string",
  "success": true,
  "traceId": "string"
}

Request

Query Params

format

string

required

format only support: jpg | jpeg | png | webp

Header Params

Authorization

string

required

Example:

Bearer YOUR_API_KEY

Content-Type

string

required

Example:

application/json

Responses

🟢200OK

*/*

Body

code

integer <int32>

required

Result code, where 0 indicates success and non-0 indicates an error.
Please refer to Error Codes

data

object (ApiUploadResult)

optional

fileKey

string

required

Unique storage path identifier for uploaded image,the value will be required when creating the task later.

imageUrl

string

required

Pre-signed upload URL, Use this URL to upload your resource file via a PUT request.

msg

string

optional

Description of the result, providing additional context or information about the operation outcome.

success

boolean

required

traceId

string

required

Trace ID for tracking the request across distributed systems.

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Segment image by prompt

Upload File