--- title: "Dublagem para Português" description: "Dubla áudio de outro idioma para o português do Brasil, preservando a voz original. Preço por faixa, a partir de R$ 7,58 por chamada." lang: pt-BR canonical: https://doc.apibrasil.io/apis/creditos/360cb5a9-dec0-11f1-98bb-bc24118aba26 markdown: https://doc.apibrasil.io/apis/creditos/360cb5a9-dec0-11f1-98bb-bc24118aba26.md source: apibrasil-documentation --- # Dublagem para Português > Dubla áudio de outro idioma para o português do Brasil, preservando a voz original. Preço por faixa, a partir de R$ 7,58 por chamada. - **Categoria:** Voz e Áudio com IA - **Cobrança:** por consulta, só com o Bearer Token - **Preço:** R$ 7,58 por consulta - **Limite:** 990.000 por mês - **Cadastro:** CPF ou CNPJ - **Versão:** v2 - **Publicada por:** APIBrasil - **Especificação OpenAPI:** https://doc.apibrasil.io/apis/creditos/360cb5a9-dec0-11f1-98bb-bc24118aba26/openapi.json ## Como chamar **Endereço base:** `https://gateway.apibrasil.io/api/v2` Autenticação: cabeçalho `Authorization: Bearer `. Nada além disso. Com `homolog: true` no corpo, o gateway responde de uma base fixa, com a forma real da resposta, e não cobra. O CPF 00000000000 é dessa base e não é de ninguém: use-o nos testes, nunca em produção. ## Endpoints (4 endpoints) **Sumário** 1. `POST /consulta/voz-dublagem/credits` 2. `POST /consulta/voz-dublagem/credits` 3. `POST /consulta/voz-dublagem/credits` 4. `POST /consulta/voz-dublagem/credits` ### 1. POST /consulta/voz-dublagem/credits ⚠️ Aviso: a dublagem é cobrada na criação, quando o identificador é devolvido (HTTP 200). Áudio acima de 1 minuto, vídeo, formato não aceito, arquivo que não pôde ser lido e áudio recusado para dublagem não são cobrados. Se a dublagem falhar depois de criada, a consulta responde com a situação falhou e o valor da criação é estornado pelo suporte. Dublar mídia de até 1 minuto: Cria a dublagem do áudio para o português do Brasil e responde na hora, sem esperar o processamento. Devolve o identificador da dublagem (job_id), a situação (situacao, que neste momento é sempre processando) e a previsão do serviço em segundos (previsao_segundos, que pode vir nula). Guarde o identificador e acompanhe com o tipo voz-dublagem-consultar, que entrega o link do áudio quando a dublagem termina. Este tipo aceita áudio de até 1 minuto, contado no conteúdo do arquivo, e nunca dubla além disso: a criação pede só os primeiros 1 minuto. Envie um POST com tipo=voz-dublagem-1min e: - audio_url (opcional, url): Link público do áudio em MP3, Ogg/Opus ou WAV sem compressão (PCM), em http ou https, com até 25 MB. Informe audio_url ou audio_base64, nunca os dois. FLAC, M4A/AAC, Ogg/Vorbis, WebM e vídeo são recusados. - audio_base64 (opcional, base64): O áudio em base64 (MP3, Ogg/Opus ou WAV sem compressão, PCM), com até 1 MiB depois de decodificado. Informe audio_url ou audio_base64, nunca os dois. FLAC, M4A/AAC, Ogg/Vorbis, WebM e vídeo são recusados. - idioma_de_origem (opcional, texto): Código de duas letras do idioma falado no áudio, como en, es ou fr. Sem este campo, ou com auto, o idioma é detectado. O valor pt é recusado: o destino da dublagem é sempre o português do Brasil. - numero_de_falantes (opcional, inteiro): Quantas pessoas falam no áudio, de 0 a 9. O padrão é 0, que deixa o serviço detectar. - variacao (opcional, inteiro): Número de 0 a 999999, sem efeito na dublagem: cada criação já cria uma dublagem nova, mesmo com o corpo igual ao de uma anterior. Respostas de erro (nenhuma é cobrada): - HTTP 400: nenhum ou os dois campos de áudio, formato não aceito, vídeo, idioma_de_origem fora do padrão ou igual a pt, numero_de_falantes fora de 0 a 9, ou áudio acima de 1 minuto (a mensagem diz a duração enviada e qual tipo comporta) - HTTP 400: o serviço de dublagem recusou o áudio: confira se há fala, se o idioma de origem está certo e se o áudio já não está em português - HTTP 502: o serviço de dublagem respondeu sem o identificador ou com erro - HTTP 503: o serviço de dublagem está indisponível ou no limite de chamadas simultâneas; tente de novo em alguns segundos - HTTP 504: a criação da dublagem passou do tempo limite Preço: R$ 7,58 por chamada. Em homologação (homolog=true), sem cobrança, a resposta traz dados fictícios no mesmo formato. Ao enviar um áudio para dublagem, você declara que tem direito sobre ele: é o autor, o titular da voz ou tem autorização de quem é, inclusive para traduzir e dublar o conteúdo. Guarde a prova dessa autorização por cinco anos: ela pode ser pedida. O áudio dublado é gerado por inteligência artificial e leva uma marca d'água inaudível, que não pode ser removida. Avise quem ouve que a voz é sintética quando a lei exigir ou quando a falta do aviso puder enganar. A dublagem não pode ser usada em filme, televisão ou serviço de streaming. O uso em redes sociais e em anúncios é permitido. O áudio é processado em servidores nos Estados Unidos. Não envie gravação com dado de saúde, número de cartão ou número de documento oficial, como o CPF. A dublagem pode ser consultada por 24 horas a partir da criação. Depois disso ela é apagada, junto com o áudio enviado, e a consulta responde 404; o link já entregue continua valendo até expira_em. A dublagem que falhou é apagada na consulta que informa a falha. O link do áudio dublado vale por 24 horas, renovadas a cada consulta da dublagem concluída dentro desse prazo. Cada criação cria uma dublagem nova, com outro job_id, e é cobrada, mesmo com o corpo igual ao de uma criação anterior: guarde o job_id de cada uma. Cada consulta lê a situação atual da dublagem. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/voz-dublagem/credits` - **Versão da rota:** v2 **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```json { "tipo": "voz-dublagem-1min", "audio_url": "https://exemplo.com.br/entrevista-em-ingles.mp3", "idioma_de_origem": "en", "numero_de_falantes": 1, "homolog": true } ``` **Em cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/consulta/voz-dublagem/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" \ -d '{"tipo":"voz-dublagem-1min","audio_url":"https://exemplo.com.br/entrevista-em-ingles.mp3","idioma_de_origem":"en","numero_de_falantes":1,"homolog":true}' ``` Este endpoint aceita `homolog: true` no corpo: a resposta volta com dados válidos, `api_limit_for` igual a `homolog` e sem tarifação. **Resposta de exemplo, do catálogo** ```json { "user": { "first_name": "[omitido]", "email": "[omitido]", "cellphone": "[omitido]", "notification": "yes" }, "balance": "392,420", "balance_before": "400,000", "tax": "7,580", "status_code": 200, "error": false, "message": "Dados validos! Voce foi tarifado em R$ 7,58.", "valor_consulta": 7.58, "api_limit_for": "credit", "homolog": false, "data": { "tipo": "voz-dublagem-1min", "job_id": "AbCdEfGhIj0123456789", "situacao": "processando", "previsao_segundos": 30 } } ``` ### 2. POST /consulta/voz-dublagem/credits ⚠️ Aviso: a dublagem é cobrada na criação, quando o identificador é devolvido (HTTP 200). Áudio acima de 3 minutos, vídeo, formato não aceito, arquivo que não pôde ser lido e áudio recusado para dublagem não são cobrados. Se a dublagem falhar depois de criada, a consulta responde com a situação falhou e o valor da criação é estornado pelo suporte. Dublar mídia de até 3 minutos: Cria a dublagem do áudio para o português do Brasil e responde na hora, sem esperar o processamento. Devolve o identificador da dublagem (job_id), a situação (situacao, que neste momento é sempre processando) e a previsão do serviço em segundos (previsao_segundos, que pode vir nula). Guarde o identificador e acompanhe com o tipo voz-dublagem-consultar, que entrega o link do áudio quando a dublagem termina. Este tipo aceita áudio de até 3 minutos, contado no conteúdo do arquivo, e nunca dubla além disso: a criação pede só os primeiros 3 minutos. Envie um POST com tipo=voz-dublagem-3min e: - audio_url (opcional, url): Link público do áudio em MP3, Ogg/Opus ou WAV sem compressão (PCM), em http ou https, com até 25 MB. Informe audio_url ou audio_base64, nunca os dois. FLAC, M4A/AAC, Ogg/Vorbis, WebM e vídeo são recusados. - audio_base64 (opcional, base64): O áudio em base64 (MP3, Ogg/Opus ou WAV sem compressão, PCM), com até 1 MiB depois de decodificado. Informe audio_url ou audio_base64, nunca os dois. FLAC, M4A/AAC, Ogg/Vorbis, WebM e vídeo são recusados. - idioma_de_origem (opcional, texto): Código de duas letras do idioma falado no áudio, como en, es ou fr. Sem este campo, ou com auto, o idioma é detectado. O valor pt é recusado: o destino da dublagem é sempre o português do Brasil. - numero_de_falantes (opcional, inteiro): Quantas pessoas falam no áudio, de 0 a 9. O padrão é 0, que deixa o serviço detectar. - variacao (opcional, inteiro): Número de 0 a 999999, sem efeito na dublagem: cada criação já cria uma dublagem nova, mesmo com o corpo igual ao de uma anterior. Respostas de erro (nenhuma é cobrada): - HTTP 400: nenhum ou os dois campos de áudio, formato não aceito, vídeo, idioma_de_origem fora do padrão ou igual a pt, numero_de_falantes fora de 0 a 9, ou áudio acima de 3 minutos (a mensagem diz a duração enviada e qual tipo comporta) - HTTP 400: o serviço de dublagem recusou o áudio: confira se há fala, se o idioma de origem está certo e se o áudio já não está em português - HTTP 502: o serviço de dublagem respondeu sem o identificador ou com erro - HTTP 503: o serviço de dublagem está indisponível ou no limite de chamadas simultâneas; tente de novo em alguns segundos - HTTP 504: a criação da dublagem passou do tempo limite Preço: R$ 22,73 por chamada. Em homologação (homolog=true), sem cobrança, a resposta traz dados fictícios no mesmo formato. Ao enviar um áudio para dublagem, você declara que tem direito sobre ele: é o autor, o titular da voz ou tem autorização de quem é, inclusive para traduzir e dublar o conteúdo. Guarde a prova dessa autorização por cinco anos: ela pode ser pedida. O áudio dublado é gerado por inteligência artificial e leva uma marca d'água inaudível, que não pode ser removida. Avise quem ouve que a voz é sintética quando a lei exigir ou quando a falta do aviso puder enganar. A dublagem não pode ser usada em filme, televisão ou serviço de streaming. O uso em redes sociais e em anúncios é permitido. O áudio é processado em servidores nos Estados Unidos. Não envie gravação com dado de saúde, número de cartão ou número de documento oficial, como o CPF. A dublagem pode ser consultada por 24 horas a partir da criação. Depois disso ela é apagada, junto com o áudio enviado, e a consulta responde 404; o link já entregue continua valendo até expira_em. A dublagem que falhou é apagada na consulta que informa a falha. O link do áudio dublado vale por 24 horas, renovadas a cada consulta da dublagem concluída dentro desse prazo. Cada criação cria uma dublagem nova, com outro job_id, e é cobrada, mesmo com o corpo igual ao de uma criação anterior: guarde o job_id de cada uma. Cada consulta lê a situação atual da dublagem. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/voz-dublagem/credits` - **Versão da rota:** v2 **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```json { "tipo": "voz-dublagem-3min", "audio_url": "https://exemplo.com.br/entrevista-em-ingles.mp3", "idioma_de_origem": "en", "numero_de_falantes": 1, "homolog": true } ``` **Em cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/consulta/voz-dublagem/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" \ -d '{"tipo":"voz-dublagem-3min","audio_url":"https://exemplo.com.br/entrevista-em-ingles.mp3","idioma_de_origem":"en","numero_de_falantes":1,"homolog":true}' ``` Este endpoint aceita `homolog: true` no corpo: a resposta volta com dados válidos, `api_limit_for` igual a `homolog` e sem tarifação. **Resposta de exemplo, do catálogo** ```json { "user": { "first_name": "[omitido]", "email": "[omitido]", "cellphone": "[omitido]", "notification": "yes" }, "balance": "377,270", "balance_before": "400,000", "tax": "22,730", "status_code": 200, "error": false, "message": "Dados validos! Voce foi tarifado em R$ 22,73.", "valor_consulta": 22.73, "api_limit_for": "credit", "homolog": false, "data": { "tipo": "voz-dublagem-3min", "job_id": "AbCdEfGhIj0123456789", "situacao": "processando", "previsao_segundos": 30 } } ``` ### 3. POST /consulta/voz-dublagem/credits ⚠️ Aviso: a dublagem é cobrada na criação, quando o identificador é devolvido (HTTP 200). Áudio acima de 5 minutos, vídeo, formato não aceito, arquivo que não pôde ser lido e áudio recusado para dublagem não são cobrados. Se a dublagem falhar depois de criada, a consulta responde com a situação falhou e o valor da criação é estornado pelo suporte. Dublar mídia de até 5 minutos: Cria a dublagem do áudio para o português do Brasil e responde na hora, sem esperar o processamento. Devolve o identificador da dublagem (job_id), a situação (situacao, que neste momento é sempre processando) e a previsão do serviço em segundos (previsao_segundos, que pode vir nula). Guarde o identificador e acompanhe com o tipo voz-dublagem-consultar, que entrega o link do áudio quando a dublagem termina. Este tipo aceita áudio de até 5 minutos, contado no conteúdo do arquivo, e nunca dubla além disso: a criação pede só os primeiros 5 minutos. Envie um POST com tipo=voz-dublagem-5min e: - audio_url (opcional, url): Link público do áudio em MP3, Ogg/Opus ou WAV sem compressão (PCM), em http ou https, com até 25 MB. Informe audio_url ou audio_base64, nunca os dois. FLAC, M4A/AAC, Ogg/Vorbis, WebM e vídeo são recusados. - audio_base64 (opcional, base64): O áudio em base64 (MP3, Ogg/Opus ou WAV sem compressão, PCM), com até 1 MiB depois de decodificado. Informe audio_url ou audio_base64, nunca os dois. FLAC, M4A/AAC, Ogg/Vorbis, WebM e vídeo são recusados. - idioma_de_origem (opcional, texto): Código de duas letras do idioma falado no áudio, como en, es ou fr. Sem este campo, ou com auto, o idioma é detectado. O valor pt é recusado: o destino da dublagem é sempre o português do Brasil. - numero_de_falantes (opcional, inteiro): Quantas pessoas falam no áudio, de 0 a 9. O padrão é 0, que deixa o serviço detectar. - variacao (opcional, inteiro): Número de 0 a 999999, sem efeito na dublagem: cada criação já cria uma dublagem nova, mesmo com o corpo igual ao de uma anterior. Respostas de erro (nenhuma é cobrada): - HTTP 400: nenhum ou os dois campos de áudio, formato não aceito, vídeo, idioma_de_origem fora do padrão ou igual a pt, numero_de_falantes fora de 0 a 9, ou áudio acima de 5 minutos (a mensagem diz a duração enviada e qual tipo comporta) - HTTP 400: o serviço de dublagem recusou o áudio: confira se há fala, se o idioma de origem está certo e se o áudio já não está em português - HTTP 502: o serviço de dublagem respondeu sem o identificador ou com erro - HTTP 503: o serviço de dublagem está indisponível ou no limite de chamadas simultâneas; tente de novo em alguns segundos - HTTP 504: a criação da dublagem passou do tempo limite Preço: R$ 37,88 por chamada. Em homologação (homolog=true), sem cobrança, a resposta traz dados fictícios no mesmo formato. Ao enviar um áudio para dublagem, você declara que tem direito sobre ele: é o autor, o titular da voz ou tem autorização de quem é, inclusive para traduzir e dublar o conteúdo. Guarde a prova dessa autorização por cinco anos: ela pode ser pedida. O áudio dublado é gerado por inteligência artificial e leva uma marca d'água inaudível, que não pode ser removida. Avise quem ouve que a voz é sintética quando a lei exigir ou quando a falta do aviso puder enganar. A dublagem não pode ser usada em filme, televisão ou serviço de streaming. O uso em redes sociais e em anúncios é permitido. O áudio é processado em servidores nos Estados Unidos. Não envie gravação com dado de saúde, número de cartão ou número de documento oficial, como o CPF. A dublagem pode ser consultada por 24 horas a partir da criação. Depois disso ela é apagada, junto com o áudio enviado, e a consulta responde 404; o link já entregue continua valendo até expira_em. A dublagem que falhou é apagada na consulta que informa a falha. O link do áudio dublado vale por 24 horas, renovadas a cada consulta da dublagem concluída dentro desse prazo. Cada criação cria uma dublagem nova, com outro job_id, e é cobrada, mesmo com o corpo igual ao de uma criação anterior: guarde o job_id de cada uma. Cada consulta lê a situação atual da dublagem. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/voz-dublagem/credits` - **Versão da rota:** v2 **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```json { "tipo": "voz-dublagem-5min", "audio_url": "https://exemplo.com.br/entrevista-em-ingles.mp3", "idioma_de_origem": "en", "numero_de_falantes": 1, "homolog": true } ``` **Em cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/consulta/voz-dublagem/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" \ -d '{"tipo":"voz-dublagem-5min","audio_url":"https://exemplo.com.br/entrevista-em-ingles.mp3","idioma_de_origem":"en","numero_de_falantes":1,"homolog":true}' ``` Este endpoint aceita `homolog: true` no corpo: a resposta volta com dados válidos, `api_limit_for` igual a `homolog` e sem tarifação. **Resposta de exemplo, do catálogo** ```json { "user": { "first_name": "[omitido]", "email": "[omitido]", "cellphone": "[omitido]", "notification": "yes" }, "balance": "362,120", "balance_before": "400,000", "tax": "37,880", "status_code": 200, "error": false, "message": "Dados validos! Voce foi tarifado em R$ 37,88.", "valor_consulta": 37.88, "api_limit_for": "credit", "homolog": false, "data": { "tipo": "voz-dublagem-5min", "job_id": "AbCdEfGhIj0123456789", "situacao": "processando", "previsao_segundos": 30 } } ``` ### 4. POST /consulta/voz-dublagem/credits ⚠️ Aviso: a consulta é cobrada quando a situação é devolvida (HTTP 200), em qualquer das três situações. Identificador fora do padrão, dublagem que não existe ou que é de outra conta, dublagem pronta mais longa que a faixa comprada na criação e falha ao buscar o áudio não são cobrados. Consultar o andamento e baixar a dublagem: Diz em que situação está uma dublagem criada pela sua conta e, quando ela termina, entrega o áudio dublado. A resposta traz sempre o identificador (job_id) e a situação (situacao): processando, quando ainda não terminou (consulte de novo em alguns segundos); concluida, com o link do áudio (audio_url), o tipo do arquivo (tipo_mime), o tamanho em bytes (tamanho_bytes), a duração em segundos (duracao_segundos) e a validade do link (expira_em); ou falhou, com um aviso de que a dublagem não será entregue e de que a cobrança da criação deve ser estornada pelo suporte. Envie um POST com tipo=voz-dublagem-consultar e: - job_id (obrigatório, texto): O identificador devolvido no campo job_id quando a dublagem foi criada (de 10 a 40 letras e dígitos). Respostas de erro (nenhuma é cobrada): - HTTP 400: o campo job_id não veio ou não tem de 10 a 40 letras e dígitos - HTTP 400: a dublagem pronta ficou mais longa que a faixa comprada na criação: o arquivo não é entregue; crie a dublagem de novo no tipo que comporta a duração do áudio - HTTP 404: a dublagem não existe, não foi criada pela sua conta ou já foi apagada (24 horas depois da criação, ou depois de informada a falha) - HTTP 502: o serviço de dublagem respondeu com erro ou sem o áudio da dublagem concluída - HTTP 503: o serviço de dublagem está indisponível ou no limite de chamadas simultâneas; tente de novo em alguns segundos - HTTP 504: a consulta passou do tempo limite Preço: R$ 0,01 por chamada. Em homologação (homolog=true), sem cobrança, a resposta traz dados fictícios no mesmo formato. Ao enviar um áudio para dublagem, você declara que tem direito sobre ele: é o autor, o titular da voz ou tem autorização de quem é, inclusive para traduzir e dublar o conteúdo. Guarde a prova dessa autorização por cinco anos: ela pode ser pedida. O áudio dublado é gerado por inteligência artificial e leva uma marca d'água inaudível, que não pode ser removida. Avise quem ouve que a voz é sintética quando a lei exigir ou quando a falta do aviso puder enganar. A dublagem não pode ser usada em filme, televisão ou serviço de streaming. O uso em redes sociais e em anúncios é permitido. O áudio é processado em servidores nos Estados Unidos. Não envie gravação com dado de saúde, número de cartão ou número de documento oficial, como o CPF. A dublagem pode ser consultada por 24 horas a partir da criação. Depois disso ela é apagada, junto com o áudio enviado, e a consulta responde 404; o link já entregue continua valendo até expira_em. A dublagem que falhou é apagada na consulta que informa a falha. O link do áudio dublado vale por 24 horas, renovadas a cada consulta da dublagem concluída dentro desse prazo. Cada criação cria uma dublagem nova, com outro job_id, e é cobrada, mesmo com o corpo igual ao de uma criação anterior: guarde o job_id de cada uma. Cada consulta lê a situação atual da dublagem. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/voz-dublagem/credits` - **Versão da rota:** v2 **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```json { "tipo": "voz-dublagem-consultar", "job_id": "AbCdEfGhIj0123456789", "homolog": true } ``` **Em cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/consulta/voz-dublagem/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" \ -d '{"tipo":"voz-dublagem-consultar","job_id":"AbCdEfGhIj0123456789","homolog":true}' ``` Este endpoint aceita `homolog: true` no corpo: a resposta volta com dados válidos, `api_limit_for` igual a `homolog` e sem tarifação. **Resposta de exemplo, do catálogo** ```json { "user": { "first_name": "[omitido]", "email": "[omitido]", "cellphone": "[omitido]", "notification": "yes" }, "balance": "399,990", "balance_before": "400,000", "tax": "0,010", "status_code": 200, "error": false, "message": "Dados validos! Voce foi tarifado em R$ 0,01.", "valor_consulta": 0.01, "api_limit_for": "credit", "homolog": false, "data": { "tipo": "voz-dublagem-consultar", "job_id": "AbCdEfGhIj0123456789", "situacao": "concluida", "audio_url": "https://gateway.apibrasil.io/proxy/?u=https%3A%2F%2Fvoz-dublagem.apidocumentos.com.br%2Faudio%2Fdublagem-0f1e2d3c4b5a49788796a5b4c3d2e1f0", "tipo_mime": "audio/mpeg", "tamanho_bytes": 121600, "duracao_segundos": 7.6, "expira_em": "2026-11-13T15:00:00-03:00" } } ``` Nos exemplos de resposta, os campos da conta que gerou o exemplo (`user.first_name`, `user.email`, `user.cellphone`) saem como `[omitido]`. O resto é o que o catálogo publica. ## Armadilhas: o que uma integração erra sem avisar Apuradas nas respostas que o próprio catálogo publica. Em todas elas o código funciona no caminho feliz e falha em silêncio no resto: 1. **O erro chega no CORPO, com HTTP 200.** A resposta traz um campo `error` booleano e uma `message`. Checar só `response.ok` ou o status HTTP deixa passar falha como sucesso. Confira SEMPRE `error === false` antes de ler `data`. 2. **`balance`, `tax` e `extra_charges.total` são STRING em formato brasileiro — e o formato varia entre APIs.** Valores observados no catálogo: `"154,380"`, `"497,84"`, `"0,000"` e `"0.19"`. Vírgula em umas, ponto em outra; três casas decimais em umas, duas em outra. Em JavaScript, `parseFloat("154,380")` devolve `154` e perde os centavos sem erro nenhum, e `Number("154,380")` devolve `NaN`. Escreva um conversor que trate os dois separadores, e nunca use esses campos numa decisão financeira sem convertê-los. 3. **Cada chamada custa dinheiro.** Retry cego multiplica a conta. Nunca repita automaticamente um 4xx: parâmetro errado repetido continua errado e continua cobrando. Repita só tempo esgotado e 5xx, com recuo exponencial e um teto pequeno de tentativas. 4. **HTTP 402 é saldo insuficiente, e repetir não resolve.** É o único status que exige ação humana — recarregar. Trate-o como erro terminal, com mensagem própria, e não o jogue no mesmo balde dos 4xx genéricos. 5. **`extra_charges` cobra à parte do preço da consulta.** Quando o corpo pede serviços adicionais, a resposta traz cada um com o preço e um `total` que NÃO está incluso no valor base. Se você mostra custo a quem usa, some os dois. ## Ver também - Especificação OpenAPI: https://doc.apibrasil.io/apis/creditos/360cb5a9-dec0-11f1-98bb-bc24118aba26/openapi.json - Catálogo de APIs: [Catálogo de APIs](https://doc.apibrasil.io/apis.md) - SDKs oficiais: [SDKs oficiais](https://doc.apibrasil.io/sdks.md) - Índice da documentação: https://doc.apibrasil.io/llms.txt - Versão HTML desta página: https://doc.apibrasil.io/apis/creditos/360cb5a9-dec0-11f1-98bb-bc24118aba26