2slides API 参考2slides 幻灯片生成服务的完整 API 文档。基础 URLhttps://2slides.com/api/v1认证所有 API 请求需要在 Authorization 头中使用 Bearer 令牌进行认证Authorization: Bearer YOUR_API_KEY从 https://2slides.com/api 获取你的 API 密钥将 API 密钥存储在环境变量中SLIDES_2SLIDES_API_KEY端点1. 生成幻灯片根据用户输入生成幻灯片可选择主题。端点POST /slides/generate请求头Authorization: Bearer YOUR_API_KEY Content-Type: application/json请求体{userInput:string必需- 要转换为幻灯片的内容,themeId:string必需- 来自 themes/search 的主题 ID,responseLanguage:string可选默认Auto- 语言代码,mode:string可选默认sync- sync 或 async}支持的语言Auto, English, Simplified Chinese简体中文, Traditional Chinese繁體中文, Spanish, Arabic, Portuguese, Indonesian, Japanese, Russian, Hindi, French, German, Vietnamese, Turkish, Polish, Italian, Korean响应同步模式{slideUrl:https://2slides.com/slides/...,pdfUrl:https://2slides.com/slides/.../download,status:completed}响应异步模式{jobId:abc123...,status:pending}注意同步模式等待生成完成并直接返回结果可能需要 30-60 秒异步模式立即返回 jobId使用/jobs/{jobId}轮询结果2. 创建类似参考图片生成与参考图片样式匹配的幻灯片Nano Banana Pro 模式。端点POST /slides/create-like-this请求头Authorization: Bearer YOUR_API_KEY Content-Type: application/json请求体{userInput:string必需- 幻灯片内容,referenceImageUrl:string必需- 参考图片的 URL 或 base64,responseLanguage:string可选默认Auto,aspectRatio:string可选默认16:9- 宽:高格式,resolution:string可选默认2K- 1K、2K 或 4K,page:number可选默认1- 0 为自动检测最大 100,contentDetail:string可选默认concise- concise 或 standard}分辨率选项1K标准质量2K高质量默认4K超高画质内容详情选项concise简洁、关键词聚焦的内容standard全面、详细的内容页面参数设置为0启用自动幻灯片数量检测设置为具体数字1-100指定确切幻灯片数量响应{success:true,data:{jobId:608f8997-5207-480c-9ff2-d2475cba6b9d,status:success,message:成功生成 N 张幻灯片,downloadUrl:https://...pdf...,jobUrl:https://2slides.com/workspace?jobId...,createdAt:1770108913384,updatedAt:1770108934015,slidePageCount:3,successCount:3,failedCount:0}}响应字段success布尔值表示请求是否成功data.jobId唯一作业标识符data.status生成状态“success” 或 “failed”data.message人类可读的状态消息data.downloadUrl直接 PDF 下载 URL临时1 小时后过期data.jobUrl在 2slides 工作区中查看幻灯片data.slidePageCount生成的幻灯片数量data.successCount成功生成的幻灯片数量data.failedCount失败的幻灯片数量注意此端点始终同步运行处理时间每页约 30 秒典型响应时间30-60 秒1-2 页自动生成 PDF匹配参考图片的样式和设计超时建议设置为max(120, pages * 40)秒3. 创建 PDF 幻灯片从文本生成自定义设计的幻灯片可指定设计规格。端点POST /slides/create-pdf-slides请求头Authorization: Bearer YOUR_API_KEY Content-Type: application/json请求体{userInput:string必需- 幻灯片内容,responseLanguage:string可选默认Auto,aspectRatio:string可选默认16:9- 宽:高格式,resolution:string可选默认2K- 1K、2K 或 4K,page:number可选默认1- 0 为自动检测最大 100,contentDetail:string可选默认concise- concise 或 standard,designSpec:string可选- 设计规格例如 modern minimalist}响应{success:true,data:{jobId:608f8997-5207-480c-9ff2-d2475cba6b9d,status:success,message:成功生成 N 张幻灯片,downloadUrl:https://...pdf...,jobUrl:https://2slides.com/workspace?jobId...,slidePageCount:3,successCount:3,failedCount:0}}注意类似于 create-like-this但无需参考图片使用 AI 根据内容和设计规格生成自定义设计相同的点数成本每页 100 点数1K/2K每页 200 点数4K处理时间每页约 30 秒始终同步运行4. 生成旁白以单说话人或多说话人模式为幻灯片添加 AI 语音旁白。端点POST /slides/generate-narration请求头Authorization: Bearer YOUR_API_KEY Content-Type: application/json请求体{jobId:string必需- 幻灯片生成的作业 IDUUID 格式,language:string可选默认Auto- 旁白语言,voice:string可选默认Puck- 可用语音名称,multiSpeaker:boolean可选默认false- 启用多说话人模式}可用语音共 30 种Puck, Aoede, Charon, Kore, Fenrir, Phoebe, Asteria, Luna, Stella, Theia, Helios, Atlas, Clio, Melpomene, Calliope, Erato, Euterpe, Polyhymnia, Terpsichore, Thalia, Urania, Zeus, Hera, Poseidon, Athena, Apollo, Artemis, Ares, Aphrodite, Hephaestus响应{success:true,jobId:abc123...,status:pending,message:旁白生成已开始}注意作业必须已完成才能添加旁白Nano Banana 作业的作业 ID 必须为 UUID 格式成本每页 210 点数10 用于文本200 用于音频异步运行 - 使用 /jobs/{jobId} 轮询多说话人模式使用不同语音增加多样性支持 19 种语言加自动检测5. 下载幻灯片页面和语音将幻灯片导出为 PNG 文件将语音旁白导出为 WAV 文件打包为 ZIP 归档。端点POST /slides/download-slides-pages-voices请求头Authorization: Bearer YOUR_API_KEY Content-Type: application/json请求体{jobId:string必需- 幻灯片生成的作业 ID}响应{success:true,downloadUrl:https://...zip...,message:下载已就绪}归档内容页面每张幻灯片的 PNG 文件语音WAV 音频文件如果生成了旁白文字记录旁白的文本转录注意成本完全免费不消耗点数下载 URL 仅在1 小时内有效高质量 PNG 导出WAV 格式音频包含所有幻灯片和语音文件6. 搜索主题搜索可用的演示文稿主题。端点GET /themes/search请求头Authorization: Bearer YOUR_API_KEY查询参数query: string必需- 搜索关键词 limit: number可选默认20最大100响应{themes:[{id:theme_id_123,name:Professional Blue,description:Clean professional theme with blue accents,previewUrl:https://...}],count:1}7. 获取作业状态检索异步生成作业的状态和结果。端点GET /jobs/{jobId}请求头Authorization: Bearer YOUR_API_KEY路径参数jobId: string必需- 异步生成的作业 ID响应{jobId:abc123,status:completed|pending|failed,slideUrl:https://2slides.com/slides/...,pdfUrl:https://2slides.com/slides/.../download,narrationStatus:completed|pending|not_started,error:error message if failed}状态值pending作业仍在处理中completed幻灯片已就绪failed生成失败请查看 error 字段旁白状态值not_started未请求旁白pending旁白正在生成completed旁白已就绪轮询建议每 20-30 秒轮询一次避免服务器压力错误处理所有端点返回标准 HTTP 状态码200 OK请求成功400 Bad Request参数无效401 UnauthorizedAPI 密钥缺失或无效404 Not Found资源未找到429 Too Many Requests超出速率限制500 Internal Server Error服务器错误错误响应格式{error:错误消息,code:ERROR_CODE}常见错误代码INSUFFICIENT_CREDITS账户点数不足INVALID_JOB_ID作业 ID 未找到或格式无效RATE_LIMIT_EXCEEDED请求过多请参见下面的速率限制JOB_NOT_COMPLETED作业必须完成才能添加旁白INVALID_UUID作业 ID 必须为 UUID 格式适用于 Nano Banana 作业点数成本快速 PPT生成端点每页 10 点数Nano Banana 1K/2Kcreate-like-this、create-pdf-slides每页 100 点数Nano Banana 4K每页 200 点数语音旁白每页 210 点数10 用于文本200 用于音频下载导出免费不消耗点数购买点数2slides 采用按需付费点数系统无需订阅。点数套餐当前促销最高 20% 折扣点数价格每 1,000 成本节省2,000$5.00$2.50—4,000$9.50$2.385%10,000$22.50$2.2510%20,000$42.50$2.1315%40,000$80.00$2.0020%主要优势新用户可获得500 个免费点数约 50 页快速 PPT点数永不过期无月订阅3 天退款窗口购买地址https://2slides.com/pricing示例成本10 页快速 PPT 演示文稿100 点数最大套餐下 $0.2510 页 Nano Banana 2K 演示文稿1,000 点数最大套餐下 $2.0010 页带旁白的演示文稿2,100 点数最大套餐下 $4.20速率限制不同端点有不同的速率限制快速 PPT生成每分钟 10 个请求Nano Bananacreate-like-this、create-pdf-slides每分钟 6 个请求最佳实践每 20-30 秒轮询异步作业避免服务器压力如果被限制429 错误等待后重试在 https://2slides.com/api 查看套餐的速率限制下载 URL 过期所有下载 URLPDF、ZIP 归档文件仅在1 小时内有效。生成后请及时下载文件。最佳实践内容格式化为获得最佳效果清晰结构化内容标题人工智能导论 第 1 节机器学习 - 定义 - 关键概念 - 应用 第 2 节深度学习 - 神经网络 - 训练过程 - 用例选择同步 vs 异步模式同步模式用于快速生成5 张幻灯片异步模式用于大型演示文稿5 张幻灯片异步模式用于集成到可以轮询的工作流中主题选择使用相关关键词搜索主题如果有预览 URL预览主题在生成请求中使用主题 ID留空主题以使用默认样式语言支持指定responseLanguage以不同语言生成幻灯片Auto- 自动语言检测默认English- 英语Simplified Chinese- 简体中文Traditional Chinese- 繁體中文Spanish- 西班牙语Arabic- 阿拉伯语Portuguese- 葡萄牙语Indonesian- 印度尼西亚语Japanese- 日语Russian- 俄语Hindi- 印地语French- 法语German- 德语Vietnamese- 越南语Turkish- 土耳其语Polish- 波兰语Italian- 意大利语Korean- 韩语
 - MySQL)
