Integre seu sistema com ajuda da sua IA
Não sabe programar? Baixe o guia e envie ao ChatGPT, Claude, Cursor ou à IA que ajuda você a desenvolver seu sistema. Ele reúne os recursos da API e as instruções para fazer a integração.
- Baixe o PDF abaixo.
- Anexe o arquivo à sua IA e cole o pedido pronto.
- Diga qual é o seu sistema e o que deseja integrar.
Guia atualizado em 17/10/2026 · 19 páginas · PDF. A IA precisa ter acesso ao projeto ou orientar você nas alterações. Configure sua chave somente no servidor, nunca no chat da IA.
Pedido pronto para a sua IA
Anexei o guia atualizado da API Biziva. Leia o PDF e integre ao meu sistema os recursos que eu solicitar. Primeiro identifique o projeto e o backend; use a base https://api.biziva.com.br/v1 e teste GET /models. Configure BIZIVA_API_KEY somente no servidor: não peça que eu cole a chave neste chat e não a coloque no navegador, código público ou logs. Siga os contratos do PDF para idempotência, cobrança fracionária, tarefas assíncronas e erros. Preserve as integrações existentes. Use testes simulados; antes de um teste pago, informe operação e orçamento. Se faltar acesso ao projeto, explique o próximo passo. Meu sistema é: [descreva aqui]. Quero começar com: [descreva os recursos].
API BIZIVA
Uma integração, várias capacidades.
Base independente: https://api.biziva.com.br/v1. A chave e a carteira pertencem à conta do console da API.
A integração antiga em biziva.com.br/api/v1 continua com conta e capacidades próprias. Não misture chaves ou saldos entre os dois ambientes.
Autenticação
Use Authorization: Bearer em um servidor seguro. Não exponha a chave secreta no aplicativo público. Catálogo exige catalog:read; execução exige services:create; consultas dependem dos escopos e da propriedade dos recursos.
Capacidades e caminhos
| Capacidade | Rota | Contrato resumido |
|---|
| Texto | POST /v1/chat/completions | messages, model, max_tokens; streaming quando suportado. |
| Imagem | POST /v1/images/generations | prompt e model; consulte o catálogo para opções e limites. |
| Transcrever áudio | POST /v1/audio/transcriptions | Arquivo em multipart/form-data. |
| Gerar voz | POST /v1/audio/speech | input, voice e model. |
| Vídeo com áudio | POST /v1/videos | prompt; image_url opcional. biziva-video, aproximadamente 5s, 720p. Áudio obrigatório e verificado. |
| Catálogo de vídeo | GET /v1/videos/models | Disponibilidade e preço efetivos antes de criar. |
| Voz em tempo real | POST /v1/realtime/sessions | Cria sessão e ticket único; conexão WebSocket com PCM16 24kHz mono. |
| Mídias adicionais | POST /v1/audio/music, /audio/effects, /audio/clones | Recursos sujeitos a preço e disponibilidade. Clonagem exige autorização e verificação da voz. |
| Vídeo adicional | POST /v1/videos/extended, /videos/edits, /videos/dubs | Duração/resolução e campos variam; consulte /v1/features. |
| Tradução de vídeo | POST /v1/videos/translations | video_asset_id, target_language. MP4 falado até 16MB/60s; pt/en/es/fr/de/it; sem lipsync. |
| Documentos e agentes | /v1/knowledge-bases, /agents, /agent-tools, /tickets | Recursos isolados pela conta. Importação/OCR é explícita; revisão antes de indexar. |
| Tarefas | GET /v1/tasks/{id} | Consulte estado e resultado. Não repita uma criação paga quando o resultado for incerto. |
| Capacidades | GET /v1/features; GET /v1/models | Contratos, opções e identificadores disponíveis na versão publicada. |
Exemplos de criação
Os exemplos geram consumo quando executados. Consulte disponibilidade, preço e saldo antes de enviar.
Texto
curl https://api.biziva.com.br/v1/chat/completions \
-H "Authorization: Bearer $BIZIVA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"biziva-auto","messages":[{"role":"user","content":"Resuma este procedimento."}],"max_tokens":300}'
Vídeo
curl https://api.biziva.com.br/v1/videos \
-H "Authorization: Bearer $BIZIVA_API_KEY" \
-H "Idempotency-Key: video-demo-20261017" \
-H "Content-Type: application/json" \
-d '{"model":"biziva-video","prompt":"Cafeteria tranquila ao amanhecer","audio_prompt":"Ambiente de cafeteria com xícaras e café sendo servido","audio":true,"seconds":5,"resolution":"720p","aspect_ratio":"16:9"}'
Criar sessão de voz
curl https://api.biziva.com.br/v1/realtime/sessions \
-H "Authorization: Bearer $BIZIVA_API_KEY" \
-H "Idempotency-Key: voice-demo-20261017" \
-H "Content-Type: application/json" \
-d '{"model":"biziva-realtime","voice":"marin","instructions":"Responda em português com clareza."}'
Conversa por voz
A criação retorna os dados da sessão e um ticket de conexão de uso único, que não é reemitido. Use a URL e os subprotocolos retornados; nunca coloque a chave da conta na URL. Envie input_audio_buffer.append com PCM16 24kHz mono em base64, depois input_audio_buffer.commit e response.create. Eventos de áudio chegam pelo WebSocket.
Contrato atual: até 120s por sessão, 30s de áudio de entrada, seis turnos e duas sessões pendentes por conta. Não existe reconexão automática com ticket já usado.
Cobrança, tarefas e falhas
Texto usa multiplicador 1,5×; imagem, vídeo e áudio usam 1,3×. Isso é multiplicador sobre custo, não margem líquida. Preço, câmbio, modelo e unidade devem ser consultados nos endpoints próprios. Liquidação fracionária preserva o consumo abaixo de um centavo.
Vídeo exige áudio: resultado inválido não é entregue como vídeo final. Tarefas de tradução possuem etapas cobradas separadamente; falhar depois não desfaz etapas já entregues. OCR e transcrição exigem revisão humana.
Use Idempotency-Key estável para a mesma operação. Em timeout ou envio incerto, consulte o ID antes de tentar novamente. 400: contrato inválido; 401/403: credencial/permissão; 402: saldo ou plano; 409: conflito/idempotência; 429: limite; 5xx: indisponibilidade. Leia o erro retornado e mantenha o request_id.
A Central permite revisar agentes, documentos, limites e aprovações. A pausa da Central não desliga todas as rotas diretas da API.
Abrir console