# OpenAI and Cohere compatible endpoints

Four endpoints accept the request shape you already send to OpenAI or Cohere. Point your SDK's base URL at `https://labs.greatwork.company/v1` and use a Great Work Labs key.

```python
from openai import OpenAI
client = OpenAI(base_url="https://labs.greatwork.company/v1", api_key=os.environ["GWL_API_KEY"])

client.embeddings.create(model="atlas-1", input=["first doc", "second doc"])
client.moderations.create(input="text to check")
client.audio.transcriptions.create(model="scribe-1", file=open("call.m4a", "rb"), response_format="verbose_json")
```

## `POST /v1/embeddings` (Atlas)

OpenAI request and response shape. `model` is ignored unless it names an Atlas version; `encoding_format: "base64"` works. Vectors have 384 dimensions. Add `"input_type": "query"` for search queries (documents use the default). `usage.prompt_tokens` is an approximation; `usage.cost_usd` is exact.

## `POST /v1/moderations` (Warden)

OpenAI response shape (`flagged`, `categories`, `category_scores` with OpenAI's category names), mapped from Warden's 15 policy categories. For toxicity scores (insults, threats, obscenity), call [Sieve](https://labs.greatwork.company/models/sieve-1) directly.

## `POST /v1/audio/transcriptions` (Scribe)

Multipart with `file`, optional `language` and `response_format`: `json` (default), `text`, `srt`, `vtt` or `verbose_json` (with word and segment timestamps).

## `POST /v1/rerank` (Ladder)

Cohere and Jina request shape: `query`, `documents` (strings or `{"text"}` objects), `top_n`, `return_documents`. Response has `results[].index` and `results[].relevance_score`. `/v2/rerank` works too.
