For technical support or additional assistance, contact support@sellerpic.ai.
Apply for an API Key to authenticate your API requests.
Include the API Key in the Authorization
header of all API requests as shown below:
curl --location --request POST 'https://api.sellerpic.ai/v1/api/generate/instructEdit' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"imageKey": "UPLOAD/1911986840705904640/2025/04/16/e562bc9273cb4edab3b7c0ea36787b7f.jpg",
"prompt": "The model touches her hairband and her face slightly turns to the side."
}'
Note
ReplaceYOUR_API_KEY
with the API key obtained from your application.
This API enforces hard concurrent task limits per account. Task creation requests will fail immediately when the number of in-progress tasks reaches these thresholds:
Task type | Max Concurrent Tasks |
---|---|
Image to Video | 10 |
Instruct Edit | 5 |
Segment image by prompt | 5 |
Segment image by type | 5 |
All Other task | 10 |
Note
- Task Counting: Includes all tasks in
CREATED
RUNNING
- Rejection Behavior: Receive immediate error code
30003
response- Capacity Release: Task slots become available when tasks reach to
SUCCESS
orFAILED
Prerequisite
Ensure all required assets (e.g., source images) are uploaded before initiating generation tasks.
Upload binary asset data by sending a PUT
request to the URL returned in Step 1.
API Reference: Upload File
HTTP Response Codes:
200 OK
: Asset uploaded successfully.403 Forbidden
: The upload URL has expired. Reacquire a URL via the Request Upload File URL API.Prerequisite
Confirm completion of Steps 1 and 2 before initiating generation.
Available APIs:
Response Handling
The response includes a task_id
field. Use this ID to monitor task progress via the Retrieve Task Status API.
Use the Retrieve Task Status API to verify task completion. Polling requests must maintain a minimum interval of 1 minute between consecutive checks.
Critical Dependency
Generated files are only accessible via the Download API after the task succeeds.
Download Generated Result API
Returns a time-limited URL for accessing generated files.
Execute a GET
request against the URL obtained in Step 5 to download the file directly. Please complete the download within 12 hour.
Type | Credits/Task |
---|---|
Instruct Edit task | 1 |
Image to video task (5-second) | 10 |
Image to video task (10-second) | 15 |
Try-On (Apparel) | 4 |
Try-On (Accessories) | 2 |
Lifestyle Scene | 4 |
Swap Fashion Model | 4 |
Background Replacer | 1~4 |
Background Remover | 1 |
The error code list helps you quickly identify issues.
Code | Description |
---|---|
0 | Success. The request was processed successfully. |
400 | Failed to validate the parameter. |
403 | Forbidden. |
404 | Empty data. |
500 | Server is busy, please try again later. |
504 | Request timeout, please try again later. |
5001 | Data not found. |
5002 | Unknown enums. |
5003 | Field validation failed. |
5004 | Download file failed. |
5005 | Too many attempts. |
10014 | API authentication failed. Please check authorization header. |
20000 | Service unavailable. The requested service is temporarily unavailable. |
20001 | Authorization failed. Insufficient permissions or invalid access tokens. |
20002 | Invalid user token. The user authorization token is invalid. |
20014 | Insufficient credits remaining to use. |
30001 | Image make timeout. |
30002 | Image make failed. |
30003 | Task limit reached. Please wait for completion. |
30004 | Image param error. Image cannot be fully transparent. |
30005 | Image param error. Image must have transparent area. |
30006 | Image make failed. |
30007 | No setting image operate. |
30008 | Download file failed. |
30009 | Image make sensitive content. |
30010 | Image make version not support. |
30011 | Free task too much. Please upgrade your account. |
30012 | Task limit reached. Please wait for completion. |
30013 | Image not found. |
30014 | Unable to process the image. Please try a different image. |
30015 | Animated WEBP file is not supported. |
30016 | The file size exceeds the limit. |
30017 | Image not finished. |
30018 | Image make type not support. |
30019 | Download format not support. |
30020 | Image is broken. |
30021 | Image format error. |
30022 | Upload file fail. |
30023 | Model image unrecognized. |
30024 | Image illegal. |
30025 | Background color invalid. |
30026 | File not found. |
30027 | Image too large. |
40000 | Missing user token. The required user access token is missing. |
40001 | Missing required parameters. A mandatory parameter is missing in the request. |
40002 | Invalid parameters. The provided parameters are invalid or malformed. |
40004 | Business processing failed. The request could not be processed due to business logic issues. |
40005 | Unknown error. An unexpected error occurred; contact support. |
40006 | Insufficient permissions. The requester lacks the necessary permissions. |
40007 | Missing app token. The required application authorization token is missing. |
42900 | Server busy. The server is overloaded; try again later. |
50001 | Unauthorized API. The requested API is not authorized for the user. |