[Important Notice: API Integration Update Required]Dear Developers,Thank you for your continued support of the AILabTools API.We would like to inform you that the current API has been updated with changes to the request and response specifications. These changes involve adjustments to parameters and response fields, and may affect existing integrations that rely on the previous API behavior.To ensure your application continues to work correctly, we strongly recommend that you review and update your current API integration as soon as possible.If you have any questions or need assistance with updating your integration, please feel free to contact our support team:
📧 support@ailabtools.comThank you for your understanding and cooperation. We appreciate your continued trust in AILabTools.Best 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.