查询图片翻译结果

POSThttp://***/query_result消耗: 免费

此接口用于根据 RequestId 查询图片翻译任务的状态和结果，返回翻译后的图片信息。

请求参数

名称	类型	必填	描述
AccountId	string	是	账号ID。
RequestId	string	是	任务标识，从"异步提交任务"接口返回。
UnifiedFontSize	int	否	统一字体大小。设置后，图片中所有翻译后的文字将强制使用该字号（例如：24）。此参数与 FontSizeAdjustment 互斥，两者都传时优先使用本参数。注：传递此参数必须参与 Signature 签名计算。
FontSizeAdjustment	int	否	字体大小微调（相对值）。在算法自动排版的字号基础上，统一增加或减少字号（例如：传 5 表示所有字号变大5号，传 -3 表示所有字号缩小3号）。注：传递此参数必须参与 Signature 签名计算。
Signature	string	是	请求签名，用于验证请求合法性。

返回示例

{
    "RequestId": "D774D33D-F1CB-5A2C-A787-E0A2179239CE",
    "Code": 200,
    "Message": "Translation completed",
    "Data": {
        "InPaintingUrl": "https://example.com/result_inpainting.jpg",
        "TemplateJson": "{...}",
        "FinalImageUrl": "https://example.com/result_final.jpg"
    }
}

任务处理中时的返回示例：

{
    "RequestId": "D774D33D-F1CB-5A2C-A787-E0A2179239CE",
    "Code": 202,
    "Message": "Translation in progress",
    "Data": null
}

Python 调用示例

# -*- coding: utf-8 -*-
import base64
import hashlib
import hmac
import json
import time
import requests

API_ENDPOINT = "http://***/query_result"
ACCOUNT_ID = "pic_YOUR_ID"
SECRET_KEY = "YOUR_SECRET_KEY"

def generate_signature(params, secret_key):
    sorted_params = sorted(params.items())
    param_string = "&".join(
        f"{key}={value}"
        for key, value in sorted_params
        if value is not None and value != "" and key != "Signature"
    )
    sign_string = f"{param_string}&SecretKey={secret_key}"
    signature = hmac.new(
        secret_key.encode("utf-8"),
        sign_string.encode("utf-8"),
        hashlib.sha256
    ).digest()
    return base64.b64encode(signature).decode("utf-8")

def call_api():
    params = {
        "AccountId": ACCOUNT_ID,
        "RequestId": "D774D33D-F1CB-5A2C-A787-E0A2179239CE",
    }
    params["Signature"] = generate_signature(params, SECRET_KEY)

    response = requests.post(API_ENDPOINT, json=params, timeout=60)

    try:
        print(json.dumps(response.json(), indent=2, ensure_ascii=False))
    except ValueError:
        print(response.text)

if __name__ == "__main__":
    call_api()

Java 调用示例

import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.util.Base64;
import java.util.Locale;
import java.util.Map;
import java.util.TreeMap;
import java.util.stream.Collectors;

public class PicTechQueryResultDemo {
    private static final String API_URL = "http://***/query_result";
    private static final String ACCOUNT_ID = "pic_YOUR_ID";
    private static final String SECRET_KEY = "YOUR_SECRET_KEY";

    public static void main(String[] args) throws Exception {
        Map<String, Object> params = new TreeMap<>();
        params.put("AccountId", ACCOUNT_ID);
        params.put("RequestId", "D774D33D-F1CB-5A2C-A787-E0A2179239CE");
        params.put("Signature", generateSignature(params, SECRET_KEY));

        String jsonBody = buildJson(params);
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(API_URL))
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
                .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }

    private static String generateSignature(Map<String, Object> params, String secretKey) throws Exception {
        String paramString = params.entrySet().stream()
                .filter(entry -> entry.getValue() != null && !entry.getValue().toString().isEmpty())
                .map(entry -> entry.getKey() + "=" + entry.getValue())
                .collect(Collectors.joining("&"));
        String signString = paramString + "&SecretKey=" + secretKey;

        Mac hmacSha256 = Mac.getInstance("HmacSHA256");
        hmacSha256.init(new SecretKeySpec(secretKey.getBytes(StandardCharsets.UTF_8), "HmacSHA256"));
        return Base64.getEncoder().encodeToString(
                hmacSha256.doFinal(signString.getBytes(StandardCharsets.UTF_8))
        );
    }

    private static String buildJson(Map<String, Object> params) {
        return "{" + params.entrySet().stream()
                .map(entry -> "\"" + entry.getKey() + "\":" + toJsonValue(entry.getValue()))
                .collect(Collectors.joining(",")) + "}";
    }

    private static String toJsonValue(Object value) {
        if (value instanceof Number || value instanceof Boolean) {
            return value.toString();
        }
        return "\"" + escapeJson(value.toString()) + "\"";
    }

    private static String escapeJson(String value) {
        return value
                .replace("\\", "\\\\")
                .replace("\"", "\\\"")
                .replace("\n", "\\n")
                .replace("\r", "\\r")
                .replace("\t", "\\t");
    }
}