diff --git a/scripts/ktv_uapi_migration.sql b/scripts/ktv_uapi_migration.sql
index 29bab7fb..1ca021f1 100644
--- a/scripts/ktv_uapi_migration.sql
+++ b/scripts/ktv_uapi_migration.sql
@@ -200,6 +200,20 @@ WHERE llmid='llm_ktv_realesrgan_upscale' AND llmcatelogid='ktv_pipeline';
 -- P2 补充: 设置 ppid（v1/models 查询要求 ppid IS NOT NULL）
 -- ============================================================
 UPDATE llm_api_map SET ppid = 'pp_ktv' WHERE llmid LIKE 'llm_ktv%' AND ppid IS NULL;
+
+-- ============================================================
+-- P2 补充: upappkey (API调用鉴权必需)
+-- ============================================================
+INSERT INTO upappkey (id, upappid, ownerid, apikey, orgid)
+SELECT 'ktv_gateway_key', 'ktv-gateway', 'UiEi7hKqAmU1-jqQEVhZe', '', '0'
+WHERE NOT EXISTS (SELECT 1 FROM upappkey WHERE upappid = 'ktv-gateway');
+
+-- ============================================================
+-- P2 补充: response模板容错 — {% if error %} 处理GPU错误响应
+-- 所有同步服务的response模板使用{% if error %}块，GPU返回
+-- {"error":"..."}时直接透传，避免Jinja2 UndefinedError
+-- （tokentest已手动更新，此处为生产部署用SQL）
+-- ============================================================
 -- ============================================================
 -- KTV Pipeline v1 API RBAC 权限配置
 -- 新增 /v1/pipeline/submit 端点权限
diff --git a/scripts/ktv_uapi_migration_p2_uapi.sql b/scripts/ktv_uapi_migration_p2_uapi.sql
index 7ee27502..34fa4cb9 100644
--- a/scripts/ktv_uapi_migration_p2_uapi.sql
+++ b/scripts/ktv_uapi_migration_p2_uapi.sql
@@ -112,3 +112,17 @@ WHERE llmid='llm_ktv_realesrgan_upscale' AND llmcatelogid='ktv_pipeline';
 -- P2 补充: 设置 ppid（v1/models 查询要求 ppid IS NOT NULL）
 -- ============================================================
 UPDATE llm_api_map SET ppid = 'pp_ktv' WHERE llmid LIKE 'llm_ktv%' AND ppid IS NULL;
+
+-- ============================================================
+-- P2 补充: upappkey (API调用鉴权必需)
+-- ============================================================
+INSERT INTO upappkey (id, upappid, ownerid, apikey, orgid)
+SELECT 'ktv_gateway_key', 'ktv-gateway', 'UiEi7hKqAmU1-jqQEVhZe', '', '0'
+WHERE NOT EXISTS (SELECT 1 FROM upappkey WHERE upappid = 'ktv-gateway');
+
+-- ============================================================
+-- P2 补充: response模板容错 — {% if error %} 处理GPU错误响应
+-- 所有同步服务的response模板使用{% if error %}块，GPU返回
+-- {"error":"..."}时直接透传，避免Jinja2 UndefinedError
+-- （tokentest已手动更新，此处为生产部署用SQL）
+-- ============================================================