Skip to main content

入力項目の一覧取得

指定したレスポンスの生成に使用した入力項目を返します。 previous_response_id で連携されたマルチターンカンバセーションの場合、リストには以前のターンのユーザー入力とアシスタントの応答も含まれます。 レスポンス ID を照会できるのは、作成リクエストを store=true で送信した場合のみです。

{WorkspaceId} を実際の ワークスペース ID に置き換えてください。
  • [ China (Beijing) ]
SDK base_url： https://{WorkspaceId}.us-west-1.maas.aliyuncs.com/compatible-mode/v1HTTP リクエスト URL： GET https://{WorkspaceId}.us-west-1.maas.aliyuncs.com/compatible-mode/v1/responses/{response_id}/input_items

パスパラメーター

response_id 文字列 (必須)照会するレスポンスの ID です。 フォーマットは resp_xxx です。 レスポンス ID を照会できるのは、作成リクエストを store=true で送信した場合のみです。

クエリパラメーター

after 文字列 (任意)ページネーション用のカーソルです。 指定した項目 ID (フォーマット： msg_xxx) 以降の項目を返します。 方向は order に従います。 項目 ID の取得元： Create a response API の output[].id、またはこの API の data[].id、first_id、last_id です。 ページネーションを行うには、前回のレスポンスの last_id を次のリクエストの after パラメーターに指定してください。limit 整数 (任意)返す項目の最大数です。 範囲： [1, 100]。 デフォルト： 20。order 文字列 (任意)ソート順です。 指定可能な値： asc (昇順)、desc (降順)。 デフォルト： desc。
  • デフォルトのリクエスト
  • フィルター付きリクエスト
Python
import os
from openai import OpenAI

client = OpenAI(
    # 環境変数を設定していない場合は、この行を Model Studio API キーに置き換えてください：api_key="sk-xxx"
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    base_url="https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
)

response = client.responses.input_items.list("resp_xxx")
print(response.data)

戻り値

data 配列入力項目のリストです。 各要素は、 id、role、content、type、status の各フィールドを含むメッセージオブジェクトです。 role は user または assistant です。 content の各要素の type は、 input_text (ユーザー入力) または output_text (アシスタントの応答) です。 previous_response_id で連携されたマルチターンカンバセーションの場合、このリストには以前のターンのユーザーメッセージとアシスタントの応答が時系列順で含まれます。first_id 文字列リストの最初の項目の ID です。last_id 文字列リストの最後の項目の ID です。has_more ブール値さらに項目が存在するかどうかを示します。 true の場合、返された last_id を次のリクエストの after パラメーターに指定し、追加の項目を取得してください。id 文字列これらの入力項目に対応するレスポンスの ID です。model 文字列このレスポンスの生成に使用したモデル名です。created_at 整数レスポンスが作成された UNIX タイムスタンプ (ミリ秒) です。 注：これは Create a response API と Retrieve a response API が返す created_at フィールド (秒) とは異なります。previous_response_id 文字列previous_response_id で連携されたマルチターンカンバセーションの場合にのみ返されます。 値は、直前のターンのレスポンス ID です。
{
    "created_at": 1778674066000,
    "data": [
        {
            "content": [
                {
                    "text": "Hello",
                    "type": "input_text"
                }
            ],
            "id": "msg_8dac4972-fdba-42b5-bed9-280441ced8ea",
            "role": "user",
            "status": "completed",
            "type": "message"
        }
    ],
    "first_id": "msg_8dac4972-fdba-42b5-bed9-280441ced8ea",
    "has_more": false,
    "id": "resp_4ca7fa5e-6ff5-9787-bc18-af6ca5eff36c",
    "last_id": "msg_8dac4972-fdba-42b5-bed9-280441ced8ea",
    "model": "qwen3.8-max"
}

エラーレスポンス

指定したレスポンス ID が存在しない場合、API は次のエラーを返します： 
{
    "request_id": "xxx",
    "code": "InvalidParameter",
    "message": "Response with id 'resp_xxx' not found."
}