应用调用API参考

Python

请求示例

import os
from http import HTTPStatus
from dashscope import Application

response = Application.call(
    # 若没有配置环境变量，可用百炼API Key将下行替换为：api_key="sk-xxx"。但不建议在生产环境中直接将API Key硬编码到代码中，以减少API Key泄露风险。
    api_key=os.getenv("DASHSCOPE_API_KEY"), 
    app_id='YOUR_APP_ID', 
    prompt='你是谁？')

if response.status_code != HTTPStatus.OK:
    print(f'request_id={response.request_id}\ncode={response.status_code}\nmessage={response.message}\n')
else:
    print(f'request_id={response.request_id}\noutput={response.output}\nusage={response.usage}\n')

响应示例

request_id=e3bba3a5-5784-9592-aa18-03170770de1e
output={"text": "我是来自阿里云的超大规模语言模型，我叫通义千问。
我可以回答各种问题、提供信息、与您进行对话和交流。有什么可以帮助您的吗？", 
"finish_reason": "stop", "session_id": "a0606349b3c34c6fad7cf1d6454e0072", 
"thoughts": null, "doc_references": null}
usage={"models": [{"model_id": "qwen-max", "input_tokens": 121, "output_tokens": 37}]}

Java

package org.example;
// 建议dashscope SDK的版本 >= 2.12.0
import com.alibaba.dashscope.app.*;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;


public class Test {
    public static void appCall()
            throws ApiException, NoApiKeyException, InputRequiredException {
        ApplicationParam param = ApplicationParam.builder()
                // 若没有配置环境变量，可用百炼API Key将下行替换为：api_key="sk-xxx"。但不建议在生产环境中直接将API Key硬编码到代码中，以减少API Key泄露风险。
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                .appId("YOUR_APP_ID")
                .prompt("你是谁？")
                .build();

        Application application = new Application();
        ApplicationResult result = application.call(param);

        System.out.printf("requestId: %s, text: %s, finishReason: %s\n",
                result.getRequestId(), result.getOutput().getText(), result.getOutput().getFinishReason());

        if (result.getUsage() != null && result.getUsage().getModels() != null) {
            for (ApplicationUsage.ModelUsage usage : result.getUsage().getModels()) {
                System.out.printf("modelId: %s, inputTokens: %d, outputTokens: %d\n",
                        usage.getModelId(), usage.getInputTokens(), usage.getOutputTokens());
            }
        }
    }

    public static void main(String[] args) {
        try {
            appCall();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            throw new RuntimeException(e);
        }
        System.exit(0);
    }
}

requestId: 1458c2c0-05aa-9df3-9f99-e36d6a11cfbe, 
text: 我是来自阿里云的语言模型，名叫通义千问。我被设计用来帮助用户获得信息、解答问题和进行对话。有什么我可以帮助你的吗？, 
finishReason: stop
modelId: qwen-max, inputTokens: 121, outputTokens: 34

curl

请求示例

curl -X POST https://dashscope.aliyuncs.com/api/v1/apps/YOUR_APP_ID/completion \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "input": {
        "prompt": "你是谁？"
    },
    "parameters":  {},
    "debug": {}
}' 

响应示例

{"output":{"finish_reason":"stop",
"session_id":"232ea2e9e6ef448db6b14465c06a9a56",
"text":"我是来自阿里云的超大规模语言模型，我叫通义千问。
我是一个能够回答问题、创作文字，还能表达观点、撰写代码的AI助手。
如果您有任何问题或需要帮助，请随时告诉我，我会尽力为您提供帮助。"},
"usage":{"models":[{"output_tokens":51,"model_id":"qwen-max","input_tokens":121}]},
"request_id":"661c9cad-e59c-9f78-a262-78eff243f151"}% 

Python

请求示例

import os
from http import HTTPStatus
from dashscope import Application

def call_with_session():
    response = Application.call(
                                # 若没有配置环境变量，可用百炼API Key将下行替换为：api_key="sk-xxx"。但不建议在生产环境中直接将API Key硬编码到代码中，以减少API Key泄露风险。
                                api_key=os.getenv("DASHSCOPE_API_KEY"), 
                                app_id='YOUR_APP_ID',
                                prompt='我想去新疆')

    if response.status_code != HTTPStatus.OK:
        print('request_id=%s, code=%s, message=%s\n' % (response.request_id, response.status_code, response.message))
        return response

    response1 = Application.call(
                                # 若没有配置环境变量，可用百炼API Key将下行替换为：api_key="sk-xxx"。但不建议在生产环境中直接将API Key硬编码到代码中，以减少API Key泄露风险。
                               api_key=os.getenv("DASHSCOPE_API_KEY"), 
                                app_id='YOUR_APP_ID',
                                prompt='那边有什么旅游景点或者美食?',
                                session_id=response.output.session_id)
    if response1.status_code != HTTPStatus.OK:
        print('request_id=%s, code=%s, message=%s\n' % (response1.request_id, response1.status_code, response1.message))
    else:
        print('request_id=%s\n output=%s\n usage=%s\n' % (response1.request_id, response1.output, response1.usage))


if __name__ == '__main__':
    call_with_session()

响应示例

request_id=a9d3f1b1-6745-981a-af82-9ec58522d78f
 output={"text": "新疆不仅旅游景点丰富多样，美食也同样令人向往。
 以下是一些不可错过的旅游景点和美食推荐：\n\n### 旅游景点\n\n
 1. **赛里木湖**：被誉为“大西洋最后一滴眼泪”，水质清澈，四周雪山环抱，是摄影和休闲的好去处。\n
 2. **禾木村**：位于布尔津县，是一个充满原始风貌的图瓦人村落，秋天时金黄的白桦林和炊烟袅袅的木屋构成了一幅幅美丽的画卷。\n
 3. **库车大峡谷**（天山神秘大峡谷）：红褐色的岩石经过亿万年的风蚀水侵形成了独特的地貌，行走其中仿佛进入另一个世界。\n
 4. **塔克拉玛干沙漠**：中国最大的沙漠，可以体验骑骆驼、沙漠探险，观赏壮观的日落与星空。\n
 5. **国际大巴扎**（乌鲁木齐）：购买手工艺品、品尝新疆特色小吃，体验浓郁的异域风情和商贸氛围。\n\n### 美食\n\n
 1. **羊肉串**：新疆的羊肉串以其肉质鲜美、调料独特而闻名，是夜市上不可或缺的美食。\n
 2. **大盘鸡**：鸡肉与土豆、青椒等食材炖煮而成，味道鲜美，分量十足，通常搭配宽面食用。\n
 3. **手抓饭**：以羊肉、胡萝卜、洋葱等食材和大米一起烹制，饭粒松软，香气四溢。\n
 4. **馕**：新疆的传统面食，外皮酥脆，内里柔软，是旅行中的理想干粮。\n
 5. **哈密瓜、葡萄**：新疆水果以甜美著称，特别是哈密瓜和各种葡萄品种，夏季时令最佳。\n
 6. **酸奶**：自制的新疆酸奶浓厚香醇，常配以蜂蜜或果仁食用，是解腻佳品。\n\n无论是自然风光还是地方美食，新疆都能为旅行者提供难忘的体验。
 希望这些建议能帮助您规划一次精彩的旅程！", 
 "finish_reason": "stop", 
 "session_id": "443f935a8d80496f94dcfa4a04b7edfa", 
 "thoughts": null, "doc_references": null}
 usage={"models": [{"model_id": "qwen-max", 
 "input_tokens": 688, 
 "output_tokens": 423}]}

Java

请求示例

package org.example;
import com.alibaba.dashscope.app.*;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import java.util.Arrays;
import java.util.List;
public class Test {
    public static void callWithSession()
            throws ApiException, NoApiKeyException, InputRequiredException {
        ApplicationParam param = ApplicationParam.builder()
                // 若没有配置环境变量，可用百炼API Key将下行替换为：api_key="sk-xxx"。但不建议在生产环境中直接将API Key硬编码到代码中，以减少API Key泄露风险。
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                .appId("YOUR_APP_ID")
                .prompt("我想去新疆")
                .build();

        Application application = new Application();
        ApplicationResult result = application.call(param);

        param.setSessionId(result.getOutput().getSessionId());
        param.setPrompt("那边有什么旅游景点或者美食?");
        result = application.call(param);

        System.out.printf("requestId: %s, text: %s, finishReason: %s\n",
                result.getRequestId(), result.getOutput().getText(), result.getOutput().getFinishReason());
    }

    public static void main(String[] args) {
        try {
            callWithSession();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.out.printf("Exception: %s", e.getMessage());
        }
        System.exit(0);
    }
}

响应示例

requestId: 440a0772-3c67-922e-8acb-d90840b96217, text: 新疆作为一个旅游资源极为丰富的地区，不仅自然景观壮美，人文景观也极具特色。以下是一些著名的旅游景点及当地不可错过的美食推荐：

### 旅游景点

1. **喀纳斯湖**：被誉为“人间仙境”，以其变幻莫测的湖水颜色、周边的原始森林和神秘的水怪传说而著名。
2. **那拉提草原**：位于伊犁河谷，夏季绿草如茵，野花遍地，是体验哈萨克族游牧文化的绝佳地点。
3. **火焰山**：位于吐鲁番盆地，因《西游记》中的故事而闻名，独特的红色山体在阳光下如同火焰般耀眼。
4. **天山天池**：高山湖泊，四周被雪山环抱，水质清澈，风景如画。
5. **喀什老城**：拥有千年历史的古城，漫步在这里，可以感受到浓郁的维吾尔族风情和历史文化。
6. **塔克拉玛干沙漠**：中国最大的沙漠，体验骑骆驼穿越沙丘，观赏沙漠日落的壮丽景象。
7. **禾木村**：被誉为中国最美的乡村之一，秋季时分，村庄被金黄色的白桦林环绕，美不胜收。

### 美食推荐

1. **羊肉串**：新疆的标志性美食，选用优质羊肉，炭火烤制，香气四溢。
2. **手抓饭**：用羊肉、胡萝卜、洋葱等食材与大米一起烹制，味道鲜美，营养丰富。
3. **大盘鸡**：鸡肉与土豆、辣椒一同炖煮，再配上宽面，色香味俱全。
4. **馕**：新疆的主食之一，外皮酥脆，内里绵软，便于携带，是长途旅行的理想食物。
5. **拉条子**：类似面条，但更粗更有嚼劲，常搭配各种肉类和蔬菜。
6. **烤全羊**：节日和庆典上的重头菜，外皮金黄酥脆，肉质鲜嫩多汁。
7. **酸奶疙瘩**：一种特色奶制品，口感酸甜，营养丰富，是解腻佳品。
8. **哈密瓜、葡萄**：新疆的水果享誉全国，尤其以哈密瓜和葡萄最为出名，香甜可口。

无论是自然风光的探索还是美食的享受，新疆都能给你带来难忘的体验。旅行时不妨尝试融入当地生活，体验更多地道的新疆文化。, finishReason: stop

curl

请求示例（上一轮会话）

curl -X POST https://dashscope.aliyuncs.com/api/v1/apps/YOUR_APP_ID/completion \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "input": {
        "prompt": "我想去新疆"},
    "parameters":  {},
    "debug": {}
}' 

响应示例（上一轮会话）

{"output":{"finish_reason":"stop",
"session_id":"d380aeb21d4b4b018f1d7ae9f98de404",
"text":"新疆，全称新疆维吾尔自治区，是中国的一个自治区，位于中国西北部，是中国面积最大的省级行政区。新疆地域辽阔，自然风光壮丽，拥有丰富的文化和民族多样性，著名的景点包括天山、喀纳斯湖、吐鲁番的火焰山、库车大峡谷、伊犁草原以及丝绸之路沿线的历史遗迹等。\n\n如果你计划去新疆旅行，有几点建议：\n\n1. **时间选择**：新疆四季分明，夏季（6月至8月）是旅游旺季，天气适宜，但也是游客最多的时候。春秋两季（4月至5月，9月至10月）景色独特，人少景美，也是不错的选择。冬季寒冷且长，适合滑雪和观赏雪景。\n\n2. **行程规划**：新疆地域广阔，城市之间距离遥远，建议提前规划好行程，考虑租车或参加当地的旅游团。北疆以自然风光为主，如喀纳斯、禾木；南疆则更多展现人文风情，如喀什古城、和田。\n\n3. **安全须知**：新疆部分地区由于特殊的地理和社会环境，可能会有一些安全检查和限制措施，请务必遵守当地规定，携带身份证件，并关注最新的旅行安全提示。\n\n4. **适应时差**：新疆使用乌鲁木齐时间（UTC+6），与北京时间（UTC+8）有2小时时差，注意调整作息。\n\n5. **饮食体验**：新疆美食丰富，如羊肉串、手抓饭、拉条子、馕、哈密瓜等，别具风味，值得尝试。\n\n6. **尊重当地文化**：新疆是一个多民族聚居的地区，旅行中应尊重各民族的风俗习惯和宗教信仰，尤其是参观清真寺等地时，注意着装得体。\n\n记得提前办理好相关旅行证件，查询最新的旅行政策，希望你在新疆有一个难忘的旅程！"},
"usage":{"models":[{"output_tokens":389,"model_id":"qwen-max","input_tokens":51}]},
"request_id":"a1e8cbb2-51dc-9733-a97c-e7ca5a7f0438"}%   

请求示例（下一轮会话）

curl -X POST https://dashscope.aliyuncs.com/api/v1/apps/YOUR_APP_ID/completion \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "input": {
        "prompt": "那边有什么美食？",
        "session_id":"d380aeb21d4b4b018f1d7ae9f98de404"
    },
    "parameters":  {},
    "debug": {}
}' 

响应示例（上一轮会话）

{"output":{"finish_reason":"stop",
"session_id":"d380aeb21d4b4b018f1d7ae9f98de404",
"text":"新疆是一个美食天堂，因其独特的地理位置和多元的文化交融，孕育出了许多令人垂涎的特色美食。以下是一些你到了新疆不可错过的地道美食：\n\n1. **羊肉串**：新疆羊肉串以其大块的肉、香辣的调味和独特的烤制方法而闻名，是夜市和街头最常见的小吃之一。\n\n2. **大盘鸡**：一道结合了鸡肉、土豆、青椒、宽面等食材的菜肴，味道鲜美，分量十足，是新疆餐饮中的明星菜品。\n\n3. **手抓饭**：主要由米饭、羊肉、胡萝卜、洋葱等烹饪而成，饭粒松软，肉香四溢，色彩诱人。\n\n4. **拉条子**：又称拌面，是新疆特色的面食，面条筋道，通常搭配各种蔬菜和牛肉或羊肉的炒菜一起食用。\n\n5. **馕**：新疆的主食之一，是一种烤制的面饼，外皮酥脆，内里绵软，便于携带和储存，是旅行时的理想食物。\n\n6. **哈密瓜和葡萄**：新疆因其干燥的气候和充足的日照，盛产甜美的水果，其中哈密瓜和葡萄尤为著名，甜度高，口感绝佳。\n\n7. **酸奶**：新疆的手工酸奶浓郁而不腻，通常会加入蜂蜜或糖来调节口味，非常受欢迎。\n\n8. **烤包子**：外表金黄酥脆，内馅多为羊肉和洋葱，是早餐或快餐的好选择。\n\n9. **喀什噶尔冰激凌**：用传统方式制作的冰激凌，口感醇厚，奶香浓郁，有的还会加入坚果或果仁。\n\n10. **纳仁**：一种羊肉炖煮后，与手工面片混合的菜肴，是哈萨克族的传统美食。\n\n这些美食只是新疆众多美味中的冰山一角，到访新疆，你将有机会体验更多地道而丰富的味觉享受。"},
"usage":{"models":[{"output_tokens":411,"model_id":"qwen-max","input_tokens":454}]},
"request_id":"366d21f5-1a4a-9fe5-8ba2-e7955ff8cd23"}% 

Python

请求示例

import os
from http import HTTPStatus
from dashscope import Application

responses = Application.call(
                            # 若没有配置环境变量，可用百炼API Key将下行替换为：api_key="sk-xxx"。但不建议在生产环境中直接将API Key硬编码到代码中，以减少API Key泄露风险。
                            api_key=os.getenv("DASHSCOPE_API_KEY"), 
                            app_id='YOUR_APP_ID',
                            prompt='你是谁？',
                            stream=True,
                            incremental_output=True)

for response in responses:
    if response.status_code != HTTPStatus.OK:
        print(f'request_id={response.request_id}\ncode={response.status_code}\nmessage={response.message}\n')
    else:
        print(f'request_id={response.request_id}\noutput={response.output}\nusage={response.usage}\n')

响应示例

request_id=b63c8c47-f4bd-9fa0-9cfc-f06da91588fe
 output={"text": "我是", "finish_reason": "null", "session_id": "42ece8924aa842a3b55405b6ddf97429", "thoughts": null, "doc_references": null}
 usage={"models": [{"model_id": "qwen-max", "input_tokens": 142, "output_tokens": 1}]}

request_id=b63c8c47-f4bd-9fa0-9cfc-f06da91588fe
 output={"text": "来自", "finish_reason": "null", "session_id": "42ece8924aa842a3b55405b6ddf97429", "thoughts": null, "doc_references": null}
 usage={"models": [{"model_id": "qwen-max", "input_tokens": 142, "output_tokens": 2}]}

request_id=b63c8c47-f4bd-9fa0-9cfc-f06da91588fe
 output={"text": "阿里", "finish_reason": "null", "session_id": "42ece8924aa842a3b55405b6ddf97429", "thoughts": null, "doc_references": null}
 usage={"models": [{"model_id": "qwen-max", "input_tokens": 142, "output_tokens": 3}]}

request_id=b63c8c47-f4bd-9fa0-9cfc-f06da91588fe
 output={"text": "云的语言模型助手，", "finish_reason": "null", "session_id": "42ece8924aa842a3b55405b6ddf97429", "thoughts": null, "doc_references": null}
 usage={"models": [{"model_id": "qwen-max", "input_tokens": 142, "output_tokens": 8}]}

request_id=b63c8c47-f4bd-9fa0-9cfc-f06da91588fe
 output={"text": "我叫通义千问。我可以", "finish_reason": "null", "session_id": "42ece8924aa842a3b55405b6ddf97429", "thoughts": null, "doc_references": null}
 usage={"models": [{"model_id": "qwen-max", "input_tokens": 142, "output_tokens": 16}]}

request_id=b63c8c47-f4bd-9fa0-9cfc-f06da91588fe
 output={"text": "回答各种问题、提供信息、进行", "finish_reason": "null", "session_id": "42ece8924aa842a3b55405b6ddf97429", "thoughts": null, "doc_references": null}
 usage={"models": [{"model_id": "qwen-max", "input_tokens": 142, "output_tokens": 24}]}

request_id=b63c8c47-f4bd-9fa0-9cfc-f06da91588fe
 output={"text": "对话等任务，很高兴为您服务！", "finish_reason": "null", "session_id": "42ece8924aa842a3b55405b6ddf97429", "thoughts": null, "doc_references": null}
 usage={"models": [{"model_id": "qwen-max", "input_tokens": 142, "output_tokens": 32}]}

request_id=b63c8c47-f4bd-9fa0-9cfc-f06da91588fe
 output={"text": "有什么可以帮助您的吗？", "finish_reason": "null", "session_id": "42ece8924aa842a3b55405b6ddf97429", "thoughts": null, "doc_references": null}
 usage={"models": [{"model_id": "qwen-max", "input_tokens": 142, "output_tokens": 37}]}

request_id=b63c8c47-f4bd-9fa0-9cfc-f06da91588fe
 output={"text": "", "finish_reason": "stop", "session_id": "42ece8924aa842a3b55405b6ddf97429", "thoughts": null, "doc_references": null}
 usage={"models": [{"model_id": "qwen-max", "input_tokens": 142, "output_tokens": 37}]}

Java

请求示例

package org.example;
import com.alibaba.dashscope.app.*;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import io.reactivex.Flowable;

public class Test {
    public static void streamCall() throws NoApiKeyException, InputRequiredException {
        ApplicationParam param = ApplicationParam.builder()
                // 若没有配置环境变量，可用百炼API Key将下行替换为：api_key="sk-xxx"。但不建议在生产环境中直接将API Key硬编码到代码中，以减少API Key泄露风险。
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                .appId("YOUR_APP_ID")
                .prompt("你是谁?")
                .incrementalOutput(true)
                .build();

        Application application = new Application();
        Flowable<ApplicationResult> result = application.streamCall(param);
        result.blockingForEach(data -> {
            System.out.printf("requestId: %s, text: %s, finishReason: %s\n",
                    data.getRequestId(), data.getOutput().getText(), data.getOutput().getFinishReason());

        });
    }

    public static void main(String[] args) {
        try {
            streamCall();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.out.printf("Exception: %s", e.getMessage());
        }
        System.exit(0);
    }
}

响应示例

requestId: a36ae034-bc33-91d0-a50f-3f4051211303, text: 我是, finishReason: null
requestId: a36ae034-bc33-91d0-a50f-3f4051211303, text: 来自, finishReason: null
requestId: a36ae034-bc33-91d0-a50f-3f4051211303, text: 阿里, finishReason: null
requestId: a36ae034-bc33-91d0-a50f-3f4051211303, text: 云的超大规模语言, finishReason: null
requestId: a36ae034-bc33-91d0-a50f-3f4051211303, text: 模型，我叫通义千问, finishReason: null
requestId: a36ae034-bc33-91d0-a50f-3f4051211303, text: 。我可以生成各种类型的文本，如, finishReason: null
requestId: a36ae034-bc33-91d0-a50f-3f4051211303, text: 文章、故事、诗歌、故事等, finishReason: null
requestId: a36ae034-bc33-91d0-a50f-3f4051211303, text: ，并能够根据不同的场景和需求进行, finishReason: null
requestId: a36ae034-bc33-91d0-a50f-3f4051211303, text: 变换和扩展。此外，我还能够, finishReason: null
requestId: a36ae034-bc33-91d0-a50f-3f4051211303, text: 回答各种问题，提供帮助和解决方案, finishReason: null
requestId: a36ae034-bc33-91d0-a50f-3f4051211303, text: 。如果您有任何问题或需要帮助，请, finishReason: null
requestId: a36ae034-bc33-91d0-a50f-3f4051211303, text: 随时告诉我！, finishReason: null
requestId: a36ae034-bc33-91d0-a50f-3f4051211303, text: , finishReason: stop

curl

请求示例

curl -X POST https://dashscope.aliyuncs.com/api/v1/apps/YOUR_APP_ID/completion \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--header 'X-DashScope-SSE: enable' \
--data '{
    "input": {
        "prompt": "你是谁？"

    },
    "parameters":  {
        "incremental_output":true
    },
    "debug": {}
}'

响应示例

id:1
event:result
:HTTP_STATUS/200
data:{"output":{"session_id":"70ac158ae65f4764b9228a52951f3711","finish_reason":"null","text":"我是"},"usage":{"models":[{"input_tokens":203,"output_tokens":1,"model_id":"qwen-max"}]},"request_id":"f66273ce-1a4d-9107-9c8a-da2a0f7267b5"}

id:2
event:result
:HTTP_STATUS/200
data:{"output":{"session_id":"70ac158ae65f4764b9228a52951f3711","finish_reason":"null","text":"来自"},"usage":{"models":[{"input_tokens":203,"output_tokens":2,"model_id":"qwen-max"}]},"request_id":"f66273ce-1a4d-9107-9c8a-da2a0f7267b5"}

id:3
event:result
:HTTP_STATUS/200
data:{"output":{"session_id":"70ac158ae65f4764b9228a52951f3711","finish_reason":"null","text":"阿里"},"usage":{"models":[{"input_tokens":203,"output_tokens":3,"model_id":"qwen-max"}]},"request_id":"f66273ce-1a4d-9107-9c8a-da2a0f7267b5"}

id:4
event:result
:HTTP_STATUS/200
data:{"output":{"session_id":"70ac158ae65f4764b9228a52951f3711","finish_reason":"null","text":"云"},"usage":{"models":[{"input_tokens":203,"output_tokens":4,"model_id":"qwen-max"}]},"request_id":"f66273ce-1a4d-9107-9c8a-da2a0f7267b5"}

id:5
event:result
:HTTP_STATUS/200
data:{"output":{"session_id":"70ac158ae65f4764b9228a52951f3711","finish_reason":"null","text":"的超大规模语言"},"usage":{"models":[{"input_tokens":203,"output_tokens":8,"model_id":"qwen-max"}]},"request_id":"f66273ce-1a4d-9107-9c8a-da2a0f7267b5"}

id:6
event:result
:HTTP_STATUS/200
data:{"output":{"session_id":"70ac158ae65f4764b9228a52951f3711","finish_reason":"null","text":"模型，我叫"},"usage":{"models":[{"input_tokens":203,"output_tokens":12,"model_id":"qwen-max"}]},"request_id":"f66273ce-1a4d-9107-9c8a-da2a0f7267b5"}

id:7
event:result
:HTTP_STATUS/200
data:{"output":{"session_id":"70ac158ae65f4764b9228a52951f3711","finish_reason":"null","text":"通义千问"},"usage":{"models":[{"input_tokens":203,"output_tokens":16,"model_id":"qwen-max"}]},"request_id":"f66273ce-1a4d-9107-9c8a-da2a0f7267b5"}

id:8
event:result
:HTTP_STATUS/200
data:{"output":{"session_id":"70ac158ae65f4764b9228a52951f3711","finish_reason":"null","text":"。"},"usage":{"models":[{"input_tokens":203,"output_tokens":17,"model_id":"qwen-max"}]},"request_id":"f66273ce-1a4d-9107-9c8a-da2a0f7267b5"}

id:9
event:result
:HTTP_STATUS/200
data:{"output":{"session_id":"70ac158ae65f4764b9228a52951f3711","finish_reason":"stop","text":""},"usage":{"models":[{"input_tokens":203,"output_tokens":17,"model_id":"qwen-max"}]},"request_id":"f66273ce-1a4d-9107-9c8a-da2a0f7267b5"}

Python

import os
from http import HTTPStatus
from dashscope import Application

# 工作流和智能体编排应用自定义输入参数透传
biz_params = {"city": "杭州"}
response = Application.call(
    # 若没有配置环境变量，可用百炼API Key将下行替换为：api_key="sk-xxx"。但不建议在生产环境中直接将API Key硬编码到代码中，以减少API Key泄露风险。
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    app_id='YOUR_APP_ID',
    prompt='查询这个城市的行政区域划分',
    biz_params=biz_params  # 传递业务参数
)

if response.status_code != HTTPStatus.OK:
    print(f'request_id={response.request_id}, code={response.status_code}, message={response.message}')
else:
    print(f'output={response.output}, usage={response.usage}')

output={"text": "杭州，简称“杭”，是浙江省的省会城市，位于中国东南部沿海地区，浙江省北部，地处北纬29°11′～30°33′，东经118°21′～120°30′之间。
全市面积16853.57平方千米，辖上城、拱墅、西湖、滨江、萧山、余杭、临平、钱塘、富阳、临安10个区和桐庐、淳安2县，代管建德1个县级市，共有13个区县（市）。
市政府驻地在上城区。截至2022年末，杭州市常住人口为1237.6万人。\n\n
杭州是中国八大古都之一，自秦朝设县治以来已有2200多年历史，曾是吴越国和南宋的都城，因风景秀丽，有“人间天堂”的美誉。市内人文古迹众多，西湖及其周边有大量的自然及人文景观遗迹，具代表性的有西湖文化、良渚文化、丝绸文化、茶文化等。", 
"finish_reason": "stop", "session_id": "6a3bf88eacda43128f57d87e29323166", 
"thoughts": null, "doc_references": null}, usage={"models": null}

import os
from http import HTTPStatus
# 建议dashscope SDK 的版本 >= 1.14.0
from dashscope import Application

biz_params = {
    # 智能体应用的自定义插件输入参数透传，自定义的插件ID替换{your_plugin_code}
    "user_defined_params": {
        "{your_plugin_code}": {
            "article_index": 2}}}
response = Application.call(
                            # 若没有配置环境变量，可用百炼API Key将下行替换为：api_key="sk-xxx"。但不建议在生产环境中直接将API Key硬编码到代码中，以减少API Key泄露风险。
                            api_key=os.getenv("DASHSCOPE_API_KEY"), 
                            app_id='YOUR_APP_ID',
                            prompt='寝室公约内容',
                            biz_params=biz_params)

if response.status_code != HTTPStatus.OK:
    print('request_id=%s, code=%s, message=%s\n' % (response.request_id, response.status_code, response.message))
else:
    print('request_id=%s\n output=%s\n usage=%s\n' % (response.request_id, response.output, response.usage))

request_id=d97e3c58-7a75-9ea1-9ecf-d5be869b748e
 output={"text": "寝室公约的第二条内容为：寝室成员应当互帮互助、互相关心、互相学习、共同提高；宽容谦让、相互尊重、以诚相待。这提醒我们，在寝室生活中要维护良好的人际关系，共同营造一个和谐、积极的生活学习环境。如果您需要了解更多的公约内容，请告诉我具体的序号或继续提问。", "finish_reason": "stop", "session_id": "8ec3fa6c59794ed3ab803b921aa38d7a", "thoughts": null, "doc_references": null}
 usage={"models": [{"model_id": "qwen-max", "input_tokens": 453, "output_tokens": 107}]}

from http import HTTPStatus
import os
# 建议dashscope SDK 的版本 >= 1.14.0
from dashscope import Application

biz_params = {
    # 智能体应用的自定义插件鉴权透传，自定义的插件ID替换{your_plugin_code}，token替换YOUR_TOKEN
    "user_defined_params": {
        "{your_plugin_code}": {
            "article_index": 2}},
    "user_defined_tokens": {
        "{your_plugin_code}": {
            "user_token": "YOUR_TOKEN"}}}
response = Application.call(
                            # 若没有配置环境变量，可用百炼API Key将下行替换为：api_key="sk-xxx"。但不建议在生产环境中直接将API Key硬编码到代码中，以减少API Key泄露风险。
                            api_key=os.getenv("DASHSCOPE_API_KEY"), 
                            app_id='YOUR_APP_ID',
                            prompt='寝室公约内容',
                            biz_params=biz_params)

if response.status_code != HTTPStatus.OK:
    print('request_id=%s, code=%s, message=%s\n' % (response.request_id, response.status_code, response.message))
else:
    print('request_id=%s\n output=%s\n usage=%s\n' % (response.request_id, response.output, response.usage))

request_id=e928fe3b-3df3-9a3f-9ea4-884aed3aea3c
 output={"text": "寝室公约的第二条内容是：“寝室成员应当互帮互助、互相关心、互相学习、共同提高；宽容谦让、相互尊重、以诚相待。”这强调了寝室成员之间应该建立和谐、支持和尊重彼此的关系。", "finish_reason": "stop", "session_id": "c3b909e48a0b4867a57b482dece9cbb7", "thoughts": null, "doc_references": null}
 usage={"models": [{"model_id": "qwen-max", "input_tokens": 432, "output_tokens": 82}]}

Java

package org.example;
import com.alibaba.dashscope.app.*;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.JsonUtils;
import io.reactivex.Flowable;

public class Test {
    public static void streamCall() throws NoApiKeyException, InputRequiredException {

        String bizParams =
                "{\"city\":\"杭州\"}";
        ApplicationParam param = ApplicationParam.builder()
                // 若没有配置环境变量，可用百炼API Key将下行替换为：api_key="sk-xxx"。但不建议在生产环境中直接将API Key硬编码到代码中，以减少API Key泄露风险。
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                .appId("YOUR_APP_ID")
                .prompt("查询这个城市的行政区域划分")
                .bizParams(JsonUtils.parse(bizParams))
                .build();

        Application application = new Application();
        Flowable<ApplicationResult> result = application.streamCall(param);
        result.blockingForEach(data -> {
            System.out.printf("requestId: %s, text: %s, finishReason: %s\n",
                    data.getRequestId(), data.getOutput().getText(), data.getOutput().getFinishReason());

        });
    }

    public static void main(String[] args) {
        try {
            streamCall();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.out.printf("Exception: %s", e.getMessage());
        }
        System.exit(0);
    }
}

requestId: 713ebb6e-8840-9f31-bd58-e7e931ef345d, 
text: 杭州市下辖10个区、1个县，代管2个县级市，
即上城区、拱墅区、西湖区、滨江区、萧山区、余杭区、临平区、钱塘区、富阳区、临安区、桐庐县、淳安县、建德市、诸暨市。, 
finishReason: stop

package org.example;
import com.alibaba.dashscope.app.*;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.JsonUtils;
import io.reactivex.Flowable;

public class Test {
    public static void streamCall() throws NoApiKeyException, InputRequiredException {
        String bizParams =
                "{\"user_defined_params\":{\"{your_plugin_code}\":{\"article_index\":2}}}";
        ApplicationParam param = ApplicationParam.builder()
                // 若没有配置环境变量，可用百炼API Key将下行替换为：api_key="sk-xxx"。但不建议在生产环境中直接将API Key硬编码到代码中，以减少API Key泄露风险。
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                .appId("YOUR_APP_ID")
                .prompt("寝室公约内容")
                .bizParams(JsonUtils.parse(bizParams))
                .build();

        Application application = new Application();
        Flowable<ApplicationResult> result = application.streamCall(param);
        result.blockingForEach(data -> {
            System.out.printf("requestId: %s, text: %s, finishReason: %s\n",
                    data.getRequestId(), data.getOutput().getText(), data.getOutput().getFinishReason());

        });
    }

    public static void main(String[] args) {
        try {
            streamCall();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.out.printf("Exception: %s", e.getMessage());
        }
        System.exit(0);
    }
}

requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝, finishReason: null
requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝室公约的第二条, finishReason: null
requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝室公约的第二条内容是：寝室成员应当互帮, finishReason: null
requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝室公约的第二条内容是：寝室成员应当互帮互助、互相关心、互相学习, finishReason: null
requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝室公约的第二条内容是：寝室成员应当互帮互助、互相关心、互相学习、共同提高；宽容谦让、, finishReason: null
requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝室公约的第二条内容是：寝室成员应当互帮互助、互相关心、互相学习、共同提高；宽容谦让、相互尊重、以诚相待。, finishReason: null
requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝室公约的第二条内容是：寝室成员应当互帮互助、互相关心、互相学习、共同提高；宽容谦让、相互尊重、以诚相待。这强调了寝室生活中成员之间和谐, finishReason: null
requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝室公约的第二条内容是：寝室成员应当互帮互助、互相关心、互相学习、共同提高；宽容谦让、相互尊重、以诚相待。这强调了寝室生活中成员之间和谐相处与共同进步的重要性。如果您需要, finishReason: null
requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝室公约的第二条内容是：寝室成员应当互帮互助、互相关心、互相学习、共同提高；宽容谦让、相互尊重、以诚相待。这强调了寝室生活中成员之间和谐相处与共同进步的重要性。如果您需要了解其他条目，请告诉我序号, finishReason: null
requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝室公约的第二条内容是：寝室成员应当互帮互助、互相关心、互相学习、共同提高；宽容谦让、相互尊重、以诚相待。这强调了寝室生活中成员之间和谐相处与共同进步的重要性。如果您需要了解其他条目，请告诉我序号。, finishReason: null
requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝室公约的第二条内容是：寝室成员应当互帮互助、互相关心、互相学习、共同提高；宽容谦让、相互尊重、以诚相待。这强调了寝室生活中成员之间和谐相处与共同进步的重要性。如果您需要了解其他条目，请告诉我序号。, finishReason: stop

package org.example;
import com.alibaba.dashscope.app.*;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.JsonUtils;
import io.reactivex.Flowable;

public class Test {
    public static void streamCall() throws NoApiKeyException, InputRequiredException {
        String bizParams =
                "{\"user_defined_params\":{\"{your_plugin_code}\":{\"article_index\":2}}," +
                        "\"user_defined_tokens\":{\"{your_plugin_code}\":{\"user_token\":\"YOUR_TOKEN\"}}}";
        ApplicationParam param = ApplicationParam.builder()
                // 若没有配置环境变量，可用百炼API Key将下行替换为：api_key="sk-xxx"。但不建议在生产环境中直接将API Key硬编码到代码中，以减少API Key泄露风险。
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                .appId("YOUR_APP_ID")
                .prompt("寝室公约内容")
                .bizParams(JsonUtils.parse(bizParams))
                .build();

        Application application = new Application();
        Flowable<ApplicationResult> result = application.streamCall(param);
        result.blockingForEach(data -> {
            System.out.printf("requestId: %s, text: %s, finishReason: %s\n",
                    data.getRequestId(), data.getOutput().getText(), data.getOutput().getFinishReason());

        });
    }

    public static void main(String[] args) {
        try {
            streamCall();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.out.printf("Exception: %s", e.getMessage());
        }
        System.exit(0);
    }
}

requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝, finishReason: null
requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝室公约的第二条, finishReason: null
requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝室公约的第二条内容是：寝室成员应当互帮, finishReason: null
requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝室公约的第二条内容是：寝室成员应当互帮互助、互相关心、互相学习, finishReason: null
requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝室公约的第二条内容是：寝室成员应当互帮互助、互相关心、互相学习、共同提高；宽容谦让、, finishReason: null
requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝室公约的第二条内容是：寝室成员应当互帮互助、互相关心、互相学习、共同提高；宽容谦让、相互尊重、以诚相待。, finishReason: null
requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝室公约的第二条内容是：寝室成员应当互帮互助、互相关心、互相学习、共同提高；宽容谦让、相互尊重、以诚相待。这强调了寝室生活中成员之间和谐, finishReason: null
requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝室公约的第二条内容是：寝室成员应当互帮互助、互相关心、互相学习、共同提高；宽容谦让、相互尊重、以诚相待。这强调了寝室生活中成员之间和谐相处与共同进步的重要性。如果您需要, finishReason: null
requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝室公约的第二条内容是：寝室成员应当互帮互助、互相关心、互相学习、共同提高；宽容谦让、相互尊重、以诚相待。这强调了寝室生活中成员之间和谐相处与共同进步的重要性。如果您需要了解其他条目，请告诉我序号, finishReason: null
requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝室公约的第二条内容是：寝室成员应当互帮互助、互相关心、互相学习、共同提高；宽容谦让、相互尊重、以诚相待。这强调了寝室生活中成员之间和谐相处与共同进步的重要性。如果您需要了解其他条目，请告诉我序号。, finishReason: null
requestId: 48bb400a-d050-9f5c-afbd-c1adb25f6a43, text: 寝室公约的第二条内容是：寝室成员应当互帮互助、互相关心、互相学习、共同提高；宽容谦让、相互尊重、以诚相待。这强调了寝室生活中成员之间和谐相处与共同进步的重要性。如果您需要了解其他条目，请告诉我序号。, finishReason: stop

curl

curl -X POST https://dashscope.aliyuncs.com/api/v1/apps/YOUR_APP_ID/completion \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "input": {
        "prompt": "查询这个城市的行政区域划分",
        "biz_params": {
        "city": "杭州"}
    },
    "parameters":  {}
}'

{"output":{"finish_reason":"stop","session_id":"c211219896004b50a1f6f66f2ec5413e",
"text":"杭州市下辖10个区、1个县，代管2个县级市，分别为：
上城区、拱墅区、西湖区、滨江区、萧山区、余杭区、临平区、钱塘区、富阳区、临安区、桐庐县、淳安县、建德市、诸暨市。
注意，诸暨市由浙江省直辖、杭州市与绍兴市共同管理。"},"usage":{},
"request_id":"02c3c9e1-7912-9505-91aa-248d04fb1f5d"}

curl -X POST https://dashscope.aliyuncs.com/api/v1/apps/YOUR_APP_ID/completion \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "input": {
        "prompt": "寝室公约内容",
        "biz_params": 
        {
            "user_defined_params":
            {
                "{your_plugin_code}":
                    {
                    "article_index": 2
                    }
            }
        } 
    },
    "parameters":  {},
    "debug":{}
}'

{"output":
{"finish_reason":"stop",
"session_id":"e151267ffded4fbdb13d91439011d31e",
"text":"寝室公约的第二条内容是：“寝室成员应当互帮互助、互相关心、互相学习、共同提高；宽容谦让、相互尊重、以诚相待。”这意呀着在寝室生活中，大家要彼此支持，共同创造一个和谐、积极向上的生活环境。"},
"usage":{"models":[{"output_tokens":94,"model_id":"qwen-max","input_tokens":453}]},
"request_id":"a39fd2b5-7e2c-983e-84a1-1039f726f18a"}%

curl -X POST https://dashscope.aliyuncs.com/api/v1/apps/YOUR_APP_ID/completion \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "input": {
        "prompt": "寝室公约内容",
        "biz_params": 
        {
            "user_defined_params":
            {
                "{your_plugin_code}":
                    {
                    "article_index": 2
                    }
            },
            "user_defined_tokens":
            {
                "{your_plugin_code}":
                    {
                    "user_token": "YOUR_TOKEN"
                    }
            }
        } 
    },
    "parameters":  {},
    "debug":{}
}'

{"output":{"finish_reason":"stop",
"session_id":"d3b5c3e269dc40479255a7a02df5c630",
"text":"寝室公约的第二条内容为：“寝室成员应当互帮互助、互相关心、互相学习、共同提高；宽容谦让、相互尊重、以诚相待。”这强调了寝室生活中成员之间和谐相处与共同进步的重要性。"},
"usage":{"models":[{"output_tokens":80,"model_id":"qwen-max","input_tokens":432}]},
"request_id":"1f77154c-edc3-9003-b622-816fa2f849cf"}%

Python

from http import HTTPStatus
import os
from dashscope import Application

response = Application.call(
                           # 若没有配置环境变量，可用百炼API Key将下行替换为：api_key="sk-xxx"。但不建议在生产环境中直接将API Key硬编码到代码中，以减少API Key泄露风险。
                            api_key=os.getenv("DASHSCOPE_API_KEY"), 
                            app_id='YOUR_APP_ID',
                            prompt='用户饮食偏好：面食',
                            memory_id='YOUR_MEMORY_ID')

if response.status_code != HTTPStatus.OK:
    print('request_id=%s, code=%s, message=%s\n' % (response.request_id, response.status_code, response.message))
else:
    print('request_id=%s, text=%s, usage=%s\n' % (response.request_id, response.output.text, response.usage))

from http import HTTPStatus
import os
from dashscope import Application

response = Application.call(
                           # 若没有配置环境变量，可用百炼API Key将下行替换为：api_key="sk-xxx"。但不建议在生产环境中直接将API Key硬编码到代码中，以减少API Key泄露风险。
                            api_key=os.getenv("DASHSCOPE_API_KEY"), 
                            app_id='YOUR_APP_ID',
                            prompt='美食推荐',
                            memory_id='YOUR_MEMORY_ID')

if response.status_code != HTTPStatus.OK:
    print('request_id=%s, code=%s, message=%s\n' % (response.request_id, response.status_code, response.message))
else:
    print('request_id=%s, text=%s, usage=%s\n' % (response.request_id, response.output.text, response.usage))

request_id=f41a7831-5e60-982b-921d-7aa0465c5a38, text=既然您偏好面食，我为您推荐几款不容错过的面食佳肴：

1. **北京炸酱面**：传统的老北京风味，特色在于那香浓的炸酱，搭配黄瓜丝、豆芽等新鲜蔬菜，面条筋道，味道醇厚。

2. **四川担担面**：辣而不燥，麻中带香，特制的肉末酱汁拌上细薄的面条，每一口都是对味蕾的极致诱惑。

3. **山西刀削面**：以其独特的制作工艺著称，面条宽厚有嚼劲，搭配各种浇头如番茄鸡蛋、牛肉等，风味独特。

4. **陕西凉皮**：虽然严格意义上属于米制品，但其在面食爱好者中也极受欢迎，酸辣爽口，特别适合夏日食用。

5. **兰州拉面**：以“一清二白三红四绿五黄”为特点，汤清而味美，面条可粗可细，搭配牛肉片和香菜，清新不腻。

6. **意大利面**：如果您想尝试国际风味，经典的意式番茄肉酱面或是奶油蘑菇面也是不错的选择，口感丰富，酱料浓郁。

希望这些建议能让您的餐桌增添几分美味！如果您有更具体的口味需求，比如偏爱辣的、清淡的或是想要了解某个特定地区的面食，欢迎告诉我！, usage={"models": [{"model_id": "qwen-max", "input_tokens": 139, "output_tokens": 296}]}

Java

请求示例（创建记忆体内容）

package org.example;
import com.alibaba.dashscope.app.*;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;

public class Test {
    public static void callWithMemory() throws NoApiKeyException, InputRequiredException {
        ApplicationParam param = ApplicationParam.builder()
                // 若没有配置环境变量，可用百炼API Key将下行替换为：api_key="sk-xxx"。但不建议在生产环境中直接将API Key硬编码到代码中，以减少API Key泄露风险。
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                .appId("YOUR_APP_ID")
                .prompt("用户饮食偏好：面食")
                .memoryId("YOUR_MEMORY_ID")
                .build();

        Application application = new Application();
        ApplicationResult result = application.call(param);

        System.out.printf("requestId: %s, text: %s, finishReason: %s\n",
                result.getRequestId(), result.getOutput().getText(), result.getOutput().getFinishReason());
    }

    public static void main(String[] args) {
        try {
            callWithMemory();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.out.printf("Exception: %s", e.getMessage());
        }
        System.exit(0);
    }
}

请求示例

package org.example;
import com.alibaba.dashscope.app.*;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;

public class Test {
    public static void callWithMemory() throws NoApiKeyException, InputRequiredException {
        ApplicationParam param = ApplicationParam.builder()
                // 若没有配置环境变量，可用百炼API Key将下行替换为：api_key="sk-xxx"。但不建议在生产环境中直接将API Key硬编码到代码中，以减少API Key泄露风险。
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                .appId("YOUR_APP_ID")
                .prompt("美食推荐")
                .memoryId("YOUR_MEMORY_ID")
                .build();

        Application application = new Application();
        ApplicationResult result = application.call(param);

        System.out.printf("requestId: %s, text: %s, finishReason: %s\n",
                result.getRequestId(), result.getOutput().getText(), result.getOutput().getFinishReason());
    }

    public static void main(String[] args) {
        try {
            callWithMemory();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.out.printf("Exception: %s", e.getMessage());
        }
        System.exit(0);
    }
}

响应示例

requestId: 9c4b303c-5951-96b0-af5e-49159e5040f1, text: 既然您喜欢面食，我为您推荐几款不同风格的面食佳肴：

1. **北京炸酱面**：这是老北京的传统面食，特色在于那浓郁的黄豆酱炸酱，搭配黄瓜丝、豆芽等新鲜蔬菜，面条筋道，酱香四溢。

2. **四川担担面**：辣而不燥，麻中带香，细滑的面条拌上特制的芝麻酱和辣椒油，再撒上碎花生和葱花，味道层次丰富。

3. **陕西油泼面**：宽厚的手工扯面，热油一浇，蒜末和辣椒粉的香气立刻被激发出来，简单却极富风味。

4. **山西刀削面**：师傅手工用刀削出的面条，厚薄适中，搭配各种浇头如番茄鸡蛋、牛肉烩菜等，口感独特。

5. **意大利面**：如果您想尝试国际风味，经典的意式面食如意大利肉酱面或海鲜面，搭配浓郁的番茄酱或奶油白酱，也是不错的选择。

6. **日式拉面**：豚骨汤底浓郁，面条弹牙，加上叉烧肉、海苔、笋干等配料，一碗下肚，温暖又满足。

希望您能尝试一下，找到自己最爱的那一款！, finishReason: stop

curl

curl -X POST https://dashscope.aliyuncs.com/api/v1/apps/YOUR_APP_ID/completion \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "input": {
        "prompt": "用户饮食偏好：面食",
        "memory_id": "YOUR_MEMORY_ID"
    },
    "parameters":  {},
    "debug": {}
}'  

curl -X POST https://dashscope.aliyuncs.com/api/v1/apps/YOUR_APP_ID/completion \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "input": {
        "prompt": "美食推荐",
        "memory_id": "YOUR_MEMORY_ID"
    },
    "parameters":  {},
    "debug": {}
}'  

{"output":{"finish_reason":"stop",
"session_id":"12677d7f5e5d423ca30db6ff77a4710d",
"text":"考虑到您对面食的偏爱，我为您推荐几种不同风味的面食佳肴：\n\n
1. **北京炸酱面**：经典的北方面食，以黄豆酱和肉酱为主料，搭配黄瓜丝、豆皮等配菜，口感丰富，酱香浓郁。\n\n
2. **四川担担面**：辣味爱好者必试，特制的辣椒油与花生碎、芽菜混合，再加入炒制的猪肉末，麻辣鲜香，十分过瘾。\n\n
3. **山西刀削面**：以其独特的制作工艺著称，面条宽厚有嚼劲，搭配各种浇头如番茄鸡蛋、牛肉等，味道醇厚。\n\n
4. **陕西凉皮**：虽然严格意义上属于小吃，但作为面食的一种变异，其酸辣爽口，搭配面筋、黄瓜丝等，非常适合夏天食用。\n\n
5. **江南阳春面**：简单而精致，清汤搭配细面条，上面撒上葱花、少许猪油，口味清淡却不失鲜美。\n\n
6. **意大利面**：如果想尝试异国风味，可以选择经典的意式番茄肉酱面或是奶油蘑菇意面，体验不同的面条文化。\n\n
希望这些建议能满足您的味蕾，不妨根据自己的口味选择尝试一下！"},
"usage":{"models":[{"output_tokens":269,"model_id":"qwen-max","input_tokens":139}]},
"request_id":"f7792da2-02f6-999c-85f1-a76de85fb99f"}%

{"code":"InvalidApiKey","message":"Invalid API-key provided.","request_id":"2637fcf9-32b1-9f4e-b0e9-1724d4aea00e"}