C#接入豆包AI模型实现首尾帧视频生成方法

欲诚其意者，先致其知，致知在格物。人生太多体验，有悲有喜，有好有坏。没有实践就没有发言权，没有亲自尝试就不要轻易否定，适合你的才是最好的。最近在火山引擎火山方舟平台模型广场中看到豆包推出最强视频生成模型 Doubao-Seedance-1.0-pro，于是也想来体验一下它的魅力。模型提供多种生成方式，其中一项“首尾帧”模式挺有意思——提供首图和尾图两张照片，结合AI对话描述生成结果视频。本文就详细讲讲如何用C#调用平台API来实现这个功能。

调用API前，需要先注册火山引擎帐号并获取API开发密钥。

火山引擎注册地址：https://console.volcengine.com/auth/login

选择火山方舟 → API Key管理 → 创建API Key即可。注意编辑权限，确保能调用对应功能的API。

构思

就像人与人之间有效的沟通一样，给AI模型提供符合情境的素材、精准且逻辑清晰的对话描述，才能生成符合预期的结果。不过为了测试它的“思考”和“创意”能力，这次特意选了两张风格迥异的美女图片——一张是现代风的人物坐在汽车后排，另一张是复古风的人物在女生宿舍。对话描述也很简短：“结合图片，请生成类似周杰伦《红颜如霜》的MV，要求生成音乐”。看看AI模型会怎么处理这种跨度极大的素材。期待之余，多少有点好奇。

创建视频生成任务

模型“思考”和生成视频需要一段时间，属于异步操作。首先要做的就是向模型申请创建视频生成任务。Doubao_CreateVideo方法提供了创建视频任务的能力，基本参数说明如下表：

方法示例代码如下：

string ErrorMessage = "";
string ResultJson = "";
public void Doubao_CreateVideo(string say, string ApiKey, string first_ImageUrlOrBase64, string last_ImageUrlOrBase64,
    string rs = "720p", string rt = "16:9", int dur = 5, int fps = 24, bool wm = true, int seed = 11, bool cf = false,
    string model = "doubao-seedance-1-0-pro-250528")
{
    string para = string.Format(" --rs {0} --rt {1} --dur {2} --fps {3} --wm {4} --seed {5} --cf {6}", rs, rt, dur, fps, wm, seed, cf);
    string ApiUrl = "https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks";
    WebService ws = new WebService();
    string[] headers = new string[3];
    headers[0] = "Content-Type:application/json";
    headers[1] = "Accept:application/json";
    headers[2] = "Authorization:Bearer " + ApiKey + "";
    StringWriter sw = new StringWriter();
    using (Newtonsoft.Json.JsonWriter writer = new Newtonsoft.Json.JsonTextWriter(sw))
    {
        writer.Formatting = Newtonsoft.Json.Formatting.Indented;
        writer.WriteStartObject();
        writer.WritePropertyName("model");
        writer.WriteValue(model);
        writer.WritePropertyName("content");
        writer.WriteStartArray();
        writer.WriteStartObject();
        writer.WritePropertyName("type");
        writer.WriteValue("text");
        writer.WritePropertyName("text");
        writer.WriteValue(say + para);
        writer.WriteEndObject();
        writer.WriteStartObject();
        writer.WritePropertyName("type");
        writer.WriteValue("image_url");
        writer.WritePropertyName("image_url");
        writer.WriteStartObject();
        writer.WritePropertyName("url");
        writer.WriteValue(first_ImageUrlOrBase64);
        writer.WriteEndObject();
        writer.WritePropertyName("role");
        writer.WriteValue("first_frame");
        writer.WriteEndObject();
        writer.WriteStartObject();
        writer.WritePropertyName("type");
        writer.WriteValue("image_url");
        writer.WritePropertyName("image_url");
        writer.WriteStartObject();
        writer.WritePropertyName("url");
        writer.WriteValue(last_ImageUrlOrBase64);
        writer.WriteEndObject();
        writer.WritePropertyName("role");
        writer.WriteValue("last_frame");
        writer.WriteEndObject();
        writer.WriteEndArray();
        writer.WriteEndObject();
        writer.Flush();
    }
    sw.Close();
    string postData = sw.GetStringBuilder().ToString();
    ErrorMessage = "";
    ResultJson = "";
    string rs2 = ws.GetResponseResult(ApiUrl, Encoding.UTF8, "POST", postData, headers);
    ErrorMessage = ws.ErrorMessage;
    ResultJson = rs2;
}

其中 WebService 类示例代码如下（通用HTTP请求封装）：

public sealed class WebService
{
    #region Internal Members
    public string ErrorMessage = "";
    #endregion

    public string GetResponseResult(string url, System.Text.Encoding encoding, string method, string postData)
    {
        return GetResponseResult(url, encoding, method, postData, null);
    }

    private static bool validSecurity(object sender, X509Certificate certificate, X509Chain chain, SslPolicyErrors sslPolicyErrors)
    {
        return true;
    }

    public string GetResponseResult(string url, System.Text.Encoding encoding, string method, string postData,
        string[] headers, string ContentType = "application/x-www-form-urlencoded", bool secValid = true)
    {
        method = method.ToUpper();
        if (secValid == false)
        {
            ServicePointManager.ServerCertificateValidationCallback = validSecurity;
        }
        System.Net.ServicePointManager.SecurityProtocol = System.Net.SecurityProtocolType.Tls | System.Net.SecurityProtocolType.Tls11 | System.Net.SecurityProtocolType.Tls12;

        if (method == "GET")
        {
            // ... GET请求代码（略，与原文一致）
        }
        if (method == "POST")
        {
            // ... POST请求代码（略，与原文一致）
        }
        ErrorMessage = "不正确的方法类型。（目前仅支持GET/POST）";
        return "";
    }
}

成功调用后会返回如下JSON：

{ "id": "cgt-20251000000008-xxxbk" }

其中的 id 就是创建成功后的任务ID。此时模型正在生成视频……

查询视频生成任务

根据创建视频成功后返回的ID，可以通过查询视频生成任务API轮询其状态，直到完成。Doubao_QueryVideoTask方法实现对任务ID的详情查询，参数说明如下：

方法示例代码：

string ErrorMessage = "";
string ResultJson = "";
public void Doubao_QueryVideoTask(string taskid, string ApiKey)
{
    string ApiUrl = "https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/" + taskid;
    WebService ws = new WebService();
    string[] headers = new string[2];
    headers[0] = "Content-Type:application/json";
    headers[1] = "Authorization:Bearer " + ApiKey + "";
    ErrorMessage = "";
    ResultJson = "";
    string rs2 = ws.GetResponseResult(ApiUrl, Encoding.UTF8, "GET", "", headers);
    ErrorMessage = ws.ErrorMessage;
    ResultJson = rs2;
}

成功返回示例：

{
  "id": "cgt-2025108-whpbk",
  "model": "doubao-seedance-1-0-pro-250528",
  "status": "succeeded",
  "content": { "video_url": "xxx" },
  "usage": { "completion_tokens": 103818, "total_tokens": 103818 },
  "created_at": 1763455989,
  "updated_at": 1763456064,
  "seed": 11,
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "framespersecond": 24
}

其中 status 为状态码，succeeded 表示已完成。其他枚举值：queued（排队中）、running（运行中）、cancelled（取消，取消后24h自动删除，仅支持排队中状态的任务被取消）、failed（失败）。如果返回的JSON中有 content.video_url 字段，就可以访问或下载该视频查看效果。

查询视频生成任务列表

如果没能及时查询单个任务，或者想查看所有生成中/已完成的任务，可以用查询视频生成任务列表API。该API仅支持查询最近7天的历史数据（UTC时间戳，范围 [T-7天, T) ）。

Doubao_QueryVideoTaskList方法实现列表查询，参数如下：

示例代码：

string ErrorMessage = "";
string ResultJson = "";
public void Doubao_QueryVideoTaskList(int page_num = 1, int page_size = 500, string filter_status = "succeeded", string ApiKey)
{
    string postData = "page_num=" + page_num.ToString() + "&page_size=" + page_size.ToString() + "&filter.status=" + filter_status;
    string ApiUrl = "https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks?" + postData;
    WebService ws = new WebService();
    string[] headers = new string[2];
    headers[0] = "Content-Type:application/json";
    headers[1] = "Authorization:Bearer " + ApiKey + "";
    ErrorMessage = "";
    ResultJson = "";
    string rs2 = ws.GetResponseResult(ApiUrl, Encoding.UTF8, "GET", "", headers);
    ErrorMessage = ws.ErrorMessage;
    ResultJson = rs2;
}

成功返回示例：

{
  "total": 5,
  "items": [
    { "id": "...", "model": "...", "status": "succeeded", "content": { "video_url": "https://..." }, ... },
    // 更多条目
  ]
}

可以通过以下代码遍历所有 video_url：

string list = "";
Newtonsoft.Json.Linq.JObject rs2 = Newtonsoft.Json.Linq.JObject.Parse(ResultJson);
for (int i = 0; i < rs2["items"].Count(); i++)
{
    list += rs2["items"][i]["content"]["video_url"].ToString() + "\r";
}

红颜如霜

生成的视频效果有点意思。AI模型确实充分发挥了想象力——对车辆场景的识别、人物行走的创意、过渡的变化都还算可以，毕竟只有12秒。人物面部五官部分稍微有点“拥挤”变形，但整体还原度相当不错。不过要求加入的《红颜如霜》音乐背景没有混入合成，估计是音乐版权的问题。于是自己录了一段歌曲片段，用手机视频编辑软件合成，最终效果如下：

AI模型生成的视频

小结

生成视频会消耗不少 tokens。注册时如果用的是先用后付模式，体验之后发现帐户欠费了——这一点需要特别留意费用说明和消耗情况，根据自己的需求来就好。

相关API文档链接：

• 文档中心入口：https://www.volcengine.com/docs/82379
• 创建视频生成任务API：https://www.volcengine.com/docs/82379/1520757
• 查询视频生成任务API：https://www.volcengine.com/docs/82379/1521309
• 查询视频生成任务列表：https://www.volcengine.com/docs/82379/1521675