Cnblogs.DashScopeSDK

Quick Start

UsingMicrosoft.Extensions.AI Interface

varclient=newDashScopeClient("your-api-key").AsChatClient("qwen-max");varcompletion=awaitclient.CompleteAsync("hello");Console.WriteLine(completion)

Console Application

varclient=newDashScopeClient("your-api-key");varcompletion=awaitclient.GetQWenCompletionAsync(QWenLlm.QWenMax,prompt);// Or use model name string// var completion = await client.GetQWenCompletionAsync("qwen-max", prompt);Console.WriteLine(completion.Output.Text);

ASP.NET Core Application

builder.AddDashScopeClient(builder.Configuration);

{"DashScope": {"ApiKey":"your-api-key"    }}

publicclassYourService(IDashScopeClientclient){publicasyncTask<string>CompletePromptAsync(stringprompt){varcompletion=awaitclient.GetQWenCompletionAsync(QWenLlm.QWenMax,prompt);returncompletion.Output.Text;}}

Supported APIs

Chat

varhistory=newList<ChatMessage>{ChatMessage.User("Please remember this number, 42"),ChatMessage.Assistant("I have remembered this number."),ChatMessage.User("What was the number I metioned before?")}varparameters=newTextGenerationParameters(){ResultFormat=ResultFormats.Message};varcompletion=awaitclient.GetQWenChatCompletionAsync(QWenLlm.QWenMax,history,parameters);Console.WriteLine(completion.Output.Choices[0].Message.Content);// The number is 42

Reasoning

varhistory=newList<TextChatMessage>{TextChatMessage.User("Calculate 1+1")};varcompletion=awaitclient.GetDeepSeekChatCompletionAsync(DeepSeekLlm.DeepSeekR1,history);Console.WriteLine(completion.Output.Choices[0]!.Message.ReasoningContent);

varstream=dashScopeClient.GetQWenChatStreamAsync(QWenLlm.QWenPlusLatest,history,newTextGenerationParameters{IncrementalOutput=true,ResultFormat=ResultFormats.Message,EnableThinking=true});

Tool Calling

stringGetCurrentWeather(GetCurrentWeatherParametersparameters){return"Sunny";}publicrecordGetCurrentWeatherParameters([property:Required][property:Description("City and state, e.g. San Francisco, CA")]stringLocation,[property:JsonConverter(typeof(EnumStringConverter<TemperatureUnit>))]TemperatureUnitUnit=TemperatureUnit.Celsius);publicenumTemperatureUnit{Celsius,Fahrenheit}

vartools=newList<ToolDefinition>{new(ToolTypes.Function,newFunctionDefinition(nameof(GetCurrentWeather),"Get current weather",newJsonSchemaBuilder().FromType<GetCurrentWeatherParameters>().Build()))};varhistory=newList<ChatMessage>{ChatMessage.User("What's the weather in CA?")};varparameters=newTextGenerationParameters{ResultFormat=ResultFormats.Message,Tools=tools};// request modelvarcompletion=awaitclient.GetQWenChatCompletionAsync(QWenLlm.QWenMax,history,parameters);Console.WriteLine(completion.Output.Choice[0].Message.ToolCalls[0].Function.Name);// GetCurrentWeatherhistory.Add(completion.Output.Choice[0].Message);// calls toolvarresult=GetCurrentWeather(new(){Location="CA"});history.Add(new("tool",result,nameof(GetCurrentWeather)));// Get final answercompletion=awaitclient.GetQWenChatCompletionAsync(QWenLlm.QWenMax,history,parameters);Console.WriteLine(completion.Output.Choices[0].Message.Content);// "Current weather in California: Sunny"

File Upload (Long Context Models)

varfile=newFileInfo("test.txt");varuploadedFile=awaitdashScopeClient.UploadFileAsync(file.OpenRead(),file.Name);varhistory=newList<ChatMessage>{ChatMessage.File(uploadedFile.Id)};varcompletion=awaitclient.GetQWenChatCompletionAsync(QWenLlm.QWenLong,history);Console.WriteLine(completion.Output.Choices[0].Message.Content);// CleanupawaitdashScopeClient.DeleteFileAsync(uploadedFile.Id);

Multimodal

varimage=awaitFile.ReadAllBytesAsync("Lenna.jpg");varresponse=dashScopeClient.GetMultimodalGenerationStreamAsync(newModelRequest<MultimodalInput,IMultimodalParameters>(){Model="qvq-plus",Input=newMultimodalInput(){Messages=[MultimodalMessage.User([MultimodalMessageContent.ImageContent(image,"image/jpeg"),MultimodalMessageContent.TextContent("她是谁？")])]},Parameters=newMultimodalParameters{IncrementalOutput=true,VlHighResolutionImages=false}});// outputvarreasoning=false;awaitforeach(varmodelResponseinresponse){varchoice=modelResponse.Output.Choices.FirstOrDefault();if(choice!=null){if(choice.FinishReason!="null"){break;}if(string.IsNullOrEmpty(choice.Message.ReasoningContent)==false){if(reasoning==false){reasoning=true;Console.WriteLine("<think>");}Console.Write(choice.Message.ReasoningContent);continue;}if(reasoning){reasoning=false;Console.WriteLine("</think>");}Console.Write(choice.Message.Content[0].Text);}}

Text-to-Speech

usingvartts=awaitdashScopeClient.CreateSpeechSynthesizerSocketSessionAsync("cosyvoice-v2");vartaskId=awaittts.RunTaskAsync(newSpeechSynthesizerParameters{Voice="longxiaochun_v2",Format="mp3"});awaittts.ContinueTaskAsync(taskId,"Cnblogs");awaittts.ContinueTaskAsync(taskId,"Code changes the world");awaittts.FinishTaskAsync(taskId);varfile=newFileInfo("tts.mp3");usingvarstream=file.OpenWrite();awaitforeach(varbintts.GetAudioAsync()){stream.WriteByte(b);}Console.WriteLine($"Audio saved to{file.FullName}");

Image Generation

Text-to-Image

vartask=awaitdashScopeClient.CreateWanxImageSynthesisTaskAsync(WanxModel.WanxV21Turbo,"A futuristic cityscape at sunset",newImageSynthesisParameters{Style=ImageStyles.OilPainting});// Pull statuswhile(true){varresult=awaitdashScopeClient.GetWanxImageSynthesisTaskAsync(task.TaskId);if(result.Output.TaskStatus==DashScopeTaskStatus.Succeeded){Console.WriteLine($"Image URL:{result.Output.Results[0].Url}");break;}awaitTask.Delay(500);}

Portrait Style Transfer

Background Generation

Application Call

varrequest=newApplicationRequest(){Input=newApplicationInput(){Prompt="Summarize this file."},Parameters=newApplicationParameters(){TopK=100,TopP=0.8f,Seed=1234,Temperature=0.85f,RagOptions=newApplicationRagOptions(){PipelineIds=["thie5bysoj"],FileIds=["file_d129d632800c45aa9e7421b30561f447_10207234"]}}};varresponse=awaitclient.GetApplicationResponseAsync("your-application-id",request);Console.WriteLine(response.Output.Text);

varrequest=newApplicationRequest(){Input=newApplicationInput(){Prompt="Summarize this file.",BizParams=newDictionary<string,object?>(){{"customKey1","custom-value"}}}};varresponse=awaitclient.GetApplicationResponseAsync("your-application-id",request);Console.WriteLine(response.Output.Text);

publicrecordTestApplicationBizParam([property:JsonPropertyName("sourceCode")]stringSourceCode);varrequest=newApplicationRequest<TestApplicationBizParam>(){Input=newApplicationInput<TestApplicationBizParam>(){Prompt="Summarize this file.",BizParams=newTestApplicationBizParam("test")}};varresponse=awaitclient.GetApplicationResponseAsync("your-application-id",request);Console.WriteLine(response.Output.Text);

Text Vectorization

vartext="Sample text for embedding";varresponse=awaitdashScopeClient.GetTextEmbeddingsAsync(TextEmbeddingModel.TextEmbeddingV4,[text],newTextEmbeddingParameters{Dimension=512});varembedding=response.Output.Embeddings.First().Embedding;Console.WriteLine($"Embedding vector length:{embedding.Length}");