我們沒有虛構延遲或成功率基準。這些數值會依帳號、佇列、模型設定與輸入而異。範例會記錄你的實際耗時、API 用量、最終狀態與失敗細節，讓你能在自己的環境中建立可辯護的基準。

為什麼角色參考圖不是可有可無

提示詞告訴模型發生了什麼事。角色參考圖則告訴模型，故事是發生在誰身上。

對於重複出現的角色，請保持以下欄位穩定：

• 名稱
• 年齡區間與整體呈現
• 髮型輪廓
• 代表性服裝配色
• 一個有辨識度的道具
• 主要參考圖
• 可選的側面與四分之三角度參考圖

在這個範例中，角色是一位短深色頭髮、穿黃色雨衣、背紅色郵差包的快遞員。這些細節既足夠精簡，能夠重複使用，也足夠鮮明，便於稽核。

步驟 1：準備伺服器環境

請使用 Node.js 20 或更新版本，以確保 fetch、FormData 與 Blob 可用。將金鑰保存在僅供伺服器使用的環境變數中。

export LLAMAGEN_API_KEY="your_server_side_key"

不要在瀏覽器 bundle、行動應用程式、公開儲存庫或任何用戶端請求中暴露這個金鑰。如果你的產品有前端，請將使用者的簡述傳送到你自己的後端，再由該後端呼叫 LlamaGen.AI。

此工作流程包含四個網路操作：

步驟 2：執行 TypeScript 快速入門

將以下內容儲存為 comic-quickstart.ts，把角色圖片放在 ./courier-reference.png，並從你的伺服器環境執行它。

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();

執行方式如下：

npx tsx comic-quickstart.ts

這個範例刻意記錄結構化物件。在正式環境中，請將相同欄位送到你的可觀測性系統，並加入你自己的請求或專案識別碼。

步驟 3：像檢視資料集一樣審查四個面板

不要因為整頁在縮圖尺寸下看起來漂亮就直接通過。請依照角色鎖定條件逐格稽核：

如果你正在建立更大的流程，請把這視為可機器讀取的品質控管。請為每個面板儲存通過／失敗原因，而不只是整頁層級的簡單核可。

步驟 4：修復單一面板，而不是整頁

最快的修復提示詞會同時指出新的動作，以及哪些元素不得改變。

Panel 3 repair:
Ren runs toward the service door.
Preserve his exact face, short dark hair, yellow rain jacket,
and visible red messenger bag.
Keep the rainy station and left-to-right movement.

面板索引是以零為起點，因此畫面上第三格對應的是 panel: 2。更新端點可以接受 panelPrompt、參考 images，或替換用的 caption。

這在操作層面上很重要。重建全部四格，可能會在修復一個舊問題的同時引入三個新的連續性風險。針對性修復能縮小審查範圍。

正式環境強化檢查清單

在整合正式上線前，請加入以下控制項：

1. 對每一次預期生成使用唯一的冪等鍵。
2. 在建立後立即儲存 generation ID。
3. 以固定間隔或退避策略輪詢，並強制設定逾時。
4. 記錄狀態、耗時、用量與失敗 payload。
5. 將上傳後的參考圖 URL 與專案記錄一起保存。
6. 驗證回傳的面板數量是否符合請求。
7. 分別審查身份、服裝、道具、場景連續性與留字空間。
8. 只要可能，就只修復受影響的面板。
9. 絕不要將 API 金鑰暴露給用戶端程式碼。
10. 請從 API 回應與文件讀取最新用量與定價，而不是把舊假設硬編碼進去。

對於更長的序列，請從 fixPanelNum 改用 pagination.totalPages 與 pagination.panelsPerPage。不要在同一個建立請求中同時傳送這兩種模式。

何時應該使用 API，而不是編輯器

當漫畫是在你自己的產品、批次工作、教育工具、出版流程或客戶工作流程中生成時，請使用 Comic API。

當創作者希望以互動方式探索故事、比較不同方案，或逐頁手動進行美術指導時，請使用視覺化編輯器。許多團隊會兩者並用：API 負責建立並記錄可重複的初稿，而編輯器則處理例外修訂。

如果你的故事結構仍在變動，請先規劃好再製作完成面板。下一篇指南 Storyboard First or Comic Panels First? 會示範如何衡量返工差異。

常見問題

我可以精準生成四個面板嗎？

可以。對單頁四格請求傳送 fixPanelNum: 4 即可。若要生成多頁，請改用 pagination 物件。

我要如何讓同一角色保持一致？

上傳乾淨的參考圖，將其回傳的 fileUrl 傳入 comicRoles[].image，保持角色名稱與服裝描述穩定，並在繼續序列前稽核每一個回傳面板。

我可以只重新生成一個有問題的面板嗎？

可以。傳送 PATCH 請求，附上以零為起點的頁面與面板索引，以及新的 panelPrompt、可選的參考圖片或 caption。

如果建立請求失敗，我是否應該用相同的冪等鍵重試？

請依照 LlamaGen.AI 文件記載的冪等行為處理，避免網路重試意外建立重複工作。只有在你有意產生新的生成結果時，才使用新的鍵。

這個範例有公開真實基準數字嗎？

沒有。它提供的是擷取真實數字所需的監測機制。只有在你於自己的帳號中，在相同條件下重複執行相同輸入並完成記錄後，才應公開延遲、用量與失敗率。

資料來源與編輯說明

• LlamaGen.AI Comic API documentation，於 2026 年 10 月 10 日查核
• LlamaGen.AI Comic API
• Meta Model API consistency cookbook，用於參考以穩定視覺參考錨定影像序列的較廣泛原則

本文由 Jay 撰寫，並由 LlamaGen.AI 內容團隊依據實際端點合約進行技術審閱。產品行為可能變動；以上連結文件才是最終依據。

準備好建立這個工作流程了嗎？開啟 LlamaGen.AI Comic API，建立伺服器端金鑰，並使用你自己的角色參考圖執行這份快速入門。

© 2026 LlamaGen.Ai 版權所有

先前的部落格

免費 AI 漫畫生成器 vs. 真正完成一本漫畫書

實測免費 AI 漫畫生成器與從腳本到成書的工作流程，看看哪個能做出讀者真正看得懂的 8 頁漫畫。

Jay

2026年9月21日

如何從劇本製作 AI 漫畫書

一套實用的劇本到成書流程，將一篇短劇本轉化為八頁風格一致的漫畫，並匯出成一本可閱讀的迷你漫畫。

Jay

2026年9月21日

Komiko 關站後的替代方案：如何繼續創作 OC 和漫畫

Komiko 即將關站。這裡提供一個實用的方法，幫你保存作品、重建 OC，並持續進行漫畫、照片轉動漫與線稿上色工作流程。

Jay

2026年9月11日

將對白刪減 50%，卻不失角色聲音

一套實用的 Story AI 工作流程，適合需要為漫畫刪減對白，同時保留角色聲音、潛台詞、情感與場景節奏的小說作家。

Jay

2026年9月5日