Mage API · Mô hình hình ảnh

Flux 2 API

Prompt dài và chỉnh sửa với nhiều ảnh tham chiếu

Lấy khóa APIDùng thử Flux 2 trong playground
POST https://api.mage.space/v1/flux2/generate

Xem nhanh

Flux 2 API chạy Flux 2 qua Mage tại POST https://api.mage.space/v1/flux2/generate. Một yêu cầu với cài đặt mặc định có giá 40 Gems (khoảng $0.04), không cần đăng ký gói. Flux 2 không nhận đề cập @handle.

Tổng quan

Flux 2 API làm được gì

Flux 2 Dev, model open-weights mạnh nhất với những prompt dài và chi tiết. Tạo hoặc chỉnh sửa từ tối đa 3 ảnh tham chiếu, lên đến 2K.

Flux 2 Dev, model open-weights dành cho prompt dài và chi tiết, tạo ảnh và chỉnh sửa từ tối đa ba ảnh tham chiếu.

Model nhận image, additional_images làm đầu vào.

Bắt đầu nhanh

Gọi Flux 2 API

Đặt MAGE_API_KEY, gửi yêu cầu tới /flux2/generate và thăm dò status_url cho đến khi yêu cầu hoàn tất.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/flux2/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "flux2-dev"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('flux2', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'flux2-dev',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("flux2", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "flux2-dev",
})

print(request["result"]["url"])

Mô hình

Giá trị model_id của Flux 2

Gửi model_id để chọn phiên bản. Yêu cầu không có model_id sẽ chạy phiên bản mặc định.

model_idTênMặc định
flux2-devFlux 2Có

Tùy chọn

Tham số của Flux 2

Các giá trị được phép trên tất cả phiên bản; mỗi phiên bản có thể hỗ trợ ít hơn. Tài liệu liệt kê các tùy chọn theo từng phiên bản.

TrườngGiá trị
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1k, 2k

Đầu vào

Đầu vào media mà Flux 2 nhận

Gửi mỗi tệp dưới dạng URL https, data URL hoặc tải lên tối đa 100 MB.

TrườngVai trò
imageẢnh tham chiếu.
additional_imagesCác ảnh tham chiếu bổ sung.

Thêm mô hình ảnh

Các API tạo ảnh khác trên Mage

Ảnh · từ 9 Gems

GPT Image 2 API

Prompt chính xác và chữ dễ đọc

Ảnh · từ 75 Gems

Grok Image API

Grok Imagine, với ba mức chất lượng

Ảnh · từ 37 Gems

Guava API

Chân thực đến mức như ảnh chụp thật

Ảnh · từ 20 Gems

HiDream API

Nhanh và linh hoạt, hỗ trợ negative prompt

Ảnh · từ 20 Gems

Krea 2 API

Thẩm mỹ tuyệt đẹp chỉ trong vài giây

Ảnh · từ 135 Gems

Mango API

Dòng mô hình ảnh chủ lực của chúng tôi

FAQ

Câu hỏi thường gặp

Flux 2 API có giá bao nhiêu?

Một yêu cầu Flux 2 với cài đặt mặc định (Flux 2) có giá 40 Gems, khoảng $0.04. Độ phân giải, thời lượng và biến thể khác sẽ làm giá thay đổi; phản hồi sẽ cho biết chính xác khoản phí. Lượt tạo thất bại sẽ được hoàn lại; lượt bị chính sách nội dung của Mage chặn thì không.

Endpoint của Flux 2 API là gì?

POST https://api.mage.space/v1/flux2/generate kèm header Authorization: Bearer chứa khóa API Mage của bạn. Phản hồi có một status_url để bạn thăm dò kết quả.

Tôi có thể gọi những model Flux 2 nào?

flux2-dev. Mặc định là Flux 2.

Flux 2 có hỗ trợ ảnh tham chiếu hoặc nhân vật không?

Flux 2 nhận image, additional_images. Flux 2 không nhận đề cập @handle.

Tôi có thể dùng Flux 2 từ Claude hoặc ChatGPT không?

Có. Hãy kết nối máy chủ Mage MCP với Claude, ChatGPT, Claude Code, Grok hoặc Cursor và yêu cầu Flux 2 theo tên. Trợ lý của bạn sẽ đọc các tùy chọn bằng get_model và báo giá trước khi tạo.

Kết quả Flux 2 được lưu giữ trong bao lâu?

Kết quả và đầu vào được lưu trong 30 ngày. Hãy tải về bộ nhớ của bạn bất cứ thứ gì bạn muốn giữ lại.

Bắt đầu xây dựng với Mage

Một tài khoản, một số dư Gems, mọi mô hình. Bạn chỉ trả tiền cho những gì mình tạo.

Lấy khóa APIDùng thử Flux 2 trong playground

Liên quan