API 文档 | Try AI Writer — 1 行代码接入 AI 写作能力

Introduction

Try AI Writer API 让你把业界最强的中文 AI 写作能力集成到自家产品中。只需 1 个 API key 即可调用 6 大平台写作模板，30+ 预置 prompt，实时流式输出（Server-Sent Events）。

⚡

超快响应

P99 < 800ms，边缘节点加速

🔒

安全合规

SOC 2 + GDPR + 中国数据本地化

🎯

风格可控

数字分身 · 6 维风格指纹匹配

Base URL： https://api.tryaiwriter.com/v1

Authentication

所有 API 请求需要在 Authorization 头中携带你的 API key。你可以在 Dashboard → API Keys 页面生成。

bash

curl https://api.tryaiwriter.com/v1/generate \
  -H "Authorization: Bearer sk-aiw-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{ "platform": "xiaohongshu", "topic": "初秋穿搭" }'

请妥善保管你的 API key。泄露后请立即在 Dashboard 撤销并重新生成。我们不会存储你的 key 明文。

Quickstart

下面的示例展示 30 秒内生成一篇小红书种草文。选择你的语言：

cURL

curl -X POST https://api.tryaiwriter.com/v1/generate \
  -H "Authorization: Bearer sk-aiw-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "xiaohongshu",
    "topic": "初秋氛围感穿搭",
    "style": "friendly",
    "max_tokens": 800
  }'

💡 完整 SDK 列表见 SDKs 章节。

Endpoints

公开 API v1 共 6 个端点，覆盖写作、风格管理、用户账户、计费、Webhook。

POST

/v1/generate

生成一篇文章，支持 6 大平台模板与自定义 prompt。

POST

/v1/generate/stream

SSE 流式输出，逐字返回生成内容，节省首字延迟。

GET

/v1/templates

获取 30+ 预置模板列表，支持按平台/类别筛选。

训练 / 更新你的数字分身风格指纹。

查询当前周期的 API 调用量、token 消耗、剩余配额。

POST

/v1/webhooks

Rate Limits

每个 API key 都有速率限制。Free 档 60 次/分钟，Pro 档 600 次/分钟，Max 档 3000 次/分钟。

档位	RPM	TPM	并发	月调用上限
Free	60	60k	5	10k
Pro	600	600k	50	100k
Max	3000	3M	200	1M

响应头会返回 X-RateLimit-Remaining 字段，实时显示剩余配额。

Errors

错误返回标准 HTTP 状态码 + JSON 错误体：

json

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "API key exceeded 60 requests per minute. Upgrade to Pro for higher limits.",
    "doc_url": "https://docs.tryaiwriter.com/errors#rate_limit_exceeded",
    "request_id": "req_8f2k3j4h5g6f7d8s"
  }
}

400

invalid_request

请求参数缺失或格式错误，请检查必填字段。

401

invalid_api_key

API key 无效或已撤销，请在 Dashboard 重新生成。

429

rate_limit_exceeded

超过速率限制，请降低并发或升级档位。

500

internal_error

服务器内部错误，请稍后重试。

503

model_overloaded

上游模型暂时过载，请稍后重试（带 Retry-After 头）。

Webhooks

异步长任务（如批量生成 100 篇文章）可通过 Webhook 接收完成通知。所有 Webhook 携带 X-AIW-Signature 头用于验签。

json

// POST to your webhook URL
{
  "event": "batch.completed",
  "id": "evt_8f2k3j4h5g6f7d8s",
  "created_at": "2026-06-08T10:23:45Z",
  "data": {
    "batch_id": "batch_abc123",
    "total": 100,
    "succeeded": 98,
    "failed": 2,
    "articles": [/* ... */]
  }
}