Felo API PlatformFelo API Platform
모델 목록으로 돌아가기

Recraft V4.1 Flash API

Recraft V4.1 Flash는 약 1.3초 만에 이미지를 생성하는 Recraft의 가장 빠른 이미지 모델로, V4.1 제품군의 속도·비용 등급을 담당합니다.

Recraft V4.1 Flash는 Recraft가 2026년 9월에 공개한 텍스트-이미지 모델로, API 기준 약 1.3초 만에 이미지를 생성하는 Recraft史上 가장 빠른 이미지 모델입니다. 1K 해상도의 래스터 이미지를 출력하며 최대 10,000자 프롬프트, 1:1·16:9·3:4 같은 비율 또는 1024x1024 같은 정확한 크기, 요청당 1~6장 생성을 지원합니다.

속도와 비용을 우선한 등급이지만 품질은 정식 Recraft V4.1 모델에 가깝고, 프롬프트를 충실히 따르면서 흔한 AI 느낌을 피합니다. 초안이 아닌 완성된 이미지를 반환하므로 대량 이미지 생성, 빠른 크리에이티브 반복, 사진·인물·분위기 이미지, 복잡한 장면, 초기 콘셉트와 로고 아이디어, 무드보드 제작, 스타일 테스트, 실시간 창작 방향 탐색에 적합합니다.

Enhance 버튼을 사용하면 Recraft V4.1 Pro로 2048x2048 해상도의 이미지를 다시 생성할 수 있으며, Enhance는 Subtle과 Moderate(기본값) 두 단계를 제공합니다. 스타일 파라미터·스타일 레퍼런스·네거티브 프롬프트·텍스트 레이아웃 제어는 지원하지 않고, Vector·Pro 변형도 없습니다. API는 cURL, Python, JavaScript 통합을 제공하고 이미지 바이트를 응답에 직접 반환하는 멀티파트 응답을 지원합니다.

업데이트:

모델 ID

recraft-v4.1-flash
입력
text
출력
image

주요 특징

  • API 기준 약 1.3초 이미지 생성
  • Recraft史上 가장 빠른 이미지 모델
  • 1K 해상도 래스터 출력
  • 최대 10,000자 프롬프트 지원
  • 요청당 1~6장 생성
  • Enhance로 2048x2048 업그레이드

제공 업체

1 제공 업체

제공 업체별 API 요금을 비교하세요. 공급자를 선택하면 전체 요금과 적용 조건을 확인할 수 있습니다.

제공 업체 · 요금 상세
가동률
$0.007

벤치마크

  • 중앙값 지연 시간

    초

    1.4
  • 95번째 백분위 지연 시간

    초

    1.8

점수는 모델 제공 업체가 공개한 값입니다.

Quick Start

이미지 작업을 제출하고 상태를 조회한 뒤 이미지를 저장합니다. curl과 Python 3 표준 라이브러리만 사용합니다.

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

1API key 설정

Felo API Platform 계정에서 key를 만들고 환경 변수로 설정하세요.

export FELO_API_KEY="YOUR_API_KEY"

2첫 요청 보내기

선택 매개변수 값은 모델마다 달라 예제에서는 지정하지 않습니다. 추가 전에 Playground에서 확인하세요. 필드는 input 안이 아닌 model, prompt와 같은 수준에 둡니다.

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이면 3초마다 조회하고 succeeded, failed, interrupted이면 멈춥니다. 최대 30분 대기합니다. 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출력 다운로드

성공하면 task.json의 outputs를 저장합니다. HTTPS URL, URL 객체, b64_json을 지원합니다. 서명 URL은 즉시 다운로드하세요. 이미지 다운로드에는 API Key가 필요하지 않습니다.

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가 2026년 9월에 공개한 텍스트-이미지 모델로, API 기준 약 1.3초 만에 이미지를 생성하는 Recraft史上 가장 빠른 이미지 모델입니다. 1K 해상도의 래스터 이미지를 출력하며 최대 10,000자 프롬프트, 1:1·16:9·3:4 같은 비율 또는 1024x1024 같은 정확한 크기, 요청당 1~6장 생성을 지원합니다. 속도와 비용을 우선한 등급이지만 품질은 정식 Recraft V4.1 모델에 가깝고, 프롬프트를 충실히 따르면서 흔한 AI 느낌을 피합니다. 초안이 아닌 완성된 이미지를 반환하므로 대량 이미지 생성, 빠른 크리에이티브 반복, 사진·인물·분위기 이미지, 복잡한 장면, 초기 콘셉트와 로고 아이디어, 무드보드 제작, 스타일 테스트, 실시간 창작 방향 탐색에 적합합니다. Enhance 버튼을 사용하면 Recraft V4.1 Pro로 2048x2048 해상도의 이미지를 다시 생성할 수 있으며, Enhance는 Subtle과 Moderate(기본값) 두 단계를 제공합니다. 스타일 파라미터·스타일 레퍼런스·네거티브 프롬프트·텍스트 레이아웃 제어는 지원하지 않고, Vector·Pro 변형도 없습니다. API는 cURL, Python, JavaScript 통합을 제공하고 이미지 바이트를 응답에 직접 반환하는 멀티파트 응답을 지원합니다.

사용 요금은 어떻게 계산되나요?

이용하는 제공 업체의 요금과 실제 사용량에 따라 비용이 결정됩니다. 긴 입력 등에는 다른 요금이 적용될 수 있습니다.

Recraft V4.1 Flash는 어떤 입력을 지원하나요?

텍스트 입력을 지원하며, 최대 10,000자 길이의 프롬프트를 사용할 수 있습니다.

출력 해상도와 이미지 수는 어떻게 되나요?

1K 해상도의 래스터 이미지를 출력하며, 요청당 1~6장을 생성할 수 있습니다. 1:1·16:9·3:4 비율이나 1024x1024 같은 정확한 크기를 지정할 수 있습니다.

Enhance 기능은 무엇인가요?

Enhance 버튼은 Recraft V4.1 Pro로 2048x2048 해상도의 이미지를 다시 생성하며, Subtle과 Moderate(기본값) 두 단계를 제공합니다.

어떤 작업에 적합한가요?

대량 이미지 생성, 빠른 크리에이티브 반복, 사진·인물·분위기 이미지, 복잡한 장면, 초기 콘셉트와 로고 아이디어, 무드보드 제작, 스타일 테스트, 실시간 창작 방향 탐색에 적합합니다.

Recraft V4.1 Pro와 무엇이 다른가요?

Recraft V4.1 Flash는 V4.1 제품군 내 속도·비용 등급으로, 정식 Recraft V4.1 모델에 가까운 품질을 더 빠르게 제공합니다. Recraft V4.1 Pro는 최종 결과물·마케팅 비주얼·브랜드 자산·인쇄용 2K 구성에 쓰이는 플래그십 래스터 등급입니다.

관련 모델