Introduction

The Perfect10 AI API lets you embed AI agents directly into your own applications — websites, mobile apps, Power BI dashboards, or any custom interface.

Session-based

Create a session once, reuse it for the full conversation.

Real-time streaming

SSE streaming for live token-by-token responses.

Image support

Upload and attach up to 2 images per message.

Embeddable widget

Drop-in JS widget for any website in under 2 minutes.

Base URL

https://api.perfect10.id

Typical flow

1Generate an API key from the Integration → API Key page.
2Find your agent_id from the Agents page.
3Call POST /sessions with your agent_id to get a session_id.
4Call POST /sessions/{session_id}/messages to send a message.
5Open a GET /stream/{assistant_message_id} SSE connection to receive the response.
6Repeat steps 4–5 for each turn in the conversation.