API Synty.pro для разработчиков

Адрес: https://api.synty.pro/v1. Ключ: sk-synty-… в заголовке Authorization: Bearer (для клиентов Anthropic — x-api-key).

Документация: https://synty.pro/developers. Схема OpenAPI: https://api.synty.pro/v1/openapi.json.

Оплата — с баланса владельца ключа в SC, по фактическим токенам; ответы несут usage.cost_sc и task_id.

Совместимые входы

POST /v1/chat/completions — OpenAI Chat Completions: messages, tools (function calling), stream, response_format.
POST /v1/responses — OpenAI Responses: input, instructions, tools, text.format, stream (события response.*). Для Codex CLI.
POST /v1/messages — Anthropic Messages: system, messages с блоками text/image/tool_use/tool_result, tools, stream. Для Claude Code и SDK Anthropic.
POST /v1/messages/count_tokens — оценка входа без списания.
GET /v1/models — каталог моделей (наш вид и вид OpenAI). Модель synty/auto — роутер.

Claude Code: ANTHROPIC_BASE_URL=https://api.synty.pro, ANTHROPIC_API_KEY=sk-synty-…
Codex CLI: OPENAI_BASE_URL=https://api.synty.pro/v1, OPENAI_API_KEY=sk-synty-…, wire_api = "responses"
Cursor, Cline, Continue, Aider, Open WebUI: Base URL https://api.synty.pro/v1, ключ sk-synty-…, модель из GET /v1/models.

POST /v1/chat — текст с инструментами Synty (web_search, read_url, calculate, get_rates, create_chart, deep_research), sync / stream / async.
POST /v1/images, /v1/video, /v1/audio/speech, /v1/3d, /v1/decompose — генерация медиа задачами.
GET /v1/tools, POST /v1/tools/{slug}/run — инструменты витрины (сотни готовых), input_schema в карточке.
GET /v1/apps, POST /v1/apps/{slug}/run — приложения сайта.
GET /v1/agents, POST /v1/agents/{id}/run — агенты владельца, собранные в кабинете.
POST /v1/files — файлы клиента для генераций (file_id вместо ссылки).
GET /v1/tasks/{id} — состояние и результат задачи; вебхуки ключа — событие о завершении.
POST /v1/keys, PATCH /v1/keys/{id} — ключи нод для реселлеров; поле routing: off | auto | cost_effective.

Python: пакет synty, TypeScript: synty-api (исходники — integrations/sdk в репозитории).
MCP-сервер: https://api.synty.pro/mcp — инструменты synty_chat, synty_generate_image, synty_tool_run, synty_agent_run и другие.
n8n: узел Synty (integrations/n8n).

Форма зависит от маршрута: своя {"error": {code, message, task_id}}; Anthropic {"type": "error", "error": {type, message}} на /messages; OpenAI {"error": {type, message, code}} на /responses. Коды: invalid_key 401, scope_denied 403, insufficient_balance / quota_exceeded 402, rate_limited 429, invalid_params 400, output_truncated 422, upstream_failed 502, upstream_timeout 504.