Saltar para o conteúdo principal

​
Introdução

Seedream é um serviço de imagem AI fornecido pela Ace Data Cloud, baseado no modelo de geração de imagens Seedream da ByteDance. Através da API unificada da Ace Data Cloud, você pode integrar rapidamente o Seedream usando JavaScript para realizar geração de imagens a partir de texto, edição de imagens, múltiplas resoluções, controle de marca d’água e outras funcionalidades.

​
Pré-requisitos

  • Ter uma conta Ace Data Cloud e obter o API Token
  • Ambiente Node.js 18+ ou navegador moderno

​
Uso Básico

O endpoint principal para chamar a API Seedream é: 
POST https://api.acedata.cloud/seedream/images
Este exemplo utiliza o modelo doubao-seedream-4-0-250828.
Modelos disponíveis incluem: doubao-seedream-4-5-251128, doubao-seedream-4-0-250828, doubao-seedream-3-0-t2i-250415, doubao-seededit-3-0-i2i-250628. Exemplo completo de código JavaScript: 
const response = await fetch("https://api.acedata.cloud/seedream/images", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "prompt": "um gato siamês branco sentado no parapeito da janela",
  "model": "doubao-seedream-4-0-250828",
  "size": "1K"
}),
});

const result = await response.json();
console.log(result);
Substitua YOUR_API_TOKEN pelo Token real obtido na plataforma Ace Data Cloud.

​
Tratamento da Resposta

Recomenda-se verificar o código de status da resposta e tratar erros: 
if (response.ok) {
  const result = await response.json();
  console.log("Chamada bem-sucedida:", result);
} else {
  console.error(`Falha na chamada, código de status: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

​
Encapsulamento em Node.js

Recomenda-se encapsular em uma função reutilizável: 
async function callSeedream(data) {
  const response = await fetch("https://api.acedata.cloud/seedream/images", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ACE_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(data),
  });
  if (!response.ok) throw new Error(`Erro na API: ${response.status}`);
  return response.json();
}

​
Tratamento de Erros

Códigos de erro comuns:
CódigoDescrição
401Falha na autenticação, verifique o API Token
403Saldo insuficiente ou acesso negado
429Limite de frequência de requisições excedido
500Erro interno do servidor

​
Próximos Passos