用途:调用 MD2WE 在线 AI 接口,为 Markdown 文章生成标题建议、中文摘要与配图。适用于用户需要从草稿得到五个中文标题选项、为分享卡片或微信摘要生成简短中文摘要、或生成 16:9 编辑插图的场景。
主要能力:提供三类接口——标题建议、摘要生成、图片生成;请求可显式传入 ai_config,也可依赖服务端默认配置。服务端默认仅支持 OPENAI_API_KEY、OPENAI_BASE_URL、OPENAI_TEXT_MODEL、OPENAI_IMAGE_TOOL_MODEL 四个环境变量。若文本与图片生成需要不同的凭据或 base URL,须在请求体的 ai_config 中显式传入,不要依赖 OPENAI_IMAGE_API_KEY 或 OPENAI_IMAGE_BASE_URL 作为服务端默认。
使用方式:先做服务检查: export MD2WE_BASE_URL="${MD2WE_BASE_URL:-https://md2we.com}" curl -sS "${MD2WE_BASE_URL}/api/health"
随后按需调用接口,请求体包含 markdown 与 focus_prompt 字段。标题建议接口为 /api/ai/title-suggestions,摘要接口为 /api/ai/summary,图片生成接口为 /api/ai/generate-image。需要时可在请求体中附加 ai_config,分别指定 text 与 image 的 api_key、base_url、model。
结果处理:title 返回 suggestions;summary 返回 summary;image 返回 image_url 和 revised_prompt。若服务端报告缺少 AI 凭据,应直接说明并停止,不要编造回退输出。
限制:资料未提供具体收费、价格、平台支持范围或生成效果保证,请以实际接口返回为准。