生成第一份 PPT

这一节只走一条最短路径：使用 V2 接口，从主题创建任务并生成第一份 PPT。

第 1 步：创建调用 Token

先在服务端使用 Api-Key 调用 createApiToken。


const response = await fetch('https://docmee.cn/api/user/createApiToken', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Api-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    uid: 'demo-user',
    limit: 10,
    timeOfHours: 2
  })
})
 
const result = await response.json()
console.log(result)


import requests
 
response = requests.post(
    'https://docmee.cn/api/user/createApiToken',
    headers={
        'Content-Type': 'application/json',
        'Api-Key': 'YOUR_API_KEY'
    },
    json={
        'uid': 'demo-user',
        'limit': 10,
        'timeOfHours': 2
    }
)
 
print(response.json())


package main
 
import (
  "bytes"
  "fmt"
  "io"
  "net/http"
)
 
func main() {
  body := []byte(`{"uid":"demo-user","limit":10,"timeOfHours":2}`)
  req, _ := http.NewRequest("POST", "https://docmee.cn/api/user/createApiToken", bytes.NewBuffer(body))
  req.Header.Set("Content-Type", "application/json")
  req.Header.Set("Api-Key", "YOUR_API_KEY")
 
  resp, _ := http.DefaultClient.Do(req)
  defer resp.Body.Close()
 
  data, _ := io.ReadAll(resp.Body)
  fmt.Println(string(data))
}


import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
public class CreateApiTokenExample {
  public static void main(String[] args) throws Exception {
    String body = """
      {
        "uid": "demo-user",
        "limit": 10,
        "timeOfHours": 2
      }
      """;
 
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://docmee.cn/api/user/createApiToken"))
      .header("Content-Type", "application/json")
      .header("Api-Key", "YOUR_API_KEY")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();
 
    HttpResponse<String> response = HttpClient.newHttpClient()
      .send(request, HttpResponse.BodyHandlers.ofString());
 
    System.out.println(response.body());
  }
}

拿到返回的 token 后，后续请求都在 Header 中传入：


token: YOUR_TEMP_TOKEN

第 2 步：创建生成任务

调用 createTask 创建任务。这里以 type=1 的智能生成为例。


const formData = new FormData()
formData.append('type', '1')
formData.append('content', '请生成一份关于 AI 办公趋势的产品介绍 PPT')
 
const response = await fetch('https://docmee.cn/api/ppt/v2/createTask', {
  method: 'POST',
  headers: {
    token: 'YOUR_TEMP_TOKEN'
  },
  body: formData
})
 
const result = await response.json()
console.log(result)


import requests
 
response = requests.post(
    'https://docmee.cn/api/ppt/v2/createTask',
    headers={'token': 'YOUR_TEMP_TOKEN'},
    data={
        'type': '1',
        'content': '请生成一份关于 AI 办公趋势的产品介绍 PPT'
    }
)
 
print(response.json())


package main
 
import (
  "bytes"
  "fmt"
  "io"
  "mime/multipart"
  "net/http"
)
 
func main() {
  var body bytes.Buffer
  writer := multipart.NewWriter(&body)
  writer.WriteField("type", "1")
  writer.WriteField("content", "请生成一份关于 AI 办公趋势的产品介绍 PPT")
  writer.Close()
 
  req, _ := http.NewRequest("POST", "https://docmee.cn/api/ppt/v2/createTask", &body)
  req.Header.Set("token", "YOUR_TEMP_TOKEN")
  req.Header.Set("Content-Type", writer.FormDataContentType())
 
  resp, _ := http.DefaultClient.Do(req)
  defer resp.Body.Close()
 
  data, _ := io.ReadAll(resp.Body)
  fmt.Println(string(data))
}


import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
public class CreateTaskExample {
  public static void main(String[] args) throws IOException, InterruptedException {
    String boundary = "----DocmeeBoundary";
    String body = "--" + boundary + "\\r\\n"
      + "Content-Disposition: form-data; name=\\"type\\"\\r\\n\\r\\n1\\r\\n"
      + "--" + boundary + "\\r\\n"
      + "Content-Disposition: form-data; name=\\"content\\"\\r\\n\\r\\n请生成一份关于 AI 办公趋势的产品介绍 PPT\\r\\n"
      + "--" + boundary + "--\\r\\n";
 
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://docmee.cn/api/ppt/v2/createTask"))
      .header("token", "YOUR_TEMP_TOKEN")
      .header("Content-Type", "multipart/form-data; boundary=" + boundary)
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();
 
    HttpResponse<String> response = HttpClient.newHttpClient()
      .send(request, HttpResponse.BodyHandlers.ofString());
 
    System.out.println(response.body());
  }
}

成功后会返回任务 id。

第 3 步：生成大纲与内容

调用 generateContent 为该任务生成大纲与正文内容。推荐使用流式模式。


const response = await fetch('https://docmee.cn/api/ppt/v2/generateContent', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    token: 'YOUR_TEMP_TOKEN'
  },
  body: JSON.stringify({
    id: 'TASK_ID',
    stream: true,
    length: 'medium',
    scene: '产品介绍',
    audience: '客户',
    lang: 'zh',
    prompt: '语气专业，适合演示'
  })
})
 
const result = await response.text()
console.log(result)


import requests
 
response = requests.post(
    'https://docmee.cn/api/ppt/v2/generateContent',
    headers={
        'Content-Type': 'application/json',
        'token': 'YOUR_TEMP_TOKEN'
    },
    json={
        'id': 'TASK_ID',
        'stream': True,
        'length': 'medium',
        'scene': '产品介绍',
        'audience': '客户',
        'lang': 'zh',
        'prompt': '语气专业，适合演示'
    }
)
 
print(response.text)


package main
 
import (
  "bytes"
  "fmt"
  "io"
  "net/http"
)
 
func main() {
  body := []byte(`{"id":"TASK_ID","stream":true,"length":"medium","scene":"产品介绍","audience":"客户","lang":"zh","prompt":"语气专业，适合演示"}`)
  req, _ := http.NewRequest("POST", "https://docmee.cn/api/ppt/v2/generateContent", bytes.NewBuffer(body))
  req.Header.Set("Content-Type", "application/json")
  req.Header.Set("token", "YOUR_TEMP_TOKEN")
 
  resp, _ := http.DefaultClient.Do(req)
  defer resp.Body.Close()
 
  data, _ := io.ReadAll(resp.Body)
  fmt.Println(string(data))
}


import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
public class GenerateContentExample {
  public static void main(String[] args) throws Exception {
    String body = """
      {
        "id": "TASK_ID",
        "stream": true,
        "length": "medium",
        "scene": "产品介绍",
        "audience": "客户",
        "lang": "zh",
        "prompt": "语气专业，适合演示"
      }
      """;
 
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://docmee.cn/api/ppt/v2/generateContent"))
      .header("Content-Type", "application/json")
      .header("token", "YOUR_TEMP_TOKEN")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();
 
    HttpResponse<String> response = HttpClient.newHttpClient()
      .send(request, HttpResponse.BodyHandlers.ofString());
 
    System.out.println(response.body());
  }
}

流式响应结束时会返回完整结果。你也可以在拿到初稿后继续调用 updateContent 做二次调整。

第 4 步：选择模板

如果你已经有模板 ID，可以直接使用；如果没有，可以先调用：

templates 分页查模板
randomTemplates 随机拿一批模板

第 5 步：生成 PPT

把任务 ID、模板 ID 和最终 Markdown 内容传给 generatePptx。


const response = await fetch('https://docmee.cn/api/ppt/v2/generatePptx', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    token: 'YOUR_TEMP_TOKEN'
  },
  body: JSON.stringify({
    id: 'TASK_ID',
    templateId: 'TEMPLATE_ID',
    markdown: '# AI 办公趋势\\n## 行业背景\\n### 机会与挑战\\n#### 关键观点\\n- 内容示例'
  })
})
 
const result = await response.json()
console.log(result)


import requests
 
response = requests.post(
    'https://docmee.cn/api/ppt/v2/generatePptx',
    headers={
        'Content-Type': 'application/json',
        'token': 'YOUR_TEMP_TOKEN'
    },
    json={
        'id': 'TASK_ID',
        'templateId': 'TEMPLATE_ID',
        'markdown': '# AI 办公趋势\\n## 行业背景\\n### 机会与挑战\\n#### 关键观点\\n- 内容示例'
    }
)
 
print(response.json())


package main
 
import (
  "bytes"
  "fmt"
  "io"
  "net/http"
)
 
func main() {
  body := []byte(`{"id":"TASK_ID","templateId":"TEMPLATE_ID","markdown":"# AI 办公趋势\\n## 行业背景\\n### 机会与挑战\\n#### 关键观点\\n- 内容示例"}`)
  req, _ := http.NewRequest("POST", "https://docmee.cn/api/ppt/v2/generatePptx", bytes.NewBuffer(body))
  req.Header.Set("Content-Type", "application/json")
  req.Header.Set("token", "YOUR_TEMP_TOKEN")
 
  resp, _ := http.DefaultClient.Do(req)
  defer resp.Body.Close()
 
  data, _ := io.ReadAll(resp.Body)
  fmt.Println(string(data))
}


import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
public class GeneratePptxExample {
  public static void main(String[] args) throws Exception {
    String body = """
      {
        "id": "TASK_ID",
        "templateId": "TEMPLATE_ID",
        "markdown": "# AI 办公趋势\\n## 行业背景\\n### 机会与挑战\\n#### 关键观点\\n- 内容示例"
      }
      """;
 
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://docmee.cn/api/ppt/v2/generatePptx"))
      .header("Content-Type", "application/json")
      .header("token", "YOUR_TEMP_TOKEN")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();
 
    HttpResponse<String> response = HttpClient.newHttpClient()
      .send(request, HttpResponse.BodyHandlers.ofString());
 
    System.out.println(response.body());
  }
}

接口会返回 pptInfo，其中包含 PPT ID、封面地址和 PPT 数据结构。

第 6 步：下载 PPT

如果你需要可下载文件，再调用 downloadPptx：


const response = await fetch('https://docmee.cn/api/ppt/downloadPptx', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    token: 'YOUR_TEMP_TOKEN'
  },
  body: JSON.stringify({ id: 'PPT_ID' })
})
 
const result = await response.json()
console.log(result)


import requests
 
response = requests.post(
    'https://docmee.cn/api/ppt/downloadPptx',
    headers={
        'Content-Type': 'application/json',
        'token': 'YOUR_TEMP_TOKEN'
    },
    json={'id': 'PPT_ID'}
)
 
print(response.json())


package main
 
import (
  "bytes"
  "fmt"
  "io"
  "net/http"
)
 
func main() {
  body := []byte(`{"id":"PPT_ID"}`)
  req, _ := http.NewRequest("POST", "https://docmee.cn/api/ppt/downloadPptx", bytes.NewBuffer(body))
  req.Header.Set("Content-Type", "application/json")
  req.Header.Set("token", "YOUR_TEMP_TOKEN")
 
  resp, _ := http.DefaultClient.Do(req)
  defer resp.Body.Close()
 
  data, _ := io.ReadAll(resp.Body)
  fmt.Println(string(data))
}


import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
public class DownloadPptxExample {
  public static void main(String[] args) throws Exception {
    String body = "{\"id\":\"PPT_ID\"}";
 
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://docmee.cn/api/ppt/downloadPptx"))
      .header("Content-Type", "application/json")
      .header("token", "YOUR_TEMP_TOKEN")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();
 
    HttpResponse<String> response = HttpClient.newHttpClient()
      .send(request, HttpResponse.BodyHandlers.ofString());
 
    System.out.println(response.body());
  }
}

返回的 fileUrl 可直接下载，默认有效期 2 小时。

常见建议

新接入优先使用 V2，不要从 V1 开始
生产环境由服务端创建 Token，不要在前端暴露 Api-Key
UI 集成建议为 Token 设置 limit
资源访问需要在 URL 上追加 ?token=xxx