API Access

Tona 提供了简单的 REST API，方便你以编程方式创建 instruction 和获取项目信息。如果你想把 Tona 集成到自己的工作流、脚本或第三方工具中，这会非常有用。

获取 API 凭证

1. 进入项目并点击侧边栏里的 Manual。
2. 点击页面右上角的 Use API 链接。
3. 你会看到 API Key、Base URL 和 Authorization Header。

每个项目都有独立的 API Key。请妥善保管，不要公开分享。

可用端点

获取项目信息

用于获取项目详情，包括名称、描述、积分和已连接平台账号。

Request:

GET /v1/project
Authorization: Bearer <your-api-key>

创建 Instruction

像在控制台里一样提交新的 instruction。你可以指定目标平台、内容 prompt，并可选附加图片。

Request:

POST /v1/instructions
Authorization: Bearer <your-api-key>
Content-Type: application/json

{
  "platformAccountIds": ["<account-id>"],
  "content": "Post a tweet about our new product launch",
  "images": ["https://example.com/image.webp"]
}

你可以先调用 Get Project 接口来获取平台账号 ID。

复制为 Markdown

在 API 页面点击 Copy as Markdown，可以把完整 API 文档连同你的真实 API Key 一起复制到剪贴板。这样你就能方便地粘贴到笔记里，或者发给团队中的开发者。

使用建议

• 保护好 API Key。 把它当作密码处理。如果怀疑泄露，请及时联系支持。
• 先用单个平台测试。 集成时先选一个平台账号验证流程，确认没问题后再扩大规模。