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

# Create chat

> Új beszélgetés létrehozása és építés indítása AI-val

Új beszélgetést hoz létre, és elindítja az AI munkafolyamatot.

## Kérés

```
POST /api/chat
```

### Fejlécek

| Fejléc | Kötelező | Leírás |
| - | - | - |
| `Authorization` | Igen | `Bearer macaly_...` |
| `Content-Type` | Igen | `application/json` |

### Törzsparaméterek

| Mező | Típus | Kötelező | Alapérték | Leírás |
| - | - | - | - | - |
| `content` | string | Igen | - | A felhasználó üzenete / promptja |
| `stream` | boolean | Nem | `true` | Ha `false`, adatfolyam helyett JSON-t ad vissza |
| `backend` | string | Nem | `"DEFAULT"` | A használt háttérrendszer |
| `executionMode` | `"auto"` \| `"planning"` \| `"build"` | Nem | - | Azt szabályozza, hogyan közelíti meg az AI a feladatot |
| `model` | `"gpt-5.6-terra"` \| `"gpt-6.1-sol"` \| `"gpt-6-luna"` \| `"grok-4-6"` \| `"kimi-k3"` \| `"sonnet-5-5"` \| `"opus-5-5"` \| `"blueai-glm-5-3"` \| `"blueai-glm-5-3-flash"` | Nem | - | A használt AI-modell. Alapértelmezés szerint a munkaterületen beállított modell |
| `reasoningEffort` | `"medium"` \| `"high"` | Nem | - | Azt szabályozza, mennyire mélyen gondolkodik az AI a feladaton |
| `experimental_attachments` | array | Nem | `[]` | Fájlmellékletek (a formátumot lásd lent) |

#### Mellékletek formátuma

Az `experimental_attachments` tömb minden eleme a következő szerkezetű:

| Mező | Típus | Kötelező | Leírás |
| - | - | - | - |
| `url` | string | Igen | A csatolandó fájl URL-je |
| `name` | string | Nem | A melléklet megjelenített neve |
| `contentType` | string | Nem | A fájl MIME-típusa |

### Példa kérés

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://www.macaly.com/api/chat \
    -H "Authorization: Bearer macaly_abc123..." \
    -H "Content-Type: application/json" \
    -d '{
      "content": "Create a landing page for a coffee shop",
      "stream": false
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://www.macaly.com/api/chat', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer macaly_abc123...',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      content: 'Create a landing page for a coffee shop',
      stream: false,
    }),
  });

  const data = await response.json();
  console.log(data.chatId);
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      'https://www.macaly.com/api/chat',
      headers={
          'Authorization': 'Bearer macaly_abc123...',
          'Content-Type': 'application/json',
      },
      json={
          'content': 'Create a landing page for a coffee shop',
          'stream': False,
      },
  )

  data = response.json()
  print(data['chatId'])
  ```
</CodeGroup>

## Válasz

### JSON-válasz (ha `stream: false`)

```json theme={null}
{
  "chatId": "abc123def456",
  "url": "https://www.macaly.com/chat/abc123def456",
  "streamId": "stream_xyz789",
  "assistantMessageId": "msg_123"
}
```

| Mező | Típus | Leírás |
| - | - | - |
| `chatId` | string | A beszélgetés egyedi azonosítója |
| `url` | string | A beszélgetés megtekintésére szolgáló közvetlen URL |
| `streamId` | string \| undefined | A feliratkozáshoz használt adatfolyam-azonosító. Csak munkafolyamat-alapú háttérrendszereknél szerepel |
| `assistantMessageId` | string \| undefined | A most generált asszisztensüzenet azonosítója. Csak munkafolyamat-alapú háttérrendszereknél szerepel |

### Adatfolyam-válasz (ha `stream: true`, ez az alapérték)

Ha az adatfolyam be van kapcsolva, a válasz egy szöveges adatfolyam:

```
2:[{"chatId":"abc123def456"}]
0:"Starting to build..."
...
```

Az első sor a beszélgetés azonosítóját tartalmazza `2:[{"chatId":"..."}]` formában.

#### A beszélgetés azonosítójának kinyerése az adatfolyamból

```javascript theme={null}
const text = await response.text();
const match = text.match(/2:\[{"chatId":"([^"]+)"/);
const chatId = match?.[1];
```

## Állapotkódok

| Állapot | Leírás |
| - | - |
| 200 | Sikeres - a beszélgetés létrejött |
| 400 | Érvénytelen kéréstörzs |
| 401 | Érvénytelen vagy hiányzó API-kulcs |
| 402 | Nincs elég kredit |
| 403 | Tiltott - Nincs jogosultság a megadott munkaterülethez |
| 422 | Érvényesítési hiba |
| 429 | Túllépted a kérési korlátot |
| 500 | Szerverhiba |

## Következő lépések

A beszélgetés létrehozása után:

1. **Kérdezd le az állapotot a befejezésig** a [`GET /api/chat/{chatId}/status`](/docs/hu/api/get-status) végponttal
2. **Iratkozz fel az adatfolyamra** a [`GET /api/chat/{chatId}/subscribe`](/docs/hu/api/subscribe-stream) végponttal a valós idejű frissítésekhez
3. **Küldj további üzeneteket** a [`POST /api/chat/{chatId}/publish`](/docs/hu/api/publish-message) végponttal


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.