Sourceful: Riverflow V2.5 Pro

Riverflow 2.5 Pro là cấu hình tạo và chỉnh sửa ảnh chú trọng chất lượng của Sourceful cho nội dung sáng tạo sản phẩm và chiến dịch. Dòng mô hình kết hợp chỉnh sửa nhiều bước, đánh giá tuỳ chỉnh và kiểm soát phông chữ, giúp bản yêu cầu chi tiết giữ danh tính thương hiệu và bố cục dự định.

Ailoot Ultra · Ảnh POST /v1/images/generations sourceful/riverflow-v2.5-pro

Về mô hình

Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.

Riverflow 2.5 Pro là cấu hình Pro thuộc dòng tạo và chỉnh sửa ảnh Riverflow 2.5 của Sourceful, hướng đến công việc sáng tạo cần khả năng kiểm soát và chất lượng ảnh cuối cùng. Một bản mô tả bằng văn bản có thể tạo hình ảnh, còn ảnh tham chiếu cung cấp sản phẩm, tác phẩm hoặc cảnh cần chỉnh sửa. Cách tiếp cận đặc trưng của dòng này là lập kế hoạch nhiều bước chỉnh sửa, đánh giá các phương án và sửa chúng theo kết quả được yêu cầu, thay vì coi ảnh đầu tiên là toàn bộ quy trình.

Với ảnh cho chiến dịch, chuẩn bị ảnh tham chiếu sản phẩm và định hướng thương hiệu trước khi mô tả cảnh. Chỉ rõ đặc điểm phân biệt SKU này với SKU khác, cách sắp xếp, ánh sáng và khoảng trống cần cho chữ. Một yêu cầu hữu ích có thể đặt ba sản phẩm đã gắn nhãn vào cùng một bố cục thống nhất, đồng thời giữ rõ màu sắc, kích thước và nhận diện của từng sản phẩm. Với cảnh đời sống có một sản phẩm, xác định tham chiếu nào cung cấp vật thể và tham chiếu nào cung cấp không khí hoặc bối cảnh, rồi nêu những yếu tố phải giữ lại trong quá trình biến đổi.

Riverflow 2.5 bổ sung bộ tiêu chí chấm điểm tùy chỉnh vào quá trình suy luận và đánh giá. Mô tả tiêu chí quan trọng đối với sản phẩm: nhận diện sản phẩm, độ rõ của nhãn, bố cục, tính hợp lý của cảnh hoặc khoảng trống dành cho tiêu đề. Sau các bước chỉnh sửa, mô hình suy luận có thể đánh giá phương án theo bộ tiêu chí đó và quyết định cách tiếp tục. Kết quả dành cho bao bì và hình ảnh chiến dịch giàu biểu cảm cần ưu tiên đánh giá khác nhau, vì vậy tách chỉ dẫn tạo ảnh khỏi tiêu chí dùng để đánh giá ảnh.

Thinking effort điều chỉnh lượng công việc lặp lại và mức độ nghiêm ngặt khi dòng mô hình đánh giá trước khi chấp nhận một ảnh. Quy trình 2.5 của nhà sản xuất trải từ low đến xhigh: mức thấp hỗ trợ khám phá ban đầu, còn mức cao hơn hữu ích khi yêu cầu cần tinh chỉnh thêm. Đánh giá nội bộ nhiều hơn không loại bỏ nhu cầu kiểm tra sản phẩm đã hoàn thành. Với bố cục sản phẩm phức tạp, nêu rõ chi tiết quan trọng và tiêu chí chấp nhận để công việc chỉnh sửa thêm có mục tiêu cụ thể.

Font Control nhận tối đa hai tệp phông chữ tùy chỉnh và dùng hình dáng chữ, khoảng cách cùng độ đậm được cung cấp làm hướng dẫn. Cung cấp chính xác các từ cần hiển thị, vai trò của từng khối chữ và tham chiếu phông tương ứng. Tiêu đề và chú thích ngắn có thể dùng phông khác nhau mà vẫn xác định rõ thứ bậc chữ. Kiểm tra các chữ cái và con số thực tế trong đầu ra, đặc biệt khi nhãn bao bì hoặc tên sản phẩm dùng để nhận diện mặt hàng, thay vì coi tham chiếu phông là bằng chứng mọi ký tự đều đúng.

Dòng 2.5 có các chế độ đầu ra với nền thông thường, nền một màu và nền trong suốt, bao gồm PNG trong suốt để ghép bố cục, cùng các lựa chọn xuất 1K, 2K và tối đa 4K. Chọn sản phẩm theo vị trí sử dụng: ảnh tách nền để ghép vào thiết kế khác, nền một màu được kiểm soát để tạo bộ sản phẩm đồng nhất hoặc cảnh hoàn chỉnh cho chiến dịch. Chuẩn bị hình dạng đầu ra và vị trí chữ cùng nhau; tăng mức chi tiết khi giao ảnh không sửa được bố cục đặt chủ thể chính sai chỗ.

Pro vẫn khác với cấu hình Fast và thế hệ Riverflow 2.0 trước đó. Dòng 2.5 phát triển nền tảng nhiều bước của 2.0 bằng khả năng kiểm soát đánh giá sâu hơn, chấm điểm tùy chỉnh và lựa chọn nền, xuất ảnh mở rộng. Một lần kiểm tra cuối hữu ích sẽ so sánh ảnh với tham chiếu sản phẩm, bộ tiêu chí và kiểu chữ, rồi thay đổi đúng chỉ dẫn hoặc tiêu chí gây ra điểm không khớp. Lưu ảnh được chọn cùng bản yêu cầu và tham chiếu để lần chỉnh sửa tiếp theo tiếp tục hoàn thiện cùng một định hướng sáng tạo, thay vì mất đi nhận diện đã xác lập.

Ailoot Ultra · Ảnh POST /v1/images/generations sourceful/riverflow-v2.5-pro

sourceful/riverflow-v2.5-pro

Sourceful /sourceful/riverflow-v2.5-pro

Bắt đầu

Đầu vào được chấp nhận: Văn bản · Ảnh
Kết quả: Ảnh

Có trên Ailoot · đầu vào & phương thức

Ailoot Ultra · Ảnh POST /v1/images/generations

Đầu vào: text, image
Đầu ra: image

Trường	Loại	Yêu cầu	Giá trị & giới hạn	Mặc định
Trường`model`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn sourceful/riverflow-v2.5-pro	Mặc định—
Trường`prompt`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn Độ dài tối thiểu: 1	Mặc định—
Trường`resolution`	Loại`string`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn 1K, 2K, 4K	Mặc định—
Trường`aspect_ratio`	Loại`string`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	Mặc định—
Trường`output_format`	Loại`string`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn png, jpeg, webp	Mặc định—
Trường`background`	Loại`string`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn auto, transparent, opaque	Mặc định—
Trường`n`	Loại`integer`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn Tối thiểu: 1 Tối đa: 1	Mặc định—
Trường`input_references`	Loại`array`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn Số mục tối thiểu: 0 Số mục tối đa: 10	Mặc định—
Trường`provider`	Loại`object`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn	Mặc định—

Tham số phương thức và vòng đời

Tham số	Hợp đồng
Tham số`content_type`	Hợp đồngapplication/json
Tham số`required`	Hợp đồngmodel, prompt
Tham số`material_types`	Hợp đồngtext, image

Vòng đời: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Giá trị task_id thực tế đã trả về hoặc bản ghi trong thư viện nội dung đa phương tiện

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Bảng giá

Cách tính phí cuối cùng

Các đơn giá hiển thị dùng để ước tính chi phí trước khi tạo. Khoản phí cuối cùng được tính dựa trên chi phí ghi nhận cho lượt tạo gốc. Thời lượng đầu ra đo được và số lượng dự kiến không phải là số lượng cuối cùng dùng để tính phí.

Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.

Chế độ nhanh: Chưa chỉ định Khi chọn chế độ nhanh
Chế độ Flex: Chưa chỉ định Khi chọn chế độ flex
Mức độ suy luận tối đa: Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa

Mức phí ước tính để so sánh

Giá theo cấu hình

Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế.

Cấu hình	Biểu mức phí	Số lượng dự báo	Đơn vị tính phí	Phí
Cấu hìnhGiá cơ sở cho token	Biểu mức phíMức phí cơ bản	Số lượng dự báo—	Đơn vị tính phí—	Phí Đầu vào · Token đầu vào · Ước tính chỉ để so sánh — / 1K token Đầu ra · Token đầu ra · Ước tính chỉ để so sánh — / 1K token Đầu vào · Đọc bộ nhớ đệm · Ước tính chỉ để so sánh — / 1K token Đầu vào · Ghi bộ nhớ đệm · Ước tính chỉ để so sánh — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ · Ước tính chỉ để so sánh — / 1K token
Cấu hìnhảnh đầu ra	Biểu mức phí—	Số lượng dự báo—	Đơn vị tính phímỗi ảnh đầu ra	Phí Đầu ra · ảnh đầu ra · Ước tính chỉ để so sánh $0.26 mỗi ảnh đầu ra
Cấu hìnhChi phí tạo ước tính	Biểu mức phí—	Số lượng dự báoước tính cho một lần tạo	Đơn vị tính phí—	Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh $0.26 ước tính trước khi tạo Ước tính này không phải là khoản phí bổ sung hay mức giá cố định cho lượt tạo đã hoàn tất.

Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. Cách hoạt động của cơ chế tạm giữ và quyết toán →

Ví dụ yêu cầu

Ailoot Ultra · Ảnh

curl

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'sourceful/riverflow-v2.5-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Nhận và lưu kết quả

Ailoot Ultra · Ảnh

Tải xuống từng ảnh trả về hoặc lưu nội dung Base64 của ảnh

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Lượt đọc nội dung khác

Đọc tài nguyên hiện có thuộc về bạn

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

Lưu tất cả kết quả đã hoàn tất

Lưu mọi ảnh đã hoàn tất; truy xuất từng URL trả về hoặc giải mã nội dung Base64 của ảnh.

Giữ lại toàn bộ phản hồi và các header, mọi đầu ra thực tế, các định danh gốc đã trả về và mọi trường usage. Khôi phục thao tác gốc mà không gửi lại yêu cầu tạo.

Nếu cần kiểm tra phản hồi gốc

Giữ lại X-Client-Request-ID đã trả về để đối soát. Chỉ truy xuất theo các giá trị task_id/asset_id thực tế đã trả về hoặc từ thư viện nội dung đa phương tiện thuộc quyền sở hữu của bạn; tuyệt đối không tạo URL tác vụ từ ID thao tác và không gửi lại yêu cầu tạo.

Trường phản hồi

Trường	Loại
Trường`created`	Loại
Trường`data[].url`	Loại
Trường`data[].b64_json`	Loại
Trường`usage`	Loại

Bí danh

Bí danh mô hình

Ailoot Ultra sourceful/riverflow-v2.5-pro

Bí danh đường dẫn phương thức

/v1/images

ID gọi liên quan

sourceful/riverflow-v2.5-pro

FAQ · Sourceful: Riverflow V2.5 Pro

Có những đầu vào và kết quả nào?: POST /v1/images/generations · sourceful/riverflow-v2.5-pro: text, image → image
Yêu cầu sử dụng những trường nào?: POST /v1/images/generations · sourceful/riverflow-v2.5-pro: model, prompt, resolution, aspect_ratio, output_format, background, n, input_references, provider
Áp dụng những giới hạn nào?: POST /v1/images/generations · sourceful/riverflow-v2.5-pro: n.minimum: 1; n.maximum: 1

Sourceful: Riverflow V2.5 Pro