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. Upload Asset Files

• API Reference: Upload Asset File
• Submit a single asset file per request via POST with the header:
  Content-Type: multipart/form-data
• Response: fileKey Unique identifier for successfully uploaded asset.

---

2. Create Generation Task

Prerequisite

• Complete the previous step (Upload Asset Files)
• Obtain valid fileKey from upload response

Create Task Endpoints:

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

Response Handling
The response includes a id field. Use this unique identifier to track task progress via the next step: Check Task Status.

---

3. Check Task Status

• API Reference: Check Task Status API.
• Polling Requirements
  • Minimum 60-second interval between requests
  • Monitor until task reaches terminal state SUCCESS or FAILED
• Critical Dependency
  Successfully generated files are exclusively retrievable via the next step: Get Download URL.

---

4. Get Download URL

• API Reference: Get Download Url API
• Returns a time-limited URL for accessing generated files.

---

5. Download File

• Execute a GET request using the download url from previous Step 4
• Please complete the download within 12 hour (temporary URL Expiration)
• If you receive a 403 Forbidden response (indicating URL expiration), Call the Get Download Url API API endpoint with your original task id to generate a new valid URL.

Code Examples

---

Credit Deduction Rules

Task	Credits Rule
Swap Fashion Model	1 Credit/image（4 images at once）
Try-on（Apparel）	1 Credit/image（4 images at once）
Try-on（Accessories）	1 Credit/image（2 images at once）
Image to Video（Standard，5s）	10 Credit/video
Image to Video（Standard，10s）	15 Credit/video
Lifestyle Scene	1 Credit/image（4 images at once）
Instruct Edit	1 Credit/image
Background Replacer	1 Credit/image（4 images at once）
Background Remover	1 Credit/image

---

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.
10015	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.