Daftar item input - Alibaba Cloud Model Studio - Alibaba Cloud Documentation Center

Mengembalikan item input yang digunakan untuk menghasilkan Response tertentu. Untuk percakapan multi-putaran yang dirangkai dengan previous_response_id , daftar yang dikembalikan juga mencakup input pengguna dan balasan asisten dari putaran sebelumnya. ID Response hanya dapat diquery jika permintaan pembuatan dikirim dengan store=true .

Ganti {WorkspaceId} dengan workspace ID Anda yang sebenarnya.

China (Beijing)

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

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

Path parameters

response_id string (Required)

ID Response yang akan diquery untuk mendapatkan item input-nya, dalam format resp_xxx. ID Response hanya dapat diquery jika permintaan pembuatan dikirim dengan store=true.

Query parameters

after string (Optional)

Kursor untuk paginasi. Mengembalikan item yang muncul setelah ID item tertentu (dalam format msg_xxx); arahnya mengikuti order. Sumber ID item: output[].id dari API Create a response, atau data[].id, first_id, atau last_id dari API ini. Untuk melakukan paginasi, gunakan last_id dari respons sebelumnya sebagai nilai parameter after pada permintaan berikutnya.

limit integer (Optional)

Jumlah maksimum item yang dikembalikan. Rentang nilai: [1, 100]. Default: 20.

order string (Optional)

Urutan pengurutan. Nilai yang didukung: asc (ascending) dan desc (descending). Default: desc.

Default request

Python

import os
from openai import OpenAI

client = OpenAI(
    # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris di bawah ini dengan kunci API Model Studio Anda: 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({
    // Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris di bawah ini dengan kunci API Model Studio Anda: 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"

Filtered request

Python

import os
from openai import OpenAI

client = OpenAI(
    # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris di bawah ini dengan kunci API Model Studio Anda: 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 menerima ID item (msg_xxx): dari output[].id pada Create a response, atau data[].id / first_id / last_id dari API ini.
    after="msg_xxx",
    limit=10,
    order="asc",
)
print(response.data)

Node.js

import OpenAI from "openai";

const openai = new OpenAI({
    // Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris di bawah ini dengan kunci API Model Studio Anda: 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 menerima ID item (msg_xxx): dari output[].id pada Create a response, atau data[].id / first_id / last_id dari API ini.
        after: "msg_xxx",
        limit: 10,
        order: "asc",
    });
    console.log(response.data);
}

main();

curl

# after menerima ID item (msg_xxx): dari output[].id pada Create a response, atau data[].id / first_id / last_id dari API ini.
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"

Returns

data array

Daftar item input. Setiap elemen adalah objek message dengan bidang id, role, content, type, dan status. Nilai role adalah user atau assistant. type dari setiap elemen dalam content adalah input_text (input pengguna) atau output_text (balasan asisten). Untuk percakapan multi-putaran yang dirangkai dengan previous_response_id, daftar ini berisi pesan pengguna dan balasan asisten dari putaran sebelumnya dalam urutan kronologis.

first_id string

ID item pertama dalam daftar.

last_id string

ID item terakhir dalam daftar.

has_more boolean

Menunjukkan apakah masih ada item tambahan yang tersedia. Jika bernilai true, gunakan last_id yang dikembalikan sebagai parameter after pada permintaan berikutnya untuk mengambil lebih banyak item.

id string

ID Response tempat item input ini berasal.

model string

Nama model yang digunakan untuk menghasilkan Response ini.

created_at integer

Timestamp Unix saat Response dibuat, dalam satuan milidetik. Catatan: ini berbeda dari bidang created_at yang dikembalikan oleh API Create a response dan Retrieve a response, yang menggunakan satuan detik.

previous_response_id string

Hanya dikembalikan untuk percakapan multi-putaran yang dirangkai dengan previous_response_id. Nilainya adalah ID Response dari putaran sebelumnya.

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

Error response

Jika ID Response yang ditentukan tidak ditemukan, API akan mengembalikan error berikut:

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