API de IA ConnectyHub · Começar
Inteligência para seus projetos
Referência da API de IA ConnectyHub: recursos, integração, mensagens, respostas e créditos em um só lugar.
Rotas públicas
Seções de referência
Consumo da conta
Sua primeira integração
- Entre no painel de API de IA, dê um nome ao projeto e escolha o modelo. Flash 3.5 é a opção recomendada.
- Copie a chave exibida e guarde-a no servidor do seu sistema.
- Envie messages para /chat/completions. Leia a resposta e acompanhe os créditos no painel.
Endereço e autenticação
Base URL: https://www.connectyhub.com.br/api/v1/ai
Authorization: Bearer SUA_CHAVE
Content-Type: application/jsonPrimeira solicitação · Bash
curl 'https://www.connectyhub.com.br/api/v1/ai/chat/completions' \
-H "Authorization: Bearer $CONNECTYHUB_AI_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: pedido-123-resposta-1' \
--data '{
"messages": [
{
"role": "user",
"content": "Explique o que é uma API em uma frase."
}
]
}'Configure CONNECTYHUB_AI_API_KEY no ambiente do servidor. Troque a Idempotency-Key do exemplo por uma identidade própria para cada operação e preserve-a nos reenvios.
Resposta ilustrativa
{
"id": "chatcmpl-00000000-0000-4000-8000-000000000001",
"object": "chat.completion",
"created": 1788883732,
"model": "connectyhub-auto",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Uma API permite que sistemas troquem informações por regras definidas."
},
"finish_reason": "stop"
}
],
"connectyhub": {
"request_id": "00000000-0000-4000-8000-000000000001",
"credits": 1,
"project_id": "00000000-0000-4000-8000-000000000002"
}
}Onde encontrar o resultado
| Campo | Uso |
|---|---|
| choices[0].message.content | Texto produzido pela IA. |
| connectyhub.credits | Créditos utilizados na operação; o valor do exemplo é ilustrativo. |
| connectyhub.request_id | Identificador para consultar a situação e recuperar a resposta. |
