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

Recraft V4.1 Flash V2 (free) API

빠른 반복 작업과 이미지 변형 대량 생성에 적합한 텍스트 기반 이미지 모델입니다.

Recraft V4.1 Flash V2는 텍스트 입력만으로 약1K 해상도의 래스터 이미지를 생성합니다. Recraft V4.1 Flash와 동일한 종횡비를 지원하며, 색상과 배경색을 조정할 수 있습니다. 원본 Recraft V4.1 Flash보다 텍스트 렌더링과 세부 묘사 기능이 개선되었습니다.

초기 아이디어 탐색, 프롬프트 반복, 문구·스타일 조합과 구도 테스트에 적합합니다. 이미지 변형을 대량으로 생성할 때도 빠른 반복을 지원하지만, 출력 해상도가 낮아 최종 납품물보다는 프로토타이핑에 알맞습니다. 이미지 입력, 스타일 및 스타일 참조, 기존 이미지 편집, SVG·벡터 출력은 지원하지 않습니다.

Recraft Studio의 모델 선택기와 직접 Recraft API에서 사용할 수 있습니다. 생성된 이미지는 Enhance를 통해 Recraft V4.1 Pro로2048 by2048 해상도에서 다시 생성할 수 있으며, 원래 구도와 조명을 유지하면서 Subtle 또는 Moderate 수준을 적용할 수 있습니다.

업데이트:

모델 ID

recraft-v4.1-flash-v2:free
컨텍스트
65.536K
최대 출력
58.982K
입력
text
출력
image

주요 특징

  • 약1K 래스터 이미지
  • 색상·배경색 제어
  • 개선된 텍스트 렌더링
  • 빠른 이미지 반복
  • 대량 변형 생성

제공 업체

1 제공 업체

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

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

벤치마크

  • 생성 속도

    이미지1장당1.1초

    1.1
  • 원본 Recraft V4.1 Flash 중앙 지연 시간

    100개 프롬프트를 사용한 벤치마크에서1.4초

    1.4
  • 원본 Recraft V4.1 Flash95백분위 지연 시간

    100개 프롬프트를 사용한 벤치마크에서1.8초

    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-v2:free"
}'

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

전체 레퍼런스가 필요하신가요?

API 문서 →

자주 묻는 질문

모델 소개: Recraft V4.1 Flash V2 (free)?

Recraft V4.1 Flash V2는 텍스트 입력만으로 약1K 해상도의 래스터 이미지를 생성합니다. Recraft V4.1 Flash와 동일한 종횡비를 지원하며, 색상과 배경색을 조정할 수 있습니다. 원본 Recraft V4.1 Flash보다 텍스트 렌더링과 세부 묘사 기능이 개선되었습니다. 초기 아이디어 탐색, 프롬프트 반복, 문구·스타일 조합과 구도 테스트에 적합합니다. 이미지 변형을 대량으로 생성할 때도 빠른 반복을 지원하지만, 출력 해상도가 낮아 최종 납품물보다는 프로토타이핑에 알맞습니다. 이미지 입력, 스타일 및 스타일 참조, 기존 이미지 편집, SVG·벡터 출력은 지원하지 않습니다. Recraft Studio의 모델 선택기와 직접 Recraft API에서 사용할 수 있습니다. 생성된 이미지는 Enhance를 통해 Recraft V4.1 Pro로2048 by2048 해상도에서 다시 생성할 수 있으며, 원래 구도와 조명을 유지하면서 Subtle 또는 Moderate 수준을 적용할 수 있습니다.

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

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

어떤 입력과 출력을 지원하나요?

텍스트 입력을 받아 래스터 이미지를 생성합니다. 텍스트-이미지 생성만 지원하며 이미지 입력은 지원하지 않습니다.

출력 해상도와 종횡비는 어떻게 되나요?

이미지는 약1K 해상도로 생성되며, Recraft V4.1 Flash와 동일한 종횡비를 지원합니다.

어떤 작업에 적합한가요?

초기 창작 탐색, 빠른 프롬프트 반복, 문구·스타일 조합과 구도 테스트, 이미지 변형 대량 생성에 적합합니다.

기존 이미지를 편집하거나 벡터로 출력할 수 있나요?

기존 이미지 편집과 SVG·벡터 출력은 지원하지 않습니다. 스타일 및 스타일 참조도 지원하지 않습니다.

같은 계열의 다른 모델과 비교하면 어떤 차이가 있나요?

Recraft V4.1 Flash V2는 빠른 반복과 대량 변형 생성에 초점을 둔 모델이며, 최종 납품보다는 프로토타이핑에 적합합니다.

관련 모델