무검열 AI 이미지 변환 생성기: 이미지 편집 API 실전 가이드

코드로 사진의 조명, 배경, 의상, 글자 등 한 가지만 바꾸려면 지시를 거부하거나 몰래 완화하지 않는 편집 모델이 필요합니다. 이 가이드는 어떤 편집 엔드포인트를 호출할지, 요금과 허용 입력, Playground에서 시험한 뒤 코드나 Agent로 실행하는 방법, 실패 시 대처법을 설명합니다.

한 줄 답변: 이미지 변환 호출은 모델 ID가 /edit로 끝나는 엔드포인트의 작업입니다. 프롬프트와 원본 이미지를 보내면 편집된 파일을 받습니다. 사진 한 장과 지시 하나라면 Qwen Image Edit Spicy부터 시작하세요. 편집당 $0.038, 원본 한 장이며 마스크나 강도 조절은 없습니다. 여러 원본을 함께 쓰려면 Qwen Image 3.0, Seedream 5.0 Pro, Wan 2.7을 선택합니다. 마스크에는 Qwen Image 2.1이나 FLUX.1 Dev LoRA를 사용합니다. strength는 FLUX.1 Dev LoRA와 Z-Image Turbo LoRA에만 있습니다.

아래 요금과 한도는 현재 카탈로그와 문서를 기준으로 하며, 각 요금은 무료 견적으로 확인했습니다.

편집 엔드포인트에서 ‘무검열’이 뜻하는 것

‘무검열’은 콘텐츠 필터가 없다고 명시한 모델의 카탈로그 분류입니다. SpicyAPI는 플랫폼 차원의 콘텐츠 검사를 추가하지 않으며, 결과는 모델이 결정합니다. 모든 지시를 수행한다는 약속은 아닙니다. 두 가지 결과에 대비해야 합니다.

• 거부되면 작업이 failed로 종료되고 errorCode: "content_rejected"가 반환됩니다. 잔액에서 예약된 금액은 전액 해제됩니다.
• 완화된 결과는 요청보다 수위가 낮은 완성 이미지입니다. 성공한 작업이므로 과금되지만 응답에는 이를 나타내는 표시가 없습니다. 이미지를 직접 봐야 알 수 있습니다.

모든 모델에 적용되는 제한도 있습니다. 어떤 스타일이든 미성년자를 성적으로 묘사하거나, 문서화된 동의 없이 식별 가능한 실존 인물을 친밀하거나 성적으로 묘사하는 행위(얼굴 교체와 외모 이전 포함), 사칭, 운영 지역에서 불법인 행위는 허용되지 않습니다. 편집은 원본이 실제 사진인 경우가 많아 두 번째 규칙을 위반하기 쉽습니다. 허용 이용 정책에 따르면 공개 사진, 유명인이라는 사실, 과거 관계는 동의가 아닙니다. 나이가 불분명한 자료에는 미성년자 규칙이 적용되며, 처리할 권한이 없는 사적 자료를 업로드해서는 안 됩니다.

SpicyAPI는 요청마다 심사하지 않습니다. 사용자가 사진을 올리는 서비스를 운영한다면 나이 확인, 업로드 시 동의 진술을 작업 ID와 함께 보관하는 일, 나이가 불명확한 원본 거부, 동의 기록 없는 식별 가능한 실존 인물의 편집 차단, 콘텐츠 신고 수단 제공은 운영자의 책임입니다. 이는 법률 자문이 아닙니다.

서비스는 중국 본토, 러시아, 벨라루스, 쿠바, 이란, 북한, 시리아에서 제공되지 않습니다. 약관에 따라 영국, 홍콩, 마카오, 사우디아라비아, 아랍에미리트, 카타르, 쿠웨이트, 바레인, 오만, 파키스탄, 방글라데시, 아프가니스탄, 인도네시아, 말레이시아, 브루나이에서도 제공되지 않습니다. 콘텐츠 및 이용 정책은 목록이 늘어날 수 있다고 명시합니다. 얼굴과 머리 교체는 자체 워크플로를 갖춘 별도 엔드포인트이며, AI 얼굴 교체 API 워크플로에서 다룹니다.

편집 엔드포인트 선택하기

엔드포인트마다 원본 수, 추가 제어 항목, 결과 형태가 다릅니다.

요금은 이미지 한 장 요청의 견적액입니다. Seedream 5.0 Pro의 기본 2k 요금은 1k의 두 배이며, Qwen Image 3.0은 원본당 추가 요금이 붙습니다. Qwen Image 2.1은 해상도 순서대로 요금이 오르지 않습니다. 1.5k 견적이 2k보다 높고, 2k는 원본 수와 관계없이 고정입니다. 예산을 세우기 전에 정확한 요청 본문으로 견적을 받으세요.

카탈로그에는 Seedream 5.0 Flash, Qwen Image 3.0 Pro, Wan 2.7 Pro 등 무검열로 표시된 다른 편집 모델도 있습니다. GPT Image 2와 2.5, Nano Banana의 편집 엔드포인트는 Filtered로 표시되므로 무검열 결과가 목적이라면 적합하지 않습니다.

사진 한 장, 변경 한 가지. Qwen Image Edit Spicy를 사용하세요. 요청 전체는 image_url, prompt, 선택적인 seed입니다. 지시가 유일한 제어 수단이므로 무엇을 유지할지 명시한 문장이 곧 보존 설정입니다. 리뷰에서는 일반적인 편집에 약 21초가 걸린다고 합니다. Qwen Image 2도 같은 방식이며 조금 더 저렴하지만 원본 한 장, 프롬프트 800자 제한이 있습니다.

한 번의 편집에 여러 원본. 한 사진의 얼굴, 다른 사진의 옷, 세 번째 사진의 방을 조합한다면 Qwen Image 3.0 (3장), Seedream 5.0 Pro (10장), Wan 2.7 (9장)을 선택합니다. 여러 원본을 쓰면 프롬프트에 각 이미지의 역할을 명시해야 합니다. 기본적으로 Seedream 5.0 Pro는 첫 원본에 가까운 형태, Wan 2.7은 마지막 원본 형태를 따르며 Qwen은 정사각형입니다. 세로 인물 사진을 aspect_ratio 없이 Qwen Image 3.0에 보내면 1:1로 나옵니다.

마스크나 강도 조절을 이용한 부분 편집. Qwen Image 2.1과 FLUX.1 Dev LoRA는 mask_url로 마스크를 받습니다. 원본과 같은 크기의 흑백 이미지로, 흰색 부분은 다시 그리고 검은색 부분은 보존합니다. strength (0~1, 기본 0.8, 원본에서 얼마나 달라지는지)는 FLUX.1 Dev LoRA와 Z-Image Turbo LoRA 편집 엔드포인트에 있습니다. Wan 2.7은 다른 방식으로 영역을 표시하며, bounding_boxes에 이미지당 최대 두 개의 픽셀 사각형을 지정합니다.

콘텐츠 결과. 2026년 9월 공개 테스트 보고서에서는 각 편집 모델을 다섯 콘텐츠 수준으로 시험했습니다. L1이 가장 약하고 L5가 가장 강하며, 보통 수준당 세 번 실행했습니다.

FLUX.1 Dev LoRA는 마스크와 strength를 함께 쓰는 가장 저렴한 경로입니다. 다만 공개 보고서는 텍스트→이미지 테스트이며, 강한 수준은 완화된 결과가 나왔습니다. 본격적으로 사용하기 전에 자신의 콘텐츠 수준으로 편집 한 번을 시험하세요.

모델별 상세 내용은 Seedream 5.0 Pro 같은 리뷰 페이지에 있습니다. Qwen Image Edit 무검열 테스트는 Qwen 편집 모델의 전후 비교를 보여 줍니다.

로컬인가, 호스팅인가? VRAM이 최소 8 GB인 GPU가 있고 대량 편집을 한다면 ComfyUI에서 Qwen Image Edit나 FLUX.2 Klein을 로컬로 실행하는 것도 현실적인 선택입니다. GPU를 운영하고 싶지 않거나, 앱에서 호출하거나, 이미지당 결제를 원하면 호스팅이 적합합니다. 이미지당 $0.018~$0.072이면 100회 편집은 재시도 전 $1.80~$7.20입니다.

먼저 Playground에서 시험하기

코드나 키를 다루지 않고 사진이 어떻게 편집되는지 보려면 모델 페이지의 Playground가 가장 빠릅니다.

1. Qwen Image Edit Spicy 페이지를 열고 Playground 탭의 Form 보기를 사용하세요. 실행하려면 잔액이 있는 계정으로 로그인합니다.
2. Input image에 파일을 끌어 놓습니다 (JPG, PNG, WEBP, GIF, 최대 10 MB). 또는 Asset URL과 Add URL로 이미지 파일의 직접 링크를 넣습니다.
3. Prompt에 유지할 내용을 먼저 쓰고, 바꿀 한 가지를 적습니다 (다음 절의 예시에 문구가 나옵니다).
4. 필요하면 Seed를 설정합니다. 동일한 이미지와 지시에 재사용하면 두 표현을 비교할 수 있습니다.
5. Run model을 누르고 가장 먼저 Output의 이미지를 보세요. 완화된 결과도 다른 결과처럼 과금됩니다.

다른 편집 모델은 같은 폼에 추가 원본이나 Qwen Image 2.1의 마스크 등 별도 필드가 있습니다. Form 옆 JSON 보기는 정확한 요청 본문을, 그 옆 코드 탭 (JavaScript, Python, cURL 등)은 동일한 호출을 보여 줍니다. 여기서 작동하는 설정을 프로젝트에 복사할 수 있습니다.

그다음 코드로 실행하기

Python SDK를 설치하고 (pip install spicyapi), 환경에 SPICY_API_KEY를 설정한 뒤 편집 한 번을 실행합니다. 사진을 업로드하고 요금을 표시하며, 작업을 생성하기 전에 승인을 기다리는 스크립트입니다.

import uuid
from spicyapi import SpicyClient, output_assets

client = SpicyClient()  # reads SPICY_API_KEY from the environment
MODEL = "alibaba/qwen-image-spicy-edit/edit"

source = client.upload_file("photo.jpg")  # or put a public HTTPS link in image_url
body = {
    "image_url": source["uri"],
    "prompt": "Keep the person, pose, framing and room exactly as they are. "
              "Change only the light to warm late-afternoon sun from the window on the left.",
}

quote = client.quote_task(model=MODEL, input_data=body)
print("Estimated", quote["estimatedCost"], "maximum", quote["maxCharge"])
if input("Create the task? [y/N] ").strip().lower() != "y":
    raise SystemExit

task = client.create_task(
    model=MODEL,
    input_data=body,
    idempotency_key=str(uuid.uuid4()),
    quote_id=quote["quoteId"],
    expected_cost=quote["estimatedCost"],
)
print("Resume task:", task["taskId"], flush=True)
final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
    raise SystemExit(f"{task['taskId']} ended as {final['state']}: {final.get('errorCode')}")
assets = output_assets(final)
if not assets or any(a.get("pending") or a.get("unavailable") or not a.get("url") for a in assets):
    raise RuntimeError(f"Task {task['taskId']} has no ready output; check this task before a new run")
print(assets[0]["url"])  # copy the image to your own storage now

이 호출 외의 내용은 Python SDK 참조와 작업 가이드에 있습니다. 기다리는 대신 콜백을 받아야 하는 서비스는 Webhook을 사용할 수 있습니다.

또는 Agent에게 실행 맡기기

도우미가 편집을 실행해야 한다면 공식 도구 세 가지 모두 요금을 보여 주고 유료 호출 전에 확인을 요청합니다.

• CLI. 사진을 업로드하고 반환된 spicy:// 주소와 프롬프트를 input.json의 image_url과 prompt에 넣은 뒤 다음을 실행합니다.

``bash spicyapi files upload photo.jpg spicyapi tasks create --model alibaba/qwen-image-spicy-edit/edit --input-file input.json --wait ``

CLI 문서를 참고하세요. npx @spicyapi/cli는 설치 없이 실행됩니다.

• MCP 서버. 도우미에 MCP 서버를 추가한 뒤 이렇게 요청합니다. "Edit /path/to/photo.jpg with Qwen Image Edit Spicy: keep the person, pose and room, change only the light to warm late-afternoon sun." spicyapi_upload_file로 파일을 올리고, 가격 확인을 위해 멈추는 spicyapi_task_create를 호출한 뒤 spicyapi_task_wait를 사용합니다.
• Skill. npx skills add spicyapi-ai/spicy-skill로 Agent Skill을 설치하면 코딩 도우미가 필드를 추측하는 대신 현재 모델 스키마를 읽습니다.

보낼 수 있는 입력과 비용

원본 이미지를 작업에 전달하는 방법은 세 가지입니다.

• 공개 HTTPS URL. 업로드가 필요 없습니다. 인증 정보 없이 이미지 파일 자체를 반환해야 합니다. 클라우드 드라이브나 앨범 공유 페이지는 웹페이지이므로 400으로 거부됩니다.
• 작은 인라인 이미지. 같은 필드에 data:image/png;base64,...로 작성합니다. JPEG, PNG, WebP, GIF여야 하며 디코딩 후 최대 1 MiB, 한 변 최대 8192픽셀입니다.
• 업로드. 더 크거나 비공개인 파일용입니다. JPEG, PNG, WebP, GIF를 최대 10 MiB까지 받습니다. 업로드는 무료이고 파일을 사용하는 작업만 과금됩니다. 하루 동안 유효한 spicy:// URI를 반환합니다.

Qwen Image 2는 JPEG, PNG, WebP만 허용합니다. 필드도 다릅니다. Qwen Image Edit Spicy와 FLUX.1 Dev LoRA는 image_url 문자열 하나를, 나머지는 image_urls 배열을 받습니다. 명시되지 않은 필드는 무시하지 않고 거부합니다.

비용은 해상도 단계, 원본 수, Wan 2.7에서는 num_outputs에 따라 달라집니다. 확인 전에 표시되는 요금은 정확한 요청에 대한 금액입니다. 견적과 미디어 가이드를 참고하세요.

다른 엔드포인트: 입력만 변경하기

배열을 받는 모델은 image_urls를 사용하며, 원본이 여러 개면 프롬프트로 역할을 지정합니다. 아래 모델 ID와 본문으로 같은 코드를 사용하세요.

{
  "model": "alibaba/qwen-image-3.0/edit",
  "input": {
    "prompt": "Use the person from the first image and the jacket from the second. Keep her face, hair and pose from the first image. Change nothing else.",
    "image_urls": ["spicy://f/fil_...", "spicy://f/fil_..."],
    "aspect_ratio": "3:4",
    "resolution": "2k"
  }
}

FLUX.1 Dev LoRA 마스크 편집에서는 원본 한 장의 본문에 마스크와 강도를 추가합니다.

{
  "model": "black-forest-labs/flux-1-dev-lora/edit",
  "input": {
    "prompt": "A black satin jacket with a high collar, same light as the rest of the photo.",
    "image_url": "spicy://f/fil_...",
    "mask_url": "spicy://f/fil_...",
    "strength": 0.9,
    "seed": 7
  }
}

strength가 낮을수록 원본에 가깝고 기본값은 0.8입니다. 각 모델 페이지의 현재 스키마에서 필드 값을 복사하세요. 이미지 생성 가이드는 이미지 엔드포인트의 차이를 설명합니다.

지시 작성: 유지할 내용 먼저, 변경할 내용 나중에

편집 엔드포인트는 명시하지 않은 부분을 다시 그립니다. 먼저 동일하게 유지할 것을 적고 한 가지 변경을 지정하세요. 보존할 요소를 더 많이 적어도 추가 비용은 없습니다. Qwen Image 3.0과 2.1에서 충실한 편집을 원하면 enable_prompt_expansion을 false로 설정하세요. 기본적으로 켜져 있어 프롬프트를 더 자세한 장면 설명으로 바꾸며, 보존 지시가 희석될 수 있습니다.

• 조명만: “Keep the person, pose, framing and room exactly as they are. Change only the light to warm late-afternoon sun from the window on the left. Keep the colour grade and film grain.”
• 배경만: “Keep the subject, outfit and crop. Replace the studio wall with dark theatre curtains. Add no logos or text.”
• 여러 원본: “Use the person from the first image, the jacket from the second and the street from the third. Keep her face and pose from the first image. Change nothing else.”

한 번에 한 가지만 바꾸세요. 스타일 변경과 글자 수정을 함께 하면 인물의 동일성이 흔들리기 쉽습니다. 결과가 어긋나면 다음을 확인합니다.

실패했을 때

다음은 편집에 특화된 오류입니다. 메시지 텍스트가 아니라 숫자 code나 작업의 errorCode에 따라 분기하세요.

잔액, 시간 초과 등 일반 오류는 오류 참조에 있습니다.

파일은 어떻게 보관되나요?

업로드한 사진은 하루, 결과는 최대 14일 보관됩니다. 보존할 결과는 작업 성공 직후 자신의 저장소로 복사하세요. 사진을 플랫폼에 더 짧게 남기려면 보관 문서에서 기간 단축이나 완료된 작업의 미디어와 프롬프트 폐기 방법을 확인할 수 있습니다. 임시 업로드와 영구적인 미디어 전달 및 이미지·영상 API 입문 가이드도 참고하세요.

자주 묻는 질문

강도 설정이 있는 무검열 이미지 변환 API가 있나요?

있습니다. FLUX.1 Dev LoRA (strength 0~1, 기본 0.8, 선택적 마스크)와 Z-Image Turbo LoRA의 편집 엔드포인트입니다. 다른 모델은 지시가 제어 수단이며, strength를 보내면 400 strength: is not a supported field가 반환됩니다.

사진을 꼭 업로드해야 하나요?

아닙니다. 공개 HTTPS 링크나 최대 1 MiB의 인라인 이미지를 사용할 수 있습니다. 더 크거나 비공개인 파일은 업로드하세요.

거부되거나 실패한 편집도 과금되나요?

보통은 아닙니다. 실패한 작업은 예약액을 전액 해제하며, 생성 오류는 과금하지 않습니다. 완화된 결과는 완성 이미지이므로 과금됩니다.

편집 후 얼굴과 포즈가 유지되나요?

보장되지는 않습니다. 유지할 내용을 명시하고, 한 번에 한 가지만 바꾸며, 가능하면 원본 한 장을 사용하세요. Seedream 5.0 Pro는 조명과 의상을 바꿀 때 인물을 유지했지만, 두 번째 사진의 새 세트에 합성할 때 얼굴 배치가 덜 정확했습니다. Qwen Image 2는 단순한 편집을 깔끔하게 처리했지만 복잡한 경우 일부 가구를 재구성했습니다.

실존 인물 사진을 편집해도 되나요?

그 사람의 문서화된 동의가 있어야 하며, 동의 없이 성적으로 편집해서는 안 됩니다. 모든 모델에 적용되므로 동의 기록을 자신의 시스템에 보관하세요.

어떤 엔드포인트로 시작해야 하나요?

사진 한 장과 변경 한 가지라면 Qwen Image Edit Spicy입니다. 여러 원본, 마스크, strength가 필요할 때만 바꾸세요. 먼저 편집 한 번을 실행하고 이미지를 본 뒤 엔드포인트를 바꿀지 결정합니다.

다음 단계

무해한 테스트 사진으로 Playground에서 한 번 편집하고 확인 전에 요금을 읽으세요. 그다음 결제할 해상도 단계를 선택하고, 운영 환경에서 기다리는 대신 Webhook을 사용할지 결정합니다.

Spicy 편집 모델의 프롬프트를 자세히 알아보려면 Qwen Image Edit Spicy 원본 보존 워크플로를 읽으세요. API 외의 기존 이미지 편집 모델 비교는 최고의 무검열 AI 이미지 편집 모델을 참고하세요. 무검열 이미지 API 카탈로그는 호출 가능한 모든 이미지 모델의 콘텐츠 분류와 현재 요금을 보여 줍니다.