AI Summarize API • Live on Signet test network only

Turn long text into a short paragraph or bullet summary.

AI Summarize is the lightweight writing utility on ArkAPI for issue write-ups, long notes, scraped pages, docs, or pasted text. It keeps the interface simple, returns compact output, and caches exact requests for 24 hours.

5 sats / call

POST /api/ai-summarize

Formats: paragraph, bullets

5 requests / day / token

24 hour cache

What It Does

Use /api/ai-summarize when you want fast compression of long text without the open-ended behavior of a chat endpoint. You send raw text, choose either paragraph or bullets, and optionally cap the output with max_sentences.

Good fit for markdown notes, bug reports, pasted docs, and scraped content
Paragraph mode returns a compact prose summary
Bullet mode returns short dash-prefixed lines for quick scanning

Limits and Caching

The endpoint is limited to 5 requests per day per token, matching the chat endpoint's daily cap. Exact duplicate requests are cached for 24 hours to keep repeat lookups fast and reduce backend churn.

Cache key is based on the full request body
Cache hits still count as paid ArkAPI calls
Use the same input if you want predictable repeated output

Example Request

curl -X POST https://arkapi.dev/api/ai-summarize \
  -H "Authorization: Bearer ak_your_token" \
  -H "Content-Type: application/json" \
  -d '{"text":"A README file provides essential information about a project and helps others understand how to use or reuse it.","format":"paragraph","max_sentences":3}' | jq

Example Response

{
  "success": true,
  "data": {
    "summary": "A README file is a short guide that explains a project, its contents, and how others can understand or reuse it.",
    "format": "paragraph",
    "max_sentences": 3,
    "model": "arkapi-summarize-v1"
  },
  "cost_sats": 5,
  "endpoint": "/api/ai-summarize"
}

Request Shape

{
  "text": "long text to summarize",
  "format": "paragraph",
  "max_sentences": 3
}

text is required
format is optional and accepts paragraph or bullets
max_sentences is optional and accepts values from 1 to 10