API reference

{
  "key": {
    "id": "key_8f2k1q",
    "name": "Production"
  },
  "plan": {
    "id": "developer",
    "name": "Developer",
    "requestsPerMinute": 60
  },
  "credits": {
    "limit": 5000,
    "used": 1240,
    "remaining": 3760,
    "resetsAt": "2026-11-01T00:00:00.000Z"
  }
}

curl https://toolartisan.com/api/v1/account \
  -H "Authorization: Bearer $TOOLARTISAN_API_KEY"

{
  "summary": "The article argues that…",
  "keyPoints": [
    "First point",
    "Second point"
  ]
}

curl -X POST https://toolartisan.com/api/v1/summarize \
  -H "Authorization: Bearer $TOOLARTISAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Paste the article you want summarized here. It needs at least forty characters.","length":"short"}'

{
  "translation": "Hola, ¿cómo estás?"
}

curl -X POST https://toolartisan.com/api/v1/translate \
  -H "Authorization: Bearer $TOOLARTISAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello, how are you?","source":"auto","target":"Spanish"}'

{
  "variations": [
    {
      "headline": "Focus, finally",
      "description": "Block out the noise…",
      "cta": "Shop now"
    }
  ]
}

curl -X POST https://toolartisan.com/api/v1/ad-copy \
  -H "Authorization: Bearer $TOOLARTISAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product":"Noise-cancelling headphones","audience":"Remote workers","platform":"meta","tone":"friendly"}'

{
  "markdown": "# Why small teams should automate invoicing\n\n…"
}

curl -X POST https://toolartisan.com/api/v1/blog \
  -H "Authorization: Bearer $TOOLARTISAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source":"Why small teams should automate invoicing: saves time, fewer errors, faster payment.","words":600}'

{
  "questions": [
    {
      "question": "What does photosynthesis release?",
      "options": [
        "Oxygen",
        "Nitrogen",
        "Carbon dioxide",
        "Hydrogen"
      ],
      "correct": 0,
      "explanation": "Oxygen is released…"
    }
  ]
}

curl -X POST https://toolartisan.com/api/v1/quiz \
  -H "Authorization: Bearer $TOOLARTISAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source":"Photosynthesis converts light energy into chemical energy stored in glucose, releasing oxygen as a by-product…","count":3}'

{
  "reply": "Here are three ideas: …",
  "document": null
}

curl -X POST https://toolartisan.com/api/v1/chat \
  -H "Authorization: Bearer $TOOLARTISAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","text":"Give me three names for a coffee shop."}]}'

{
  "text": "Extracted text…",
  "provider": "paddleocr",
  "ocrPages": 3
}

curl -X POST https://toolartisan.com/api/v1/pdf/ocr \
  -H "Authorization: Bearer $TOOLARTISAN_API_KEY" \
  -F "[email protected]" \
  -F "language=English"

curl -X POST https://toolartisan.com/api/v1/pdf/compress \
  -H "Authorization: Bearer $TOOLARTISAN_API_KEY" \
  -F "[email protected]" \
  -F "level=balanced" \
  -o compressed.pdf

{
  "job": {
    "id": "job_…",
    "status": "completed",
    "language": "en",
    "duration": 754,
    "conversation": "Person-1: Thanks everyone for joining.",
    "lines": [
      {
        "speaker": "Person-1",
        "text": "Thanks everyone for joining.",
        "start": 0,
        "end": 4.2
      }
    ]
  }
}

curl -X POST https://toolartisan.com/api/v1/transcribe \
  -H "Authorization: Bearer $TOOLARTISAN_API_KEY" \
  -F "[email protected]" \
  -F "language=en"

{
  "title": "Beta launch planning",
  "summary": "The team agreed to ship the beta on Friday.",
  "keyPoints": [
    "Beta ships Friday"
  ],
  "discussion": [
    "Onboarding emails"
  ],
  "actionItems": [
    "Ben: finish onboarding emails by Thursday"
  ],
  "topics": [
    "Launch"
  ]
}

curl -X POST https://toolartisan.com/api/v1/transcribe/notes \
  -H "Authorization: Bearer $TOOLARTISAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"transcript":"Anna: Let us ship the beta on Friday. Ben: I will finish the onboarding emails by Thursday.","sessionType":"meeting"}'

curl -X POST https://toolartisan.com/api/v1/vectorize \
  -H "Authorization: Bearer $TOOLARTISAN_API_KEY" \
  -F "[email protected]" \
  -o output.svg

curl -X POST https://toolartisan.com/api/v1/vectorize/trace \
  -H "Authorization: Bearer $TOOLARTISAN_API_KEY" \
  -F "[email protected]" \
  -F "colormode=color" \
  -o output.svg

{
  "words": 6,
  "characters": 35,
  "charactersNoSpaces": 30,
  "sentences": 2,
  "paragraphs": 1,
  "readingTimeSeconds": 2
}

curl -X POST https://toolartisan.com/api/v1/text/stats \
  -H "Authorization: Bearer $TOOLARTISAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"One sentence here. And another one."}'

{
  "result": "helloWorldExample"
}

curl -X POST https://toolartisan.com/api/v1/text/case \
  -H "Authorization: Bearer $TOOLARTISAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"hello world example","to":"camel"}'

{
  "valid": true,
  "result": "{\n  \"a\": [\n    1,\n    2\n  ],\n  \"b\": 1\n}"
}

curl -X POST https://toolartisan.com/api/v1/json/format \
  -H "Authorization: Bearer $TOOLARTISAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"json":"{\"b\":1,\"a\":[1,2]}","indent":2,"sortKeys":true}'

{
  "result": "SGVsbG8="
}

curl -X POST https://toolartisan.com/api/v1/base64 \
  -H "Authorization: Bearer $TOOLARTISAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello","mode":"encode"}'