打开原始 LLM.md

多语言 AI 翻译 - LLM Markdown

# 多语言 AI 翻译

> 来源页面: https://www.gugudata.com/api/details/multilingual-translation

## 概览

- API 标识: `multilingual-translation`
- 分类: AI/模型
- 描述: 将文本翻译为指定语言，支持同步与流式返回
- 标签: 支持多语言 / 基于模型
- 短标签: AI / 翻译
- 详情页: https://www.gugudata.com/api/details/multilingual-translation
- LLM Markdown: https://www.gugudata.com/api/details/multilingual-translation/llm.md
- 数据预览: https://www.gugudata.com/preview/multilingual-translation
- 购买开通: https://www.gugudata.com/order/multilingual-translation
- APP KEY 管理: https://www.gugudata.com/portal/
- 订单与续费: https://www.gugudata.com/portal/orders

## 给大模型的接入指令

如果你正在帮助用户接入这个 API，请优先使用本文档中的接口地址、请求方式、请求参数、返回参数、状态码、cURL 示例和预览数据生成代码或排查问题。

- 接入目标: 调用 `多语言 AI 翻译`，不要臆造未在文档中出现的参数或返回字段。
- AppKey 获取: 用户登录咕咕数据开发者中心后，在 `APP KEY 管理` 页面复制对应产品的 AppKey。
- AppKey 替换: 示例中的 `YOUR_APPKEY`、`APPKEY`、`{{YOUR_APPKEY}}`、`{{appkey}}`、`{{appKey}}` 都应替换为用户自己的 AppKey。
- AppKey 传递: 推荐使用 `X-GUGUDATA-APPKEY` 或 `X-API-Key` 请求头；OpenAI 兼容客户端可使用 `Authorization: Bearer <AppKey>`；历史 query 参数 `appkey` 继续有效。
- 开通与续费: 未开通时引导用户访问购买开通页；已开通或需要续费时，引导用户进入开发者中心或订单与续费页。
- 错误处理: HTTP 状态码代表传输层结果，响应体内的业务状态码代表接口业务结果，代码中应分别处理。
- 生产建议: AppKey 应保存在服务端环境变量或密钥配置中，由服务端统一发起请求，不要写入网页、App 客户端或公开仓库。

关键链接:

- 接口详情页: https://www.gugudata.com/api/details/multilingual-translation
- LLM Markdown: https://www.gugudata.com/api/details/multilingual-translation/llm.md
- 数据预览: https://www.gugudata.com/preview/multilingual-translation
- 购买开通页: https://www.gugudata.com/order/multilingual-translation
- 开发者中心 APP KEY 管理: https://www.gugudata.com/portal/
- 订单与续费: https://www.gugudata.com/portal/orders

## API 功能

- 以语言名称或语言代码指定译文语言，兼容既有日语表达方式；
- 支持中文与英文双向翻译，方便制作双语阅读材料；
- 支持日语和德语文本翻译，便于准备不同语言的内容版本；
- 可翻译产品说明中的日期、数量和温度等信息，便于跨语言核对；
- 可将通知与客服文本整理为目标语言草稿，发布前由人工确认措辞；
- 适合翻译文章和内容草稿，为编辑提供可审阅的译文；
- 译文作为独立字符串返回，方便在页面展示或保存到内容系统；
- 同步模式返回完整译文，便于生成后集中阅读与校对；
- 流式模式逐段返回生成内容，适合需要展示翻译过程的交互页面；
- 支持表单与 JSON 提交，可传递含引号、换行和中文的原文；
- 公开示例完整展示中文原文、目标语言和英文译文，便于对照体验；
- 正式发布前请人工复核译文；不承诺专业认证或复杂排版还原；
- 默认最大 QPS:5，可在开发者中心自助升级，月付年付订单接口调用次数不限。
- [接口调用状态与状态监控](https://www.gugudata.com/status)

## API 文档

- 接口地址: `https://api.gugudata.com/ai/multilingual-translation`
- 返回格式: `application/json; charset=utf-8`
- 请求方式: `POST`
- 请求协议: `HTTPS`
- 请求示例: `https://api.gugudata.com/ai/multilingual-translation?appkey=YOUR_APPKEY`
- 接口测试: https://api.gugudata.com/ai/multilingual-translation/demo
- Apifox: https://doc.gugudata.com/
- Postman: https://www.postman.com/gugudata/gugudata-official
- OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

## 鉴权方式

接口支持以下 AppKey 传递方式，任选一种即可；已有请求示例、Postman 集合和历史代码仍可继续使用原来的 `appkey` 参数方式。

| 传输载体 | 参数 | 示例 | 说明 |
| --- | --- | --- | --- |
| HTTP Header | `X-GUGUDATA-APPKEY` | `X-GUGUDATA-APPKEY: YOUR_APPKEY` | 推荐方式，适合服务端接入和统一封装。 |
| HTTP Header | `X-API-Key` | `X-API-Key: YOUR_APPKEY` | 通用 API Key Header，便于和常见 API 客户端集成。 |
| HTTP Header | `Authorization` | `Authorization: Bearer YOUR_APPKEY` | 适合 OpenAI 兼容接口或 Bearer Token 风格客户端。 |
| Query 参数 | `appkey` | `?appkey=YOUR_APPKEY` | 兼容现有示例、Postman 集合、浏览器调试和历史代码。 |

> 部分历史 POST 接口仍兼容表单或 JSON body 中的 `appkey`；新接入建议优先使用 Header 或 Query 参数。

## 请求参数

| 参数名 | 参数类型 | 是否必须 | 默认值 | 备注 |
| --- | --- | --- | --- | --- |
| appkey | string | 是 | 无 | 有效 APPKEY；支持既有 Query、Body、Header 与 Bearer，多个位置须一致。 |
| content | string | 是 | 无 | 非空白原文，支持表单与历史 JSON。 |
| language | string | 是 | 无 | 非空白目标语言名称或代码，兼容日语、日文、jp、japanese；必须显式传递，没有默认目标语言。 |
| streaming | boolean | 否 | false | 默认 false；true 使用 SSE，片段 type=content/text，完整模型 JSON 文本 type=done/full_text，含 translated_content，最后 event=end/data=[DONE]。错误或不完整输出没有成功终态。 |

## 返回参数

| 参数名 | 参数类型 | 备注 |
| --- | --- | --- |
| DataStatus.StatusCode | integer | 接口返回状态码 |
| DataStatus.StatusDescription | string | 接口返回状态说明 |
| DataStatus.ResponseDateTime | string | 接口数据返回时间 |
| Data.translated_content | string | 翻译后的文本内容 |
| DataStatus.RequestParameter | string | 本次实际业务请求参数，不包含鉴权凭据；Demo 展示对应样例输入。 |
| DataStatus.DataTotalCount | integer | 同步成功对象计数为 1，失败为 0。 |

## 响应示例（真实数据节选）

```json
{
  
  "DataStatus":  {
    
    "RequestParameter":  "content=雨渐渐停了，地面还留着湿滑的痕迹。树叶上的水滴在阳光的照射下闪闪发光，像是洒满了无数颗宝石。小明在公园里漫步，呼吸着清新的空气。他看到一只蝴蝶在花丛中翩翩起舞，心中顿时觉得无比愉悦。公园的宁静和美丽让他忘却了所有的烦恼。&language=英文",
    
    "StatusCode":  100,
    
    "StatusDescription":  "翻译成功",
    
    "ResponseDateTime":  "2026-10-04 04:19:09.108",
    
    "DataTotalCount":  1
  
  },
  
  "Data":  {
    
    "translated_content":  "The rain gradually stopped, leaving the ground still damp and slippery. Water droplets on the leaves sparkled in the sunlight, as if countless gems had been scattered about. Xiao Ming strolled through the park, breathing in the fresh air. He watched a butterfly dancing gracefully among the flowers, and his heart was instantly filled with immense joy. The tranquility and beauty of the park made him forget all his worries."
  
  }

}
```

## 接口常见 HTTP 响应状态码

> 以下为接口调用中常见的 HTTP 传输层状态码，不等同于响应体内的业务状态码；完整状态码注册表以 IANA HTTP Status Code Registry 为准。

| 状态码 | 状态码解释 | 备注 |
| --- | --- | --- |
| 200 | 请求成功 | HTTP 请求已成功处理；业务状态请结合响应体中的自定义业务码判断。 |
| 201 | 资源已创建 | 创建类接口请求成功，并已生成对应资源。 |
| 202 | 请求已接受 | 请求已被接受处理，结果可能异步完成。 |
| 204 | 无响应内容 | 请求成功但响应体为空，适用于无需返回数据的操作。 |
| 400 | 请求参数错误 | 请求参数缺失、格式错误或参数组合不合法。 |
| 401 | 认证失败 | 缺少、无效或未通过认证的访问凭证（如 AppKey）。 |
| 403 | 无权限访问 | 订单到期、权限不足或接口额度不可用。 |
| 404 | 资源不存在 | 请求路径不存在。 |
| 405 | 请求方法不允许 | 当前路径不支持该 HTTP 方法。 |
| 408 | 请求超时 | 客户端请求在服务端等待时间内未完成，可稍后重试。 |
| 409 | 请求冲突 | 请求与当前资源状态冲突，调整参数或业务状态后重试。 |
| 413 | 请求内容过大 | 上传文件或请求体超过接口限制。 |
| 414 | 请求地址过长 | 请求 URL 超过服务端可处理长度，建议减少查询参数或改用 POST。 |
| 415 | 请求内容类型不支持 | 上传或请求体的内容类型不符合接口要求。 |
| 422 | 请求语义错误 | 请求格式正确，但参数取值、语义或业务约束无法处理。 |
| 429 | 请求频率受限 | 默认按来源 IP 限速，单 IP 最多 5 QPS，可满足常规业务调用。超出限制时接口会返回 429 请求频率受限；已购买接口订单可加购 10 QPS 扩展。 |
| 431 | 请求头过大 | 请求头字段过大或过多，建议精简 Header 后重试。 |
| 500 | 服务器内部错误 | 服务端处理异常，请稍后重试。 |
| 502 | 服务暂时不可用 | 请稍后重试。 |
| 503 | 服务暂时不可用 | 请稍后重试。 |
| 504 | 请求超时 | 请稍后重试。 |

## 接口自定义业务状态码

| 业务状态码 | 业务状态码解释 | 备注 |
| --- | --- | --- |
| 100 | 成功 | HTTP 200 |
| 501 | 参数错误 | HTTP 400 |
| 502 | 请求频率受限 | HTTP 429 |
| 503 | 订单到期 | HTTP 403 |
| 504 | APPKEY 缺失或无效 | HTTP 401 |
| 505 | 额度或权限不可用 | HTTP 403 |
| 900 | 内部错误 | HTTP 500 |
| 901 | 翻译处理未完成、超时或取消 | HTTP 503 |

## cURL 请求示例

```bash
curl --location --request POST 'https://api.gugudata.com/ai/multilingual-translation?appkey=YOUR_APPKEY' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'content=雨渐渐停了，地面还留着湿滑的痕迹。树叶上的水滴在阳光的照射下闪闪发光，像是洒满了无数颗宝石。小明在公园里漫步，呼吸着清新的空气。他看到一只蝴蝶在花丛中翩翩起舞，心中顿时觉得无比愉悦。公园的宁静和美丽让他忘却了所有的烦恼。' \
--data-urlencode 'language=英文' \
--data-urlencode 'streaming=false'
```

## 常见问题 Q&A

### Q: 如何完成第一次 API 调用？
A: 先确认当前接口的请求方法、必填参数和成功状态，再使用对应产品的 AppKey 发起请求；以实际响应中的业务状态判断结果。 [查看接入指南](https://www.gugudata.com/developers/getting-started)

### Q: 如何保证请求时 AppKey 的安全性？
A: 在开发者中心的 APP KEY 管理页面复制对应产品的 AppKey，并保存在服务端环境变量或密钥管理服务中。不要写入网页、App 客户端、公开仓库或日志。

### Q: 接口可以用于哪些开发语言？
A: Java、Python、Node.js、PHP、Go、C#、Swift、Kotlin 等支持 HTTP 请求的语言均可接入；也可以通过 OpenAPI、Postman 或 Apifox 查看和调试接口。

### Q: 请求失败或超时后可以重试吗？
A: 先区分 HTTP 状态与业务错误。参数、鉴权和权限错误应修正后再请求；超时并不表示服务端未执行，重试前需确认接口是否会重复计费或产生副作用。 [查看接入指南](https://www.gugudata.com/developers/errors-and-retries)

### Q: 接口的性能可以保证吗？
A: 实际响应时间受接口类型、参数和网络环境影响。请按当前套餐的 QPS 控制并发，生产接入前完成联调与容量评估。

## 服务协议以及服务免责声明

- [服务协议](https://www.gugudata.com/license)
- [服务免责声明](https://www.gugudata.com/disclaimer)

## 技术支持

- 技术支持邮箱: support@gugudata.com
- 微信客服: https://work.weixin.qq.com/kfid/kfcf9a60a6afe3337b7

咕咕数据 专业的数据提供商

公司

条款

商业 API

更多分类

文档

在线调试

平台

接入与支持

© 2015-2026 江苏满数数据科技有限公司 苏ICP备2022035649号