Get Messages
GET /api/v1/chat/{chatGuid}/message?password={pass}&limit=50&offset=0
Returns: array of message objects with text, isFromMe, dateCreated, guid, etc.
Relay command:
{"action":"get_messages","chat_guid":"...","limit":50,"describe_images":true}
When describe_images is true and the relay config
permits image descriptions, image attachments are expanded into
pseudo-messages:
{
"guid": "message-guid:attachment-guid",
"parent_guid": "message-guid",
"kind": "image_description",
"description_status": "pending|cached|ready|error|disabled",
"attachment_guid": "attachment-guid",
"attachment_index": 0,
"attachment_count": 1,
"text": "[Image] concise description",
"from_me": false,
"date": "..."
}
Non-image attachments are returned as
kind: "attachment_placeholder" with text
values such as [Video], [Audio],
[Contact card], or [File].
Image descriptions are cache-backed on the relay host: - Cache:
~/.cache/aquaping/image_descriptions.json - Runtime config:
~/.config/aquaping/config.json - Required keys for MiniMax
activation: minimax_api_key and
image_descriptions_consent: true - Optional key:
image_descriptions_daily_limit, default 100 -
The MiniMax key must never be committed or written to docs/feed
output.