Saltar para o conteúdo principal

Antes de começar

Você precisa de uma chave de API. Crie uma na página Chaves de API do painel. Contas novas começam com 500 créditos grátis. Planos e créditos da API traz os preços.

1. Defina sua chave de API

Mantenha a chave no seu servidor. Veja Autenticação.

2. Envie uma tarefa

Faça uma pergunta ao Gemini. taskType escolhe o mecanismo; payload.prompt é o que você pergunta.
A API aceita a tarefa e a coloca na fila. Por exemplo:
credits é zero no envio. O preço da tarefa fica reservado no seu saldo quando ela começa, é cobrado quando ela é concluída e liberado se ela falhar. Veja Créditos e limites.
Mecanismos de chat como GEMINI leem payload.prompt. GOOGLE_AIO, GOOGLE_AIMODE, os mecanismos do Naver, GOOGLE_SERP e GOOGLE_PLACES leem payload.query. Cada um recorre ao outro campo na falta do seu, então qualquer um funciona. Veja Qual campo do payload é lido.

3. Colete o resultado

Adicione webhook.url ao enviar. Quando a tarefa termina, a querying.ai envia o resultado por POST para essa URL, e você nunca precisa fazer polling.
Seu endpoint recebe { task, credits, response }. Toda entrega é assinada com uma chave derivada da sua chave de API; verifique a assinatura antes de confiar no corpo. Veja Webhooks para assinatura, novas tentativas e o payload.

Próximos passos

Escolha um mecanismo

Cada taskType, o que ele devolve e quanto custa.

Lotes e grades

Envie até 500 tarefas por requisição, ou 10.000 como um único lote.

Webhooks

Payloads, verificação de assinatura e novas tentativas.

Créditos e limites

Preços, concorrência e limites diários.