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

Microsoft AI: MAI-Image-2.7 Flash API

빠른 이미지 생성과 정밀 편집을 지원하는 Microsoft AI의 공개 프리뷰 모델입니다.

Microsoft AI의 MAI-Image-2.7 Flash는 확산 기반 텍스트-이미지 생성과 정밀하고 제어 가능한 이미지-이미지 편집을 지원합니다. 텍스트 입력과 이미지 입력을 받아 이미지를 출력하며, 최대5개의 스타일 또는 주제 참조 이미지로 참조 기반 에셋을 만들 수 있습니다. 출력은 항상 PNG이며 base64로 인코딩된 JSON 객체로 반환됩니다.

이 모델은 MAI-Image-2.7과 동일한 생성 및 편집 기능을 유지하면서 더 빠르고 비용을 낮춘 변형으로 설계되었습니다. 속도를 위해 일부 충실도를 양보하므로4K 수준의 마무리보다 대량 초안 제작과 반복 작업에 적합합니다. 상품 사진 정리, 투명 배경 생성, 객체 교체, 색상·재질 변경, 간판과 마케팅 이미지의 텍스트 렌더링에 활용할 수 있습니다.

이미지 생성과 편집에만 한정되며 텍스트 추론, 도구 사용, 웹 검색은 지원하지 않습니다. 참조 이미지는 JPEG 또는 PNG 형식이어야 하고 이미지 편집에서는 최대5개까지 사용할 수 있으며, 출력 이미지의 너비와 높이는 각각 최소768 픽셀이어야 합니다. 로컬 편집에서는 편집 영역을 명시하는 것이 권장됩니다.

업데이트:

모델 ID

mai-image-2.7-flash
컨텍스트
4.096K
최대 출력
1.024K
입력
text / image
출력
image

주요 특징

  • 확산 기반 이미지 생성
  • 정밀한 이미지 편집
  • 최대5개 참조 이미지
  • 빠른 반복 작업
  • PNG 이미지 출력

제공 업체

1 제공 업체

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

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

벤치마크

  • Artificial Analysis 리더보드 — 이미지 편집

    순위7위

    7
  • Artificial Analysis 리더보드 — 텍스트-이미지 생성

    순위11위

    11
  • Artificial Analysis — 장면 및 스타일 편집

    순위3위

    3
  • Artificial Analysis — 향상 및 복원

    순위4위

    4

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

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": "mai-image-2.7-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
input_references

이미지 편집 시 예제 URL을 본인의 HTTPS 이미지 URL 또는 base64 이미지 data URL로 바꾸세요. 한 번 제출한 후 동일한 조회 및 저장 단계를 따릅니다.

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": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
  "model": "mai-image-2.7-flash",
  "input_references": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/product.png"
      }
    }
  ]
}'

지원 매개변수

  • n
  • background
  • max_tokens
  • temperature
  • aspect_ratio
  • input_references
  • max_completion_tokens

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

API 문서 →

자주 묻는 질문

모델 소개: Microsoft AI: MAI-Image-2.7 Flash?

Microsoft AI의 MAI-Image-2.7 Flash는 확산 기반 텍스트-이미지 생성과 정밀하고 제어 가능한 이미지-이미지 편집을 지원합니다. 텍스트 입력과 이미지 입력을 받아 이미지를 출력하며, 최대5개의 스타일 또는 주제 참조 이미지로 참조 기반 에셋을 만들 수 있습니다. 출력은 항상 PNG이며 base64로 인코딩된 JSON 객체로 반환됩니다. 이 모델은 MAI-Image-2.7과 동일한 생성 및 편집 기능을 유지하면서 더 빠르고 비용을 낮춘 변형으로 설계되었습니다. 속도를 위해 일부 충실도를 양보하므로4K 수준의 마무리보다 대량 초안 제작과 반복 작업에 적합합니다. 상품 사진 정리, 투명 배경 생성, 객체 교체, 색상·재질 변경, 간판과 마케팅 이미지의 텍스트 렌더링에 활용할 수 있습니다. 이미지 생성과 편집에만 한정되며 텍스트 추론, 도구 사용, 웹 검색은 지원하지 않습니다. 참조 이미지는 JPEG 또는 PNG 형식이어야 하고 이미지 편집에서는 최대5개까지 사용할 수 있으며, 출력 이미지의 너비와 높이는 각각 최소768 픽셀이어야 합니다. 로컬 편집에서는 편집 영역을 명시하는 것이 권장됩니다.

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

이용하는 제공 업체의 요금과 실제 사용량에 따라 비용이 결정됩니다. 긴 입력 등에는 다른 요금이 적용될 수 있습니다. 실제 생성 비용을 기준으로 과금됩니다. 최종 금액은 청구 내역을 확인하세요.

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

텍스트 입력과 이미지 입력을 지원하며 이미지를 출력합니다. 출력은 항상 PNG이고 base64로 인코딩된 JSON 객체로 반환됩니다.

참조 이미지는 몇 개까지 사용할 수 있나요?

스타일 또는 주제 참조 이미지를 최대5개까지 사용할 수 있습니다. 참조 이미지는 JPEG 또는 PNG 형식이어야 합니다.

컨텍스트와 출력 길이는 어떻게 되나요?

컨텍스트는32,000 tokens입니다. 별도의 output_limit은 제공되지 않았습니다.

어떤 작업에 적합한가요?

대량 초안 제작, 빠른 반복, 상품 사진 정리, 객체 교체, 색상이나 재질 변경, 간판과 마케팅 이미지 제작에 적합합니다.

이미지 편집 시 주의할 제한이 있나요?

이미지 편집에서는 참조 이미지를 최대5개까지 사용할 수 있으며 출력 이미지의 너비와 높이는 각각 최소768 픽셀이어야 합니다. 로컬 편집에서는 편집 영역을 명시하는 것이 권장됩니다.

같은 계열 모델과 어떤 차이가 있나요?

MAI-Image-2.7 Flash는 MAI-Image-2.7의 생성 및 편집 기능을 유지하면서 속도와 대량 반복 작업에 초점을 둔 변형입니다.

관련 모델