> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dedaluslabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Models API

> Unified API for chat completions, embeddings, audio, and image generation across multiple AI providers

export const LibCard = ({icon, name, version, install, github, docs}) => <div style={{
  border: "1px solid var(--border-primary, #e5e7eb)",
  borderRadius: "2px",
  padding: "20px",
  display: "flex",
  flexDirection: "column",
  gap: "14px"
}}>
    <div style={{
  display: "flex",
  alignItems: "center",
  gap: "12px"
}}>
      <span style={{
  fontFamily: "var(--font-mono, monospace)",
  fontSize: "20px",
  fontWeight: 700,
  letterSpacing: "-0.02em",
  opacity: 0.7,
  minWidth: "36px"
}}>{icon}</span>
      <div>
        <div style={{
  fontWeight: 600,
  fontSize: "14px",
  letterSpacing: "-0.01em"
}}>{name}</div>
        <div style={{
  fontSize: "11px",
  opacity: 0.4,
  fontFamily: "var(--font-mono, monospace)"
}}>{version}</div>
      </div>
    </div>
    <div style={{
  fontFamily: "var(--font-mono, monospace)",
  fontSize: "12px",
  background: "var(--background-secondary, #f8f8f8)",
  borderRadius: "2px",
  padding: "8px 10px",
  whiteSpace: "nowrap",
  overflow: "hidden",
  textOverflow: "ellipsis",
  letterSpacing: "-0.01em"
}}>{install}</div>
    <div style={{
  display: "flex",
  alignItems: "center",
  gap: "6px",
  borderTop: "1px solid var(--border-primary, #e5e7eb)",
  paddingTop: "12px"
}}>
      <a href={github} target="_blank" rel="noopener noreferrer" style={{
  opacity: 0.35,
  display: "flex",
  alignItems: "center"
}}>
        <Icon icon="github" size={15} />
      </a>
      <a href={docs} target="_blank" rel="noopener noreferrer" style={{
  flex: 1,
  textAlign: "center",
  fontSize: "12px",
  fontWeight: 500,
  padding: "5px 0",
  border: "1px solid var(--border-primary, #e5e7eb)",
  borderRadius: "2px",
  textDecoration: "none",
  color: "inherit",
  letterSpacing: "-0.01em"
}}>
        Read Docs
      </a>
    </div>
  </div>;

## Libraries

<div style={{ display: "grid", gridTemplateColumns: "repeat(auto-fill, minmax(220px, 1fr))", gap: "12px" }}>
  <LibCard icon="TS" name="TypeScript" version="0.1.0-alpha.8" install="npm install dedalus-labs" github="https://github.com/dedalus-labs/dedalus-sdk-typescript" docs="https://github.com/dedalus-labs/dedalus-sdk-typescript#readme" />

  <LibCard icon="PY" name="Python" version="0.2.0" install="pip install dedalus-labs" github="https://github.com/dedalus-labs/dedalus-sdk-python" docs="https://github.com/dedalus-labs/dedalus-sdk-python#readme" />

  <LibCard icon="GO" name="Go" version="0.1.0-alpha.3" install="go get github.com/dedalus-labs/dedalus-sdk-go" github="https://github.com/dedalus-labs/dedalus-sdk-go" docs="https://pkg.go.dev/github.com/dedalus-labs/dedalus-sdk-go" />
</div>

## Getting Started

<Steps>
  <Step title="Get an API key">
    Sign up at the [Dedalus Dashboard](https://dedaluslabs.ai/dashboard/api-keys) and create an API key.
  </Step>

  <Step title="Install an SDK">
    Pick a language from the **Install** tabs above.
  </Step>

  <Step title="Make your first call">
    Send a chat completion request using any supported model.

    <CodeGroup>
      ```typescript TypeScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
      import DedalusLabs from "dedalus-labs";

      const client = new DedalusLabs();
      const completion = await client.chat.completions.create({
        model: "openai/gpt-4o",
        messages: [{ role: "user", content: "Hello!" }],
      });
      ```

      ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
      from dedalus_labs import DedalusLabs

      client = DedalusLabs()
      completion = client.chat.completions.create(
          model="openai/gpt-4o",
          messages=[{"role": "user", "content": "Hello!"}],
      )
      ```

      ```bash CLI theme={"theme":{"light":"github-light","dark":"github-dark"}}
      curl -X POST https://api.dedaluslabs.ai/v1/chat/completions \
        -H "Authorization: Bearer $DEDALUS_API_KEY" \
        -H "Content-Type: application/json" \
        -d '{"model": "openai/gpt-4o", "messages": [{"role": "user", "content": "Hello!"}]}'
      ```
    </CodeGroup>
  </Step>
</Steps>

## Authentication

All endpoints require a Bearer token or `X-API-Key` header.
Get your key from the [Dedalus Dashboard](https://dedaluslabs.ai/dashboard/api-keys).

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
Authorization: Bearer YOUR_API_KEY
```

## Chat & Embeddings

| Method | Path                   | Description                                              |
| ------ | ---------------------- | -------------------------------------------------------- |
| `POST` | `/v1/chat/completions` | [Create chat completion](/api/v1/create-chat-completion) |
| `POST` | `/v1/embeddings`       | [Create embeddings](/api/v1/create-embeddings)           |

## Audio

| Method | Path                       | Description                                          |
| ------ | -------------------------- | ---------------------------------------------------- |
| `POST` | `/v1/audio/speech`         | [Create speech](/api/v1/create-speech)               |
| `POST` | `/v1/audio/transcriptions` | [Create transcription](/api/v1/create-transcription) |
| `POST` | `/v1/audio/translations`   | [Create translation](/api/v1/create-translation)     |

## Images & Documents

| Method | Path                     | Description                          |
| ------ | ------------------------ | ------------------------------------ |
| `POST` | `/v1/images/generations` | [Create image](/api/v1/create-image) |
| `POST` | `/v1/ocr`                | [OCR](/api-reference/ocr)            |

## Models

| Method | Path         | Description                        |
| ------ | ------------ | ---------------------------------- |
| `GET`  | `/v1/models` | [List models](/api/v1/list-models) |