Stability-AI/StableSwarmUI项目中的C API调用问题解析

在使用Stability-AI/StableSwarmUI项目时，开发者可能会遇到一个典型的API调用问题：当通过C#代码请求v2beta版本的API时，会出现"Malformed FormData request"错误，而同样的请求在curl和Python中却能正常工作。

这个问题本质上源于CDN服务处理未加引号的Content-Disposition头部时的兼容性问题。虽然RFC 6266标准明确将未加引号的形式作为示例1，但某些实现（如CDN服务）却无法正确处理这种标准格式。

在C#中，HttpClient默认会严格遵循RFC规范生成multipart/form-data请求。当这种标准格式的请求到达CDN服务时，就会触发上述错误。要解决这个问题，开发者需要手动调整Content-Disposition头部的格式。

解决方案的核心在于为每个表单字段显式添加带有引号的Content-Disposition头部。可以通过创建辅助方法来实现这一点：

public static class FormDataHelper
{
    public static void AddString(this MultipartFormDataContent content, string key, string value)
    {
        content.AddContent(key, null, new StringContent(value));
    }

    public static void AddContent(this MultipartFormDataContent formdata, string key, string filename, HttpContent content)
    {
        content.Headers.ContentDisposition = new("form-data") 
        { 
            Name = $"\"{key}\"", 
            FileName = filename is null ? null : $"\"{filename}\"" 
        };
        
        if (filename is not null)
        {
            formdata.Add(content, key, filename);
        }
        else
        {
            formdata.Add(content, key);
        }
    }
}

使用时，开发者可以这样调用：

content.AddString("prompt", "a cute rabbit");
content.AddString("output_format", "png");

这种方法通过强制为字段名添加引号，确保了与CDN服务的兼容性。值得注意的是，Stability AI团队可能已经或即将支持JSON格式的输入，这将从根本上避免multipart/form-data带来的兼容性问题。

对于开发者来说，理解这种底层协议级别的兼容性问题非常重要。它不仅出现在这个特定场景中，在开发跨平台、跨语言的API客户端时也经常遇到类似问题。掌握这种调试和解决方法，能够显著提高开发效率和应用稳定性。