Tài liệu OpenAPI

Tạo tác vụ ảnh và video, xem khả năng mô hình và đọc kết quả qua REST API. Giao diện công khai cố định ở v1.

Bắt đầu nhanh

Mọi endpoint /openapi/v1/* dùng xác thực API Key. Gửi Bearer Token trong header và không gọi trực tiếp từ mã trình duyệt.

Base URL: https://open-api.flux-art.ai
Authorization: Bearer fa_live_...

Tính lũy đẳng: Yêu cầu ảnh và video cần Idempotency-Key dài 8–128 ký tự gồm chữ, số, dấu chấm, gạch dưới, hai chấm hoặc gạch nối. Dùng lại khi timeout hoặc lỗi 5xx.

curl -X POST 'https://open-api.flux-art.ai/openapi/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: image-order-20260714-0001' \
  -d '{
    "model": "gemini-2.5-flash-image",
    "mode": "generate",
    "prompt": "Ảnh sản phẩm dưới ánh sáng ban ngày dịu nhẹ",
    "count": 1
  }'

import os
import uuid
import requests

response = requests.post(
    "https://open-api.flux-art.ai/openapi/v1/images/generations",
    headers={
        "Authorization": f"Bearer {os.environ['FLUX_ART_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "model": "gemini-2.5-flash-image",
        "mode": "generate",
        "prompt": "Ảnh sản phẩm dưới ánh sáng ban ngày dịu nhẹ",
        "count": 1,
    },
    timeout=30,
)
response.raise_for_status()
print(response.json())

import { randomUUID } from "node:crypto";

const response = await fetch(
  "https://open-api.flux-art.ai/openapi/v1/images/generations",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.FLUX_ART_API_KEY}`,
      "Content-Type": "application/json",
      "Idempotency-Key": randomUUID(),
    },
    body: JSON.stringify({
      model: "gemini-2.5-flash-image",
      mode: "generate",
      prompt: "Ảnh sản phẩm dưới ánh sáng ban ngày dịu nhẹ",
      count: 1,
    }),
  },
);

if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

Tạo thành công: 201 Created với data.status là queued nghĩa là tác vụ đã được tạo và đưa vào hàng đợi, không phải lỗi. Hãy lưu data.id rồi thăm dò URL Location hoặc endpoint tác vụ để lấy kết quả.

Danh mục mô hình

Mô hình và khả năng thay đổi theo thời gian. Hãy đọc danh mục thay vì mã hóa cứng toàn bộ.

GET/openapi/v1/models

Trả về mô hình ảnh, video cùng kích thước, tỷ lệ, thời lượng, độ phân giải và khả năng hỗ trợ.

curl 'https://open-api.flux-art.ai/openapi/v1/models' \
  -H 'Authorization: Bearer YOUR_API_KEY'

import os
import requests

response = requests.get(
    "https://open-api.flux-art.ai/openapi/v1/models",
    headers={
        "Authorization": f"Bearer {os.environ['FLUX_ART_API_KEY']}",
    },
    timeout=30,
)
response.raise_for_status()
print(response.json())

const response = await fetch(
  "https://open-api.flux-art.ai/openapi/v1/models",
  {
    headers: {
      Authorization: `Bearer ${process.env.FLUX_ART_API_KEY}`,
    },
  },
);

if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

Tạo ảnh

Mỗi yêu cầu tạo một tác vụ ảnh; endpoint công khai cố định count=1.

POST/openapi/v1/images/generations

Trường yêu cầu thường dùng

model: Mã mô hình ảnh, bắt buộc.
mode: Chế độ bắt buộc: dùng generate cho văn bản thành ảnh hoặc edit khi gửi image_urls để chỉnh sửa hay tạo từ ảnh tham chiếu.
prompt: Bắt buộc, ít nhất ba ký tự không phải khoảng trắng.
count: Cố định là 1.
image_urls: Bắt buộc trong chế độ chỉnh sửa hoặc ảnh tham chiếu; phải là URL HTTPS công khai mà mô hình truy cập được.
aspect_ratio: Tỷ lệ ảnh tùy chọn.
size / resolution: Kích thước hoặc độ phân giải tùy chọn.size dùng cho GPT Image 2, Nano Banana, Seedream, Qwen, Wan và Kling; resolution dùng cho Grok Imagine.

curl -X POST 'https://open-api.flux-art.ai/openapi/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: image-edit-20260714-0001' \
  -d '{
    "model": "gemini-2.5-flash-image",
    "mode": "edit",
    "prompt": "Giữ chủ thể và thay bằng nền studio",
    "count": 1,
    "image_urls": ["https://cdn.example.com/input.jpg"],
    "aspect_ratio": "16:9"
  }'

import os
import uuid
import requests

response = requests.post(
    "https://open-api.flux-art.ai/openapi/v1/images/generations",
    headers={
        "Authorization": f"Bearer {os.environ['FLUX_ART_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "model": "gemini-2.5-flash-image",
        "mode": "edit",
        "prompt": "Giữ chủ thể và thay bằng nền studio",
        "count": 1,
        "image_urls": ["https://cdn.example.com/input.jpg"],
        "aspect_ratio": "16:9",
    },
    timeout=30,
)
response.raise_for_status()
print(response.json())

import { randomUUID } from "node:crypto";

const response = await fetch(
  "https://open-api.flux-art.ai/openapi/v1/images/generations",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.FLUX_ART_API_KEY}`,
      "Content-Type": "application/json",
      "Idempotency-Key": randomUUID(),
    },
    body: JSON.stringify({
      model: "gemini-2.5-flash-image",
      mode: "edit",
      prompt: "Giữ chủ thể và thay bằng nền studio",
      count: 1,
      image_urls: ["https://cdn.example.com/input.jpg"],
      aspect_ratio: "16:9",
    }),
  },
);

if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

Tạo video

Hỗ trợ văn bản thành video, ảnh thành video và một số khả năng chỉnh sửa video.

POST/openapi/v1/videos/generations

Trường yêu cầu thường dùng

model: Mã mô hình video, bắt buộc.
video_mode: Chế độ video bắt buộc, ví dụ t2v, i2v_first, multimodal_ref hoặc v2v_edit; chế độ phải được mô hình hỗ trợ.
prompt: Bắt buộc, ít nhất ba ký tự không phải khoảng trắng.
image_urls: Khung đầu, khung cuối hoặc ảnh tham chiếu tùy chọn.
source_video_url: Video nguồn tùy chọn để chỉnh sửa hoặc mở rộng.
duration: Thời lượng được mô hình hỗ trợ, tùy chọn.
resolution: Tùy chọn, ví dụ 720p.
ratio / aspect_ratio: Tỷ lệ video tùy chọn.ratio dùng cho Seedance và HappyHorse; aspect_ratio dùng cho Grok, Kling và HappyHorse.

curl -X POST 'https://open-api.flux-art.ai/openapi/v1/videos/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: video-order-20260714-0001' \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "video_mode": "t2v",
    "prompt": "Cảnh máy quay tiến chậm qua thành phố về đêm",
    "duration": 10,
    "resolution": "720p",
    "ratio": "16:9"
  }'

import os
import uuid
import requests

response = requests.post(
    "https://open-api.flux-art.ai/openapi/v1/videos/generations",
    headers={
        "Authorization": f"Bearer {os.environ['FLUX_ART_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "model": "doubao-seedance-2-0-260128",
        "video_mode": "t2v",
        "prompt": "Cảnh máy quay tiến chậm qua thành phố về đêm",
        "duration": 10,
        "resolution": "720p",
        "ratio": "16:9",
    },
    timeout=30,
)
response.raise_for_status()
print(response.json())

import { randomUUID } from "node:crypto";

const response = await fetch(
  "https://open-api.flux-art.ai/openapi/v1/videos/generations",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.FLUX_ART_API_KEY}`,
      "Content-Type": "application/json",
      "Idempotency-Key": randomUUID(),
    },
    body: JSON.stringify({
      model: "doubao-seedance-2-0-260128",
      video_mode: "t2v",
      prompt: "Cảnh máy quay tiến chậm qua thành phố về đêm",
      duration: 10,
      resolution: "720p",
      ratio: "16:9",
    }),
  },
);

if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

Truy vấn tác vụ

Tác vụ mới trả 201 Created; phát lại lũy đẳng trả tác vụ cũ và 200 OK. Header gồm Location và Idempotent-Replayed.

queuedĐang xếp hàng
processingĐang tạo
succeededHoàn tất
failedThất bại
canceledĐã hủy

GET/openapi/v1/tasks/{task_id}

Đọc một tác vụ OpenAPI của tài khoản hiện tại. Khi thành công, lấy URL ảnh hoặc video từ output.

curl 'https://open-api.flux-art.ai/openapi/v1/tasks/TASK_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY'

import os
import requests

task_id = "TASK_ID"
response = requests.get(
    f"https://open-api.flux-art.ai/openapi/v1/tasks/{task_id}",
    headers={
        "Authorization": f"Bearer {os.environ['FLUX_ART_API_KEY']}",
    },
    timeout=30,
)
response.raise_for_status()
print(response.json())

const taskId = "TASK_ID";
const response = await fetch(
  `https://open-api.flux-art.ai/openapi/v1/tasks/${taskId}`,
  {
    headers: {
      Authorization: `Bearer ${process.env.FLUX_ART_API_KEY}`,
    },
  },
);

if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

GET/openapi/v1/tasks

Truy vấn tác vụ bằng phân trang con trỏ. Giới hạn đọc tác vụ theo tài khoản là 120 lần mỗi phút.

limit: Số mục mỗi trang.
cursor: Con trỏ từ trang trước.
type: image hoặc video.
status: queued, processing, succeeded, failed hoặc canceled.

Xử lý lỗi

Mọi lỗi API công khai gồm error.code, message và request_id. Khi liên hệ hỗ trợ, cung cấp request id và task id, không cung cấp API Key đầy đủ.

400
invalid_request / invalid_media_url
Sửa tham số hoặc URL nội dung; không thử lại nguyên trạng.
401
invalid_api_key
Kiểm tra khóa bị thiếu, đã tạo lại hoặc thu hồi.
402
insufficient_points / membership_required
Nạp điểm hoặc nâng cấp hội viên cần thiết.
404
task_not_found
Kiểm tra mã tác vụ và tài khoản sở hữu.
409
idempotency_key_reused
Dùng khóa lũy đẳng mới cho yêu cầu khác; thử lại sau nếu đang xử lý.
422
validation_error
Sửa trường yêu cầu theo details.
429
rate_limit / concurrent_limit
Tuân theo Retry-After hoặc chờ tác vụ hiện có.
5xx
internal_error / service_unavailable
Thử lại với độ trễ và giữ khóa lũy đẳng ban đầu.

Giá mô hình

OpenAPI và ứng dụng web dùng chung số dư điểm, quyền hội viên và ưu đãi hiện tại của tài khoản Flux Art. Điểm được trừ từ cùng một tài khoản sau khi tác vụ được tạo; nếu không đủ số dư, API trả về 402 và không tạo tác vụ.

Giá tham khảo và khoản trừ thực tế

Các bảng hiển thị mức tiêu thụ tham khảo sau ưu đãi mô hình đang cấu hình. Backend tính khoản trừ cuối cùng khi gửi yêu cầu dựa trên mô hình, tham số và quy tắc tính phí hiện hành. usage.points_charged là giá trị chính thức; đối chiếu hoàn điểm lỗi bằng usage.points_refunded.

Mô hình ảnh

Tác vụ ảnh được tính theo từng ảnh. Kích thước và chất lượng ảnh hưởng đến mức tiêu thụ của một số mô hình.

GPT Image 2

gpt-image-2

Tỷ lệ tính phí hiện tại 50%

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Thấp · 1K	Giá gốc：40；Giá ưu đãi：20。điểm / ảnh
Thấp · 2K	Giá gốc：80；Giá ưu đãi：40。điểm / ảnh
Thấp · 4K	Giá gốc：120；Giá ưu đãi：60。điểm / ảnh
Trung bình · 1K	Giá gốc：80；Giá ưu đãi：40。điểm / ảnh
Trung bình · 2K	Giá gốc：120；Giá ưu đãi：60。điểm / ảnh
Trung bình · 4K	Giá gốc：160；Giá ưu đãi：80。điểm / ảnh
Cao · 1K	Giá gốc：180；Giá ưu đãi：90。điểm / ảnh
Cao · 2K	Giá gốc：360；Giá ưu đãi：180。điểm / ảnh
Cao · 4K	Giá gốc：600；Giá ưu đãi：300。điểm / ảnh

Nano Banana 2 Lite

gemini-3.1-flash-lite-image

Tỷ lệ tính phí hiện tại 50%

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	Giá gốc：100；Giá ưu đãi：50。điểm / ảnh

Nano Banana 2

gemini-3.1-flash-image-preview

Tỷ lệ tính phí hiện tại 50%

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
512	Giá gốc：80；Giá ưu đãi：40。điểm / ảnh
1K	Giá gốc：160；Giá ưu đãi：80。điểm / ảnh
2K	Giá gốc：200；Giá ưu đãi：100。điểm / ảnh
4K	Giá gốc：320；Giá ưu đãi：160。điểm / ảnh

Nano Banana

gemini-2.5-flash-image

Tỷ lệ tính phí hiện tại 50%

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	Giá gốc：70；Giá ưu đãi：35。điểm / ảnh

Nano Banana Pro

gemini-3-pro-image-preview

Tỷ lệ tính phí hiện tại 50%

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
1K	Giá gốc：240；Giá ưu đãi：120。điểm / ảnh
2K	Giá gốc：320；Giá ưu đãi：160。điểm / ảnh
4K	Giá gốc：400；Giá ưu đãi：200。điểm / ảnh

Grok Imagine Image

grok-imagine-image

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	100điểm / ảnh

Grok Imagine Image Pro

grok-imagine-image-pro

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	250điểm / ảnh

Seedream 5.0 Pro

doubao-seedream-5-0-pro-260628

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
1K	120điểm / ảnh
2K	240điểm / ảnh

Seedream 5.0

doubao-seedream-5-0-260128

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	60điểm / ảnh

Seedream 4.5

doubao-seedream-4-5-251128

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	60điểm / ảnh

Wan 2.7 Pro

wan2.7-image-pro

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	250điểm / ảnh

Wan 2.7

wan2.7-image

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	200điểm / ảnh

Qwen Image 2.0 Pro

qwen-image-2.0-pro

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	150điểm / ảnh

Qwen Image 2.0

qwen-image-2.0

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	120điểm / ảnh

Qwen Image Max

qwen-image-max

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	120điểm / ảnh

Qwen Image Edit Max

qwen-image-edit-max

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	160điểm / ảnh

Qwen MT Image

qwen-mt-image

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	150điểm / ảnh

Z-Image Turbo

z-image-turbo

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	80điểm / ảnh

Wan 2.6 T2I

wan2.6-t2i

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	150điểm / ảnh

Wan 2.6 Image

wan2.6-image

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	150điểm / ảnh

Wan 2.5 T2I

wan2.5-t2i-preview

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	150điểm / ảnh

Wan 2.5 I2I

wan2.5-i2i-preview

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	120điểm / ảnh

Wan 2.2 Flash

wan2.2-t2i-flash

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	100điểm / ảnh

Wan 2.2 Plus

wan2.2-t2i-plus

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	100điểm / ảnh

Midjourney V7 Imagine

mj_imagine

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	60điểm / ảnh

Midjourney V7 Blend

mj_blend

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Mỗi ảnh	60điểm / ảnh

Kling Image O1

kling-image-o1

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
1K	90điểm / ảnh
2K	90điểm / ảnh
1K	90điểm / ảnh
2K	90điểm / ảnh

Kling V3 Omni Image

kling-v3-omni-image

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
1K	90điểm / ảnh
2K	90điểm / ảnh
4K	170điểm / ảnh
1K	90điểm / ảnh
2K	90điểm / ảnh
4K	170điểm / ảnh

Kling V3 Image

kling-v3-image

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
1K	90điểm / ảnh
2K	90điểm / ảnh
1K	90điểm / ảnh
2K	90điểm / ảnh

Kling V2.1 Image

kling-v2-1-image

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
1K	50điểm / ảnh
2K	50điểm / ảnh
1K	90điểm / ảnh
2K	90điểm / ảnh
1K	170điểm / ảnh
2K	170điểm / ảnh

Kling V2 New Image

kling-v2-new-image

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
1K	90điểm / ảnh

Kling V2 Image

kling-v2-image

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
1K	50điểm / ảnh
2K	50điểm / ảnh
1K	90điểm / ảnh
2K	90điểm / ảnh
1K	170điểm / ảnh
2K	170điểm / ảnh

Kling V1.5 Image

kling-v1-5-image

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
1K	50điểm / ảnh
1K	90điểm / ảnh

Kling V1 Image

kling-v1-image

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
1K	20điểm / ảnh
1K	20điểm / ảnh

Mô hình video

Tác vụ video được tính theo thời lượng tạo. Bảng dùng cấu hình mô hình và hàm tính phí chính thức để hiển thị chi phí thực tế của tác vụ mặc định 5 giây; độ phân giải, âm thanh và chế độ đầu vào video ảnh hưởng đến chi phí cuối cùng.

Grok Video

grok-video-3

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Tạo cơ bản · 480p · 5 giây	500điểm / tác vụ
Tạo cơ bản · 720p · 5 giây	750điểm / tác vụ

HappyHorse 1.0

happyhorse-1.0

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Tạo cơ bản · 720P · 5 giây	1.450điểm / tác vụ
Tạo cơ bản · 1080P · 5 giây	2.250điểm / tác vụ

HappyHorse 1.1

happyhorse-1.1

Chi tiết tiêu thụ điểm
Cấu hình	Điểm tiêu thụ
Tạo cơ bản · 720P · 5 giây	1.750điểm / tác vụ
Tạo cơ bản · 1080P · 5 giây	2.500điểm / tác vụ