AI Chat (OpenAI Compatible)

Requisição

curl -X POST "https://api.nyqo.dev/api/v1/chat/completions" \
  -H "Authorization: Bearer nyq_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{"messages":"[{\"role\":\"user\",\"content\":\"Olá!\"}]","message":"Olá! Como você pode me ajudar?"}'

Troque nyq_sua_chave_aqui pela sua chave do painel. Também aceito via header X-API-Key — nunca na query string.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`messages`	`object[]`	não	Mensagens no formato OpenAI. Ex: [{"role":"user","content":"Olá"}]
`message`	`string \| string[]`	não	Alternativa nativa: mensagem ou array. Ex: "Olá"

Resposta

Campo	Tipo	Descrição
`success`	`boolean`	Sucesso da requisição
`response`	`string`	Resposta gerada pela IA

Exemplo de resposta real

{
		"success": true,
		"response": "Olá! Como posso ajudar?"
}

Levar essa referência para o seu agente/LLM

Copie a doc em Markdown — mesmo formato das skills e do llms.txt.

# AI Chat (OpenAI Compatible)

`POST https://api.nyqo.dev/api/v1/chat/completions`

Alias compatível com OpenAI Chat Completions para a IA. Aceita `messages` no formato OpenAI ([{"role":"user","content":"..."}]) além do formato nativo (`message`). Modelo é definido pelo admin, usuário não escolhe.

Categoria: Inteligência Artificial · Slug: `ai-chat-openai-compat`

## Autenticação

```http
Authorization: Bearer nyq_sua_chave_aqui
```

Também aceito: `X-API-Key: nyq_sua_chave_aqui`. Nunca via query string (`?api_key`).

## Parâmetros

| Nome | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `messages` | `object[]` | não | Mensagens no formato OpenAI. Ex: [{"role":"user","content":"Olá"}] |
| `message` | `string | string[]` | não | Alternativa nativa: mensagem ou array. Ex: "Olá" |

## Resposta

| Campo | Tipo | Descrição |
| --- | --- | --- |
| `success` | `boolean` | Sucesso da requisição |
| `response` | `string` | Resposta gerada pela IA |

## Exemplo (curl)

```bash
curl -X POST "https://api.nyqo.dev/api/v1/chat/completions" \
  -H "Authorization: Bearer nyq_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{"messages":"[{\"role\":\"user\",\"content\":\"Olá!\"}]","message":"Olá! Como você pode me ajudar?"}'
```

## Exemplo de resposta

```json
{
		"success": true,
		"response": "Olá! Como posso ajudar?"
}
```

Erros comuns

· 401 unauthorized — sem chave ou chave inválida. Confira autenticação.
· 403 forbidden — plano sem esta rota ou chave fora do escopo. Veja planos.
· 429 rate_limited — quota estourada; aguarde Retry-After. Detalhes em rate limits.

Tabela completa em /docs — códigos de erro.