Download Generated Result

GET

https://api.sellerpic.ai/v1/api/download

Once the task is confirmed as completed, Use this API to get downloadable URL for the final edited image.
Download Link Specifications:

Validity: 12 hours

Timer starts: At API return time

Expiration behavior: HTTP 403 status

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.sellerpic.ai/v1/api/download?downloadFormat&id&uhd' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json'

Response Example

200 - Example 1

{
  "code": 0,
  "data": {
    "name": "string",
    "status": "string",
    "fileUrl": "string",
    "errorMsg": "string"
  },
  "msg": "string",
  "success": true,
  "traceId": "string"
}

Request

Query Params

downloadFormat

string

required

Output format.
Image only support jpg | png | webp
Video only support mp4 | gif | webp

string

required

Required image id

uhd

boolean

optional

Optional high-resolution image (4096px), default: false
Generates images with a maximum side length of 4096 pixels
Original files will be downloaded directly if their longest side exceeds 4096 pixels

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 (ApiImageDownloadResult)

optional

name

string

required

File name

status

string

required

Status: SUCCESS | FAILED

fileUrl

string

required

File download url

errorMsg

string

optional

Error message

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

Retrieve Generation Task Status

Retrieve API Credit Usage