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

Recraft V4.1 Flash V2 API

مدلی سریع برای تولید تصاویر رستری از متن، مناسب نمونه‌سازی، ایده‌پردازی و تولید پرحجم با کنترل رنگ و پس‌زمینه.

Recraft V4.1 Flash V2 یک مدل تولید تصویر از متن است که خروجی‌های رستری را با وضوح تقریبی1K ایجاد می‌کند. تولید تصویر از پرامپت حدود1.1 تا1.3 ثانیه طول می‌کشد و مدل همان نسبت‌های تصویر Recraft V4.1 Flash را پشتیبانی می‌کند. کنترل رنگ و رنگ پس‌زمینه در دسترس است و نسخه V2 برای سرعت بیشتر و نمایش بهتر متن داخل تصاویر طراحی شده است.

این مدل برای نمونه‌سازی سریع، ایده‌پردازی تصویری، آزمودن هم‌زمان پرامپت‌ها، پیش‌نویس‌های اولیه، ماکاپ‌های پروژه‌های فرانت‌اند و تصاویر فهرست محصولات مناسب است. ظاهر Recraft را در عکاسی، پرتره، حال‌وهوا، صحنه‌های پیچیده و مفاهیم اولیه حفظ می‌کند، اما سرعت را بر بیشترین وفاداری و جزئیات ترجیح می‌دهد.

Recraft V4.1 Flash V2 فقط تولیدکننده است و از تصویر‌به‌تصویر، سبک، شناسه سبک و مراجع سبک پیوست‌شده پشتیبانی نمی‌کند. قابلیت Enhance می‌تواند نتیجه را با Recraft V4.1 Pro در وضوح2048 by2048 بازتولید کند؛ حالت Subtle به نویز و کنتراست رسیدگی می‌کند و Moderate جزئیات کوچک را فعالانه‌تر بازسازی می‌کند، در حالی که چیدمان حفظ می‌شود.

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

MODEL ID

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

نکات برجسته

  • تولید از متن با وضوح تقریبی1K
  • حدود1.1 تا1.3 ثانیه برای تولید
  • کنترل رنگ و رنگ پس‌زمینه
  • نمایش بهتر متن در تصویر
  • مناسب ایده‌پردازی و پیش‌نویس
  • بدون پشتیبانی از تصویر‌به‌تصویر

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

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

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

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

بنچمارک‌ها

  • تأخیر میانه

    ثانیه؛ هم‌سطح FLUX.2 klein9B

    1.4
  • تأخیر صدک95

    ثانیه؛ در مقایسه با2.1 ثانیه برای FLUX.2 klein9B

    1.8
  • تأخیر میانه Z-Image-Turbo

    ثانیه

    1.8
  • تأخیر میانه FLUX.1 schnell

    ثانیه

    1.6
  • تأخیر صدک95 FLUX.1 schnell

    ثانیه

    3.6
  • تأخیر میانه Nano Banana Pro

    ثانیه

    23.3
  • تأخیر میانه Ideogram3.0

    ثانیه

    10.7
  • تأخیر میانه Grok Imagine Image2.0

    ثانیه

    69.9

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

شروع سریع

وظیفه تصویر را ارسال کنید، وضعیت را بررسی و تصاویر را ذخیره کنید. مثال‌ها از 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-v2"
}'

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 V2?

Recraft V4.1 Flash V2 یک مدل تولید تصویر از متن است که خروجی‌های رستری را با وضوح تقریبی1K ایجاد می‌کند. تولید تصویر از پرامپت حدود1.1 تا1.3 ثانیه طول می‌کشد و مدل همان نسبت‌های تصویر Recraft V4.1 Flash را پشتیبانی می‌کند. کنترل رنگ و رنگ پس‌زمینه در دسترس است و نسخه V2 برای سرعت بیشتر و نمایش بهتر متن داخل تصاویر طراحی شده است. این مدل برای نمونه‌سازی سریع، ایده‌پردازی تصویری، آزمودن هم‌زمان پرامپت‌ها، پیش‌نویس‌های اولیه، ماکاپ‌های پروژه‌های فرانت‌اند و تصاویر فهرست محصولات مناسب است. ظاهر Recraft را در عکاسی، پرتره، حال‌وهوا، صحنه‌های پیچیده و مفاهیم اولیه حفظ می‌کند، اما سرعت را بر بیشترین وفاداری و جزئیات ترجیح می‌دهد. Recraft V4.1 Flash V2 فقط تولیدکننده است و از تصویر‌به‌تصویر، سبک، شناسه سبک و مراجع سبک پیوست‌شده پشتیبانی نمی‌کند. قابلیت Enhance می‌تواند نتیجه را با Recraft V4.1 Pro در وضوح2048 by2048 بازتولید کند؛ حالت Subtle به نویز و کنتراست رسیدگی می‌کند و Moderate جزئیات کوچک را فعالانه‌تر بازسازی می‌کند، در حالی که چیدمان حفظ می‌شود.

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

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

چه ورودی و خروجی‌ای پشتیبانی می‌شود؟

ورودی مدل متن و خروجی آن تصویر رستری است. تولید آن از متن انجام می‌شود.

مدل چه کنترل‌هایی دارد؟

کنترل رنگ و رنگ پس‌زمینه پشتیبانی می‌شود. تصویر‌به‌تصویر، سبک، شناسه سبک و مراجع سبک پیوست‌شده پشتیبانی نمی‌شوند.

این مدل برای چه کارهایی مناسب است؟

برای نمونه‌سازی سریع، تولید پرحجم، ایده‌پردازی، پیش‌نویس‌های اولیه، ماکاپ‌های فرانت‌اند و تصاویر فهرست محصولات مناسب است.

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

Enhance می‌تواند نتیجه را با Recraft V4.1 Pro در وضوح2048 by2048 بازتولید کند. حالت Subtle به نویز و کنتراست رسیدگی می‌کند و Moderate جزئیات کوچک را فعالانه‌تر بازسازی می‌کند.

تفاوت آن با مدل‌های هم‌خانواده چیست؟

این مدل سریع‌ترین مدل در خانواده Recraft V4.1 معرفی شده و برای اکتشاف و پیش‌نویس طراحی شده است؛ Recraft V4.1 Pro برای بازتولید Enhance استفاده می‌شود.

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