API Docs

The public member contract.

The API base is https://ai.turkservis.online/v1, the direct MCP address is https://ai.turkservis.online/mcp. Both use a bearer key read from an environment variable.

OpenAPI JSON Client setup

AI

GET /v1/models, POST /v1/chat/completions, POST /v1/responses and GET /v1/me. Streaming responses return text/event-stream

Research and MCP

Long-running research starts with POST /v1/research/jobs and is polled with the job id. MCP serves the same guarded advisory services over Streamable HTTP.

Images and audio

GET /v1/capabilities lists available models. Use the exact model ID with POST /v1/media/run.

CLI: aiturk media list. MCP: list_capabilities and generate_media. Unavailable capabilities cannot start generation.

Open media studio

Web search

POST /v1/search runs a web search and POST /v1/web/fetch reads a single page. Available models are listed as web_search and web_fetch in GET /v1/capabilities.

Each successful request is billed per request; failed requests are refunded.

Errors and downloads

The schema documents 400, 401, 402, 403, 429, and 503 responses. CLI downloads are verified with a manifest, size, and SHA-256; the binary response type is declared separately.