AI Chat — Nyqo API

Requisição

curl -X POST "https://api.nyqo.dev/api/v1/ai/chat" \
  -H "Authorization: Bearer nyq_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{"message":"Olá! Como você pode me ajudar?","image":"https://exemplo.com/foto.jpg","image_url":"https://exemplo.com/foto.jpg","images":"[\"https://exemplo.com/foto.jpg\"]"}'

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
`message`	`string \| string[]`	sim	Mensagem ou array. Ex: "Olá" ou ["Olá","Explique X"] ou [{"role":"user","content":"Olá"}]
`image`	`string`	não	Imagem única: data URL (data:image/...;base64,...), base64 cru ou URL https da imagem
`image_url`	`string`	não	Alias para `image` — URL https de imagem (baixada server-side, max 10MB)
`images`	`string[]`	não	Array de até 4 imagens (cada uma como URL ou base64/data URL)

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?"
}
// Ex. com imagem: {"message":"descreva esta imagem","image_url":"https://example.com/foto.jpg"}

Levar essa referência para o seu agente/LLM

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

# AI Chat

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

Envia mensagem(ns) para a IA e recebe resposta. `message` aceita string ou array. Imagem opcional via `image`/`image_url`/`images` (vision). Modelo é definido pelo admin, usuário não escolhe.

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

## 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 |
| --- | --- | --- | --- |
| `message` | `string | string[]` | sim | Mensagem ou array. Ex: "Olá" ou ["Olá","Explique X"] ou [{"role":"user","content":"Olá"}] |
| `image` | `string` | não | Imagem única: data URL (data:image/...;base64,...), base64 cru ou URL https da imagem |
| `image_url` | `string` | não | Alias para `image` — URL https de imagem (baixada server-side, max 10MB) |
| `images` | `string[]` | não | Array de até 4 imagens (cada uma como URL ou base64/data URL) |

## 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/ai/chat" \
  -H "Authorization: Bearer nyq_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{"message":"Olá! Como você pode me ajudar?","image":"https://exemplo.com/foto.jpg","image_url":"https://exemplo.com/foto.jpg","images":"[\"https://exemplo.com/foto.jpg\"]"}'
```

## Exemplo de resposta

```json
{
		"success": true,
		"response": "Olá! Como posso ajudar?"
}
// Ex. com imagem: {"message":"descreva esta imagem","image_url":"https://example.com/foto.jpg"}
```

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.

Estamos em manutenção

Requisição

Parâmetros

Resposta

Levar essa referência para o seu agente/LLM

Erros comuns