圖片變清晰概述

圖片變清晰API提供了一種便捷的方式來提升圖像的清晰度。開發者可以通過該API對上傳的圖片進行處理，以獲得更高質量的圖像。該API支持文件上傳和通過URL下載的方式獲取源圖像，適用于多種應用場景。

使用流程

1. 創建任務: 開發者首先需要調用API創建一個圖片變清晰的任務。根據需求，開發者可以選擇是否等待結果返回。
2. 獲取結果: 創建任務后，開發者可以通過任務ID來查詢處理結果。API提供了輪詢機制，開發者可以定期查詢任務狀態，直到獲取最終結果。
3. 下載處理后的圖片: 一旦任務完成，開發者可以下載處理后的圖片，鏈接在任務完成后會返回。請注意，鏈接的有效期為1小時，建議及時下載并保存。

注意事項

• 圖片格式和大小要求: 處理的圖片必須符合格式和大小的限制。支持的格式包括jpg, jpeg, bmp, png等，最大尺寸為4096x4096像素，且文件大小不得超過15MB。
• 請求頻率限制: API對請求頻率有一定的限制，默認情況下每秒最多可請求2次。若超出限制，可能會收到429錯誤提示。
• 任務結果保留時間: 任務結果在生成后最多只會保留1小時。開發者需在此時間內下載結果，過期后將無法獲取。

調試與測試

開發者可以通過在線調試工具進行測試，以確保API集成的順利進行。調試工具支持文件上傳和URL輸入，便于快速驗證API的功能。

錯誤處理

在使用API的過程中，開發者可能會遇到不同的錯誤代碼。常見的錯誤包括：

• 400: 客戶端參數傳遞錯誤，需檢查參數是否缺失或值是否正確。
• 401: 認證失敗，需確認API Key是否正確。
• 429: 請求頻率超出限制，需降低請求速率。

Java 示例代碼

以下是一個使用Java調用圖片變清晰API的示例代碼：

import okhttp3.*;
import java.io.File;
import java.io.IOException;

public class ImageEnhancer {
    private static final String API_KEY = "YOUR_API_KEY";
    private static final String BASE_URL = "https://techsz.aoscdn.com/api/tasks/visual/scale";

    public static void main(String[] args) throws Exception {
        String imagePath = "/path/to/image.jpg"; // 源圖像文件路徑
        String taskId = createTask(imagePath);
        if (taskId != null) {
            pollingTaskResult(taskId);
        } else {
            System.out.println("Error: Failed to create task.");
        }
    }

    private static String createTask(String imagePath) throws IOException {
        OkHttpClient client = new OkHttpClient();
        RequestBody requestBody = new MultipartBody.Builder()
                .setType(MultipartBody.FORM)
                .addFormDataPart("image_file", new File(imagePath).getName(),
                        RequestBody.create(MediaType.parse("image/jpeg"), new File(imagePath)))
                .addFormDataPart("sync", "0") // 選擇是否等待結果
                .build();

        Request request = new Request.Builder()
                .url(BASE_URL)
                .addHeader("X-API-KEY", API_KEY)
                .post(requestBody)
                .build();

        Response response = client.newCall(request).execute();
        String responseBody = response.body().string();
        // 解析響應以獲取任務ID
        // TODO: 添加解析邏輯
        return taskId; // 返回任務ID
    }

    private static void pollingTaskResult(String taskId) throws InterruptedException, IOException {
        OkHttpClient client = new OkHttpClient();
        String url = BASE_URL + "/" + taskId;

        for (int i = 0; i < 30; i++) { // 最多輪詢30次
            Thread.sleep(1000); // 每秒輪詢一次
            Request request = new Request.Builder()
                    .url(url)
                    .addHeader("X-API-KEY", API_KEY)
                    .get()
                    .build();

            Response response = client.newCall(request).execute();
            String responseBody = response.body().string();
            // TODO: 解析響應以判斷任務狀態
            // 如果任務成功，下載結果
            // 如果任務失敗，記錄錯誤
        }
    }
}

總結

圖片變清晰API為開發者提供了一個強大的工具，能夠有效提升圖像質量。通過合理的調用和錯誤處理，開發者可以在應用中充分利用該API的功能，提升用戶體驗。