POST管理接口
AI 翻译内容
把一条内容的若干字段译成目标语言，一次往返翻完整条 —— 标题与正文一起给模型， 术语才对得上。 结果**只返回，不入库**：后台用它填译文草稿，由人过一眼、改完再照常保存。 `target_locale` 必须是该项目已注册的语言（同义标签同样算命中，大小写不敏感）， 返回的 `locale` 是注册表里的主标签。`fields` 的键取自 `kind` 的字段清单 （`announcement`：title / content；`project`：name / description）， 空值字段会被丢弃、不发给模型。 AI 翻译未启用或配置不全时返回 400；上游不可达或回包不是预期的 JSON 时返回 502/503。
URL
/api/v1/admin/projects/{projectKey}/translate鉴权方式
需要管理员 JWT（Authorization: Bearer <token>）
请求参数
Path 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| projectKey | string | 是 | 项目主键 project_key（大小写不敏感） |
Header 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer <管理员 JWT 或 API Key> |
请求体
{
"kind": "announcement",
"target_locale": "en",
"source_locale": "zh-CN",
"fields": {
"title": "新版本发布",
"content": "本次更新修复了若干问题。"
}
}响应示例
200 响应
{
"locale": "string",
"provider": "openai",
"model": "string",
"fields": {}
}POST
