> ## Documentation Index > Fetch the complete documentation index at: https://docs.co-mind.ai/llms.txt > Use this file to discover all available pages before exploring further. # Translate text > Translate a text string from a source language to a target language. Language codes follow ISO 639-1 (e.g. `en`, `de`, `fr`). If `source_lang` is omitted, the backend attempts language detection. ## OpenAPI ````yaml /openapi.yaml post /v1/translate/text openapi: 3.1.0 info: title: Co-mind.ai Private AI Platform API version: 1.2.4 description: > Co-mind.ai Private AI Platform API. ## Features - OpenAI-compatible endpoints - Tool/function calling support - Streaming responses - Multiple backend support - Personal Access Tokens (PAT) for programmatic access ## Authentication The API supports two authentication methods: **1. JWT Authentication** — Login with email/password to get short-lived access tokens. Use for interactive sessions (web apps, Postman). **2. Personal Access Tokens (PAT)** — Long-lived tokens for programmatic/API access. Create via `POST /v1/api-tokens` after authenticating with JWT. PAT format: `cmnd_.` Both methods use the `Authorization: Bearer ` header. contact: email: support@co-mind.ai servers: - url: http://co-mind-platform-host description: Co-mind.ai AI Platform security: - BearerAuth: [] tags: - name: Discovery description: List available models - name: Authentication description: >- JWT login, refresh, logout, SSO, registration, password reset, and `/v1/auth/me` - name: API Tokens description: Personal Access Token (PAT) management - name: Completions description: Text completion endpoints (single-shot, no conversation state) - name: Chat description: > OpenAI-compatible chat completions. **Stateless** — the client sends the full conversation history on every request; the server does not persist messages. - name: Responses description: > OpenAI-Responses-compatible endpoint. Wire-shape passthrough to the Inference Engine — every field the caller sends flows through, so the caller can use the full Responses API surface. The server does not persist responses server-side; use the `/v1/responses/{resp_id}/continue` variant to extend a prior response by id. - name: Embeddings description: > Text-embedding endpoint. Runs against the platform's configured embedding model (see `GET /v1/models`); the resulting vectors are returned to the caller and are not persisted server-side. - name: Translation description: > Text translation between languages. Ships with `POST /v1/translate/text`; async document translation is on the roadmap for a future release. - name: Knowledge Base description: > Knowledge base management (create / update / delete KBs, upload files, query for context) and **stateless** retrieval-augmented chat (`/v1/knowledgebase/chat/completions`). The RAG chat endpoint is stateless — the client sends the full conversation history on every request; the server injects retrieved KB context and returns the completion. - name: Chat Sessions (Preview) description: > **Preview — not currently enabled.** **Stateful** chat sessions. The server manages conversation history and supports tool orchestration (knowledge base retrieval, research, agents). These endpoints are documented for integrator preparation but are not exposed on any deployment today; they will be enabled in an upcoming release. Request and response schemas may change before general availability. - name: Researcher description: Web search, research sessions, analysis, synthesis, and source credibility - name: Quota description: Usage quota tracking paths: /v1/translate/text: post: tags: - Translation summary: Translate text description: > Translate a text string from a source language to a target language. Language codes follow ISO 639-1 (e.g. `en`, `de`, `fr`). If `source_lang` is omitted, the backend attempts language detection. operationId: translateText requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TranslateTextRequest' responses: '200': description: Successful translation content: application/json: schema: $ref: '#/components/schemas/TranslateTextResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/RateLimitExceeded' components: schemas: TranslateTextRequest: type: object required: - text - target_lang properties: text: type: string description: Text to translate. example: Hello, world. target_lang: type: string description: Target language, ISO 639-1. example: de source_lang: type: string description: Optional source language, ISO 639-1. Omit to auto-detect. example: en TranslateTextResponse: type: object properties: translated_text: type: string example: Hallo, Welt. detected_source_lang: type: string description: >- Present when `source_lang` was omitted and the backend detected the language. example: en target_lang: type: string example: de Error: type: object properties: error: type: object properties: message: type: string type: type: string code: type: string responses: BadRequest: description: Bad request content: application/json: schema: $ref: '#/components/schemas/Error' example: error: message: Invalid request parameters type: invalid_request_error code: bad_request Unauthorized: description: Authentication required or invalid token content: application/json: schema: $ref: '#/components/schemas/Error' example: error: message: Invalid authentication credentials type: permission_error code: unauthorized RateLimitExceeded: description: Rate limit exceeded headers: Retry-After: schema: type: integer description: Seconds to wait before retrying x-ratelimit-limit-requests: schema: type: integer x-ratelimit-remaining-requests: schema: type: integer x-ratelimit-reset-requests: schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' example: error: message: Rate limit exceeded type: rate_limit_exceeded code: rate_limit_exceeded securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT or PAT description: > Bearer token authentication. Supports two token types: - **JWT Access Token** — obtained via `POST /v1/auth/login` - **Personal Access Token (PAT)** — created via `POST /v1/api-tokens`, format: `cmnd_.` ````