ArtSEO 写作工具 接口手册

概览

  • 入口：/newseoallcredits-api.php
  • 方法：POST（创作）、GET（任务查询）
  • 鉴权：本站账号 auth_username + auth_password
  • 模型路由：model/modelSelect = GPT-4（默认）/GPT-5.1；
  • WP 发布凭据仍用 username / password（Application Password）

主要参数

必填除非注明可选，保持与前端一致。

参数 说明
auth_username, auth_password 本站登录鉴权（非 WP 账号）
model / modelSelect GPT-4 / GPT-5 / GPT-5.1，默认 GPT-4
keyword 多行关键词/标题，每行一篇
writelang 写作语言，例如 English (American)
brandname 品牌名
protype 1 博客；2 产品
issitemap 1 内链；2 不内链
website 选内链时必填，形如 https://example.com/
isimg 1 自动配图；2 不配图
imgtype 1 AI 生图；2 搜图
aiimgsize 1:1 或 16:9，当 imgtype=1 必填
aiimgcount 1-10，imgtype=1 必填
postid WP 分类 ID，逗号分隔，发布到 WP 时必填
ispublish 1 发布；2 草稿
username, password WP 发布账号与 Application Password
lsikeyword 可选，LSI 关键词，多行
preloaded_sitemap 可选，数组，站点地图 URL 列表

请求示例

curl

curl -X POST https://artseo.cn/newseoallcredits-api.php \
  -H "Content-Type: application/json" \
  -d '{
    "auth_username": "site_user",
    "auth_password": "site_pass",
    "modelSelect": "GPT-5",
    "keyword": "solar panel installation",
    "writelang": "English (American)",
    "lsikeyword": "precision machining\nCNC parts",
    "brandname": "ChinaCNC",
    "protype": "1",
    "issitemap": "1",
    "website": "https://www.example.com/",
    "isimg": "1",
    "imgtype": "1",
    "aiimgsize": "16:9",
    "aiimgcount": 3,
    "postid": "5,8",
    "ispublish": "1",
    "username": "wp_app_user",
    "password": "wp_app_pass"
  }'

PHP

$payload = [/* 同上 */];
$ch = curl_init('https://artseo.cn/newseoallcredits-api.php');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 120,
]);
$res  = curl_exec($ch);
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

返回示例（成功）

{
  "success": true,
  "wp_published": true,
  "message": "创作成功！WordPress发布成功！文章ID: 7067",
  "task_id": "task_xxx",
  "data": {
    "csv_saved": true,
    "wp_published": true,
    "message": "WordPress发布成功！文章ID: 7067",
    "local_content_id": 18050,
    "generated_ai_images": 0,
    "charged_ai_images": 0,
    "generated_ai_image_urls": [],
    "image_credit_cost": 0,
    "total_credit_cost": 1,
    "title": "Solar Panel Installation ...",
    "content": "<p>...HTML...</p>"
  }
}
  • content 可直接作为 HTML 渲染；如需防 XSS，可自行清洗或转义。
  • 扣费字段：total_credit_cost、charged_ai_images、image_credit_cost。

常见错误码

  • 400：auth_username/auth_password 为空或参数缺失
  • 401：鉴权失败（本站账号密码错误）
  • 409：未登录（下游要求登录但未注入 user_id）
  • 411：余额不足
  • 500：服务器错误或目标写作引擎缺失

任务查询（GET）

  • 最近任务：GET https://artseo.cn/newseoallcredits-api.php?action=user_tasks&limit=20
  • 单任务状态：GET https://artseo.cn/newseoallcredits-api.php?action=task_status&task_id=xxx