Listar elementos de entrada - Alibaba Cloud Model Studio - Centro de documentación de Alibaba Cloud

Devuelve los elementos de entrada utilizados para generar la respuesta especificada. Para conversaciones de múltiples turnos encadenadas por previous_response_id, la lista devuelta también incluye entradas del usuario y respuestas del asistente de turnos anteriores. Un ID de respuesta solo se puede consultar cuando la solicitud de creación se envió con store=true.

Reemplace {WorkspaceId} con su ID de espacio de trabajo real.

China (Beijing)

SDK base_url: https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1

URL de solicitud HTTP: GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/responses/{response_id}/input_items

Parámetros de ruta

response_id string (Obligatorio)

El ID de respuesta para el cual consultar elementos de entrada, en el formato resp_xxx. Un ID de respuesta solo se puede consultar cuando la solicitud de creación se envió con store=true.

Parámetros de consulta

after string (Opcional)

Un cursor para la paginación. Devuelve elementos que vienen después del ID de elemento especificado (en el formato msg_xxx); la dirección sigue a order. Fuentes del ID de elemento: output[].id de la API Create a response, o data[].id, first_id o last_id de esta API. Para paginar, pase el last_id de la respuesta anterior como after en la siguiente solicitud.

limit integer (Opcional)

El número máximo de elementos a devolver. Rango de valores: [1, 100]. Valor predeterminado: 20.

order string (Opcional)

Orden de clasificación. Valores admitidos: asc (ascendente) y desc (descendente). Valor predeterminado: desc.

Solicitud predeterminada

Python

import os
from openai import OpenAI

client = OpenAI(
    # If you have not configured the environment variable, replace the line below with your Model Studio API key: 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)

Node.js

import OpenAI from "openai";

const openai = new OpenAI({
    // If you have not configured the environment variable, replace the line below with your Model Studio API key: apiKey: "sk-xxx"
    apiKey: process.env.DASHSCOPE_API_KEY,
    baseURL: "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1"
});

async function main() {
    const response = await openai.responses.inputItems.list("resp_xxx");
    console.log(response.data);
}

main();

curl

curl https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/responses/resp_xxx/input_items \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Solicitud filtrada

Python

import os
from openai import OpenAI

client = OpenAI(
    # If you have not configured the environment variable, replace the line below with your Model Studio API key: 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",
    # after takes an item ID (msg_xxx): from output[].id of Create a response, or data[].id / first_id / last_id of this API.
    after="msg_xxx",
    limit=10,
    order="asc",
)
print(response.data)

Node.js

import OpenAI from "openai";

const openai = new OpenAI({
    // If you have not configured the environment variable, replace the line below with your Model Studio API key: apiKey: "sk-xxx"
    apiKey: process.env.DASHSCOPE_API_KEY,
    baseURL: "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1"
});

async function main() {
    const response = await openai.responses.inputItems.list("resp_xxx", {
        // after takes an item ID (msg_xxx): from output[].id of Create a response, or data[].id / first_id / last_id of this API.
        after: "msg_xxx",
        limit: 10,
        order: "asc",
    });
    console.log(response.data);
}

main();

curl

# after takes an item ID (msg_xxx): from output[].id of Create a response, or data[].id / first_id / last_id of this API.
curl "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/responses/resp_xxx/input_items?after=msg_xxx&limit=10&order=asc" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Devuelve

data array

La lista de elementos de entrada. Cada elemento es un objeto de mensaje con los campos id, role, content, type y status. role es ya sea user o assistant. El type de cada elemento en content es ya sea input_text (entrada del usuario) o output_text (respuesta del asistente). Para conversaciones de múltiples turnos encadenadas por previous_response_id, la lista contiene mensajes del usuario y respuestas del asistente de turnos anteriores en orden cronológico.

first_id string

El ID del primer elemento en la lista.

last_id string

El ID del último elemento en la lista.

has_more boolean

Indica si hay más elementos disponibles. Cuando es true, pase el last_id devuelto como el parámetro after en la siguiente solicitud para obtener más elementos.

id string

El ID de respuesta al que pertenecen estos elementos de entrada.

model string

El nombre del modelo utilizado para generar esta respuesta.

created_at integer

La marca de tiempo Unix cuando se creó la respuesta, en milisegundos. Nota: esto difiere del campo created_at devuelto por las APIs Create a response y Retrieve a response, que está en segundos.

previous_response_id string

Se devuelve solo para conversaciones de múltiples turnos encadenadas por previous_response_id. El valor es el ID de respuesta del turno anterior.

{
    "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"
}

Respuesta de error

Si el ID de respuesta especificado no existe, la API devuelve el siguiente error:

{
    "request_id": "xxx",
    "code": "InvalidParameter",
    "message": "Response with id 'resp_xxx' not found."
}