• Nome
• Faixa etária e apresentação
• Silhueta do cabelo
• Cores características da roupa
• Um acessório distintivo
• Imagem de referência principal
• Referências opcionais de lado e em três quartos

Neste exemplo, o papel é de um mensageiro com cabelo curto e escuro, uma capa de chuva amarela e uma bolsa carteiro vermelha. Esses detalhes são compactos o suficiente para repetir e distintos o bastante para auditar.

Etapa 1: Prepare o Ambiente do Servidor

Use Node.js 20 ou mais recente para que fetch, FormData e Blob estejam disponíveis. Mantenha a chave em uma variável de ambiente exclusiva do servidor.

export LLAMAGEN_API_KEY="your_server_side_key"

Não exponha essa chave em um bundle de navegador, aplicativo móvel, repositório público ou solicitação no lado do cliente. Se o seu produto tiver um frontend, envie o briefing do usuário para o seu próprio backend e deixe que esse backend chame a LlamaGen.AI.

O fluxo de trabalho tem quatro operações de rede:

Etapa 2: Execute o Guia Rápido em TypeScript

Salve o seguinte como comic-quickstart.ts, coloque uma imagem do personagem em ./courier-reference.png e execute-o a partir do ambiente do seu servidor.

import { basename } from "node:path";
import { readFile } from "node:fs/promises";
import { randomUUID } from "node:crypto";

const API_BASE = "https://api.llamagen.ai";
const API_KEY = process.env.LLAMAGEN_API_KEY;

if (!API_KEY) {
  throw new Error("Set LLAMAGEN_API_KEY before running this script.");
}

type UploadResponse = {
  code?: number;
  fileUrl: string;
};

type Usage = {
  total_comics?: number;
  redraw_panels?: number;
  amount?: number;
};

type Generation = {
  id: string;
  status: "LOADING" | "PROCESSED" | "FAILED" | "CANCELLED" | string;
  usage?: Usage;
  comics?: Array<{
    page?: number;
    panels?: Array<{
      panel?: number;
      image?: string;
      assetUrl?: string;
      caption?: string;
    }>;
  }>;
  error?: unknown;
};

async function api<T>(path: string, init: RequestInit = {}): Promise<T> {
  const response = await fetch(`${API_BASE}${path}`, {
    ...init,
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      ...init.headers,
    },
  });

  const text = await response.text();
  const body = text ? JSON.parse(text) : null;

  if (!response.ok) {
    throw new Error(
      `Comic API ${response.status}: ${JSON.stringify(body)}`,
    );
  }

  return body as T;
}

async function uploadReference(filePath: string) {
  const bytes = await readFile(filePath);
  const form = new FormData();
  form.set("file", new Blob([bytes]), basename(filePath));

  return api<UploadResponse>("/v1/comics/upload", {
    method: "POST",
    body: form,
  });
}

async function waitForGeneration(
  generationId: string,
  timeoutMs = 10 * 60_000,
) {
  const startedAt = Date.now();

  while (Date.now() - startedAt < timeoutMs) {
    const job = await api<Generation>(
      `/v1/comics/generations/${generationId}`,
    );

    console.log(
      JSON.stringify({
        generationId,
        status: job.status,
        elapsedMs: Date.now() - startedAt,
        usage: job.usage,
      }),
    );

    if (job.status === "PROCESSED") return job;

    if (job.status === "FAILED" || job.status === "CANCELLED") {
      throw new Error(
        `Generation ended as ${job.status}: ${JSON.stringify(job.error)}`,
      );
    }

    await new Promise((resolve) => setTimeout(resolve, 4_000));
  }

  throw new Error(`Generation ${generationId} timed out.`);
}

async function main() {
  const startedAt = Date.now();

  try {
    const reference = await uploadReference("./courier-reference.png");

    const created = await api<Generation>("/v1/comics/generations", {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "Idempotency-Key": randomUUID(),
      },
      body: JSON.stringify({
        prompt: [
          "Create one four-panel comic page in a restrained cinematic manga style.",
          "Panel 1: Ren enters a rain-soaked station and notices a golden key.",
          "Panel 2: Close view as Ren lifts the key and studies it.",
          "Panel 3: Ren runs toward an old locked service door.",
          "Panel 4: Ren opens the door and warm light spills into the station.",
          "Keep the same face, haircut, yellow jacket, and red messenger bag.",
          "Leave clean space for later lettering.",
        ].join("\n"),
        preset: "japanese_manga",
        size: "1024x1024",
        fixPanelNum: 4,
        language: "en",
        comicRoles: [
          {
            name: "Ren",
            age: 22,
            gender: "male",
            dress: "yellow rain jacket, black trousers, red messenger bag",
            image: reference.fileUrl,
          },
        ],
      }),
    });

    const firstPass = await waitForGeneration(created.id);
    console.log("first_pass_complete", {
      id: firstPass.id,
      elapsedMs: Date.now() - startedAt,
      usage: firstPass.usage,
      pages: firstPass.comics?.length ?? 0,
    });

    // Example review result: panel 3 lost the red bag.
    const repairQueued = await api<Generation>(
      `/v1/comics/generations/${created.id}`,
      {
        method: "PATCH",
        headers: { "Content-Type": "application/json" },
        body: JSON.stringify({
          page: 0,
          panel: 2,
          panelPrompt:
            "Ren runs toward the service door. Preserve his exact face, short dark hair, yellow rain jacket, and visible red messenger bag.",
          images: [reference.fileUrl],
        }),
      },
    );

    console.log("repair_queued", {
      id: repairQueued.id,
      usage: repairQueued.usage,
    });

    const repaired = await waitForGeneration(created.id);
    console.log("workflow_complete", {
      id: repaired.id,
      totalElapsedMs: Date.now() - startedAt,
      finalStatus: repaired.status,
    });
  } catch (error) {
    console.error("comic_workflow_failed", {
      elapsedMs: Date.now() - startedAt,
      message: error instanceof Error ? error.message : String(error),
    });
    process.exitCode = 1;
  }
}

await main();

Execute com:

npx tsx comic-quickstart.ts

O exemplo registra intencionalmente objetos estruturados. Em produção, envie os mesmos campos para o seu sistema de observabilidade e inclua seu próprio identificador de solicitação ou projeto.

Etapa 3: Revise os Quatro Painéis Como se Fossem um Conjunto de Dados

Não aprove uma página porque ela parece atraente em tamanho de miniatura. Audite cada painel em relação ao bloqueio do personagem:

Trate isso como controle de qualidade legível por máquina se você estiver construindo um pipeline maior. Armazene um motivo de aprovação/reprovação por painel, não apenas um joinha no nível da página.

Etapa 4: Corrija um Painel, Não a Página Inteira

O prompt de correção mais rápido nomeia tanto a nova ação quanto os elementos que não podem mudar.

Correção do painel 3:
Ren corre em direção à porta de serviço.
Preserve seu rosto exato, cabelo curto e escuro, capa de chuva amarela
e a bolsa carteiro vermelha visível.
Mantenha a estação chuvosa e o movimento da esquerda para a direita.

Os índices dos painéis são baseados em zero, então o terceiro painel visível é panel: 2. O endpoint de atualização pode aceitar panelPrompt, images de referência ou uma caption de substituição.

Isso é importante operacionalmente. Reconstruir os quatro painéis pode introduzir três novos riscos de continuidade ao corrigir um antigo. A correção direcionada reduz a superfície de revisão.

Checklist de Robustez para Produção

Antes de publicar a integração, adicione estes controles:

1. Use uma chave de idempotência exclusiva para cada geração pretendida.
2. Armazene o ID da geração imediatamente após a criação.
3. Consulte com um intervalo fixo ou backoff e imponha um timeout.
4. Registre status, tempo decorrido, uso e cargas de falha.
5. Mantenha as URLs de referência enviadas com o registro do projeto.
6. Valide que a contagem de painéis retornada corresponde à solicitação.
7. Revise identidade, figurino, acessórios, continuidade da cena e espaço para texto separadamente.
8. Sempre que possível, corrija apenas o painel afetado.
9. Nunca exponha a chave de API ao código do lado do cliente.
10. Leia o uso e os preços atuais a partir da resposta da API e da documentação, em vez de fixar suposições antigas no código.

Para sequências mais longas, mude de fixPanelNum para pagination.totalPages e pagination.panelsPerPage. Não envie os dois modos em uma única solicitação de criação.

Quando Usar a API em Vez do Editor

Use a API de Quadrinhos quando os quadrinhos forem gerados dentro do seu próprio produto, job em lote, ferramenta educacional, pipeline de publicação ou fluxo de trabalho do cliente.

Use o editor visual quando um criador quiser explorar a história interativamente, comparar alternativas ou dirigir artisticamente cada página à mão. Muitas equipes usam ambos: a API cria e registra a primeira versão repetível, enquanto o editor lida com revisões excepcionais.

Se a estrutura da sua história ainda está mudando, planeje-a antes de fazer painéis finalizados. O próximo guia, Storyboard First or Comic Panels First?, mostra como medir a diferença de retrabalho.

FAQ

Posso gerar exatamente quatro painéis?

Sim. Envie fixPanelNum: 4 para uma solicitação de página única com quatro painéis. Para várias páginas, use o objeto pagination.

Como mantenho um personagem consistente?

Faça upload de uma imagem de referência limpa, passe o fileUrl retornado em comicRoles[].image, mantenha estáveis o nome do papel e a descrição do figurino, e audite cada painel retornado antes de continuar a sequência.

Posso regenerar apenas um painel ruim?

Sim. Envie uma solicitação PATCH com os índices de página e painel baseados em zero, além de um novo panelPrompt, imagens de referência opcionais ou legenda.

Devo tentar novamente uma solicitação de criação com falha usando a mesma chave de idempotência?

Use o comportamento de idempotência documentado pela LlamaGen.AI para que novas tentativas de rede não criem trabalho duplicado acidentalmente. Use uma nova chave apenas quando quiser intencionalmente uma nova geração.

Este exemplo expõe números reais de benchmark?

Não. Ele expõe a instrumentação necessária para capturar seus números reais. Publique latência, uso e taxas de falha apenas depois de executar repetidamente a mesma entrada na sua própria conta e registrar as condições.

Fontes e Divulgação Editorial

• Documentação da API de Quadrinhos LlamaGen.AI, verificada em 10 de outubro de 2026
• API de Quadrinhos LlamaGen.AI
• Cookbook de consistência da Meta Model API, consultado pelo princípio mais amplo de ancorar uma série de imagens em referências visuais estáveis

Escrito por Jay e tecnicamente revisado em relação ao contrato ativo do endpoint pela equipe de conteúdo da LlamaGen.AI. O comportamento do produto pode mudar; a documentação vinculada é a fonte da verdade.

Pronto para criar o fluxo de trabalho? Abra a API de Quadrinhos LlamaGen.AI, crie uma chave no lado do servidor e execute o guia rápido com sua própria referência de personagem.

© 2026 LlamaGen.Ai Todos os direitos reservados

Blogs anteriores

Gerador de Quadrinhos com IA Gratuito vs. Realmente Concluir uma História em Quadrinhos

Um teste prático de geradores de quadrinhos com IA gratuitos versus um fluxo de trabalho de roteiro

Jay

September 21st, 2026

Como Fazer uma História em Quadrinhos com IA a Partir de um Roteiro

Um fluxo de trabalho prático de roteiro para livro para transformar um roteiro curto em oito páginas

Jay

September 21st, 2026

Alternativa ao Komiko após o encerramento: como continuar criando OCs e quadrinhos

O Komiko está sendo encerrado. Aqui está uma forma prática de salvar seu trabalho, recriar OCs e con

Jay

September 11th, 2026

Corte 50% do Diálogo Sem Perder a Voz

Um fluxo de trabalho prático com Story AI para romancistas que precisam cortar diálogo para quadrinh

Jay

September 5th, 2026