GeoForce 开放平台 API

用一把密钥接入 GEO 多智能体全部能力。最近更新:2026-09-06

本文档描述 GeoForce 开放平台 API(当前版本 v1,路径不带版本号;未来不兼容变更将以 /api/v2/… 前缀另行发布)。
接口基地址:https://geoforce.cn。所有示例均为服务端到服务端调用。

1. 概述与快速开始

GeoForce 是 GEO(生成式引擎优化)多智能体平台:围绕一个「优化问题」自动完成 意图问题生成 → 文章撰写 → 媒体匹配发布 → 数据统计 四步闭环,让品牌内容被豆包、DeepSeek、千问、腾讯元宝等 AI 搜索引用。开放平台把网页端的全部用户能力以 HTTP API 形式开放,第三方系统可以:

维护品牌/产品知识库,批量生成意图问题集;
创建优化任务,选择托管模式一键全自动跑完,或按状态机逐步驱动并人工审核;
查询媒体库、算力账单、任务进度与产物(文章、发布回链、统计报告);
合作方(渠道)通过专用接口为其终端客户开户、充值、签发密钥。

1.1 获取密钥

途径	说明
网页自助	登录 GeoForce → 左侧栏底部账号卡「API 密钥」按钮 → 输入名称 → 生成。明文只显示一次。
合作方代签	渠道合作方持合作方密钥调用 `POST /api/partner/accounts` 开户,响应里直接带该账号的第一把密钥;之后可用 `POST /api/partner/accounts/{id}/api-keys` 再签。

密钥形如 gf_ + 64 位十六进制,权限等同于该账号本人,调用消耗该账号算力。每个账号最多 5 把有效密钥,可随时在网页端撤销(立即生效)。

1.2 三步跑通一个托管任务

BASE=https://geoforce.cn
KEY=gf_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# ① 确认密钥可用(相当于 whoami)
curl -s $BASE/api/auth/me -H "Authorization: Bearer $KEY"
# {"ok":true,"data":{"id":12,"username":"demo","role":"client","industry_type":"通用","credits":1800,"plan_tier":"formal","plan_expires_at":"2027-03-06","via":"api_key",...}}

# ② 建品牌(知识库越完整,智能体产出越贴合)
curl -s -X POST $BASE/api/brands -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"name":"晨曦咖啡","industry":"咖啡连锁","positioning":"城市白领的第三空间","target_audience":"25-40 岁一线城市上班族"}'
# {"ok":true,"data":{"id":3}}

# ③ 建托管任务:auto_approve=1 时服务端自动跑完四步,无需再调任何 run-* 接口
curl -s -X POST $BASE/api/tasks -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"brand_id":3,"custom_questions":["上海哪家咖啡适合办公"],"auto_approve":1,"article_count":1,"media_price_cap_credits":100}'
# {"ok":true,"data":{"id":57,"ids":[57]}}

# ④ 轮询进度(建议 10~30 秒一次),status 到 stats_ready 即完成
curl -s $BASE/api/tasks/57 -H "Authorization: Bearer $KEY" | jq '.data.task | {status, running_step, managed_run}'

托管任务每一步仍独立扣费;算力不足或账号不可用时熔断停下,原因写在任务 messages 最后一条,也可用 GET /api/tasks/interrupted 一次拉取全部中断任务。

2. 鉴权

所有接口(除 /api/auth/login、/api/wiki 等公开接口)要求请求头:

Authorization: Bearer gf_xxxxxxxx…

规则	说明
密钥 = 账号	密钥能做的事与该账号在网页端能做的完全一致,数据隔离按账号。
上限	每账号 5 把有效密钥;撤销后名额释放。
撤销即时	网页端撤销后,下一次请求即 401。
不接受密钥的接口	`/api/admin/*`(管理端)、`/api/api-keys`(密钥管理)、`/api/auth/change-password`(改密)只认网页登录会话。防止泄露的密钥自我繁殖或反过来改密码。
合作方密钥	只能调 `/api/partner/`,调其它接口一律 401;反之账号级密钥调 `/api/partner/` 也是 401。
CORS	未开放跨域,请从服务端调用,不要把密钥放进浏览器前端。
泄露处理	立即在网页端撤销并重新生成;所有密钥调用都有审计日志,管理员可追溯。

3. 通用约定

3.1 响应包

{"ok": true,  "data": { ... }}
{"ok": false, "error": "中文错误说明"}

3.2 HTTP 状态码

状态码	含义	处理建议
200	成功	—
400	参数不合法 / 任务状态不允许该操作	看 `error` 修正参数;状态类错误要先查任务当前状态
401	未鉴权 / 密钥无效或已撤销 / 该接口不接受密钥	检查 Authorization 头
402	算力不足	充值后重试;`error` 里有需要与现有算力
404	资源不存在或不属于当前账号	两种情况刻意不区分
409	该任务的这一步正在执行中(并发抢占失败)	不是错误:等待或轮询任务状态,不要重试扣费
429	登录接口限流	仅 `/api/auth/login`
500	服务端错误	`error` 仅供排查,不要据其文本做分支

3.3 其它

时间:所有时间字段为服务器本地时间(东八区)裸串,形如 2026-09-06 14:32:10,不带时区标识。
分页:带 page 参数的列表接口返回 {items, total, page, page_size},page_size 上限 100(媒体库默认 50,数字人形象默认 24,其余默认 20)。部分列表接口不带 page 时返回旧协议的全量数组(文档逐条标注)。
金额:一律为「算力」,不出现人民币。
DELETE 参数:大多数接口经 query ?id=,个别经 JSON body,文档逐条标注。
枚举:目标平台、内容类型、问题类型等取值见附录。

4. SSE 流式接口

生成类接口(五个 run-*、问题集生成、重发等)返回 Content-Type: text/event-stream,逐行推送:

data: {"type":"start","step":"intent"}

data: {"type":"progress","current":1,"total":3,"label":"正在生成第 1 条"}

data: {"type":"item","entity":"intent","data":{"id":101,"question":"...","review_status":"pending"}}

data: {"type":"status","status":"intent_pending_review"}

data: {"type":"done","summary":{"generated":3}}

事件	字段	说明
`start`	`step`, `total?`	流开始;step 为 intent/article/media/publish/stats/intent_set…
`progress`	`current`, `total`, `label`	进度
`reasoning`	`delta`	模型思考过程增量(仅展示用)
`item`	`entity`, `data`	一条产物已落库(intent/article/plan/publish_result/report/intent_set_item…)
`item_error`	`label`, `message`	单条产物失败(已按篇退费)
`status`	`status`	任务状态推进
`error`	`message`	流内错误(通常已退费,消息里注明)
`done`	`summary`	结束,summary 结构随接口不同

双通道错误:流开始前的错误(401/402/400/409)仍是普通 JSON 响应,按 Content-Type 分流即可。

可以断开连接:算力在流开始前已扣,断开后服务端继续跑完并落库。之后轮询 GET /api/tasks/{id}:task.running_step 非空表示这一步仍在执行,task.status 推进表示完成,messages 里有失败说明。同步 HTTP 客户端建议设置 stream=True 或较短超时后直接轮询,避免阻塞到流结束(单步最长约 10 分钟)。

curl 示例:curl -N -X POST $BASE/api/tasks/57/run-intents -H "Authorization: Bearer $KEY"。自建反向代理需关闭响应缓冲(nginx proxy_buffering off)并把读超时放到 660 秒以上。

5. 任务状态机与人工审核

draft → intent_pending_review → intent_approved → articles_pending_review → articles_approved
      → media_pending_review → media_approved → published → stats_ready

接口	允许的起始状态	推进到
`POST run-intents`	`draft`, `intent_pending_review`	`intent_pending_review`(托管:`intent_approved`)
`POST review` entity=intent	`intent_pending_review`, `intent_approved`	有通过项即 `intent_approved`
`POST run-articles`	`intent_approved`, `articles_pending_review`	`articles_pending_review`(托管:`articles_approved`)
`POST review` entity=article	`articles_pending_review`, `articles_approved`	`articles_approved`
`POST run-media-match`	`articles_approved`, `media_pending_review`	`media_pending_review`(托管/mock:直通到 `published`)
`POST review` entity=plan	`media_pending_review`, `media_approved`	`media_approved`
`POST run-publish`	`media_approved`, `published`, `stats_ready`, `completed`	仅从 `media_approved` 推进到 `published`;其余状态用于重发失败篇
`POST run-stats`	`published`, `stats_ready`, `completed`	`stats_ready`

托管模式(auto_approve=1):通过 API 创建即由服务端流水线自动依次执行,产物自动通过审核;调用方只需轮询。中断(算力不足/账号不可用)后可补充算力再手动调对应 run-* 续跑。
人工模式:调用方按上表逐步 run-* → review → 下一步。同一任务同一时刻只允许一个 run-* 在跑(409)。
任务进入下游后,上游遗留的待审核实体不可再审(状态机不逆行);未采纳的意图可拿去另建新任务。

6. 知识库

6.1 品牌 `/api/brands`

方法	路径	说明
GET	`/api/brands`	当前账号全部品牌(数组)
POST	`/api/brands`	创建,返回 `{id}`
PUT	`/api/brands`	更新,body 含 `id` + 任意字段
DELETE	`/api/brands?id=3`	删除,级联删除该品牌的产品/图片/问题集/官网;名下已有优化任务时删除失败(任务保留历史,需先删任务)

字段(全部可选字符串,name 必填):name 品牌名 · industry 行业 · positioning 定位 · story 品牌故事 · core_values 核心价值 · target_audience 目标人群 · competitors 竞品 · certifications 资质认证 · awards 奖项 · official_channels 官方渠道 · faq 常见问答 · forbidden_words 禁用词 · extra_notes 补充说明 · contact_name / contact_phone / contact_address 联系方式 · business_regions 业务区域。

知识库不做检索增强,全部字段拼进智能体提示词,写得越具体产出越准。

6.2 产品 `/api/products`

方法	路径	说明
GET	`/api/products?brand_id=3`	该品牌产品列表
POST	`/api/products`	创建,`name` 与 `brand_id` 必填,返回 `{id}`
PUT	`/api/products`	更新,body 含 `id`
DELETE	`/api/products?id=8`	删除

字段:name · category 分类 · description 描述 · advantages 优势 · specs 规格参数 · price_info 价格信息 · usage_scenarios 使用场景 · usage_guide 使用指南 · materials_ingredients 材质/成分 · service_policy 服务政策 · user_reviews 用户评价 · comparison_points 对比要点 · extra_notes。

6.3 图片 `/api/images`

方法	路径	说明
GET	`/api/images?brand_id=3` 或 `?product_id=8`	图片列表
POST	`/api/images`	`multipart/form-data`:`file`(jpg/jpeg/png/gif/webp,≤10MB)、`brand_id?`、`product_id?`、`tag?`;返回 `{id, url}`
DELETE	`/api/images?id=21`	删除

curl -s -X POST $BASE/api/images -H "Authorization: Bearer $KEY" \
  -F file=@./store.jpg -F brand_id=3 -F tag=门店实拍

托管模式撰写文章时会随机取品牌/产品图片作头图;url 为站内相对路径,发布时自动转为公网地址。

7. 意图问题集 `/api/intent-sets`

问题集是围绕品牌/产品的「消费者会问 AI 的问题」资产,覆盖推荐/对比/负面/特性/场景/正面六类,每题带 70~99 的决策影响权重。建任务时可直接引用问题集条目 id。

方法	路径	说明	计费
GET	`/api/intent-sets?brand_id=&product_id=&product_ids=1,2&include_items=1`	列表(数组),`include_items=1` 附带条目	—
POST	`/api/intent-sets`	SSE 生成:`{brand_id, product_id?, count(5~20,默认10), requirements?(≤500字)}`;`item.entity=intent_set_item`,`done.summary={set_id,name,generated}`	`intent_set` ×1,失败整笔退
GET	`/api/intent-sets/{id}`	详情含 `items[]`	—
PATCH	`/api/intent-sets/{id}`	`{name}`(≤60)	—
DELETE	`/api/intent-sets/{id}`	删除	—
POST	`/api/intent-sets/{id}/items`	手动加题 `{question(≤200), question_type?, weight?(70~99), rationale?}` → `{id}`	—
PATCH	`/api/intent-sets/{id}/items/{itemId}`	改题 `{question?, question_type?, weight?, rationale?}`	—
DELETE	`/api/intent-sets/{id}/items/{itemId}`	删题	—

条目结构:{id, set_id, question, question_type, weight, rationale, source('ai'|'manual')}。

8. 任务流水线 `/api/tasks`

8.1 创建任务 `POST /api/tasks`

字段	类型	必填	说明
`brand_id`	int	✓	品牌
`product_ids`	int[]		产品多选(空 = 品牌级)
`intent_item_ids`	int[]	三选一	问题集条目,≤20,每题创建一个任务
`custom_questions`	string[]	三选一	手动问题,≤20 条、单条 ≤200 字,每条一个任务
`selected_question`	string	三选一	单条问题;三者都不传 = 由智能体自主规划
`target_platforms`	string[]		目标 AI 平台(附录 A.2),只影响选题与文风,不影响执行
`content_type`	string		内容类型,取值按账号行业类型(附录 A.3),不传由智能体决定
`article_count`	int		每个问题的文章篇数,1~10,默认 1
`auto_approve`	0/1		1 = 托管模式(API 创建时服务端自动跑完)
`media_price_cap_credits`	int		单篇媒体发稿费上限(算力),10~100000,默认 100
`title`	string		仅单任务生效,留空自动生成
`objective`	string		额外内容要求(口吻/细节等),进入选题、写作、审计提示词

优先级 intent_item_ids > custom_questions > selected_question。响应 {id, ids}:id 为首个任务,ids 为本次创建的全部任务(批量时多个)。创建本身不扣费。

8.2 任务列表 `GET /api/tasks`

不带 page:返回全部任务数组(旧协议)。带 page:分页协议,可选筛选 status_group(ongoing 进行中 / published 已发布三态)、brand_id、q(标题关键词 ≤50 字)、has_failed=1(含失败篇)、interrupted=1(托管中断)。每行 = 任务全部列 + brand_name, product_name, published_count, failed_count, plan_count。

8.3 任务详情 `GET /api/tasks/{id}`

{"ok":true,"data":{
  "task":     {"id":57,"status":"articles_pending_review","running_step":null,"auto_approve":0,"managed_run":0,"publish_serial":null,"article_count":1,"media_price_cap_credits":100,...},
  "brand":    {...}, "product": {...}, "products": [...],
  "intents":  [{"id":101,"question":"...","intent_type":"决策型","review_status":"approved",...}],
  "articles": [{"id":301,"title":"...","content":"# Markdown 正文","review_status":"pending","audit_status":null,"image_ids":"[]",...}],
  "plans":    [{"id":501,"article_id":301,"media_id":"m123","media_name":"...","price_credits":80,"review_status":"approved","publish_status":"published","published_url":"https://...","media_state":"已出稿",...}],
  "report":   {"id":9,"report_md":"# 统计复盘 ...","created_at":"..."},
  "messages": [{"id":1,"stage":"article","role":"assistant","content":"...","created_at":"..."}]
}}

task.running_step 非空 = 某步正在执行;plans[].published_url 在刚提交时是网关临时预览链,出稿后同步为正式回链(media_state 变为「已出稿/已完成」)。

其余:PATCH /api/tasks/{id} {title}(≤60)重命名;DELETE /api/tasks/{id} 删除(已消耗算力不退)。

8.4 执行步骤(SSE)

接口	body	计费	失败退费
`POST /api/tasks/{id}/run-intents`	`{feedback?}`	`intent` ×1	整笔退
`POST /api/tasks/{id}/run-articles`	`{feedback?}`	`article` × 待写篇数;托管另加 `content_audit` × 篇	按篇退
`POST /api/tasks/{id}/run-media-match`	`{feedback?, media_ids?: string[]}`	`media_match` ×1;托管/直通发布时再加发布费	整笔退
`POST /api/tasks/{id}/run-publish`	无	`publish` × 篇 + 各篇媒体发稿费快照(`media_fee`)	按失败篇退
`POST /api/tasks/{id}/run-stats`	`{feedback?}`	`stats` ×1	整笔退

feedback(≤2000 字)= 对话式反馈:把上一版产物 + 审核意见 + 反馈交给智能体重做(照常扣费)。文章反馈只重写未通过且未进发布计划的篇目。
media_ids = 限定候选媒体范围(≤200 个,取自 GET /api/media 的 id);传了则不受单篇上限约束。
断点续跑:run-articles/run-publish 只处理没有产物或失败的条目,重复调用幂等。
发布前费用 = publish 单价 × 篇数 + Σ plans[].price_credits,余额不足 402 整批不发。

8.5 审核 `POST /api/tasks/{id}/review`

{"entity":"article","decisions":[{"id":301,"status":"approved"},{"id":302,"status":"rejected","note":"数据不准"}]}

entity ∈ intent | article | plan;响应 {approved: 该实体表已通过总数}。至少一条通过即推进状态;不属于本任务的 id 静默忽略。窗口见第 5 节。

8.6 其它

接口	说明
`PATCH /api/tasks/{id}/articles/{articleId}`	人工编辑 `{title?(≤120), content?(Markdown,≤200000)}`,不扣费;已进入发布中/已发布的文章拒绝
`POST /api/tasks/{id}/republish`	SSE,`{plan_id, media_id}`:把失败/未发布的计划换到指定媒体后立即发布;扣 `publish` + 新媒体发稿费,不重扣匹配费
`POST /api/tasks/{id}/sync-status`	同步网关出稿状态与正式回链 → `{updates:[{plan_id, media_state, link}]}`;拒稿自动置 failed 并退费。mock 环境 400
`GET /api/tasks/interrupted`	托管中断任务 → `{count, tasks:[{id,title,status,last_message,updated_at}]}`

9. 媒体库查询 `GET /api/media?page=1`

带 page 为分页协议(默认每页 50,上限 100)。筛选参数:

参数	说明
`type`	大类(网站/自媒体/微信/微博/短视频/海外…),空 = 全部
`q`	关键词(名称/行业/属性/地区)
`industry` / `area` / `attr`	行业分类 / 地区 / 属性
`facet_<维度>=<值>`	标签维度(综合门户/新闻源/可发GEO/认证类型/领域分类…),维度名与候选值在响应 `facet_options`
`price_min_credits` / `price_max_credits`	发稿费区间(算力,含边界)
`price_gt` / `price_le`	价格档位(内部用,与上面互斥)
`weight_min`	百度权重下限
`sort`	`default`(权重↓收录率↓)/ `price_asc` / `price_desc` / `weight_desc` / `record_desc`

响应:{items:[{id, name, type, industry, area, price_credits, weight, ...}], total, page, page_size, tab_counts, facet_options, filtered_ids?, price_tiers, live}。filtered_ids 仅在结果 ≤500 时下发,可直接作为 run-media-match 的 media_ids。

10. 算力与账单 `GET /api/credits`

{"ok":true,"data":{
  "balance":1800, "frozen":0, "state":"active", "freeze_deadline":null,
  "plan_tier":"formal", "plan_expires_at":"2027-03-06",
  "summary":{"earned":2000,"spent":200,"spent_month":200,"top_step":"article","top_step_credits":100},
  "transactions":[{"id":88,"task_id":57,"step":"article","credits_delta":-100,"balance_after":1800,"remark":"...","created_at":"..."}],
  "pricing":[{"step":"intent","credits_cost":50,"description":"意图问题生成(每次)"}]
}}

不带 page:transactions 为最近 100 条;带 page:分页协议(列表键仍是 transactions),筛选 kind=spend|income、step、from/to(YYYY-MM-DD)。
算力状态三态:active 可用;frozen 正式会员算力有效期届满后 30 天冻结期(充值达门槛可解冻);voided 已作废。冻结/作废时 balance 为 0,frozen 为不可用数额。
失败退费落同 step 正向流水,remark 注明原因。

10.1 计费表(实时)

计费步骤 `step`	算力	说明
`article`	20	文章撰写(每篇)
`content_audit`	10	内容审计(每篇,托管模式)
`geo_monitor`	5	GEO 表现监测(每问题每平台一次查询)
`intent`	5	意图问题生成(每次)
`intent_set`	20	意图问题集生成(每次)
`media_match`	40	媒体匹配(每次)
`publish`	10	媒体发布执行(每篇,不含媒体费用)
`short_video_script`	10	短视频口播脚本生成(每次)
`short_video_synthesis`	5	数字人视频合成(每秒)
`site_article`	20	官网文章生成(每篇)
`site_create`	1000	智能体官网创建(每个品牌一次)
`site_section`	10	官网内容板块生成(每次)
`stats`	10	数据统计报告(每次)
`strategy`	50	策略报告生成(每次)

另:媒体发稿费(media_fee)= 媒体单价 × 平台比例,在媒体匹配落库时定格为 plans[].price_credits,发布时与 publish 一起扣;short_video_synthesis 按视频秒数计。

11. 计划任务 `/api/schedules`

周期性自动创建托管任务(快照模板,后续问题集变动不影响)。

方法	路径	说明
GET	`/api/schedules`	计划列表(数组)
POST	`/api/schedules`	创建:`frequency`(daily/weekly/monthly)必填、`run_hours` int、`weekday`(0~~6,weekly)、`month_day`(1~~28,monthly)、`name?` + 与创建任务同名的模板字段(`brand_id, product_ids, intent_item_ids
PUT	`/api/schedules`	`{id, enabled: true
DELETE	`/api/schedules?id=5`	删除
GET	`/api/schedules/runs?job_id=&status=&from=&to=&page=`	执行历史(success/failed/skipped),失败行带 `can_retry`
POST	`/api/schedules/runs/{runId}/retry`	按原模板立即重建任务
GET	`/api/schedules/tasks?job_id=&status_group=&page=`	计划关联的任务

创建计划不会立即执行,首次任务在下一个到期时点由调度器创建。

12. 合作方接口 `/api/partner/*`

面向渠道合作方(如钉钉)的自动化开户体系。需要 合作方密钥(由 GeoForce 管理员在后台按渠道签发),该密钥只能调本节接口,且只触达 channel 等于自身渠道的客户账号。

12.1 开户 `POST /api/partner/accounts`

字段	必填	说明
`username`	✓	登录名,全平台唯一
`password`	✓	初始密码,≥6 位
`company_name`		公司名
`industry_type`		通用 / 文旅 / 美业 / B2B,默认通用(决定可选内容类型)
`plan_tier`		`formal`(默认,正式会员,算力 6 个月有效)/ `trial`(试用 7 天)
`credits`		发放算力(非负整数),不传用平台默认值(当前 200)

curl -s -X POST $BASE/api/partner/accounts -H "Authorization: Bearer $PARTNER_KEY" -H "Content-Type: application/json" \
  -d '{"username":"dd_corp_001","password":"Init@2026","company_name":"某某科技"}'
# {"ok":true,"data":{"id":88,"username":"dd_corp_001","api_key":"gf_…","key_prefix":"gf_1a2b3c4d","credits":200,"plan_tier":"formal","plan_expires_at":"2027-03-06"}}

api_key 是该账号的第一把账号级密钥(明文仅此一次),合作方可代终端客户持有并调用第 6~11 节全部接口。账号自动归入合作方渠道,不关联任何销售方。

12.2 账号列表 / 详情

GET /api/partner/accounts?page=1&page_size=20 → 分页协议,items[] 与详情同结构。
GET /api/partner/accounts/{id} → {id, username, company_name, industry_type, plan_tier, plan_expires_at, status, created_at, credits(可用), credits_state(active|frozen|voided), frozen_credits}。非本渠道账号 404。

12.3 充值 `POST /api/partner/accounts/{id}/recharge`

body {credits} 正整数 → {credits_added, balance_after}。规则与管理端一致:正式会员每次充值把整个余额有效期重置为今天 +6 个月;试用会员到期后拒绝充值(需管理员转正);算力冻结期内单次充值须达激活门槛;作废算力不复活。

12.4 再签密钥 `POST /api/partner/accounts/{id}/api-keys`

body {name?} → {id, api_key, key_prefix}。受每账号 5 把有效密钥上限。

所有合作方操作都写审计(含渠道与密钥 id),平台管理员可随时撤销合作方密钥;撤销不影响已开出的账号与其密钥。

13. 其他板块(简表)

以下能力同样对密钥开放,接口形状与网页端一致;需要详细字段可先在网页端操作一遍后对照。

板块	方法路径	说明	计费
手动发稿	`GET/POST /api/manual-posts`,`PATCH/DELETE /api/manual-posts/{id}`,`POST /api/manual-posts/{id}/publish`,`POST /api/manual-posts/sync`	自写 Markdown 文章 + 自选媒体直接发布;GET 带 `page`/`status`/`q` 分页	仅媒体发稿费 `manual_media_fee`
效果监测	`GET/POST /api/monitor/configs`,`PUT/DELETE /api/monitor/configs/{id}`,`POST /api/monitor/configs/{id}/run`,`GET /api/monitor/runs`,`GET /api/monitor/runs/{id}`	监测品牌问题在六个 AI 平台的提及与信源	`geo_monitor` × 问题数 × 平台数
数字人视频	`GET/POST(SSE) /api/short-video/scripts`,`GET/PATCH/DELETE /api/short-video/scripts/{id}`,`GET/POST /api/short-video/jobs`,`GET /api/short-video/jobs/{id}`,`GET /api/short-video/jobs/{id}/download`,`GET /api/short-video/options`,`GET /api/short-video/persons`	口播脚本生成 → 选形象/音色/背景 → 合成 → 下载 mp4	`short_video_script` / `short_video_synthesis`(按秒)
智能体官网	`GET/POST /api/sites`,`GET/PATCH/DELETE /api/sites/{id}`,`GET/POST(SSE) /api/sites/{id}/sections`,`PATCH/DELETE …/sections/{sectionId}`,`GET/POST(SSE) /api/sites/{id}/articles`,`PATCH/DELETE …/articles/{articleId}`,`GET/POST/DELETE /api/sites/{id}/links`	按知识库生成品牌独立站,发布后公开于 `/site/{slug}`	`site_create` / `site_section` / `site_article`
策略报告	`GET/POST(SSE) /api/strategies`,`GET/PATCH/DELETE /api/strategies/{id}`	GEO + 营销策略 Markdown 报告(需账号开通「实用工具」)	`strategy`
统计总览	`GET /api/stats-overview`	账号级 KPI / 漏斗 / 近 30 天趋势 / 平台与类型覆盖	—
当前账号	`GET /api/auth/me`	密钥对应账号信息,含 `via: "api_key"`	—

附录

A.1 任务状态对照

值	含义
`draft`	草稿
`intent_pending_review`	意图待审核
`intent_approved`	意图已通过
`articles_pending_review`	文章待审核
`articles_approved`	文章已通过
`media_pending_review`	发布计划待审核
`media_approved`	发布计划已通过
`published`	已发布
`stats_ready`	报告已生成

审核状态 review_status:pending / approved / rejected。发布状态 publish_status:unpublished / publishing / published / failed。

A.2 目标平台 `target_platforms`

豆包 · DeepSeek · 千问 · 腾讯元宝 · Kimi · 百度文心(网页端默认勾选前四个)。

A.3 内容类型 `content_type`(按账号 `industry_type`)

行业类型	可选值
通用	深度文章 · 新闻稿 · 公众号推文 · 视频脚本 · 问答帖 · 产品测评
文旅	旅行攻略 · 行程规划 · 景点测评 · 游记体验 · 文旅问答帖 · 文旅新闻稿
美业	变美攻略 · 项目科普 · 探店体验 · 案例分享 · 美业问答帖 · 避坑指南
B2B	行业洞察 · 解决方案 · 客户案例 · 选型指南 · 技术问答帖 · 企业新闻稿

A.4 问题类型 `question_type`

问题集条目 question_type:推荐型 · 对比型 · 负面型 · 特性型 · 场景型 · 正面型;权重 weight 取 70~99。

注意:任务流水线产出的 intents[].intent_type 是另一套分类(认知型 · 对比型 · 决策型 · 问题解决型 · 场景型),由意图规划智能体判定,与问题集的六类不是同一口径,请勿互相当作枚举校验。

A.5 开户渠道 `channel`

平台 · Workbuddy · Traework · Qwenwork · 钉钉 · 亚马逊 · 其他。

A.6 变更记录

日期	内容
2026-09-06	v1 首发:账号级 API 密钥(Bearer)、合作方接口、本文档

GeoForce 开放平台 API

1. 概述与快速开始

1.1 获取密钥

1.2 三步跑通一个托管任务

2. 鉴权

3. 通用约定

3.1 响应包

3.2 HTTP 状态码

3.3 其它

4. SSE 流式接口

5. 任务状态机与人工审核

6. 知识库

6.1 品牌 /api/brands

6.2 产品 /api/products

6.3 图片 /api/images

7. 意图问题集 /api/intent-sets

8. 任务流水线 /api/tasks

8.1 创建任务 POST /api/tasks

8.2 任务列表 GET /api/tasks

8.3 任务详情 GET /api/tasks/{id}

8.4 执行步骤(SSE)

8.5 审核 POST /api/tasks/{id}/review