diff --git a/.env.example b/.env.example
index 2b36ecc..c511079 100644
--- a/.env.example
+++ b/.env.example
@@ -35,3 +35,10 @@ COS_SECRET_ID=
 COS_SECRET_KEY=
 COS_BUCKET=
 COS_REGION=ap-guangzhou
+
+# ── 词云平台（下单后 WCD 生产任务，R4）────────────────
+# 词云服务（FastAPI）地址；留空视为未配置：
+# 下单后的 WCD 派单返回结构化 "not_configured"，不做假成功（详见 docs/wordcloud-contract.md）
+WORDCLOUD_API_URL=
+# 请求词云平台超时（毫秒），可选，默认 30000
+WORDCLOUD_TIMEOUT_MS=30000
diff --git a/src/config/configuration.ts b/src/config/configuration.ts
index 90cb26c..fd6010b 100644
--- a/src/config/configuration.ts
+++ b/src/config/configuration.ts
@@ -35,4 +35,10 @@ export default () => ({
     bucket: process.env.COS_BUCKET ?? '',
     region: process.env.COS_REGION ?? 'ap-guangzhou',
   },
+  wordcloud: {
+    // 词云平台（FastAPI）服务地址；为空视为未配置，下单后的 WCD 派单返回 not_configured
+    apiUrl: process.env.WORDCLOUD_API_URL ?? '',
+    // 请求 wordcloud 超时（毫秒）
+    timeoutMs: parseInt(process.env.WORDCLOUD_TIMEOUT_MS ?? '30000', 10),
+  },
 });
diff --git a/src/config/validation.schema.ts b/src/config/validation.schema.ts
index 31344bb..88fe297 100644
--- a/src/config/validation.schema.ts
+++ b/src/config/validation.schema.ts
@@ -28,4 +28,8 @@ export const validationSchema = Joi.object({
   COS_SECRET_KEY: Joi.string().allow('').default(''),
   COS_BUCKET: Joi.string().allow('').default(''),
   COS_REGION: Joi.string().default('ap-guangzhou'),
+
+  // 词云平台：允许为空（未配置时下单派单返回 not_configured，见 wordcloud-contract.md）
+  WORDCLOUD_API_URL: Joi.string().allow('').default(''),
+  WORDCLOUD_TIMEOUT_MS: Joi.number().default(30000),
 });