• Nama
• Rentang usia dan penampilan
• Siluet rambut
• Warna pakaian khas
• Satu properti yang khas
• Gambar referensi utama
• Referensi samping dan tiga perempat opsional

Dalam contoh ini, perannya adalah seorang kurir dengan rambut pendek gelap, jaket hujan kuning, dan tas selempang merah. Detail-detail itu cukup ringkas untuk diulang dan cukup khas untuk diaudit.

Langkah 1: Siapkan Lingkungan Server

Gunakan Node.js 20 atau yang lebih baru agar fetch, FormData, dan Blob tersedia. Simpan kunci dalam variabel lingkungan yang hanya untuk server.

export LLAMAGEN_API_KEY="your_server_side_key"

Jangan pernah mengekspos kunci ini dalam bundle browser, aplikasi mobile, repositori publik, atau permintaan sisi klien. Jika produk Anda memiliki frontend, kirim brief pengguna ke backend Anda sendiri dan biarkan backend itu memanggil LlamaGen.AI.

Alur kerja ini memiliki empat operasi jaringan:

Langkah 2: Jalankan Quickstart TypeScript

Simpan yang berikut ini sebagai comic-quickstart.ts, letakkan gambar karakter di ./courier-reference.png, lalu jalankan dari lingkungan server Anda.

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

Jalankan dengan:

npx tsx comic-quickstart.ts

Contoh ini sengaja mencatat objek terstruktur. Dalam produksi, kirim field yang sama ke sistem observabilitas Anda dan sertakan identifier permintaan atau proyek Anda sendiri.

Langkah 3: Tinjau Empat Panel Seperti Sebuah Dataset

Jangan menyetujui halaman hanya karena terlihat menarik pada ukuran thumbnail. Audit setiap panel terhadap kunci karakter:

Perlakukan ini sebagai kontrol kualitas yang dapat dibaca mesin jika Anda membangun pipeline yang lebih besar. Simpan alasan lulus/gagal per panel, bukan hanya persetujuan tingkat halaman.

Langkah 4: Perbaiki Satu Panel, Bukan Seluruh Halaman

Prompt perbaikan tercepat menyebutkan baik aksi baru maupun elemen-elemen yang tidak boleh berubah.

Perbaikan panel 3:
Ren berlari menuju pintu layanan.
Pertahankan wajahnya yang persis sama, rambut pendek gelap, jaket hujan kuning,
dan tas selempang merah yang terlihat.
Pertahankan stasiun yang hujan dan pergerakan dari kiri ke kanan.

Indeks panel berbasis nol, jadi panel ketiga yang terlihat adalah panel: 2. Endpoint update dapat menerima panelPrompt, images referensi, atau caption pengganti.

Ini penting secara operasional. Membangun ulang keempat panel dapat memperkenalkan tiga risiko kontinuitas baru saat memperbaiki satu risiko lama. Perbaikan terarah mempersempit permukaan tinjauan.

Checklist Penguatan Produksi

Sebelum mengirim integrasi, tambahkan kontrol berikut:

1. Gunakan kunci idempotensi yang unik untuk setiap generasi yang dimaksudkan.
2. Simpan ID generasi segera setelah pembuatan.
3. Lakukan polling dengan interval tetap atau backoff dan terapkan timeout.
4. Catat status, waktu berjalan, penggunaan, dan payload kegagalan.
5. Simpan URL referensi yang diunggah bersama catatan proyek.
6. Validasi bahwa jumlah panel yang dikembalikan sesuai dengan permintaan.
7. Tinjau identitas, kostum, properti, kontinuitas adegan, dan ruang lettering secara terpisah.
8. Perbaiki hanya panel yang terdampak kapan pun memungkinkan.
9. Jangan pernah mengekspos kunci API ke kode sisi klien.
10. Baca penggunaan dan harga terkini dari respons API dan dokumentasi alih-alih melakukan hardcode pada asumsi lama.

Untuk urutan yang lebih panjang, beralihlah dari fixPanelNum ke pagination.totalPages dan pagination.panelsPerPage. Jangan kirim kedua mode dalam satu permintaan create.

Kapan Menggunakan API alih-alih Editor

Gunakan Comic API saat komik dibuat di dalam produk Anda sendiri, batch job, alat pendidikan, pipeline penerbitan, atau alur kerja pelanggan.

Gunakan editor visual saat kreator ingin mengeksplorasi cerita secara interaktif, membandingkan alternatif, atau mengarahkan seni setiap halaman secara manual. Banyak tim menggunakan keduanya: API membuat dan mencatat first pass yang dapat diulang, sementara editor menangani revisi khusus.

Jika struktur cerita Anda masih berubah, rencanakan terlebih dahulu sebelum membuat panel final. Panduan berikutnya, Storyboard First or Comic Panels First?, menunjukkan cara mengukur perbedaan pengerjaan ulang.

FAQ

Bisakah saya menghasilkan tepat empat panel?

Ya. Kirim fixPanelNum: 4 untuk permintaan satu halaman dengan empat panel. Untuk banyak halaman, gunakan objek pagination sebagai gantinya.

Bagaimana cara menjaga satu karakter tetap konsisten?

Unggah gambar referensi yang bersih, masukkan fileUrl yang dikembalikan ke dalam comicRoles[].image, pertahankan nama peran dan deskripsi kostum tetap stabil, dan audit setiap panel yang dikembalikan sebelum melanjutkan urutan.

Bisakah saya meregenerasi hanya satu panel yang buruk?

Ya. Kirim permintaan PATCH dengan indeks halaman dan panel berbasis nol ditambah panelPrompt baru, gambar referensi opsional, atau caption.

Haruskah saya mencoba ulang permintaan create yang gagal dengan kunci idempotensi yang sama?

Gunakan perilaku idempotensi yang didokumentasikan oleh LlamaGen.AI agar percobaan ulang jaringan tidak secara tidak sengaja membuat pekerjaan duplikat. Gunakan kunci baru hanya saat Anda memang sengaja menginginkan generasi baru.

Apakah contoh ini menampilkan angka tolok ukur nyata?

Tidak. Ini menampilkan instrumentasi yang dibutuhkan untuk menangkap angka nyata Anda. Publikasikan latensi, penggunaan, dan tingkat kegagalan hanya setelah menjalankan input yang sama berulang kali di akun Anda sendiri dan mencatat kondisinya.

Sumber dan Pengungkapan Editorial

• LlamaGen.AI Comic API documentation, diperiksa pada 10 Oktober 2026
• LlamaGen.AI Comic API
• Meta Model API consistency cookbook, dirujuk untuk prinsip yang lebih luas tentang menautkan rangkaian gambar ke referensi visual yang stabil

Ditulis oleh Jay dan ditinjau secara teknis terhadap kontrak endpoint langsung oleh tim konten LlamaGen.AI. Perilaku produk dapat berubah; dokumentasi yang ditautkan adalah sumber kebenaran.

Siap membangun alur kerja? Buka LlamaGen.AI Comic API, buat kunci sisi server, dan jalankan quickstart dengan referensi karakter Anda sendiri.

AI Storyboard Generator

Visualize every scene before production starts.

© 2026 LlamaGen.Ai Semua hak dilindungi

Blog sebelumnya

Generator Komik AI Gratis vs. Benar-Benar Menyelesaikan Buku Komik

Uji praktis generator komik AI gratis versus alur kerja skrip-ke-buku untuk membuat komik 8 halaman

Jay

21 September 2026

Cara Membuat Buku Komik AI dari Naskah

Alur kerja praktis dari naskah ke buku untuk mengubah satu naskah pendek menjadi delapan halaman kom

Jay

21 September 2026

Alternatif Komiko Setelah Tutup: Cara Tetap Membuat OC dan Komik

Komiko akan ditutup. Berikut cara praktis untuk menyimpan karya Anda, membangun ulang OC, dan melanj

Jay

11 September 2026

Pangkas Dialog 50% Tanpa Kehilangan Suara

Alur kerja Story AI yang praktis untuk penulis novel yang perlu memangkas dialog untuk komik sambil

Jay

5 September 2026