API 参考
创建找社区任务
创建一个新的找社区异步任务。
POST
/api/open/v1/community-discovery/jobs接口概览
201community_discovery:write
创建一个新的找社区异步任务。
认证方式
请求头使用：
Authorization: Bearer <token>这个接口所需的 scopes：
community_discovery:write建议传递
Idempotency-Key，保证创建型请求安全重试。请求体
strategy_text
string完整策略描述；与 product_summary 至少传一个。
product_summary
string产品一句话概述；推荐传。
target_audience
string目标用户描述。
use_cases
string[]核心使用场景，最多 12 项。
constraints
string[]运营约束与边界，最多 12 项。
language
enum<string>返回语言偏好。
zhen
响应
201 - application/json
id
string找社区任务 ID。
object
string固定为 community_discovery.job。
status
string任务状态，例如 queued、running、completed、failed。
progress
number任务进度，范围 0-100。
stage_message
string | null当前阶段说明。
result_id
string | null完成后可用于定位结果对象。
created_at
string任务创建时间（ISO 8601）。
updated_at
string最近更新时间（ISO 8601）。
result_url
string结果可用时返回结果查询地址。
reused
boolean命中同一幂等键时返回 true。
常见错误
UNAUTHORIZED
error_code缺少或无效的 Bearer Token。
FORBIDDEN
error_code当前 Token 缺少所需 scope。
RATE_LIMITED
error_code当前 Token 触发限流。
INVALID_ARGUMENT
error_code请求参数不符合 schema 约束。
NOT_FOUND
error_code目标资源不存在，或不属于当前账户。
INSUFFICIENT_CREDITS
error_code账户积分不足，无法创建新任务。
说明
- 创建型接口建议始终带上 幂等-Key，避免重试时重复计费或重复建任务。
这个页面对你有帮助吗？