Ir para o conteúdo

Threads e mensagens

A conversa persistente: criar threads, acrescentar mensagens e paginar o histórico.

Atualizado em 10 de ago. de 2026

A thread é a conversa. Cada mensagem nova é um POST — e é tudo que você envia: o histórico anterior já está no servidor. A thread não pertence a um assistente; qualquer assistente pode executá-la, o vínculo acontece no run.

POSThttps://api.hinow.ai/v1/threadsBearer

Cria uma thread — vazia ou já com as primeiras mensagens.

Parâmetros

  • messagesarray· body

    Mensagens iniciais: [{"role": "user", "content": "..."}].

  • tool_resourcesobject· body

    Vector stores da conversa: {"file_search": {"vector_store_ids": ["vs_..."]}}.

  • metadataobject· body

Respostas

200O objeto thread
POSThttps://api.hinow.ai/v1/threads/{thread_id}/messagesBearer

Acrescenta uma mensagem à conversa.

Parâmetros

  • thread_idstring· pathobrigatório
  • rolestring· bodyobrigatório

    user ou assistant.

  • contentstring | array· bodyobrigatório

    Texto simples ou blocos de conteúdo (text, image_url).

  • attachmentsarray· body

    Arquivos anexados à mensagem.

  • metadataobject· body

Respostas

200O objeto thread.message
400role inválida (aceita apenas user e assistant)

Ler o histórico

A listagem segue a paginação por cursor da OpenAI: limit (até 100), order (asc|desc), after e before recebendo um id de mensagem. O filtro run_id devolve só o que uma execução específica produziu.

# a resposta mais recente
curl -s "https://api.hinow.ai/v1/threads/thread_.../messages?order=desc&limit=1" \
  -H "Authorization: Bearer hi_SUA_API_KEY"

# só as mensagens geradas por um run
curl -s "https://api.hinow.ai/v1/threads/thread_.../messages?run_id=run_..." \
  -H "Authorization: Bearer hi_SUA_API_KEY"

Mensagens do assistente chegam com role: "assistant", run_id e assistant_id preenchidos, e o texto em content[0].text.value.

Gerenciar

# ler
curl -s https://api.hinow.ai/v1/threads/thread_... -H "Authorization: Bearer hi_SUA_API_KEY"

# editar metadata / tool_resources
curl -s https://api.hinow.ai/v1/threads/thread_... \
  -H "Authorization: Bearer hi_SUA_API_KEY" -H "Content-Type: application/json" \
  -d '{"metadata": {"cliente": "acme"}}'

# remover (leva as mensagens junto)
curl -s -X DELETE https://api.hinow.ai/v1/threads/thread_... -H "Authorization: Bearer hi_SUA_API_KEY"

Extensão HINOW: listar threads

A OpenAI nunca ofereceu GET /v1/threads — aqui existe, com a mesma paginação dos demais recursos. Útil para reconstruir a lista de conversas de um usuário sem manter um índice paralelo.

Esta página foi útil?