Felo API PlatformFelo API Platform
بازگشت به مدل‌ها

Recraft V4.1 Flash API

Recraft V4.1 Flash سریع‌ترین مدل تصویرسازی Recraft است که تصاویر رستر ۱K را در حدود ۱.۳ ثانیه از طریق API تولید می‌کند.

Recraft V4.1 Flash یک مدل تولید تصویر از متن است که در سپتامبر ۲۰۲۶ معرفی شده و به عنوان سریع‌ترین مدل تصویرسازی Recraft شناخته می‌شود. این مدل تصاویر رستر با رزولوشن ۱K تولید می‌کند و می‌تواند در هر درخواست بین ۱ تا ۶ تصویر ایجاد کند. پرامپت‌های تا ۱۰٬۰۰۰ کاراکتر را می‌پذیرد و نسبت‌های تصویر مانند ۱:۱، ۱۶:۹ و ۳:۴ یا اندازه‌های دقیق مثل 1024x1024 را پشتیبانی می‌کند.

این مدل برای تولید انبوه تصویر، تکرار سریع خلاقانه و بررسی سبک‌های بصری در زمان واقعی مناسب است. کیفیت آن نزدیک به مدل کامل Recraft V4.1 توصیف شده و از پرامپت‌ها به دقت پیروی می‌کند و از ظاهر عمومی و کلیشه‌ای هوش مصنوعی پرهیز دارد. کاربردهایی مانند عکاسی، پرتره، تصاویر حال‌وهوا و صحنه‌های پیچیده، مفاهیم اولیه، ایده‌های لوگو و ساخت مودبورد را پوشش می‌دهد.

دکمه Enhance تصویر را با Recraft V4.1 Pro در رزولوشن ۲۰۴۸ در ۲۰۴۸ بازتولید می‌کند و دو سطح دارد: Subtle و Moderate (پیش‌فرض). این مدل از استایل‌های سفارشی قابل اشتراک در سراسر پلتفرم پشتیبانی می‌کند و از طریق API با گزینه‌های یکپارچه‌سازی cURL، Python و JavaScript در دسترس است. پاسخ‌های multipart نیز پشتیبانی می‌شوند تا بایت‌های تصویر مستقیماً در پاسخ بازگردانده شوند.

به‌روزرسانی:

MODEL ID

recraft-v4.1-flash
ورودی
text
خروجی
image

نکات برجسته

  • سریع‌ترین مدل تصویرسازی Recraft
  • تولید تصویر ۱K در حدود ۱.۳ ثانیه
  • پشتیبانی از پرامپت تا ۱۰٬۰۰۰ کاراکتر
  • تولید ۱ تا ۶ تصویر در هر درخواست
  • ارتقا با Enhance به ۲۰۴۸ در ۲۰۴۸
  • استایل‌های سفارشی قابل اشتراک

ارائه‌دهندگان

1 ارائه‌دهنده

قیمت API را بین ارائه‌دهندگان مقایسه کنید. یک ارائه‌دهنده را انتخاب کنید تا همه هزینه‌ها و شرایط را ببینید.

ارائه‌دهنده · جزئیات قیمت‌گذاری
دسترس‌پذیری
$0.007

بنچمارک‌ها

  • میانه تأخیر

    ثانیه

    1.4
  • تأخیر صدک ۹۵

    ثانیه

    1.8

امتیازها همان‌گونه که ارائه‌دهنده مدل منتشر کرده است.

شروع سریع

وظیفه تصویر را ارسال کنید، وضعیت را بررسی و تصاویر را ذخیره کنید. مثال‌ها از curl و کتابخانه استاندارد Python 3 استفاده می‌کنند.

POST https://openapi.felo.ai/api/v1/images/generations

1کلید API خود را بگیرید

از حساب Felo API Platform خود کلیدی بسازید و آن را به‌عنوان متغیر محیطی تنظیم کنید.

export FELO_API_KEY="YOUR_API_KEY"

2اولین درخواست خود را بفرستید

مقادیر اختیاری به مدل بستگی دارند و اینجا تنظیم نشده‌اند. آن‌ها را در Playground تأیید کنید. فیلدها هم‌سطح model و prompt هستند و داخل input قرار نمی‌گیرند.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
  "model": "recraft-v4.1-flash"
}'

3بررسی وظیفه

ارسال، task_id برمی‌گرداند. در queued یا running هر ۳ ثانیه بررسی کنید؛ در succeeded، failed یا interrupted متوقف شوید. حداکثر انتظار ۳۰ دقیقه است. برای ادامه بررسی بدون ارسال مجدد، created.json را نگه دارید.

python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen

task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800

while task["status"] in ("queued", "running"):
    if time.monotonic() >= deadline:
        raise TimeoutError(f"Keep task_id={task_id} to resume polling")
    time.sleep(3)
    with urlopen(Request(url, headers=headers), timeout=60) as response:
        task = json.load(response)
    if task.get("task_id") != task_id or task.get("kind") != "image":
        raise ValueError("Unexpected task response")
    print(task["status"])

if task["status"] != "succeeded":
    raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
    raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY

4دانلود خروجی

پس از موفقیت، outputs را از task.json ذخیره کنید. نشانی HTTPS، شیء URL و b64_json پشتیبانی می‌شوند. پیوندهای امضاشده را زود دانلود کنید؛ دانلود تصویر به کلید API نیاز ندارد.

python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen

task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
    raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}

for index, output in enumerate(task["outputs"], 1):
    item = output if isinstance(output, dict) else {}
    url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
    mime = item.get("media_type") or "image/png"
    if url and url.startswith("https://"):
        with urlopen(url, timeout=60) as response:
            data = response.read()
            mime = response.headers.get_content_type()
    elif url and url.startswith("data:image/") and ";base64," in url:
        header, encoded = url.split(",", 1)
        mime = header[5:].split(";", 1)[0]
        data = base64.b64decode(encoded, validate=True)
    elif item.get("b64_json"):
        data = base64.b64decode(item["b64_json"], validate=True)
    else:
        raise ValueError("Unrecognized image output")
    path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
    path.write_bytes(data)
    print(path)
PY

پارامترهای پشتیبانی‌شده

  • n
  • aspect_ratio

مرجع کامل را ترجیح می‌دهید؟

مرجع API →

پرسش‌های متداول

معرفی مدل: Recraft V4.1 Flash?

Recraft V4.1 Flash یک مدل تولید تصویر از متن است که در سپتامبر ۲۰۲۶ معرفی شده و به عنوان سریع‌ترین مدل تصویرسازی Recraft شناخته می‌شود. این مدل تصاویر رستر با رزولوشن ۱K تولید می‌کند و می‌تواند در هر درخواست بین ۱ تا ۶ تصویر ایجاد کند. پرامپت‌های تا ۱۰٬۰۰۰ کاراکتر را می‌پذیرد و نسبت‌های تصویر مانند ۱:۱، ۱۶:۹ و ۳:۴ یا اندازه‌های دقیق مثل 1024x1024 را پشتیبانی می‌کند. این مدل برای تولید انبوه تصویر، تکرار سریع خلاقانه و بررسی سبک‌های بصری در زمان واقعی مناسب است. کیفیت آن نزدیک به مدل کامل Recraft V4.1 توصیف شده و از پرامپت‌ها به دقت پیروی می‌کند و از ظاهر عمومی و کلیشه‌ای هوش مصنوعی پرهیز دارد. کاربردهایی مانند عکاسی، پرتره، تصاویر حال‌وهوا و صحنه‌های پیچیده، مفاهیم اولیه، ایده‌های لوگو و ساخت مودبورد را پوشش می‌دهد. دکمه Enhance تصویر را با Recraft V4.1 Pro در رزولوشن ۲۰۴۸ در ۲۰۴۸ بازتولید می‌کند و دو سطح دارد: Subtle و Moderate (پیش‌فرض). این مدل از استایل‌های سفارشی قابل اشتراک در سراسر پلتفرم پشتیبانی می‌کند و از طریق API با گزینه‌های یکپارچه‌سازی cURL، Python و JavaScript در دسترس است. پاسخ‌های multipart نیز پشتیبانی می‌شوند تا بایت‌های تصویر مستقیماً در پاسخ بازگردانده شوند.

هزینه استفاده چگونه محاسبه می‌شود؟

صورت‌حساب شما به ارائه‌دهنده‌ای که استفاده می‌کنید، قیمت‌های آن و میزان مصرف شما بستگی دارد. ورودی‌های طولانی‌تر یا شرایط دیگر ممکن است قیمت متفاوتی داشته باشند.

Recraft V4.1 Flash چه نوع ورودی و خروجی‌ای پشتیبانی می‌کند؟

این مدل ورودی متنی می‌پذیرد و تصویر رستر تولید می‌کند. پرامپت‌ها می‌توانند تا ۱۰٬۰۰۰ کاراکتر باشند.

حداکثر تعداد تصاویر در هر درخواست چقدر است؟

می‌توان در هر درخواست بین ۱ تا ۶ تصویر تولید کرد.

چه نسبت‌ها یا اندازه‌هایی برای تصویر پشتیبانی می‌شود؟

نسبت‌هایی مانند ۱:۱، ۱۶:۹ و ۳:۴ یا اندازه‌های دقیق مثل 1024x1024 پشتیبانی می‌شوند.

دکمه Enhance چه کاری انجام می‌دهد؟

تصویر را با Recraft V4.1 Pro در رزولوشن ۲۰۴۸ در ۲۰۴۸ بازتولید می‌کند. دو سطح Subtle و Moderate (پیش‌فرض) دارد.

تفاوت Recraft V4.1 Flash با سایر مدل‌های خانواده V4.1 چیست؟

Flash لایه سرعت و هزینه است و نسخه‌های Vector و Pro ندارد. Recraft V4.1 Pro لایه پرچمدار رستر برای تحویل نهایی است، Recraft V4.1 Vector برای SVG و لوگوتایپ و Recraft V4.1 Utility برای عکس‌های ساده محصول کاربرد دارد.

مدل‌های مرتبط