GoodPage API 文档 - 文本转精美网页

📖 概述

GoodPage提供强大的文本转 HTML API 服务，可将普通文本自动转换为具有丰富视觉效果的精美网页。支持多种样式模板、智能排版和自定义需求。

✨ 智能美化

AI 自动分析内容，智能匹配最佳排版风格和视觉元素

🎨 多样模板

17+ 种专业设计模板，满足不同场景的展示需求

⚡ 快速响应

通常 3-10 秒内完成转换，支持高并发调用

🔗 灵活输出

可返回 HTML 代码或直接生成可访问的网页链接

🌐 API 端点

POST https://cn.goodpage.net/api/text-to-page

📝 请求参数

请求头

Content-Type: application/json

请求体（JSON 格式）

参数名	类型	必填	默认值	说明
`content`	string	是	-	要转换的文本内容
`title`	string	否	AI 生成	文章标题（如不提供，AI 会自动生成）
`content_strategy`	string	否	`strict`	扩写模式： `strict` - 严格遵循原文 `interpret` - 解读优化 `expand` - 扩写丰富
`extra_requirements`	string	否	空	额外需求，用自然语言描述格式化要求，例如："使用蓝色主题"、"添加表格展示数据"
`response_type`	string	否	`html`	响应类型： `html` - 返回 HTML 内容和元数据（默认） `url` - 只返回网页 URL（不返回 HTML 内容，减少传输）
`style`	string	否	AI 选择	指定样式模板代码，如：`minimalist`、`premium_bw`、`tech_blue` 等
`include_title`	boolean	否	`true`	是否在生成的 HTML 中包含标题： `true` - 包含 `<h1>` 标题标签 `false` - 不生成任何标题标签
`design_system`	object	否	AI 选择	Design System 配置对象（高级功能），用于精确控制页面样式。 ⚠️ 重要：此参数仅在 `style="diy"`（自定义风格）时生效。如果使用其他预设风格，此参数将被忽略。包含以下字段： • `theme` (string): 主题 ID，如 `"minimal"`, `"dark"`, `"pink"` 等（17种主题） • `layout` (string): 布局 ID，如 `"single-column"`, `"integrated/ppt"` 等 • `typography` (string): 排版 ID，如 `"modern"`, `"serif"`, `"handwritten"` • `width` (string): 宽度控制，如 `"fixed"`, `"percentage"`, `"fullscreen"` • `effects` (array): 特效数组，如 `["starry-bg"]`, `["particle"]` 等（11种特效） • `components` (array): 组件数组（可选）如未提供，AI 会根据内容智能选择最佳配置

💻 请求示例

基础用法

{
  "content": "这是一段测试文本。\n\nAI 技术正在改变我们的生活方式。"
}

完整用法

{
  "content": "人工智能正在改变世界\n\n随着技术的进步，人工智能已经深入到我们生活的方方面面。从智能手机到自动驾驶汽车，AI 技术正在重塑我们的生活方式。\n\n未来展望：\n1. 更智能的个人助手\n2. 医疗诊断的革新\n3. 教育个性化\n4. 工业自动化",
  "title": "人工智能改变生活",
  "content_strategy": "strict",
  "extra_requirements": "请使用蓝色主题，添加科技感的元素",
  "response_type": "url",
  "style": "neon_glassmorphism"
}

Design System 高级用法（精确控制样式）

{
  "content": "商业计划书\n\n第一章：市场分析\n...",
  "title": "商业计划书",
  "style": "diy",
  "design_system": {
    "theme": "minimal",
    "layout": "integrated/ppt",
    "typography": "modern",
    "width": "fullscreen",
    "effects": ["none"]
  },
  "response_type": "url"
}

⚠️ 重要提示：使用 design_system 时，必须同时设置 "style": "diy"，否则该参数将被忽略。
说明：使用 design_system 可以精确控制页面的每个维度：
• Theme（色调）: 17种主题可选（pink, dark, minimal, business-professional等）
• Layout（布局）: 单栏、双栏、PPT演示、文章、网站等
• Typography（排版）: modern（现代）、serif（衬线体）、handwritten（手写体）
• Width（宽度）: fixed（固定）、percentage（百分比）、fullscreen（全屏）
• Effects（特效）: starry-bg（星空）、particle（粒子）、gradient-flow（流光）等11种
• Components（组件）: 支持表格、ECharts图表等专业组件
如不提供 design_system，AI 会根据内容自动选择最佳配置

📤 响应格式

成功响应（response_type: "html"，默认）

{
  "status": "success",
  "message": "HTML generated successfully",
  "return_data": {
    "page_html": "<!DOCTYPE html>\n<html lang=\"zh-CN\">...",
    "content_html": "<div>...</div>",
    "title": "文章标题",
    "keywords": "关键词1, 关键词2",
    "description": "简短描述"
  },
  "article_id": "abcdefgh",
  "url": "/p/abcdefgh",
  "full_url": "https://cn.goodpage.net/p/abcdefgh",
  "quota": {
    "remaining": 48,
    "used": 2,
    "limit": 50
  }
}

说明：return_data 对象包含：

page_html: 完整的 HTML 页面（包含 DOCTYPE、head、body）
content_html: 仅文章正文 HTML（不含页面结构）
title: 文章标题（如未提供则 AI 自动生成）
keywords: 从内容中提取的 SEO 关键词
description: 文章的 SEO 描述

成功响应（response_type: "url"）

{
  "status": "success",
  "message": "HTML generated and saved successfully",
  "url": "/p/abcdefgh",
  "full_url": "https://cn.goodpage.net/p/abcdefgh",
  "article_id": "abcdefgh",
  "title": "人工智能改变生活",
  "quota": {
    "remaining": 48,
    "used": 2,
    "limit": 50
  }
}

说明：URL 模式不返回 HTML 内容以减少数据传输。

错误响应

{
  "status": "error",
  "message": "错误信息描述"
}

🔧 使用示例

Python 示例

import requests

# API 端点（推荐）
url = "https://cn.goodpage.net/api/text-to-page"

# 请求数据
payload = {
    "content": """人工智能正在改变世界
    
随着技术的进步，人工智能已经深入到我们生活的方方面面。从智能手机到自动驾驶汽车，AI 技术正在重塑我们的生活方式。

未来展望：
1. 更智能的个人助手
2. 医疗诊断的革新
3. 教育个性化
4. 工业自动化""",
    "title": "人工智能改变生活",
    "response_type": "url"
}

# 发送请求
response = requests.post(url, json=payload)

# 检查响应
if response.status_code == 200:
    result = response.json()
    if result["status"] == "success":
        article_url = result["full_url"]
        print(f"✅ 网页生成成功！")
        print(f"🔗 访问链接: {article_url}")
    else:
        print(f"❌ 生成失败: {result['message']}")
else:
    print(f"❌ 请求失败，状态码: {response.status_code}")

JavaScript 示例

async function textToPage() {
    const url = 'https://cn.goodpage.net/api/text-to-page';
    
    const payload = {
        content: `人工智能正在改变世界

随着技术的进步，人工智能已经深入到我们生活的方方面面。`,
        title: '人工智能改变生活',
        response_type: 'url'
    };
    
    try {
        const response = await fetch(url, {
            method: 'POST',
            headers: {
                'Content-Type': 'application/json'
            },
            body: JSON.stringify(payload)
        });
        
        const result = await response.json();
        
        if (result.status === 'success') {
            console.log('✅ 网页生成成功！');
            console.log('🔗 访问链接:', result.full_url);
        } else {
            console.error('❌ 生成失败:', result.message);
        }
    } catch (error) {
        console.error('❌ 请求异常:', error.message);
    }
}

textToPage();

cURL 示例

curl -X POST https://cn.goodpage.net/api/text-to-page \
  -H "Content-Type: application/json" \
  -d '{
    "content": "这是一段测试文本。\n\nAI 技术正在改变我们的生活。",
    "title": "测试文章",
    "response_type": "url"
  }'

📊 配额说明

每个 IP 地址享有 50 次免费调用额度。超过配额后，请联系客服升级。

配额有效期为 30 天，到期后自动重置。

🎨 可用样式模板

您可以通过 style 参数指定以下样式模板：

模板代码	中文名称	英文名称	特点
`minimalist`	极简主义	Minimalist	简洁专业 - 适合技术文档、报告
`premium_bw`	高级黑白	Premium Black & White	优雅黑白灰 - 通过字体和排版展现文字美感
`neon_glassmorphism`	霓虹玻璃	Neon Glass	科技感、未来感 - 适合AI、科技主题
`magazine_gradient`	杂志渐变	Magazine Gradient	温暖现代 - 适合生活方式、时尚
`cyberpunk_neon`	赛博朋克	Cyberpunk Neon	科技前卫 - 适合网络安全、黑客主题
`minimalist_timeline`	时间线	Minimalist Timeline	历史进程 - 适合发展历程、时间序列
`gradient_glass`	渐变玻璃	Gradient Glass	柔和现代 - 适合商业、创业主题
`bold_waves`	大胆波浪	Bold Waves	活力动感 - 适合运动、年轻群体
`space_cosmic`	太空宇宙	Space Cosmic	科幻探索 - 适合天文、航天主题
`swiss_grid`	瑞士网格	Swiss Grid	严谨专业 - 适合数据分析、学术研究
`handdrawn_notes`	手绘笔记	Handdrawn Notes	轻松创意 - 适合学习笔记、创意想法
`dark_luxury`	暗黑奢华	Dark Luxury	高端神秘 - 适合奢侈品、高端品牌
`pastel_soft`	柔和粉彩	Pastel Soft	温柔清新 - 适合女性、儿童、温馨主题
`brutalist_bold`	粗野主义	Brutalist Bold	强烈个性 - 适合艺术、设计表达
`kawaii_bubbles`	可爱泡泡	Kawaii Bubbles	萌系活泼 - 适合萌宠、二次元、娱乐
`newspaper_classic`	报纸经典	Newspaper Classic	传统正式 - 适合新闻、公告、声明
`geometric_modern`	几何现代	Geometric Modern	现代结构化 - 适合建筑、设计主题
`digital_magazine`	数字杂志	Digital Magazine	沉浸式阅读 - 适合深度内容、专业出版
`colorful_dance`	色彩飞舞	Colorful Dance	动态排版 - 夸张字号、多样形态、丰富色彩的视觉盛宴
`website`	网站首页	Homepage	完整网站主页 - 包含导航、特性展示、案例、统计、FAQ、联系信息等模块

🎨 Design System 资源清单

Design System 提供六维设计控制，让您精确定制页面样式。以下是所有可用资源的完整清单：

1. Theme（色调层）- 17种主题

ID	中文名	风格特点
`minimal`	极简主题	简洁清爽，适合正式文档和商业报告
`dark`	暗黑主题	深色背景，适合技术文档和夜间阅读
`pink`	粉红主题	柔和的粉红色调，适合温馨、女性化内容
`business-professional`	商务专业	稳重的商务风格，适合企业文档
`classical-elegant`	古典优雅	优雅的古典风格，适合文学作品
`coral-reef`	珊瑚礁	温暖的珊瑚色调，适合自然主题
`cyberpunk-neon`	赛博朋克	霓虹科技风，适合未来感内容
`forest-green`	森林绿	清新的绿色调，适合环保主题
`ink-zen`	水墨禅意	东方水墨风格，适合文化艺术
`lavender-dream`	薰衣草梦	梦幻的紫色调，适合浪漫内容
`luxury-gold`	奢华金	金色奢华风格，适合高端品牌
`nordic-fresh`	北欧清新	简约北欧风，适合生活方式
`ocean-blue`	海洋蓝	清爽的蓝色调，适合科技内容
`pop-art`	波普艺术	活泼的波普风格，适合创意内容
`sunset-warm`	日落暖色	温暖的日落色调，适合情感内容
`tech-future`	科技未来	未来科技感，适合创新主题
`vintage-newspaper`	复古报纸	复古报纸风格，适合怀旧内容

2. Layout（布局层）- 8种布局

ID	类型	中文名	说明
`single-column`	简单布局	一栏	所有内容在一列中垂直排列，通用内容
`double-column`	简单布局	二栏	双栏布局，适合对比展示
`triple-column`	简单布局	三栏	三栏布局，适合多列展示
`integrated/article`	综合布局	文章	标准文章布局，带标题和正文区域
`integrated/ppt`	综合布局	类PPT	PPT演示布局，全屏单栏幻灯片
`integrated/magazine`	综合布局	杂志分栏	杂志风格，多列排版
`integrated/website`	综合布局	网站页面	网站布局，自由组合头部、主体、侧边栏、底部
`integrated/documentation`	综合布局	帮助文档	文档布局，导航+文章内容

3. Typography（排版层）- 3种排版

ID	中文名	字体特点	适用场景
`modern`	现代字体	清晰的无衬线字体	技术文档、商业报告
`serif`	衬线体	优雅的衬线字体	文学作品、正式文档
`handwritten`	手写体	活泼的手写风格	儿童内容、创意作品

4. Width（宽度控制层）- 3种选项

ID	中文名	CSS规则	适用场景
`fixed`	固定宽度	`width: 800px;`	长文阅读
`percentage`	百分比宽度	`width: 80%; max-width: 1200px;`	响应式适配
`fullscreen`	全屏宽度	`width: 100%;`	宽表格/图表

5. Effects（特效层）- 11种特效

ID	中文名	类型	说明
`none`	无特效	-	默认选项，无动画效果
`starry-bg`	星空背景	背景动画	动态星空背景，星星闪烁效果
`particle`	粒子效果	粒子动画	浮动粒子效果
`gradient-flow`	渐变流光	背景	流动的渐变色背景，色彩平滑过渡
`aurora`	极光效果	背景	北极光般的动态光带效果
`wave-ripple`	波浪涟漪	动画	水面波纹扩散效果
`neon-grid`	霓虹网格	背景	赛博朋克风格的霓虹网格背景
`floating-bubbles`	漂浮气泡	动画	向上升起的半透明气泡动画
`light-rays`	光线追踪	背景	动态光束从中心向外辐射
`digital-rain`	数字雨	背景	矩阵风格的绿色数字雨效果
`falling-petals`	花瓣飘落	动画	樱花花瓣飘落的浪漫效果

⚠️ 重要提示：design_system 参数仅在 style="diy"（自定义风格）时生效。如果使用其他预设风格（如 minimalist、premium_bw 等），即使提供了 design_system 参数，系统也会忽略它。
💡 建议：如需使用 Design System 的精确控制功能（包括表格组件、ECharts图表等），请务必设置 "style": "diy"。

❓ 常见问题

Q: 为什么返回 403 错误？

A: 您的 IP 地址配额已用完。每个 IP 有 50 次免费调用额度，超过后需要联系客服升级。

Q: 如何获取文章的永久链接？

A: 使用 response_type: "url" 参数，API 会返回完整的网页访问链接。

Q: 生成的 HTML 可以离线使用吗？

A: 是的，所有样式都是内联的，无需外部资源，可以完全离线使用。

Q: 支持哪些语言？

A: 支持中文、英文等多种语言，API 会自动检测文本语言并应用相应的排版规则。

Q: 如何处理长文本？

A: 建议单次请求不超过 10,000 字。对于超长文本，可以分段处理或联系客服获取优化方案。

📞 技术支持

如有问题或需要提升配额，请通过以下方式联系我们：

邮箱：chenkunji@qq.com
网站：https://cn.goodpage.net

🚀 GoodPage API 文档