深表美文 API 文档 - 文本转精美网页

📖 概述

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

✨ 智能美化

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

🎨 多样模板

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

⚡ 快速响应

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

🔗 灵活输出

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

🌐 API 端点

POST https://p.isheet.net/api/text-to-html

📝 请求参数

请求头

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
`style`	string	否	AI 选择	指定样式模板代码，如：`minimalist`、`premium_bw`、`tech_blue` 等

💻 请求示例

基础用法

{
  "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"
}

📤 响应格式

成功响应（返回 HTML）

{
  "status": "success",
  "message": "HTML generated successfully",
  "html": "<!DOCTYPE html>\n<html lang=\"zh-CN\">\n...",
  "article_id": "abcdefgh",
  "title": "人工智能改变生活"
}

成功响应（返回 URL）

{
  "status": "success",
  "message": "HTML generated and saved successfully",
  "url": "/p/abcdefgh",
  "full_url": "https://p.isheet.net/p/abcdefgh",
  "article_id": "abcdefgh",
  "title": "人工智能改变生活"
}

错误响应

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

🔧 使用示例

Python 示例

import requests

# API 端点
url = "https://p.isheet.net/api/text-to-html"

# 请求数据
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 textToHtml() {
    const url = 'https://p.isheet.net/api/text-to-html';
    
    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);
    }
}

textToHtml();

cURL 示例

curl -X POST https://p.isheet.net/api/text-to-html \
  -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	现代结构化 - 适合建筑、设计主题

❓ 常见问题

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://p.isheet.net

🚀 深表美文 API 文档