Flow Agent API

Responses API 参考

通过 OpenAI 兼容模式的 Responses API 调用阿里云百炼应用

Responses API 提供与 OpenAI 兼容的接口模式，用于调用阿里云百炼应用（智能体应用、工作流应用）。您可以复用现有的 OpenAI 代码库，或快速集成来自 OpenAI 生态的各类工具。

调用方式

Responses API 提供两种调用模式：

模式	适用场景	说明
同步调用	实时交互，需要即时获取结果	请求后等待完整响应返回
异步调用	耗时较长的任务（如生成报告、多步骤工具调用）	提交后返回任务 ID，后续查询结果

接入地址

SDK base_url: https://dashscope.aliyuncs.com/api/v2/apps/agent/{APP_ID}/compatible-mode/v1/
HTTP Endpoint: POST https://dashscope.aliyuncs.com/api/v2/apps/agent/{APP_ID}/compatible-mode/v1/responses

请将 {APP_ID} 替换为实际的应用 ID。

前提条件

已获取 API Key 并配置到环境变量
已创建阿里云百炼应用并获取应用 ID
如果通过 SDK 调用，还需要安装 OpenAI Python SDK

快速上手

from openai import OpenAI
import os

api_key = os.getenv("DASHSCOPE_API_KEY")
app_id = 'APP_ID'  # 替换为实际的应用 ID
base_url = f'https://dashscope.aliyuncs.com/api/v2/apps/agent/{app_id}/compatible-mode/v1/'

client = OpenAI(
    api_key=api_key,
    base_url=base_url
)

response = client.responses.create(
    input="你是谁？",
)

print(response.model_dump_json(indent=2))

本页目录

调用方式
接入地址
前提条件
快速上手