Na compra corporativa da API Doubao, o padrão comum é validar primeiro com uma conta pessoal e só depois correr atrás de contrato e nota fiscal. Na fase de protótipo não há problema, mas ao conectar o negócio aparecem três falhas: o titular da conta não é a empresa, as Keys não têm fronteira de permissão e ninguém revisou os termos de dados. A API Doubao é operada pelo Volcano Ark, e o objeto de compra é a combinação "serviço de modelo + conta + contrato".

Nota: Doubao, Volcano Ark e Volcano Engine são marcas da ByteDance e de empresas associadas. Este artigo é apenas uma referência técnica de compra, não constitui parecer jurídico e não implica vínculo de subordinação, representação ou parceria com os titulares das marcas. Preços, cotas e termos seguem as páginas do fornecedor, o contrato assinado e a página de preços do site.

1. Divida o checklist em cinco blocos

Módulo Perguntas a confirmar Materiais a entregar
Titular e conta Titular do contrato, administradores Documentos de verificação, registro de contas
Permissões e Keys Uma Key por aplicação Usuários IAM, políticas, lista de Keys
Cota e limitação Cota gratuita, pico Modelo de uso, configuração de alertas
Dados e segurança de conteúdo Treinamento e responsabilidade de revisão Termos, acordos, fluxo de tratamento
Custo e nota fiscal Forma de cobrança, emissão Planilha de orçamento, contrato, nota fiscal

2. Titular e conta: a empresa não deve usar conta pessoal

  1. Registre-se com e-mail do domínio da empresa, conclua a verificação e vincule o CNPJ.
  2. Use a conta principal apenas para finanças e administração; crie subusuários IAM por aplicação.
  3. Conceda aos subusuários apenas o menor privilégio e não compartilhe administradores.
  4. Crie, rotacione e revogue Keys no console IAM; trate imediatamente desligamentos e baixas.
  5. Ative autenticação multifator e mantenha logs de auditoria.

A documentação IAM do Volcano Ark distingue dois tipos de Key: as criadas no console IAM pertencem ao subusuário e exigem anexação manual de políticas do Ark; as criadas no console do Ark já vêm com políticas predefinidas. As primeiras são mais adequadas para governança de permissões. Em qualquer caso, a Key não deve entrar no front-end, no repositório de código ou em conversas.

3. Cota e limitação: cota gratuita não é cota de compra

A cota gratuita para novos usuários serve para validação, não para planejamento de capacidade. A compra precisa distinguir quatro tipos de número: a cota gratuita é calculada por modelo, compartilhada entre conta principal e subcontas, cobre apenas tokens de inferência online e não inclui plugins, base de conhecimento, lote e armazenamento de cache; a limitação de nível de modelo inclui RPM, TPM, TPD, IPM e concorrência em andamento, definidos pela plataforma, com aumento por ticket; a limitação de nível de terminal pode ser ajustada na página de detalhes; ao atingir o teto de uso, o serviço é pausado, e esse teto é incompatível com parte dos recursos de cache e de baixa latência.

Antes da compra, peça à área de negócio os valores de pico de RPM, TPM e os comprimentos máximos de entrada e saída. Após o lançamento, monitore sobretudo o 429: ServerOverloaded pede backoff, RequestBurstTooFast pede subida mais lenta, e SetLimitExceeded indica cota esgotada. O Volcano Ark permite enfileirar requisições com X-Ark-Max-Wait-Timeout-Ms, adequado a tarefas não em tempo real, mas é preciso aumentar o timeout.

4. Dados e conformidade: transforme explicações verbais em cláusulas

Os termos específicos do Volcano Ark informam que, sem consentimento individual, a plataforma não armazena nem usa dados do cliente para treinar ou otimizar modelos; os dados podem ser tratados por revisão de conformidade, diagnóstico de falha ou alerta de chamada anormal; a plataforma faz estatísticas agregadas, mas não retém os dados originais do cliente. A empresa ainda precisa confirmar seis pontos:

  1. Se o sandbox de alta segurança está ativado e se os dados são transmitidos ao fornecedor do modelo.
  2. Se o modelo é proprietário, aberto ou ajustado, e quais termos se aplicam a cada caso.
  3. Titularidade, escopo de uso, retenção e exclusão dos dados de ajuste fino.
  4. Se há transferência transfronteiriça e se é necessária avaliação específica.
  5. Se é possível assinar contrato corporativo, acordo de processamento de dados e acordo de confidencialidade.
  6. Prazo de notificação de incidentes de segurança, fluxo de tratamento e disponibilidade de relatórios de auditoria.

Dois avisos especiais. Primeiro, modelo com ajuste fino não significa "modelo de propriedade da empresa": os termos geralmente concedem apenas uso exclusivo após pagamento, e o modelo continua implantado na plataforma, sem entrega de código-fonte e parâmetros. Segundo, os termos não têm prazo geral de retenção; a empresa deve guardar os próprios logs e definir em contrato a obrigação de exclusão. Dados sensíveis devem ser anonimizados antes.

5. Segurança de conteúdo: capacidade da plataforma e responsabilidade da aplicação são coisas distintas

Os modelos Doubao têm mecanismos básicos de segurança, e o Volcano Ark oferece guardrails de conteúdo que podem ser configurados no terminal para revisar entrada e saída. A solução padrão usa os mecanismos da plataforma; empresas que precisam de políticas mais detalhadas podem contratar o serviço de controle de conteúdo do Volcano Engine. Requisições bloqueadas retornam um erro com identificador Detection, acompanhado de etiqueta de revisão e request ID.

Mas "a plataforma tem guardrails" não significa "a empresa não tem responsabilidade de revisão". Até a documentação consultada para este artigo, os guardrails personalizados cobrem principalmente geração de imagem, vídeo e 3D; negócios de texto ainda precisam, na camada de aplicação, de filtro de palavras sensíveis, validação estruturada e revisão humana. Na compra, deixe claro: quem mantém a política de revisão, como contestar bloqueios indevidos, por quanto tempo os logs são mantidos e quem trata conteúdo irregular.

6. Custo, contrato e nota fiscal

A cobrança da API Doubao não é um preço unitário multiplicado por tokens. As variáveis incluem: entrada e saída cobradas separadamente, alguns modelos com faixas por comprimento de entrada, entrada de áudio com preço próprio, preço de acerto de cache, taxa de armazenamento de cache, preço de inferência em lote, preço de treinamento e inferência de ajuste fino, unidades de modelo e inferência de baixa prioridade. Alguns modelos de terceiros têm diferença entre pico e vale.

Controle o custo nesta ordem:

  1. Escalonar modelos: modelos leves para classificação, extração e reescrita; modelos principais para raciocínio complexo.
  2. Comprimir entrada e estabilizar prefixo: recuperar apenas trechos relevantes, resumir o histórico e fixar o prompt.
  3. Limitar saída: definir comprimento máximo e exigir resultados estruturados.
  4. Agrupar tarefas offline: anotação e resumo em inferência em lote, geralmente com custo menor; tarefas não em tempo real podem usar baixa prioridade.
  5. Definir tetos de uso: tanto no nível de modelo quanto no de terminal.
  6. Consolidar a fatura por Key: separar custos por API Key ID ou por projeto.

Para pagamento corporativo, prefira transferência bancária e guarde contrato, pedido, comprovante e nota fiscal. A nota é emitida apenas para serviços contratados com sucesso ou faturas já geradas; adiantamentos não consumidos não podem ser faturados; reembolso de valor já faturado exige primeiro o processo de estorno da nota; a alíquota muda conforme a política, e o preço antes de impostos normalmente permanece. Prevalece a central de custos.

Ao usar vários modelos, um gateway de IA nacional pode unificar fatura e nota em RMB, mas é preciso confirmar mais uma camada de dependência de serviço e termos de dados. A página de preços serve apenas de referência; os preços mudam.

7. Aceite do piloto: duas semanas para decidir a ampliação

  1. Escolha um cenário real, mas não crítico, e defina quatro métricas: taxa de sucesso, latência P95, proporção de 429 e custo por tarefa.
  2. Use a cota gratuita ou um pequeno volume pós-pago para validar autenticação, streaming e códigos de erro.
  3. Conecte de 5% a 10% do tráfego em lançamento gradual, teste RPM e TPM de pico e confirme que limitação e alertas funcionam.
  4. Teste a política de segurança de conteúdo com amostras sensíveis, registrando taxa de bloqueio indevido e tempo de tratamento.
  5. Peça ao jurídico e à segurança para revisar termos, acordo de processamento de dados e retenção de logs, e confira a fatura.
  6. Ensaie uma degradação: com o modelo principal indisponível, troque para o modelo ou gateway alternativo.

O script abaixo serve para o teste de fumaça antes do lançamento, verificando Key, nome do modelo e campos de uso:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ARK_API_KEY"],
    base_url=os.environ["ARK_BASE_URL"],  # endereço direto ou do gateway conforme a documentação
)

resp = client.chat.completions.create(
    model=os.environ["ARK_MODEL"],
    messages=[{"role": "user", "content": "Responda apenas OK"}],
    max_tokens=16,
    stream=False,
)

print(resp.model)
print(resp.choices[0].message.content)
print(resp.usage)

O teste de fumaça prova apenas que "a chamada funciona", não que "há capacidade para suportar volume". O aceite real depende da taxa de erro, da distribuição de latência e da fatura no período de lançamento gradual.

Perguntas frequentes

A compra corporativa do Doubao exige conta com verificação de pessoa jurídica?

Quando há pagamento por transferência, contrato e nota fiscal, recomenda-se conta com verificação de pessoa jurídica. Conta pessoal serve para validação, não para assumir o negócio da empresa.

A cota gratuita pode ser usada no aceite de produção?

Pode ser usada para validação funcional, mas não como capacidade de produção. A cota gratuita tem limitação e escopo restritos e é pausada ao esgotar.

A API Doubao usa dados corporativos para treinamento?

Os termos da plataforma informam que, sem consentimento individual, os dados não são usados para treinamento ou otimização, mas os termos podem variar por tipo de modelo, ativação do sandbox de alta segurança e ajuste fino. Prevalecem o contrato assinado e os termos do fornecedor.

A revisão de conteúdo é responsabilidade da plataforma ou da empresa?

A plataforma oferece mecanismos básicos de segurança e guardrails opcionais, mas a empresa continua responsável por entrada e saída, política de revisão e tratamento de irregularidades. Aplicações de texto precisam especialmente de revisão na camada de aplicação.

Como escolher entre conexão direta e gateway de IA?

Para equipes que usam apenas Doubao, já concluíram a verificação corporativa e têm processo financeiro simples, a conexão direta é mais curta; para quem precisa de entrada multi-modelo, fatura em RMB e nota fiscal, o gateway simplifica. Custos seguem a página de preços.

Próximos passos

Faça primeiro um piloto de duas semanas para validar resultado das tarefas, limitação e fatura, e só então defina o volume de compra. Para comparar o Doubao com outros modelos na mesma interface, crie uma Key de teste no ZSQH AI Gateway; modelos, preços e termos seguem a página de preços e a documentação do fornecedor.

Leitura relacionada: