C# 两种方案实现 DeepSeek API 调用：从基础到进阶

一、技术背景与调用价值

DeepSeek API 作为先进的人工智能服务接口，为开发者提供了自然语言处理、图像识别等核心能力。在C#生态中实现API调用，既能利用.NET平台的强类型特性保证代码健壮性，又能通过异步编程模型提升并发性能。本文将通过两种典型方案——原生HttpClient与RestSharp封装库，系统阐述从认证配置到异常处理的完整实现路径。

二、方案一：HttpClient原生实现

1. 认证配置与基础环境

使用Bearer Token认证时，需在API密钥管理平台获取有效凭证。建议将密钥存储在环境变量中，通过Environment.GetEnvironmentVariable()方法读取：

string apiKey = Environment.GetEnvironmentVariable("DEEPSEEK_API_KEY");
if (string.IsNullOrEmpty(apiKey))
{
    throw new InvalidOperationException("API密钥未配置");
}

2. 请求构造与异步调用

创建HttpClient实例时，推荐使用IHttpClientFactory进行依赖注入，避免Socket耗尽问题：

// Startup.cs配置示例
services.AddHttpClient("DeepSeekClient", client => 
{
    client.BaseAddress = new Uri("https://api.deepseek.com/v1/");
    client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
});
// 调用示例
public async Task<string> CallDeepSeekAsync(string endpoint, object payload)
{
    var client = _httpClientFactory.CreateClient("DeepSeekClient");
    var request = new HttpRequestMessage(HttpMethod.Post, endpoint)
    {
        Content = new StringContent(
            JsonSerializer.Serialize(payload),
            Encoding.UTF8,
            "application/json")
    };
    request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", apiKey);
    var response = await client.SendAsync(request);
    response.EnsureSuccessStatusCode();
    return await response.Content.ReadAsStringAsync();
}

3. 响应解析与错误处理

采用System.Text.Json进行反序列化时，需定义与API响应匹配的DTO类：

public class ApiResponse<T>
{
    public string Status { get; set; }
    public T Data { get; set; }
    public string Error { get; set; }
}
// 使用示例
var response = await CallDeepSeekAsync("text/completion", new { prompt = "C#编程" });
var result = JsonSerializer.Deserialize<ApiResponse<CompletionResult>>(response);
if (result.Status != "success")
{
    _logger.LogError($"API调用失败: {result.Error}");
}

三、方案二：RestSharp封装库实现

1. 库安装与基础配置

通过NuGet安装RestSharp后，创建封装类实现更简洁的调用：

// 安装命令
// Install-Package RestSharp
public class DeepSeekClient
{
    private readonly RestClient _client;
    public DeepSeekClient(string apiKey)
    {
        var options = new RestClientOptions("https://api.deepseek.com/v1/")
        {
            ConfigureMessageHandler = _ => new System.Net.Http.SocketsHttpHandler
            {
                PooledConnectionLifetime = TimeSpan.FromMinutes(1)
            }
        };
        _client = new RestClient(options);
        _client.AddDefaultHeader("Authorization", $"Bearer {apiKey}");
    }
}

2. 请求执行与参数绑定

RestSharp的自动参数绑定极大简化请求构造：

public async Task<CompletionResult> GetCompletion(string prompt, int maxTokens = 100)
{
    var request = new RestRequest("text/completion", Method.Post);
    request.AddJsonBody(new { prompt, max_tokens = maxTokens });
    var response = await _client.ExecuteAsync<ApiResponse<CompletionResult>>(request);
    if (!response.IsSuccessful)
    {
        throw new ApiException($"HTTP错误: {response.StatusCode}, 详情: {response.ErrorMessage}");
    }
    return response.Data?.Data;
}

3. 高级特性应用

利用RestSharp的序列化器配置支持复杂对象：

// 自定义序列化设置
var settings = new JsonSerializerOptions
{
    PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
    WriteIndented = true
};
_client.UseSerializer(() => new SystemTextJsonSerializer(settings));

四、性能优化与最佳实践

1. 连接复用：通过SocketsHttpHandler配置连接池参数，建议设置PooledConnectionIdleTimeout为60秒

2. 重试机制：实现指数退避算法处理临时性网络错误

   public async Task<T> ExecuteWithRetry<T>(Func<Task<T>> action, int maxRetries = 3)
   {
    var delays = Enumerable.Range(1, maxRetries)
        .Select(i => Math.Pow(2, i) * 1000); // 指数退避
    foreach (var delay in delays)
    {
        try
        {
            return await action();
        }
        catch (HttpRequestException ex) when (delay < delays.Last())
        {
            await Task.Delay((int)delay);
        }
    }
    throw new TimeoutException("操作超过最大重试次数");
   }

3. 日志记录：集成Serilog记录完整请求/响应周期
4. 限流处理：根据API的QPS限制实现令牌桶算法

五、安全与合规建议

1. 密钥管理：使用Azure Key Vault或AWS Secrets Manager进行密钥轮换

2. 数据脱敏：在日志中过滤敏感参数

   public class SensitiveDataConverter : JsonConverter<string>
   {
    public override string Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
    {
        return reader.GetString();
    }
    public override void Write(Utf8JsonWriter writer, string value, JsonSerializerOptions options)
    {
        if (value?.Length > 10) // 示例：截断长文本
        {
            writer.WriteStringValue(value.Substring(0, 7) + "...");
        }
        else
        {
            writer.WriteStringValue(value);
        }
    }
   }

3. HTTPS强制：通过HttpClientHandler禁用非加密连接

六、扩展应用场景

1. 批量处理：使用Parallel.ForEachAsync实现并发请求

2. 流式响应：处理DeepSeek的SSE（Server-Sent Events）流数据

   public async IAsyncEnumerable<string> StreamCompletion(string prompt)
   {
    var request = new HttpRequestMessage(HttpMethod.Get, "text/stream");
    // ...认证配置
    using var response = await _client.SendAsync(request, HttpCompletionOption.ResponseHeadersRead);
    using var stream = await response.Content.ReadAsStreamAsync();
    using var reader = new StreamReader(stream);
    while (!reader.EndOfStream)
    {
        var line = await reader.ReadLineAsync();
        if (!string.IsNullOrEmpty(line) && line.StartsWith("data:"))
        {
            var data = line.Substring(5).Trim();
            yield return JsonSerializer.Deserialize<StreamChunk>(data).Text;
        }
    }
   }

3. Grpc集成：对于高频调用场景，可考虑生成Grpc客户端

七、总结与选型建议

方案维度	HttpClient原生实现	RestSharp封装实现
学习曲线	较高，需手动处理细节	较低，提供高级抽象
性能	轻微优势（无中间层）	可接受损耗（约5-8%）
功能覆盖	完全可控	依赖库版本
维护成本	较高（需自行处理边缘情况）	较低（社区维护）

推荐场景：

• 复杂业务逻辑或需要深度定制时选择HttpClient
• 快速原型开发或标准CRUD操作选择RestSharp

通过本文介绍的两种方案，开发者可根据项目需求灵活选择实现路径，在保证代码质量的同时显著提升开发效率。建议结合单元测试（使用Moq模拟HTTP响应）和集成测试构建完整的测试体系，确保API调用的可靠性。