Pular para o conteúdo principal
GET
/
api
/
v1
/
llm
/
responses
Python (SDK)
from openapi import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.llm.responses.list(after="resp_abc123", before="resp_xyz789", limit=25, order="desc")

    # Handle response
    print(res)
{
  "object": "list",
  "data": [
    {
      "id": "resp_abc123",
      "object": "response",
      "created_at": 1735689600,
      "completed_at": 1735689601,
      "status": "completed",
      "error": null,
      "incomplete_details": null,
      "background": false,
      "instructions": null,
      "max_output_tokens": null,
      "max_tool_calls": 30,
      "metadata": {
        "status": "reviewed",
        "reviewer": "john_doe"
      },
      "model": "meetkai:functionary-urdu-mini-pak",
      "output": [
        {
          "type": "message",
          "id": "msg_abc123",
          "role": "assistant",
          "content": [
            {
              "type": "output_text",
              "text": "The capital of France is Paris.",
              "annotations": []
            }
          ],
          "status": "completed"
        }
      ],
      "output_text": "The capital of France is Paris.",
      "parallel_tool_calls": true,
      "previous_response_id": null,
      "reasoning": {
        "effort": null,
        "summary": null
      },
      "service_tier": "auto",
      "store": true,
      "text": {
        "format": {
          "type": "text"
        },
        "verbosity": "medium"
      },
      "tool_choice": "auto",
      "tools": [],
      "truncation": "auto",
      "usage": {
        "input_tokens": 8,
        "input_tokens_details": {
          "cached_tokens": 0
        },
        "output_tokens": 7,
        "output_tokens_details": {
          "reasoning_tokens": 0
        },
        "total_tokens": 15
      },
      "user": null
    }
  ],
  "first_id": "resp_abc123",
  "last_id": "resp_abc123",
  "has_more": false
}

Autorizações

Authorization
string
header
obrigatório

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Parâmetros de consulta

after
string

Um ID de resposta para usar como um cursor para paginação. Retorna respostas que vêm após este ID na lista. Usado para paginação baseada em cursor para buscar páginas subsequentes.

Exemplo:

"resp_abc123"

before
string

Um ID de resposta a ser usado como um cursor para paginação. Retorna respostas que vêm antes deste ID na lista. Usado para paginação baseada em cursor para buscar páginas anteriores.

Exemplo:

"resp_xyz789"

limit
integer
padrão:20

O número máximo de respostas a retornar por página. Deve estar entre 1 e 100. O padrão é 20 itens.

Intervalo obrigatório: 1 <= x <= 100
Exemplo:

25

order
enum<string>
padrão:desc

A ordem para retornar as respostas é pela data de criação. 'asc' retorna as respostas mais antigas primeiro, 'desc' retorna as respostas mais novas primeiro. O padrão é 'desc' (mais novas primeiro).

Opções disponíveis:
asc,
desc
Exemplo:

"desc"

Resposta

200 - application/json

Lista paginada de respostas para o usuário autenticado.

Objeto de lista paginada contendo respostas com metadados de paginação baseada em cursor.

object
any
obrigatório

O tipo de objeto, sempre 'lista' para respostas de lista paginadas.

data
object[]
obrigatório

Array de objetos de resposta. Cada resposta contém seu status, modelo, entrada/saída, logs de uso de ferramentas, metadados e informações de conclusão.

has_more
boolean
obrigatório

Indica se há mais respostas disponíveis além da página atual. Verdadeiro se páginas adicionais existirem, falso caso contrário.

first_id
string

O ID da primeira resposta na página atual. Usado como um ponto de referência para paginação.

last_id
string

O ID da última resposta na página atual. Usado como um cursor para buscar a próxima página.