Introduction

Build intelligent healthcare applications with Persly Medical AI APIs.

Persly provides a suite of medical AI APIs designed for healthcare applications. Our APIs are optimized for medical use cases and can include source citations, enabling developers to build intelligent healthcare products.

Docs are updated continuously. Validate your integration against the API Reference examples before shipping.

APIs

Chat Completions

Medical AI responses with source citations and follow-up suggestions.

Finder

AI-powered medical information search with optional answer generation.

Embeddings

Generate 1536-dimensional embeddings optimized for medical text.

Rerank

Rerank documents by medical relevance for improved search accuracy.

Domains

Public domain catalog for include_domains and exclude_domains filters.

MCP (Model Context Protocol)

Connect AI Agents

Let AI assistants like Claude and ChatGPT access your medical records directly.

Key Features

Medical Domain Expertise — Models trained and optimized for healthcare use cases
Source Citations — Chat and Finder responses can include source citations. If none are retrieved, non-streaming fields may be null. For Chat streaming (stream: true), the sources event returns [] when none are found.
Simple Pricing — Prepaid credits with transparent per-request pricing and no hidden fees

Getting Started

Get your first API response in under 5 minutes:

Create an account at platform.persly.ai
Generate an API key from the dashboard
Make your first API call

Your first API call

curl https://api.persly.ai/v1/chat/completions \
  -H "Authorization: Bearer $PERSLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "persly-chat-v1",
    "messages": [{"role": "user", "text": "What are the common symptoms of type 2 diabetes?"}]
  }'

Ready to dive in? Follow our Quickstart Guide for a complete walkthrough.