O Doubao é o modelo da ByteDance servido pelo Volcengine Ark. Este tutorial mostra como criar a conta, gerar a chave e fazer a primeira chamada, sem depender de nenhum agregador.
Antes de escrever código: o que você precisa saber
O Doubao não é uma ferramenta de chatbot pronta para o usuário final. É uma família de modelos que você acessa por API, e isso muda a ordem das coisas. Em vez de abrir um site, criar login e conversar, o caminho começa no console de nuvem da ByteDance, passa pela ativação de um modelo específico e termina em uma requisição HTTP.
Quem procura "Doubao AI" ou "Doubao API" normalmente tem um destes dois objetivos: construir um produto sobre o modelo ou comparar a relação custo-benefício com OpenAI, Anthropic e Google. Os dois cenários exigem que você entenda a estrutura de níveis antes de sair escrevendo código.
Há um detalhe que costuma travar os primeiros passos. O caminho direto pelo Volcengine Ark exige número de celular da China continental e verificação de identidade, o que inviabiliza a maior parte dos desenvolvedores brasileiros. Existe um atalho por agregadores compatíveis com o padrão OpenAI, e ele faz sentido para quem só quer testar sem passar por toda essa burocracia regional. Vamos cobrir os dois.
Os modelos Doubao que valem a sua atenção
A linha é grande. São 19 SKUs ativos em 2026, divididos entre chat, imagem e vídeo. Você não precisa decorar todos, apenas entender as quatro gerações e onde cada uma se encaixa.
Geração | Modelo de entrada | Preço de saída (por 1M tokens) | Contexto | Para quem |
|---|---|---|---|---|
Seed 2.0 | doubao-seed-2.0-pro | US$ 2,57 | 256K | Tarefas de raciocínio e código mais exigentes |
Seed 2.0 | doubao-seed-2.0-lite | US$ 0,526 | 256K | Volume alto com contexto longo |
Seed 1.6 | doubao-seed-1.6 | US$ 1,168 | 256K | Equilíbrio entre custo e capacidade |
Seed 1.6 | doubao-seed-1.6-flash | US$ 0,219 | 256K | Classificação, extração e rascunhos |
Doubao 1.5 | doubao-1.5-lite | US$ 0,088 | 32K | Só quando 32K de contexto basta |
Os valores são de lista em dólares por milhão de tokens, segundo o registro de modelos do TokenMix consultado em maio de 2026. O destaque é o doubao-seed-1.6-flash: é o piso realista da linha, com saída cerca de seis vezes mais barata que o Seed 2.0 Pro. A diferença importa quando você processa muito texto.
O Doubao 1.5 parece tentador pelo preço, mas o teto de 32K de contexto elimina a maioria dos fluxos modernos de RAG e análise de documentos longos. Para projetos novos, comece no Flash e escale só quando o trabalho justificar a diferença de custo entre as duas gerações.
Criando a chave no Volcengine Ark
Se você tem acesso ao console chinês, o caminho direto sai mais barato, porque você paga o preço de lista do fornecedor sem a margem de quem revende. O processo tem quatro etapas.
- Acesse console.volcengine.com e faça login. Sem conta, o cadastro pede número de celular da China continental e verificação de nome real.
- No menu lateral, clique em ModelArk e depois em Gerenciamento de chaves de API (API Key Management), na parte de baixo da barra.
- Clique em Criar chave de API. O sistema gera a credencial na hora.
- Clique no ícone de olho ao lado da chave para revelá-la e copie. Guarde em um cofre de segredos, nunca no código-fonte.
O passo que quase todo mundo esquece vem depois: ativar o modelo. Uma chave nova não dá acesso automático a nada.
- Na barra lateral do Ark, entre em Open Management e ative os modelos que você vai usar, como a série Doubao Seed.
- Consulte a lista de modelos na documentação oficial e anote o Model ID exato, por exemplo
doubao-seed-1.6-flash. - Cole esse ID no seu cliente ou na sua requisição. O endereço base do padrão é
https://ark.cn-beijing.volces.com/api/v3/.
Sem o passo 5, sua primeira chamada volta com erro de modelo não encontrado, mesmo com a chave correta.
O caminho alternativo por agregador
Para quem está fora da China, os agregadores compatíveis com a API da OpenAI resolvem o bloqueio de cadastro. Você faz um único registro com e-mail e acessa os mesmos modelos por um endpoint que já conhece.
O custo é que você paga um preço roteado, próximo da paridade em vez do piso do fornecedor. Em troca, ganha tempo: nenhuma verificação de identidade, nenhuma barreira regional e a possibilidade de trocar entre modelos Doubao, GPT e Claude no mesmo cliente.
Vale saber o trade-off antes de decidir. Se sua empresa tem entidade na China continental, o caminho direto compensa. Se o objetivo é prototipar rápido de São Paulo, o agregador é o atalho honesto.
Sua primeira chamada, passo a passo
O endpoint de chat do Doubao segue o padrão OpenAI e é síncrono. Imagem e vídeo funcionam de outro jeito, como tarefas assíncronas, que veremos adiante. Comece pelo texto, porque é o caminho mais simples e o que confirma se a sua chave e o seu modelo estão configurados corretamente antes de você partir para fluxos mais complexos.
A estrutura mínima de uma requisição em Python:
- Instale o cliente padrão com
pip install openai. - Crie um arquivo e defina o endereço base:
https://ark.cn-beijing.volces.com/api/v3/. - Informe sua chave de API na variável de ambiente, nunca no corpo do arquivo.
- Escolha o modelo pelo Model ID, como
doubao-seed-1.6-flash. - Monte a lista de mensagens com o papel
usere o texto do pedido. - Envie para
/chat/completionse leia o campochoices.
O código abaixo resume os passos de 2 a 6:
from openai import OpenAI
client = OpenAI(
api_key="SUA_CHAVE_AQUI",
base_url="https://ark.cn-beijing.volces.com/api/v3/",
)
resposta = client.chat.completions.create(
model="doubao-seed-1.6-flash",
messages=[{"role": "user", "content": "Resuma o mercado de IA no Brasil em 3 linhas."}],
)
print(resposta.choices[0].message.content)Se a resposta chegar, você está no ar. O temperature e os demais parâmetros funcionam como no padrão OpenAI, então o que você já sabe sobre prompts se aplica direto.
Quando a linha de código não responde
Três erros concentram a maior parte dos travamentos.
O primeiro é modelo não encontrado. Quase sempre significa que o passo de ativação no Ark foi pulado, ou que o Model ID foi copiado errado.
O segundo é erro de autenticação. Confira se a chave foi colada sem espaços e se ainda não foi revogada no console.
O terceiro é estouro de contexto. Todos os modelos de chat das gerações 1.6 e 2.0 param em 256K tokens, mas o Doubao 1.5 fica em 32K. Se o seu documento é grande, o modelo antigo corta o texto antes de responder.
Imagem e vídeo seguem outro fluxo
Aqui o padrão muda. Chat é síncrono, imagem e vídeo são assíncronos. Você envia o pedido, recebe um identificador de tarefa e depois consulta um segundo endpoint até o arquivo ficar pronto.
A linha de imagem é a Seedream, hoje na versão 5.0, com a 4.5 como geração anterior. A de vídeo é a Seedance, na versão 2.0. Diferente do chat, elas são cobradas por geração, não por token.
Esse modelo de cobrança muda o planejamento. Como o custo é por imagem ou por vídeo gerado, testes exploratórios pesam mais no orçamento do que no chat. Vale montar um roteiro de prompts antes de disparar lotes grandes.
Escolhendo o modelo certo para cada tarefa
A pergunta prática não é qual modelo é o melhor, e sim qual evita gasto desnecessário. A regra que funciona é começar barato e escalar só quando houver motivo técnico.
Use o doubao-seed-1.6-flash para classificação em massa, extração de dados e geração de rascunhos. É onde o volume acontece e onde o custo de saída de US$ 0,219 por milhão pesa pouco.
Suba para o doubao-seed-2.0-lite quando precisar de 256K de contexto com mais qualidade, típico de RAG sobre bases internas. Para raciocínio complexo e código, o doubao-seed-2.0-code e o doubao-seed-2.0-pro entram em cena.
A conta fecha quando você compara cenários. Rodar tudo no Seed 2.0 Pro custa várias vezes mais do que operar um roteador que manda 90% do tráfego para o Flash e reserva 10% para o Pro. O padrão de "comece barato, escale quando precisar" é o que separa um projeto viável de um orçamento estourado.
Perguntas frequentes sobre a API Doubao
Preciso saber chinês para usar? Não. A documentação tem versões em inglês e o endpoint segue o padrão OpenAI, então qualquer cliente compatível funciona.
O Doubao tem modo de raciocínio? Sim. Os modelos das gerações 1.6 e 2.0 suportam modo de pensamento, chamadas de ferramenta, saída em JSON e streaming, além de visão.
Ele serve para produção em português? Serve. Os modelos são multilíngues, e a qualidade em português do Brasil tem melhorado a cada geração. Teste com seus próprios textos antes de colocar em produção, porque o desempenho varia por tarefa.
Existe versão gratuita? Não há camada gratuita de API. Todo acesso é cobrado por token ou por geração, dependendo do modelo.
Se o seu objetivo é experimentar sem compromisso, comece por uma única chamada de chat no Flash. Meça a qualidade na sua tarefa real e só depois decida se vale ativar os modelos maiores. A barreira de entrada é baixa, e o custo do primeiro teste é de centavos.






