翻译接口文档

本接口提供文本翻译能力：调用成功将返回翻译结果，并自动扣减该 appid 的可用额度（1 次调用 = 1 点）。

1. 概览

2. 请求说明

请求 JSON 结构：

{
    "appid": "demoApp1",
    "key": "secretKeyAbc",
    "text": "你好，世界！",
    "target_language": "en",
    "source_language": "auto" // 可选，当前内部自动检测，可省略
  }

3. 响应说明

成功响应：

{
    "translatedText": "Hello, world!"
  }

失败响应：

{
    "error": "no credits"
  }

4. 常见错误

5. 示例代码

5.1 cURL

curl -X POST "https://fy-api.zaofont.com" \
   -H "Content-Type: application/json" \
   -d '{
    "appid": "demoApp1",
    "key": "secretKeyAbc",
    "text": "今天天气很好，我们去公园散步吧。",
    "target_language": "en"
  }'

5.2 Python (requests)

import requests
  
  API_URL = "https://fy-api.zaofont.com"
  APPID = "demoApp1"
  KEY = "secretKeyAbc"
  
  def translate(text, target="en", source=None):
      payload = {
          "appid": APPID,
          "key": KEY,
          "text": text,
          "target_language": target
      }
      if source:
          payload["source_language"] = source
      r = requests.post(API_URL, json=payload, timeout=15)
      r.raise_for_status()
      data = r.json()
      if "translatedText" in data:
          return data["translatedText"]
      raise RuntimeError(data)
  
  print(translate("你好，世界！", "en"))

5.3 Node.js (fetch)

const API_URL = "https://fy-api.zaofont.com";
  const APPID = "demoApp1";
  const KEY = "secretKeyAbc";
  
  async function translate(text, target = "en", source) {
    const body = {
      appid: APPID,
      key: KEY,
      text,
      target_language: target
    };
    if (source) body.source_language = source;
  
    const res = await fetch(API_URL, {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify(body)
    });
    const data = await res.json();
    if (!res.ok || !data.translatedText) {
      throw new Error(data.error || "Translate failed");
    }
    return data.translatedText;
  }
  
  translate("测试一下接口", "en")
    .then(console.log)
    .catch(console.error);

5.4 PHP (cURL)

<?php
  $apiUrl = "https://fy-api.zaofont.com";
  $payload = [
    "appid" => "demoApp1",
    "key" => "secretKeyAbc",
    "text" => "欢迎使用翻译接口",
    "target_language" => "en"
  ];
  
  $ch = curl_init();
  curl_setopt_array($ch, [
    CURLOPT_URL => $apiUrl,
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Content-Type: application/json"],
    CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
    CURLOPT_TIMEOUT => 15,
  ]);
  $res = curl_exec($ch);
  if ($res === false) { die("Curl error: ".curl_error($ch)); }
  $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
  curl_close($ch);
  $data = json_decode($res, true);
  if ($code >= 400) { var_dump($data); exit; }
  echo $data["translatedText"] ?? "failed";
  

5.5 Java (HttpClient)

import java.net.http.*;
  import java.net.URI;
  import java.time.Duration;
  
  public class TranslateClient {
    static final String API_URL = "https://fy-api.zaofont.com";
    static final String APPID = "demoApp1";
    static final String KEY = "secretKeyAbc";
  
    public static void main(String[] args) throws Exception {
      String text = "这是一个测试";
      String json = String.format(
        "{\"appid\":\"%s\",\"key\":\"%s\",\"text\":\"%s\",\"target_language\":\"en\"}",
        APPID, KEY, escape(text)
      );
  
      HttpClient client = HttpClient.newBuilder()
        .connectTimeout(Duration.ofSeconds(5))
        .build();
  
      HttpRequest req = HttpRequest.newBuilder()
        .uri(URI.create(API_URL))
        .timeout(Duration.ofSeconds(15))
        .header("Content-Type", "application/json")
        .POST(HttpRequest.BodyPublishers.ofString(json))
        .build();
  
      HttpResponse<String> resp = client.send(req, HttpResponse.BodyHandlers.ofString());
      System.out.println(resp.body());
    }
  
    static String escape(String s){
      return s.replace("\\", "\\\\").replace("\"","\\\"");
    }
  }

6. 最佳实践 & 建议

• 分段翻译： 超长文本自行按段拆分，合并结果。
• 本地缓存： 相同文本 hash 后命中缓存，减少额度消耗。
• 错误重试： 仅对网络类错误做指数退避；业务错误勿重试。
• 安全： 不在公开前端硬编码真实 key，建议后端代理。
• 限频： 客户端自行节流（如 <= 5 QPS），避免被封禁。
• 监控： 统计成功率、耗时、错误分布，及剩余额度预警。

7. FAQ

最后更新：