AI驱动的API
释义文本
生成提供文本的释义版本。
此 API 非常适合从事内容管理系统、重写工具或增强内容独特性的开发人员。它在保持原意的同时自动化改写文本的过程，使其成为内容创作、学术写作和营销文案的理想选择。使用案例包括为 SEO 创建独特内容、生成替代文本版本以及提高可读性。
仅需要 content 参数。
您可以定义输出语言、最大字符长度和语气。在上下文参数中可以提供有关如何处理文本的附加说明。请记住，max_length 作为语言模型的强烈建议，而不是严格要求，以保持结果的整体意义。
您可以通过提供 voice_tone 参数来设置您的首选写作风格。它可以是形容词，比如 funny 或 joyous，甚至是著名作家的名字。
此 API 方法还提供了一个可选的 context 参数，可以用于提供额外的灵活内容处理说明。
AI 工作涉及两个关键步骤：
- 提交AI任务： 通过发送工作请求来启动流程。
- 监控和接收结果： 持续检查作业状态，并在成功完成后获取最终输出。
相关SDK/库
-full_size.jpg)
Step 1. 提交 AI 工作请求
Endpoint: POST - /api/v1/content/paraphrase
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| content | String | Yes | 提供要改写的内容。 |
| language | String | No | 指定输出语言，默认为 English。 |
| voice_tone | String | No | 指定输出的语气。可以是形容词如 funny 或 joyous，甚至是 famous writer 的名字。 |
| max_length | Number | No | 指定改写内容的最大长度。 |
| context | String | No | 提供额外的背景以提高改写的准确性。 |
请求示例:
{
"content": "红牛的马克斯·维斯塔潘说，本周末的拉斯维加斯大奖赛是\"99% 的表演和 1% 的体育赛事\"。 \n\n 这位三届世界冠军表示，他对比赛周围的喧闹不\"感到期待\"，这也是一级方程式赛车首次在这座城市著名的地段比赛。 \n\n 其他领先车手对这种炒作则持更模棱两可的态度。\n\n 阿斯顿·马丁的费尔南多·阿隆索说：\"考虑到已经做出的投资和我们比赛的地方，值得给予一点[的]不同待遇和额外的表演。\" \n\n 周末在周三晚上以盛大的开幕式拉开帷幕。\n\n 其特色是由几位音乐明星的表演，包括凯莉·米洛和旅行者乐队，并在灯光和音效表演下，车手被升降到稀疏的观众面前。 \n\n 刘易斯·汉密尔顿说：\"来到这里真是太棒了。这很令人兴奋 - 如此令人难以置信的地方，如此多的灯光，巨大的能量，巨大的嗡嗡声。 \n\n \"这是最具标志性的城市之一。它肯定是一个大秀。它永远不会像银石那样[在历史和纯粹性方面]。但也许随着时间的推移，这里的社区人们会逐渐热爱这项运动。\" \n\n 汉密尔顿补充道：\"这最终是一项业务。你仍然会看到这里有好的比赛。 \n\n \"也许赛道会很好，也许会很糟。在[模拟器]上感觉一般般。在尝试之前不要批评。我听说有很多人抱怨[F1总裁] Stefano [Domenicali] 和[所有者] Liberty 的方向[但]我认为他们做得非常出色。\"",
"max_length": 500,
"language": "English",
"voice_tone": "David Attenborough alike",
"context": "replace Lewis first name with Bob"
}
响应示例:
{
"status_url": "https://sharpapi.com/api/v1/content/translate/job/status/5de4887a-0dfd-49b6-8edb-9280e468c210",
"job_id": "5de4887a-0dfd-49b6-8edb-9280e468c210"
}````
---
## Step 2. 监控并获取 AI 工作结果
**Endpoint:** `GET - /api/v1/content/paraphrase/job/status/:uuid`
一个端点用于检查请求的 API 工作的进度。
**结果示例:**
```json
{
"data": {
"type": "api_job_result",
"id": "385fec60-e73e-458c-a6c9-6e76e5a76661",
"attributes": {
"status": "success",
"type": "content_paraphrase",
"result": {
"paraphrase": "红牛的马克斯·维斯塔潘评论说，拉斯维加斯大奖赛是\'99% 的表演和 1% 的体育\'。这位三届世界冠军对这个盛会并不感到兴奋，这标志着 F1 首次在这座城市的地段比赛。其他车手，如费尔南多·阿隆索，承认了独特的投资和场地。活动以盛大的仪式开始，特色是像凯莉·米洛这样的明星。鲍勃·汉密尔顿表达了对这个标志性城市的兴奋，注意到表演和体育的结合，并称赞 F1 在 Stefano Domenicali 和 Liberty 的领导下的方向。"
}
}
}
}