text-to-video

name	text-to-video
description	基于文本描述生成短视频（5s/10s），适用于电商营销、创意宣传、教育讲解等场景，异步轮询获取结果。
license	MIT

能力概述

通过百度千帆平台 Kling 模型，根据文字提示词自动生成 5 秒或 10 秒的视频内容（不含声音）。

项目	说明
认证模式	platform_managed（密钥由平台注入，无需用户配置）
第三方域名	app-bo4w33bsdqm9-api-o9wN672BkyMa-gateway.appmiaoda.com
支持平台	Web、MiniProgram
说明	创建任务接口用于提交任务，查询接口用于轮询结果

接口列表：

接口	方法	路径	说明
创建文生视频任务	POST	/beta/video/generations/kling/text2video	提交生成任务，返回 task_id
查询任务状态	GET	/beta/video/generations/kling/text2video	轮询任务状态，成功后返回视频 URL

工作流：

用户提交 prompt
    ↓
POST /text2video  →  返回 task_id
    ↓
每 5 秒轮询 GET /text2video?task_id=xxx
    ↓
task_status == "succeed"  →  获取 videos[0].url
    ↓
将视频 URL 转存至 Supabase Storage（视频链接 30 天后失效）

---

生成期用法（Agent 直接调用）

此 API 为异步接口，需先提交任务获取 task_id，再轮询查询状态直至完成。

详见：

• references/submit-api.md（创建文生视频任务）
• references/query-api.md（查询文生视频生成任务状态）

完整异步工作流示例（生成期）：

const apiKey = process.env["INTEGRATIONS_API_KEY"]!;

/**
 * 创建文生视频任务
 * @param prompt - 正向文本提示词，最大 2500 字符
 * @param duration - 视频时长（秒），枚举值：5、10，默认 5
 * @param modelName - 生成模型，枚举值：kling-v1、kling-v1-6、kling-v2-master、kling-v2-1-master
 * @returns task_id
 */
async function submitTextToVideo(
  prompt: string,
  duration: string = "5",
  modelName: string = "kling-v1-6"
): Promise<string> {
  const response = await fetch(
    "https://app-bo4w33bsdqm9-api-o9wN672BkyMa-gateway.appmiaoda.com/beta/video/generations/kling/text2video",
    {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "X-Gateway-Authorization": `Bearer ${apiKey}`,
      },
      body: JSON.stringify({ model_name: modelName, prompt, duration }), // model_name 为必填参数
    }
  );
  if (!response.ok) throw new Error(`HTTP error: `);
   json =  response.();
   (json. !== )   ();
   json..;
}


  (): <{
  : ;
  : ;
  ?: ;
  ?: { : <{ : ; : ; :  }> };
  : ;
  : ;
}> {
   url =  (
    
  );
  url..(, taskId);
   response =  (url.(), {
    : ,
    : {
      : ,
      : ,
    },
  });
   (!response.)   ();
   json =  response.();
   (json. !== )   ();
   json.;
}


  (): <> {
   taskId =  (prompt, duration, modelName);

    = ;
    =  *  * ;
   deadline = .() + ;

   (.() < deadline) {
      ( (r, ));
     result =  (taskId);
     (result. === ) {
       videoUrl = result.?.?.[]?.;
       (!videoUrl)   ();
       videoUrl;
    }
     (result. === ) {
        ();
    }
    
  }
    ();
}

生成期文件下载（必须执行）：

生成接口返回的视频 URL 是 CDN 临时链接（30 天后失效），在生成期（Agent 直接调用场景）获得 URL 后，必须立即使用 Bash 工具将文件下载到本地，以便用户查看结果。

curl -L -o <本地路径> "<视频 URL>"

完整生成期工作流（含下载步骤）：

1. 调用生成函数获取视频 URL
2. 使用 Bash 工具执行 curl -L -o <本地路径> "<url>" 将文件下载到本地
3. 告知用户文件已保存到对应路径

注意：上游 CDN 链接有时效性，应在获得 URL 后立即下载，不要延迟。

---

生成后用法（应用内通过 Edge Function 调用）

本 API 为异步接口，Edge Function 设计原则：

• 创建任务 Edge Function：立即返回 task_id 给前端，不在 Edge Function 内部轮询。
• 查询任务 Edge Function：前端每 5 秒调用一次，直到 task_status 为 succeed 或 failed。
• 当状态为 succeed 时，将 task_result.videos[0].url 转存至 Supabase Storage（原始视频链接 30 天后失效）。

平台差异：

平台	调用方式	说明
Web	supabase.functions.invoke 或原生 fetch	标准 JSON 调用
MiniProgram	supabase.functions.invoke	标准 JSON 调用

详见：

• references/submit-api.md（创建任务 Edge Function + 前端代码）
• references/query-api.md（查询任务 Edge Function + 前端轮询代码 + Supabase Storage 转存）