Família Doubao Seed

Os modelos de texto Doubao Seed da ByteDance, incluindo Seed 2.1 Pro, Seed 2.1 Turbo, Seed Evolving e Seed Character. São chamados pela API compatível com OpenAI e, exceto o Seed Character, também suportam o endpoint nativo da Anthropic, podendo ser usados no Claude Code. Os modelos de geração de imagens do Doubao estão em Seedream (Doubao), e os de vídeo, em Seedance.

Tarefas comuns

Modelos

A lista completa de modelos e os preços atualizados estão na página de modelos . O prefixo dos IDs de modelo é volcengine/ e pode ser omitido; usar os prefixos bytedance/ ou doubao/, ou os nomes de modelo com data do Volcano Engine Ark, retorna 404.

Esses modelos são oferecidos pelo Volcano Engine (volcengine) e todos suportam os endpoints Chat Completions e Responses.

Exemplos de chamada

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="volcengine/doubao-seed-2.1-pro",
    messages=[{"role": "user", "content": "Explique em uma frase o que é idempotência."}],
    extra_body={"thinking": {"type": "disabled"}},
)
print(resp.choices[0].message.content)

curl https://api.ofox.io/v1/chat/completions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "volcengine/doubao-seed-2.1-pro",
    "messages": [{"role": "user", "content": "Explique em uma frase o que é idempotência."}],
    "thinking": {"type": "disabled"}
  }'

Thinking profundo

• thinking.type aceita enabled e disabled; enviar auto retorna 400.
• Em nossos testes com “Explique em uma frase o que é idempotência.”: o Seed 2.1 Pro gerou por padrão cerca de 1500 tokens de thinking e levou cerca de 40 segundos; o Seed Evolving, cerca de 1700 tokens e cerca de 54 segundos. Com o thinking desativado, a resposta veio em cerca de 2 segundos.
• Os tokens de thinking contam em max_tokens. Se o limite for muito baixo, content pode vir vazio, com finish_reason igual a length.
• Os tokens de thinking são cobrados pelo preço de saída, e a quantidade aparece em usage.completion_tokens_details.reasoning_tokens.

Ler o conteúdo do thinking: em respostas com streaming, ele fica em delta.reasoning_content; em respostas sem streaming, fica em message.reasoning_details, e é preciso concatenar o text de cada item na ordem.

Usar no Claude Code

Seed 2.1 Pro, Seed 2.1 Turbo e Seed Evolving suportam o endpoint nativo da Anthropic, no endereço https://api.ofox.io/anthropic:

• Pelo endpoint Anthropic, sem o parâmetro thinking, o conteúdo do thinking não é retornado. Quando precisar de thinking, envie "thinking": {"type": "enabled", "budget_tokens": 2000} ou {"type": "adaptive"}; o conteúdo do thinking é retornado em blocos thinking.
• O Seed Character não suporta o endpoint Anthropic, e a chamada retorna protocol_not_supported.

Os passos completos de configuração do Claude Code estão em Configuração do Claude Code.

Entrada de imagem e saída estruturada

• Entrada de imagem: todos os modelos acima aceitam entrada de imagem pelo bloco de conteúdo padrão image_url; o formato está em Visão. O link da imagem precisa poder ser baixado rapidamente pela internet pública; caso contrário, a resposta é Timeout while downloading url. Também é possível usar dados em base64.
• Saída estruturada: response_format aceita json_schema e json_object; o formato está em Saída estruturada.
• Chamada de ferramentas: usa o parâmetro padrão tools e retorna tool_calls.

Erros comuns

Outros erros gerais estão em Tratamento de erros.

Documentação oficial

• Volcano Engine Ark · Documentação 

Perguntas frequentes