Get Started

For technical support or additional assistance, contact support@sellerpic.ai.

---

Obtain Your API Key

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:

---

API Request Example

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
Replace YOUR_API_KEY with the API key obtained from your application.

---

Task Concurrency Limits

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

1. Task Counting: Includes all tasks in CREATED RUNNING
2. Rejection Behavior: Receive immediate error code 30003 response
3. Capacity Release: Task slots become available when tasks reach to SUCCESS or FAILED

---

Workflow Overview

---

1. Get Upload URL

Prerequisite
Ensure all required assets (e.g., source images) are uploaded before initiating generation tasks.

• Use the Request Upload File URL API to obtain a time-limited upload URL.

---

2. Upload Asset Files

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.

---

3. Generate Images/Videos

Prerequisite
Confirm completion of Steps 1 and 2 before initiating generation.

Available APIs:

• Image To Video
• Instruct Edit
• Try-On (Apparel)
• Try-On (Accessories)
• Lifestyle Scene
• Swap Fashion Model
• Background Replacer

Response Handling
The response includes a task_id field. Use this ID to monitor task progress via the Retrieve Task Status API.

---

4. Monitor Task Status

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.

---

5. Retrieve Download URL

Download Generated Result API
Returns a time-limited URL for accessing generated files.

---

6. Download File

Execute a GET request against the URL obtained in Step 5 to download the file directly. Please complete the download within 12 hour.

code examples

---

Credit Deduction Rules

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

---

Error Codes

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.