[Important: API Service Retirement Announcement]Dear Developers,Thank you for your continued trust and support in AILabTools API. In order to provide more efficient and reliable services, we will officially deprecate the current version of this API.As this interface is based on an outdated architecture and its performance can no longer meet evolving needs, it will no longer be available starting from the date of this announcement.We kindly recommend that you evaluate and adopt an alternative solution as soon as possible to ensure a smooth transition for your applications.If you have any questions or need assistance during the migration, please feel free to contact our support team:
📧 [email protected]We sincerely appreciate your understanding and cooperation, and we remain committed to delivering better and more advanced services for you.Warm regards,AILabTools Support Team
Request
- URL:
https://www.ailabapi.com/api/image/effects/image-hd-color-migration - Method:
POST - Content-Type:
multipart/form-data
Image requirements
- Image format:
PNGJPGJPEG - Image size: No more than 3 MB.
- Image resolution: Larger than 64x64px, smaller than 10000x10000px.
- The image must be RGB 3-channel.
Headers
| Field | Required | Type | Description |
|---|---|---|---|
ailabapi-api-key | YES | string | Application API KEY. Get API KEY |
Body
Fixed Fields
| Field | Required | Type | Scope | Example | Description |
|---|---|---|---|---|---|
image | YES | file | |||
mode | YES | string | AUTO, TEMPLATE, REF_PIC | AUTO`: Automatic color extension.`, TEMPLATE: Color palette extension., “REF_PIC: Reference picture extension color. | |
degree | YES | string | [0, 1] | 0.4 | Top color degree. |
mode === AUTO
| Field | Required | Type | Scope | Default | Description |
|---|---|---|---|---|---|
color_count | NO | integer | 1, 2, 3, 4, 5, 6, 7, 8 | 1 | Expand the number of color families. |
mode === TEMPLATE
| Field | Required | Type | Example | Description |
|---|---|---|---|---|
color_template | YES | string | 056A6B,0A0B0C | Color palette topology, Top master color list, color value definition ARGB. e.g. 0A0B0C, array size [1, 7]. |
mode === REF_PIC
| Field | Required | Type | Description |
|---|---|---|---|
ref | YES | file | Reference image. |
Response
Response Field Handling Flow-
Handle
Public Response FieldsParse and validate thePublic Response Fields, checking the status code or response message to ensure the request is successful and error-free. -
Handle
Business Response FieldsIf thePublic Response Fieldsare valid and error-free, proceed with processing the business logic in theBusiness Response Fields.
Public Response Fields
Viewing Public Response Fields and Error CodesBusiness Response Fields
| Field | Type | Scope | Description |
|---|---|---|---|
data | object | The content of the result data returned. | |
+image_list | array of string | The URL address of the image after the coloring is completed, and the image format is PNG. Return when the result of the query asynchronous task is successful. |
image_list is not obtained in synchronous state, please keep request_id and call Querying Async Task Results API to obtain the processing result.
Asynchronous task results are valid for 30 minutes. It is recommended that asynchronous task results be queried every 5 seconds.