POST Tạo Tác Vụ Dịch Hình Ảnh
Tạo Tác Vụ Dịch Hình Ảnh Shop Scope bắt buộc: serller.product.optimize Khởi tạo một tác vụ dịch cho một hoặc nhiều hình ảnh. API bất đồng bộ này đưa các hình ảnh vào hàng đợi để xử lý theo ngôn ngữ đích được chỉ định. Chỉ áp dụng cho người bán bán hàng xuyên khu vực EU. Sử dụng webhook Image Translation Completed
để theo dõi tiến trình dịch, hoặc truyền task ID vào Get Image Translation Tasks API
để lấy trạng thái và các hình ảnh đã được dịch. Lưu ý:
- Vui lòng đợi 5 phút sau khi tạo tác vụ trước khi gọi endpoint Get, và thử lại theo các khoảng cách trên 10 giây để tránh bị giới hạn tần suất.
- Mỗi tác vụ tương ứng với việc dịch 1 hình ảnh sang 1 ngôn ngữ đích.
- Bạn có thể tạo tối đa 20 tác vụ mỗi lần gọi và 500 tác vụ mỗi ngày. Bất kỳ tác vụ nào vượt quá giới hạn hàng ngày sẽ bị từ chối. Phiên bản 202505
POST/product/202505/images/translation_tasks
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được cho phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của người bán từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của người bán. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key duy nhất. Vui lòng dùng key cụ thể được gán cho app của bạn. |
| sign Required | string | Chữ ký được tạo bởi thuật toán gen. Khi bạn gửi các yêu cầu API tới TTS, bạn phải ký chúng để TTS có thể nhận diện người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được dùng cho tất cả các yêu cầu API. Lập trình viên có thể dùng giá trị này để chuyển đổi sang giờ địa phương. |
| shop_cipher Required | string | Dùng thuộc tính này để truyền thông tin shop khi yêu cầu API. Việc không truyền đúng giá trị khi yêu cầu API cho các shop xuyên biên giới sẽ trả về phản hồi không chính xác. Lấy bằng API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| images Required | []object | Danh sách các hình ảnh cần dịch.Sử dụng Upload Product Image API để tải lên các hình ảnh trước và lấy các image URI tương ứng.Lưu ý: Tổng số tổ hợp hình ảnh và ngôn ngữ đích không được vượt quá 20. Ví dụ, bạn có thể gửi 10 hình ảnh với 2 ngôn ngữ đích mỗi hình, nhưng bạn không thể gửi 10 hình ảnh với 5 ngôn ngữ đích mỗi hình. |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | Mã trạng thái thành công hoặc thất bại được trả về trong phản hồi API. |
| message | string | Các thông báo thành công hoặc thất bại được trả về trong phản hồi API. Lý do thất bại sẽ được mô tả trong thông báo. |
| request_id | string | Nhật ký yêu cầu |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
Xem các mã lỗi phổ biến
| Code | Message | | --- | --- | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 12038008 | The image URI is invalid. Please use the URI generated by the Upload Product Image API. | | 12038009 | The specified target_language is invalid or unsupported. | | 12038010 | The number of translation task IDs exceeded the limit of 20. | | 12038012 | Exceeded the daily limit of 500 translation tasks. | | 12038013 | This operation is not available for this shop. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext