DEV Community: Lê Minh Paul

Hướng dẫn sử dụng Midjourney API với Apiframe

Lê Minh Paul — Wed, 20 Aug 2025 10:12:50 +0000

Tổng quan

Apiframe cung cấp các REST endpoint rõ ràng để điều khiển Midjourney AI từ ứng dụng của bạn. Quy trình chuẩn là: gửi tác vụ (Imagine, Vary, Upscale, Pan, Zoom) → nhận task_id → Fetch để lấy trạng thái/kết quả hoặc nhận Webhook nếu đã khai báo. Endpoint Imagine hỗ trợ mode = fast hoặc turbo.

Bạn sẽ học được gì trong bài này?

Xác thực (Authentication)
Imagine (tạo ảnh)
Vary (Strong/Subtle)
Upscale (Subtle/Creative)
Pan & Zoom
Lấy kết quả (Polling vs Webhook)
Ví dụ workflow đầy đủ bằng JavaScript (axios) và Python (requests)
Best practices (bảo mật, xử lý lỗi, hiệu năng)

Xác thực (Authentication)

Mọi request cần header Authorization đặt bằng API key của bạn (không phải dạng Bearer ...). API key lấy từ Dashboard của Apiframe: https://app.apiframe.ai/dashboard/api-keys

Lưu ý URL nền tảng

Nhóm endpoint tạo/gia công: https://api.apiframe.ai/pro/...

Nhóm endpoint truy vấn (Fetch): https://api.apiframe.ai/...

JavaScript (axios) – cấu hình chung

import axios from "axios";

const API_KEY = process.env.APIFRAME_API_KEY;

export const mj = axios.create({
  baseURL: "https://api.apiframe.ai/pro",
  headers: {
    "Content-Type": "application/json",
    "Authorization": API_KEY, // KHÔNG dùng 'Bearer '
  },
});

export const fetcher = axios.create({
  baseURL: "https://api.apiframe.ai",
  headers: {
    "Content-Type": "application/json",
    "Authorization": API_KEY,
  },
});

Python (requests) – headers chung

import os
import requests

API_KEY = os.environ.get("APIFRAME_API_KEY")
HEADERS = {
    "Content-Type": "application/json",
    "Authorization": API_KEY,  # KHÔNG dùng 'Bearer '
}

Imagine (tạo ảnh)

Tạo 4 ảnh từ một prompt. Có thể chọn mode là fast hoặc turbo. Với production, khuyến nghị thêm webhook_url và webhook_secret để nhận kết quả tự động.

JavaScript (axios)

const { data } = await mj.post("/imagine", {
  prompt: "Một quán cà phê tối giản, ánh nắng ban mai, tông ấm, film grain",
  mode: "fast", // hoặc "turbo"
  webhook_url: "https://example.com/webhooks/apiframe",
  webhook_secret: "whsec_123", // sẽ được gửi qua header 'x-webhook-secret'
});
console.log("Task ID:", data.task_id);

Python (requests)

res = requests.post(
    "https://api.apiframe.ai/pro/imagine",
    headers=HEADERS,
    json={
        "prompt": "Một quán cà phê tối giản, ánh nắng ban mai, tông ấm, film grain",
        "mode": "turbo",  # hoặc "fast"
        "webhook_url": "https://example.com/webhooks/apiframe",
        "webhook_secret": "whsec_123",
    },
)
print("Task ID:", res.json().get("task_id"))

Vary (Strong/Subtle)

Tạo 4 biến thể mới dựa trên kết quả trước đó. Truyền parent_task_id (chính là task_id của tác vụ nguồn), index ("1"–"4") để chọn ảnh, và type = strong hoặc subtle.

JavaScript

await mj.post("/vary", {
  parent_task_id: "29e983ca-7e86-4017-a9e3-ef6fe9cd5f2a",
  index: "2",
  type: "strong", // hoặc "subtle"
  webhook_url: "https://example.com/webhooks/apiframe",
  webhook_secret: "whsec_123",
});

Python

requests.post(
    "https://api.apiframe.ai/pro/vary",
    headers=HEADERS,
    json={
        "parent_task_id": "29e983ca-7e86-4017-a9e3-ef6fe9cd5f2a",
        "index": "2",
        "type": "subtle",  # hoặc "strong"
        "webhook_url": "https://example.com/webhooks/apiframe",
        "webhook_secret": "whsec_123",
    },
)

Upscale (Subtle/Creative)

Phóng lớn ảnh (thường ~2×). subtle giữ nguyên tinh thần/chi tiết, creative có xu hướng thêm chi tiết mới.

JavaScript

await mj.post("/upscale", {
  parent_task_id: "29e983ca-7e86-4017-a9e3-ef6fe9cd5f2a",
  index: "1",
  type: "creative", // hoặc "subtle"
});

Python

requests.post(
    "https://api.apiframe.ai/pro/upscale",
    headers=HEADERS,
    json={
        "parent_task_id": "29e983ca-7e86-4017-a9e3-ef6fe9cd5f2a",
        "index": "1",
        "type": "subtle",
    },
)

Pan & Zoom

Pan mở rộng khung theo hướng (thêm nội dung mới) trong khi Zoom “zoom out”/đổi bố cục.

Pan: type = up / down / left / right
Zoom:
- type = 1.5 hoặc 2 tương ứng “zoom out 1.5x/2x”
- Bất kỳ giá trị (1, 2] là “custom zoom”
- 1 = “make square”

JavaScript (Pan)

await mj.post("/pan", {
  parent_task_id: "29e983ca-7e86-4017-a9e3-ef6fe9cd5f2a",
  index: "3",
  type: "right",
});

Python (Zoom)

requests.post(
    "https://api.apiframe.ai/pro/zoom",
    headers=HEADERS,
    json={
        "parent_task_id": "29e983ca-7e86-4017-a9e3-ef6fe9cd5f2a",
        "index": "1",
        "type": 1.5,
    },
)

Lấy kết quả (Polling vs Webhook)

Polling (truy vấn định kỳ)

Dùng Fetch để lấy trạng thái/kết quả theo task_id:

POST https://api.apiframe.ai/fetch với payload { "task_id": "<id>" }
Có Fetch Many để lấy hàng loạt task_id

JavaScript – Fetch một lần

import axios from "axios";
const API_KEY = process.env.APIFRAME_API_KEY;

async function fetchOnce(taskId) {
  const { data } = await axios.post(
    "https://api.apiframe.ai/fetch",
    { task_id: taskId },
    {
      headers: {
        "Content-Type": "application/json",
        "Authorization": API_KEY,
      },
    }
  );
  return data; // data.status có thể là: pending/processing/finished/failed/...
}

Python – Fetch một lần

import os, requests

API_KEY = os.environ["APIFRAME_API_KEY"]
resp = requests.post(
    "https://api.apiframe.ai/fetch",
    headers={"Content-Type": "application/json", "Authorization": API_KEY},
    json={"task_id": "29e983ca-7e86-4017-a9e3-ef6fe9cd5f2a"},
)
print(resp.json())

Webhook (khuyến nghị cho production)

Khai báo webhook_url và webhook_secret ngay trong request Imagine/Vary/… Apiframe sẽ POST cập nhật và kết quả tới URL của bạn, kèm header x-webhook-secret để bạn xác thực.

Express (Node.js) – xác thực webhook

import express from "express";
const app = express();
app.use(express.json());

app.post("/webhooks/apiframe", (req, res) => {
  const provided = req.headers["x-webhook-secret"];
  if (provided !== process.env.APIFRAME_WEBHOOK_SECRET) {
    return res.status(401).end();
  }
  // TODO: xử lý req.body (status updates / final result)
  res.status(200).end();
});

Ví dụ workflow đầy đủ

JavaScript (axios)

import axios from "axios";

const API_KEY = process.env.APIFRAME_API_KEY;

const mj = axios.create({
  baseURL: "https://api.apiframe.ai/pro",
  headers: {
    "Content-Type": "application/json",
    "Authorization": API_KEY,
  },
});

const fetcher = axios.create({
  baseURL: "https://api.apiframe.ai",
  headers: {
    "Content-Type": "application/json",
    "Authorization": API_KEY,
  },
});

async function generateAndUpscale() {
  // 1) Imagine (fast)
  const imagine = await mj.post("/imagine", {
    prompt: "Ảnh sản phẩm tối giản: ly gốm trên nền vải linen, ánh sáng tự nhiên",
    mode: "fast",
  });
  const taskId = imagine.data.task_id;

  // 2) Poll tới khi finished hoặc failed
  let result;
  for (let i = 0; i < 50; i++) {
    const { data } = await fetcher.post("/fetch", { task_id: taskId });
    if (data?.status === "finished") { result = data; break; }
    if (data?.status === "failed") throw new Error("Generation failed");
    await new Promise((r) => setTimeout(r, 2000)); // backoff 2s
  }
  if (!result) throw new Error("Timeout chờ kết quả imagine");

  // 3) Upscale (creative) ảnh #1
  const up = await mj.post("/upscale", {
    parent_task_id: taskId,
    index: "1",
    type: "creative",
  });
  const upId = up.data.task_id;

  // 4) Poll kết quả upscale
  let final;
  for (let i = 0; i < 50; i++) {
    const { data } = await fetcher.post("/fetch", { task_id: upId });
    if (data?.status === "finished") { final = data; break; }
    if (data?.status === "failed") throw new Error("Upscale failed");
    await new Promise((r) => setTimeout(r, 2000));
  }
  return final; // chứa URL ảnh cuối cùng
}

generateAndUpscale().then(console.log).catch(console.error);

Python (requests)

import os
import time
import requests

API_KEY = os.environ["APIFRAME_API_KEY"]
HEADERS = {"Content-Type": "application/json", "Authorization": API_KEY}

def post(url, payload):
    return requests.post(url, headers=HEADERS, json=payload).json()

# 1) Imagine (turbo)
imagine = post("https://api.apiframe.ai/pro/imagine", {
    "prompt": "Ảnh sản phẩm tối giản: ly gốm trên nền vải linen, ánh sáng tự nhiên",
    "mode": "turbo"
})
task_id = imagine["task_id"]

# 2) Poll
for _ in range(50):
    data = post("https://api.apiframe.ai/fetch", {"task_id": task_id})
    if data.get("status") == "finished":
        break
    if data.get("status") == "failed":
        raise RuntimeError("Generation failed")
    time.sleep(2)

# 3) Pan sang phải ảnh #2
pan = post("https://api.apiframe.ai/pro/pan", {
    "parent_task_id": task_id,
    "index": "2",
    "type": "right"
})
pan_id = pan["task_id"]

# 4) Poll kết quả pan
for _ in range(50):
    out = post("https://api.apiframe.ai/fetch", {"task_id": pan_id})
    if out.get("status") == "finished":
        print(out)
        break
    if out.get("status") == "failed":
        raise RuntimeError("Pan failed")
    time.sleep(2)

Best Practices

Bảo mật & API keys
- Không bao giờ để API key ở frontend/mobile; luôn qua backend/proxy.
- Sử dụng biến môi trường, hệ thống secret manager.
- Header đúng định dạng: Authorization: YOUR_API_KEY (không dùng Bearer).
Webhook tin cậy
- Khai báo webhook_url và webhook_secret trong request gốc.
- Ở server, bắt buộc kiểm tra header x-webhook-secret để xác thực.
- Ghi log request và triển khai idempotency (nếu cần).
Xử lý lỗi & backoff
- Theo dõi trạng thái: pending, staged, starting, processing, finished, failed, retry/retrying.
- Retry với exponential backoff; dừng đúng lúc khi failed.
- Đặt timeout tổng cho quy trình đợi (ví dụ 80–120 giây).
Chọn chế độ
- turbo cho yêu cầu độ trễ thấp.
- fast cho đa số trường hợp tối ưu chi phí.
Chaining tác vụ
- Với Vary/Upscale/Pan/Zoom: luôn truyền parent_task_id (tác vụ nguồn) + index ("1"–"4").
Fetch Many
- Khi chạy nhiều task_id, ưu tiên Fetch Many để giảm số lần gọi mạng.

Kết luận

Bạn đã có một hướng dẫn đầy đủ và thực dụng để tích hợp Midjourney qua Apiframe: bắt đầu từ Imagine (fast/turbo), tinh chỉnh bằng Vary / Upscale / Pan / Zoom, rồi thu kết quả với Fetch hoặc Webhook. Hãy chủ động thử nghiệm — so sánh strong vs subtle, creative vs subtle, pan theo nhiều hướng, cũng như tỉ lệ zoom linh hoạt — để xây dựng pipeline tạo ảnh phù hợp nhất cho sản phẩm của bạn.

Apiframe: Tự động hóa Midjourney AI cho lập trình viên và startup Việt

Lê Minh Paul — Mon, 18 Aug 2025 02:42:44 +0000

Mở đầu: Cơn sốt hình ảnh AI ở Việt Nam

Nếu bạn để ý, dạo gần đây trên Facebook, TikTok hay LinkedIn ở Việt Nam tràn ngập những hình ảnh cực kỳ ấn tượng được tạo bởi AI. Từ poster sự kiện, ảnh bìa sản phẩm, đến cả concept art cho game hay truyện tranh. Nhiều bạn bè dev của mình cũng thử nghịch và đều “wow” trước chất lượng. Rõ ràng, AI đang mở ra một làn sóng sáng tạo mới, và ở Việt Nam, mình thấy cộng đồng bắt đầu hứng thú với việc dùng AI để làm sản phẩm thực tế chứ không chỉ “cho vui” nữa.

Midjourney là gì và vì sao ai cũng thích?

Midjourney AI là một công cụ tạo hình ảnh từ text nổi tiếng nhất hiện nay. Bạn chỉ cần gõ một đoạn mô tả, ví dụ như “a cyberpunk city at sunset”, là vài giây sau đã có một loạt ảnh đẹp lung linh. Nhiều designer, marketer, thậm chí cả lập trình viên dùng nó để tạo ý tưởng nhanh, tiết kiệm thời gian và chi phí.

Cái hay của Midjourney là hình ảnh cực kỳ chất lượng và có “style” riêng, chứ không bị lẫn lộn như nhiều AI khác. Nhưng có một vấn đề lớn…

Vấn đề: API chính thức không tồn tại

Midjourney hiện tại chỉ hoạt động qua Discord. Muốn tạo ảnh thì phải vào server, gõ lệnh, rồi copy link ảnh về. Với người dùng bình thường thì ổn, nhưng với dev hoặc startup muốn tích hợp AI vào app/web thì rất phiền.

Không có API chính thức để gọi từ backend.
Không thể tự động hóa quy trình (ví dụ tạo hàng loạt ảnh sản phẩm).
Khó tích hợp với workflow có sẵn (Zapier, Make, CRM…).

Mình từng thử viết script để “bẻ” workflow từ Discord, nhưng khá hacky và không ổn định. Và chắc nhiều bạn dev ở Việt Nam cũng gặp cảnh này.

Giải pháp: Apiframe xuất hiện

Và đây là lúc Apiframe bước vào. Apiframe basically cung cấp một Midjourney API cho anh em dev.

Một vài điểm nổi bật mình thấy khá thích:

Tốc độ: ảnh trả về chỉ khoảng 12 giây với turbo mode, nhanh hơn nhiều so với việc tự chờ trên Discord.
Dễ tích hợp: chỉ cần gọi API bằng Node.js, Python, hay bất kỳ ngôn ngữ nào bạn thích.
Tự động hóa: có thể kết nối với Zapier, Make để tạo workflow. Ví dụ: khi có sản phẩm mới trên website → tự động tạo hình ảnh từ Midjourney → đăng lên Facebook/Shopify.
Ổn định: không cần phải duy trì bot Discord riêng, Apiframe đã xử lý backend rồi.

Nói đơn giản: Apiframe giúp biến Midjourney từ một tool “dành cho người dùng cuối” thành một nền tảng AI có thể nhúng vào app của bạn.

Ứng dụng thực tế cho startup Việt

Mình nghĩ cơ hội cho dev và startup Việt khá lớn nếu tận dụng Apiframe. Một vài ví dụ:

E-commerce: Shop bán hàng online có thể tự động tạo ảnh sản phẩm với nhiều phong cách khác nhau. Thay vì thuê designer, bạn có thể thử prompt và tạo nhanh bộ ảnh.
Marketing: Team marketing có thể generate banner, poster, hay concept để chạy A/B testing. Hình ảnh độc lạ sẽ thu hút nhiều hơn trên Facebook Ads.
Startup app: Bạn có thể build một app nhỏ cho người dùng Việt, ví dụ “AI Poster Generator” hoặc “AI Wedding Invitation”, tất cả chạy ngầm với Apiframe.
Game/Art: Dev indie có thể generate concept art để thử nghiệm nhanh ý tưởng game trước khi đầu tư vẽ tay.

Cái hay là Apiframe lo hết phần nặng nhọc (tương tác với Midjourney), còn bạn chỉ cần tập trung vào logic sản phẩm và user experience.

Kết luận: Cơ hội mới cho dev Việt

Mình thấy AI nói chung và Midjourney nói riêng sẽ không chỉ là “trend” nữa, mà sẽ thành công cụ thiết yếu cho nhiều ngành ở Việt Nam. Với Apiframe, dev và startup có thể dễ dàng đưa Midjourney AI vào sản phẩm của mình, từ đó mở ra nhiều cơ hội mới.

Nếu bạn là lập trình viên đang muốn nghịch AI, hay là founder đang tìm cách cải thiện marketing/sản phẩm, mình nghĩ Apiframe đáng để thử. Ai biết đâu, từ một API nhỏ này, bạn sẽ launch được sản phẩm AI tiếp theo hot ở Việt Nam.

👉 Nếu bạn quan tâm, hãy thử khám phá Apiframe nhé.