簡單示例

Qwen-Long模型可以基于您上傳的文檔進行回復。此處以百煉系列手機產品介紹.docx作為示例文件。

1. 將文件通過OpenAI兼容接口上傳到百煉平臺，獲取file-id。有關文檔上傳接口的詳細參數解釋及調用方式，請參考API文檔頁面進行了解。

   Python

   import os
   from pathlib import Path
   from openai import OpenAI
   
   client = OpenAI(
       api_key=os.getenv("DASHSCOPE_API_KEY"),
       base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
   )
   
   file_object = client.files.create(file=Path("百煉系列手機產品介紹.docx"), purpose="file-extract")
   print(file_object.id)

   curl

   curl --location --request POST 'https://dashscope.aliyuncs.com/compatible-mode/v1/files' \
     --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
     --form 'file=@"百煉系列手機產品介紹.docx"' \
     --form 'purpose="file-extract"'

   運行以上代碼，您可以得到本次上傳文件對應的file-id。

2. 將file-id傳入System Message中且數量不超過 100 個，并在User Message中輸入問題。

   在通過 system message 提供文檔信息時，建議同時設置一個正常role-play的system message，如默認的 “You are a helpful assistant.”，角色設定會對文檔的處理效果產生影響，因此建議在消息中明確設定自己的角色。

   Python

   import os
   from openai import OpenAI
   
   client = OpenAI(
       api_key=os.getenv("DASHSCOPE_API_KEY"),
       base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
   )
   
   completion = client.chat.completions.create(
       model="qwen-long",
       messages=[
           {'role': 'system', 'content': 'You are a helpful assistant.'},
           {'role': 'system', 'content': 'fileid://file-fe-xxx'},
           {'role': 'user', 'content': '這篇文章講了什么？'}
       ],
       stream=True,
       stream_options={"include_usage": True}
   )
   
   full_content = ""
   for chunk in completion:
       if chunk.choices and chunk.choices[0].delta.content:
           full_content += chunk.choices[0].delta.content
           print(chunk.model_dump())
   
   print({full_content})

   curl

   curl --location 'https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions' \
   --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
   --header "Content-Type: application/json" \
   --data '{
       "model": "qwen-long",
       "messages": [
           {"role": "system","content": "You are a helpful assistant."},
           {"role": "system","content": "fileid://file-fe-xxx"},
           {"role": "user","content": "這篇文章講了什么？"}
       ],
       "stream": true,
       "stream_options": {
           "include_usage": true
       }
   }'

   通過配置stream及stream_options參數，Qwen-Long模型會流式輸出回復，并在最后返回的對象中通過usage字段展示Token使用情況。

   本文中的所有代碼示例均采用流式輸出，以清晰和直觀地展示模型輸出過程。如果您希望查看非流式輸出的案例，請參見此處的非流式輸出案例。

   Python

   {'id':'chatcmpl-565151e8-7b41-9a78-ae88-472edbad8c47','choices':[{'delta':{'content':'','function_call':null,'role':'assistant','tool_calls':null},'finish_reason':null,'index':0,'logprobs':null}],'created':1726023099,'model':'qwen-long','object':'chat.completion.chunk','service_tier':null,'system_fingerprint':null,'usage':null}
   {'id':'chatcmpl-565151e8-7b41-9a78-ae88-472edbad8c47','choices':[{'delta':{'content':'這篇文章','function_call':null,'role':null,'tool_calls':null},'finish_reason':null,'index':0,'logprobs':null}],'created':1726023099,'model':'qwen-long','object':'chat.completion.chunk','service_tier':null,'system_fingerprint':null,'usage':null}
   {'id':'chatcmpl-565151e8-7b41-9a78-ae88-472edbad8c47','choices':[{'delta':{'content':'介紹了','function_call':null,'role':null,'tool_calls':null},'finish_reason':null,'index':0,'logprobs':null}],'created':1726023099,'model':'qwen-long','object':'chat.completion.chunk','service_tier':null,'system_fingerprint':null,'usage':null}
   {'id':'chatcmpl-565151e8-7b41-9a78-ae88-472edbad8c47','choices':[{'delta':{'content':'百','function_call':null,'role':null,'tool_calls':null},'finish_reason':null,'index':0,'logprobs':null}],'created':1726023099,'model':'qwen-long','object':'chat.completion.chunk','service_tier':null,'system_fingerprint':null,'usage':null}
   ......
   {'id':'chatcmpl-565151e8-7b41-9a78-ae88-472edbad8c47','choices':[{'delta':{'content':'滿足不同的使用需求','function_call':null,'role':null,'tool_calls':null},'finish_reason':null,'index':0,'logprobs':null}],'created':1726023099,'model':'qwen-long','object':'chat.completion.chunk','service_tier':null,'system_fingerprint':null,'usage':null}
   {'id':'chatcmpl-565151e8-7b41-9a78-ae88-472edbad8c47','choices':[{'delta':{'content':'。','function_call':null,'role':null,'tool_calls':null},'finish_reason':null,'index':0,'logprobs':null}],'created':1726023099,'model':'qwen-long','object':'chat.completion.chunk','service_tier':null,'system_fingerprint':null,'usage':null}
   {'id':'chatcmpl-565151e8-7b41-9a78-ae88-472edbad8c47','choices':[{'delta':{'content':'','function_call':null,'role':null,'tool_calls':null},'finish_reason':'stop','index':0,'logprobs':null}],'created':1726023099,'model':'qwen-long','object':'chat.completion.chunk','service_tier':null,'system_fingerprint':null,'usage':null}
   {'id':'chatcmpl-565151e8-7b41-9a78-ae88-472edbad8c47','choices':[],'created':1726023099,'model':'qwen-long','object':'chat.completion.chunk','service_tier':null,'system_fingerprint':null,'usage':{'completion_tokens':93,'prompt_tokens':5395,'total_tokens':5488}}
   {'這篇文章是關于百煉系列手機的產品介紹，詳細描述了六款不同型號的手機特點和賣點：.....每款手機都有其獨特的特點和目標用戶群體，旨在滿足不同消費者的需求。'}

   curl

   data: {"choices":[{"delta":{"content":"","role":"assistant"},"index":0,"logprobs":null,"finish_reason":null}],"object":"chat.completion.chunk","usage":null,"created":1728649489,"system_fingerprint":null,"model":"qwen-long","id":"chatcmpl-e2434284-140a-9e3a-8ca5-f81e65e98d01"}
   
   data: {"choices":[{"finish_reason":null,"delta":{"content":"這篇文章"},"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1728649489,"system_fingerprint":null,"model":"qwen-long","id":"chatcmpl-e2434284-140a-9e3a-8ca5-f81e65e98d01"}
   
   data: {"choices":[{"delta":{"content":"是"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1728649489,"system_fingerprint":null,"model":"qwen-long","id":"chatcmpl-e2434284-140a-9e3a-8ca5-f81e65e98d01"}
   
   data: {"choices":[{"delta":{"content":"關于"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1728649489,"system_fingerprint":null,"model":"qwen-long","id":"chatcmpl-e2434284-140a-9e3a-8ca5-f81e65e98d01"}
   
   .....
   
   data: {"choices":[{"delta":{"content":"描述了每款"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1728649489,"system_fingerprint":null,"model":"qwen-long","id":"chatcmpl-e2434284-140a-9e3a-8ca5-f81e65e98d01"}
   
   data: {"choices":[{"delta":{"content":"手機的主要特點和"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1728649489,"system_fingerprint":null,"model":"qwen-long","id":"chatcmpl-e2434284-140a-9e3a-8ca5-f81e65e98d01"}
   
   data: {"choices":[{"delta":{"content":"規格，并提供了參考"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1728649489,"system_fingerprint":null,"model":"qwen-long","id":"chatcmpl-e2434284-140a-9e3a-8ca5-f81e65e98d01"}
   
   data: {"choices":[{"delta":{"content":"售價信息。"},"finish_reason":null,"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1728649489,"system_fingerprint":null,"model":"qwen-long","id":"chatcmpl-e2434284-140a-9e3a-8ca5-f81e65e98d01"}
   
   data: {"choices":[{"finish_reason":"stop","delta":{"content":""},"index":0,"logprobs":null}],"object":"chat.completion.chunk","usage":null,"created":1728649489,"system_fingerprint":null,"model":"qwen-long","id":"chatcmpl-e2434284-140a-9e3a-8ca5-f81e65e98d01"}
   
   data: {"choices":[],"object":"chat.completion.chunk","usage":{"prompt_tokens":5395,"completion_tokens":71,"total_tokens":5466},"created":1728649489,"system_fingerprint":null,"model":"qwen-long","id":"chatcmpl-e2434284-140a-9e3a-8ca5-f81e65e98d01"}
   
   data: [DONE]