Muitas pessoas pesquisam "API Doubao gratuita" querendo uma entrada sem custo para uso prolongado. Na prática, o Volcano Ark oferece a novos usuários uma cota de inferência gratuita de uso único: tem escopo, tem mecanismo de parada ao esgotar e não é uma versão gratuita com chamadas ilimitadas. Tratar a "cota gratuita" como "modelo gratuito" é a principal causa de problemas mais adiante.

Nota: Doubao, Volcano Ark e Volcano Engine são marcas da ByteDance e de empresas associadas. Este artigo é apenas uma explicação técnica e uma referência de seleção, sem vínculo de subordinação, representação ou parceria com os titulares das marcas. Cotas, modelos e preços podem mudar; consulte o console do Volcano Engine, a documentação do fornecedor e a página de preços do site.

1. O que é o "gratuito" da API Doubao

Até outubro de 2026, a capacidade gratuita do Volcano Ark tem principalmente duas camadas:

A primeira é a cota gratuita de inferência para novos usuários. Após o cadastro no Volcano Engine, alguns modelos incluem uma quantidade de chamadas gratuitas. A documentação do fornecedor não apresenta um número único para todos os modelos; a cota é calculada por modelo, compartilhada entre conta principal e subcontas, e também compartilhada entre modelo base e versão com ajuste fino.

A segunda é o modo de experiência assistida. É um interruptor no nível da conta, destinado a contas com verificação concluída que nunca ativaram o serviço de modelos; a documentação informa uma cota de experiência de 500 mil tokens. Quando ativado, consome apenas a cota gratuita e, perto do esgotamento, o serviço é pausado automaticamente, sem gerar cobrança; ao esgotar, normalmente retorna HTTP 429 com SetLimitExceeded. O modo vem desativado por padrão e, uma vez desativado, não pode ser reativado.

Nenhuma das duas camadas é um "plano gratuito permanente". Elas se parecem mais com uma amostra: suficiente para validar o fluxo do negócio, mas insuficiente para sustentar tráfego de produção por longo prazo.

2. O que a cota gratuita cobre e o que não cobre

A cota gratuita desconta apenas "custos de inferência online com pagamento por token", incluindo tokens de cache com acerto, cache sem acerto e saída. O que passa despercebido é o que ela não cobre:

Item de custo Normalmente coberto pela cota gratuita Atenção na compra
Tokens de inferência online Sim Acerto, não acerto e saída são cobrados separadamente
Plugins e base de conhecimento Não Podem ter cobrança própria
Inferência em lote Não O processamento em lote tem critério próprio
Armazenamento de cache de contexto Não Cobrado por hora, separadamente
Treinamento de ajuste fino Não Treinamento e inferência são cobrados à parte
Geração de imagem, vídeo e 3D Conforme o console Pode ser por unidade ou por peça, não por token

Além disso, o modo de experiência assistida cobre a maioria dos modelos, mas exclui modelos de embedding multimodal e de interpretação simultânea. Em aplicações de recuperação aumentada ou multimodais, não presuma que todas as chamadas estão dentro da cota gratuita.

3. Limitação: cota gratuita não significa concorrência gratuita

A cota gratuita resolve "se há custo"; a limitação resolve "se é possível chamar de forma estável". O Volcano Ark define limites de RPM, TPM, TPD, IPM e concorrência por modelo. O limite de nível de modelo é definido pela plataforma; o de nível de terminal pode ser ajustado pelo cliente, e o aumento geralmente exige abertura de ticket. Modelos leves costumam ter limites padrão mais folgados; consulte a lista de modelos e a página de ativação.

Há três códigos de erro comuns: ServerOverloaded indica recursos pressionados; RequestBurstTooFast indica subida de tráfego rápida demais; SetLimitExceeded indica cota gratuita esgotada. Os três são HTTP 429, mas os dois primeiros pedem backoff ou suavização do tráfego, enquanto o último só se resolve com recuperação da cota ou migração para pago.

Não enfrente o 429 com "repetir imediatamente". Requisições com falha também podem consumir cota, e quanto mais se repete, pior fica. O mais seguro é organizar filas, aplicar backoff exponencial com jitter e ter um modelo de degradação. O script abaixo registra tokens e tipo de erro de cada chamada, para que em uma semana se possa avaliar se a cota basta:

import os, time, json
from openai import OpenAI

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

def call(prompt: str) -> dict:
    start = time.time()
    try:
        resp = client.chat.completions.create(
            model=os.environ["ARK_MODEL"],
            messages=[{"role": "user", "content": prompt}],
            max_tokens=512,
        )
        usage = resp.usage
        return {
            "ok": True,
            "seconds": round(time.time() - start, 3),
            "prompt_tokens": usage.prompt_tokens,
            "completion_tokens": usage.completion_tokens,
        }
    except Exception as exc:
        return {
            "ok": False,
            "seconds": round(time.time() - start, 3),
            "error": type(exc).__name__,
            "detail": str(exc)[:200],
        }

if __name__ == "__main__":
    for i in range(5):
        print(json.dumps(call("Explique em uma frase o que é limitação de taxa"), ensure_ascii=False))

Consolide os resultados por dia e observe três coisas: tokens médios diários, proporção de 429 e tokens médios por tarefa. Se a cota gratuita basta ou não é uma decisão de dados, não de sensação.

4. Termos de dados: gratuito não significa sem restrições

Requisições dentro da cota gratuita também passam pela plataforma. Os termos específicos do Volcano Ark informam que, sem consentimento individual do cliente, 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 iniciado pelo cliente ou alerta de chamada anormal; a plataforma faz estatísticas agregadas, mas não retém os dados originais do cliente.

Ainda assim, há pontos a confirmar: se o sandbox de alta segurança está ativado, o que determina se os dados são entregues ao fornecedor do modelo; sem ele, aplicam-se os termos do fornecedor do modelo. Os termos não estabelecem prazo geral de retenção nem prazo de exclusão, e o cliente precisa guardar os próprios logs. Modelos proprietários, modelos abertos, ajuste fino e processamento em lote têm regras de dados diferentes. O teste gratuito não é motivo para pular a revisão de conformidade.

5. Para que a faixa gratuita serve

A cota gratuita é mais adequada para "validação" e cenários internos de baixo risco:

  • Integração de interface: confirmar autenticação, timeout, saída em streaming e códigos de erro.
  • Iteração de prompts: executar dezenas a centenas de vezes com tarefas reais, observando estabilidade e consumo de tokens.
  • Seleção de modelo: comparar desempenho de modelos principais, leves, de tradução e de persona.
  • Ferramentas internas: resumo de reuniões, classificação de documentos e extração de campos, com baixa concorrência e possibilidade de revisão.

Por outro lado, os cenários abaixo não devem depender da cota gratuita:

  • Interfaces de produção voltadas ao cliente, que exigem estabilidade e limite de responsabilidade.
  • Alta concorrência, contexto longo e processamento em lote, em que a cota se esgota muito mais rápido do que o esperado.
  • Tarefas com dados pessoais, contratos, código e dados financeiros, que precisam passar antes pela revisão de conformidade.
  • Compras corporativas que exigem nota fiscal, contrato, SLA ou pagamento por transferência.

6. Principais riscos da cota gratuita

O primeiro é esgotamento sem margem: o modo de experiência assistida pausa o serviço diretamente, e o negócio pode ser interrompido sem aviso de cobrança. O segundo é descontinuação de modelo: a lista de modelos marca os "em breve descontinuados", e o modelo disponível na faixa gratuita pode não ser o principal no longo prazo. O terceiro é limitação e picos de tráfego: campanhas ou rastreadores acionam 429 com facilidade. O quarto é Key compartilhada: uma Key de origem desconhecida não permite rastrear responsabilidade e pode violar os termos da plataforma. O quinto é mudança de termos e preços: cota, escopo de modelos e forma de cobrança podem ser ajustados.

7. Passos para migrar do gratuito para o pago

  1. Registre por uma semana, com tráfego real, tokens, proporção de 429 e custo por tarefa.
  2. Conclua a verificação de pessoa jurídica e confirme titular do contrato, pagamento e tipo de nota fiscal.
  3. Ative os modelos em "gestão de ativação"; a cota gratuita restante continua sendo descontada primeiro.
  4. Defina tetos de uso por modelo e por terminal, para que experimentos não estourem o orçamento.
  5. Configure alertas de saldo, consumo e taxa de erro.
  6. Faça um lançamento gradual com 5% a 10% do tráfego de produção, observando latência, erros e fatura.
  7. Prepare um modelo ou canal alternativo e ensaie uma troca.
  8. Após estabilizar, amplie o tráfego e revise mensalmente preço unitário, acerto de cache e versão do modelo.

Equipes que precisam de entrada unificada para vários modelos, fatura em RMB e nota fiscal podem criar uma Key de teste no ZSQH AI Gateway e comparar o Doubao com outros modelos na mesma interface. Preços e modelos disponíveis seguem a página de preços; não use números de artigos antigos no orçamento.

Perguntas frequentes

A API Doubao tem uma versão gratuita de longo prazo?

Não há uma versão gratuita que possa ser usada como dependência padrão de longo prazo. As capacidades gratuitas públicas são principalmente a cota de inferência para novos usuários e o modo de experiência assistida, ambos com limites de elegibilidade ou de cota; a continuidade depende da página do fornecedor.

Os 500 mil tokens são compartilhados por todos os modelos?

A documentação descreve o modo de experiência assistida como uma cota no nível da conta, enquanto a cota gratuita de inferência é calculada por modelo; os dois critérios não são totalmente equivalentes. O saldo real deve ser conferido na página de gestão de ativação; não planeje capacidade supondo "500 mil por modelo".

A cobrança começa automaticamente quando a cota gratuita acaba?

No modo de experiência assistida, não: o serviço é pausado e retorna 429. Ao desativar esse modo ou ativar o modelo, o excedente passa a ser cobrado no modelo pós-pago.

A cota gratuita pode ser usada em inferência em lote?

Normalmente não. A cota cobre apenas tokens de inferência online; inferência em lote, plugins, base de conhecimento e armazenamento de cache têm critérios próprios.

A faixa gratuita e a paga usam o mesmo modelo?

Na maioria dos casos, são os mesmos endpoints de modelo, mas escopo, limitação e funcionalidades podem diferir. No teste, observe o nome real do modelo na resposta e valide contexto longo, chamada de ferramentas e saída estruturada.

Próximos passos

Use primeiro a cota gratuita para validar a interface e os prompts, depois calcule o custo mensal com tráfego real e só então decida entre conexão direta e gateway. Para fatura unificada e comparação de vários modelos, comece pelo cadastro no ZSQH AI Gateway; modelos e preços seguem a página de preços.

Leitura relacionada: