Head Swap (Image)

namifusion/head-swap/image-edit

namifusion/head-swap/image-edit. 이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.

전체 매개변수, 출력 스키마 및 실시간 요금

AI 모델 API 마켓하나의 플랫폼, 모든 기능가장 인기이용약관이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.
images *Imagesimage_upload—2–2 items

전체 매개변수, 출력 스키마 및 실시간 요금

자세히 보기하나의 플랫폼, 모든 기능이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.
imagesarray<string>

API

이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.

cURL
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/namifusion/head-swap/image-edit" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "images": [
      "https://assets-public.namifusion.com/uploads/images/2026-04-21/76c1186af77d.png",
      "https://assets-public.namifusion.com/uploads/images/2026-04-21/149467630166.png"
    ]
  }
}'

# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
  -H "Authorization: Bearer YOUR_API_KEY"
Python
import time, requests

API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1) Submit
resp = requests.post(
    "https://www.namifusion.com/api/v1/marketplace/run/namifusion/head-swap/image-edit",
    headers=HEADERS,
    json={
        "input": {
            "images": [
                "https://assets-public.namifusion.com/uploads/images/2026-04-21/76c1186af77d.png",
                "https://assets-public.namifusion.com/uploads/images/2026-04-21/149467630166.png"
            ]
        }
    },
)
resp.raise_for_status()  # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()

# 2) Poll until a terminal state (completed / failed / cancelled).
#    This model is allowed up to 600s server-side.
deadline = time.time() + 660
while task.get("status") not in ("completed", "failed", "cancelled"):
    if time.time() > deadline:
        raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
    time.sleep(3)
    poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
    poll.raise_for_status()
    task = poll.json()

print(task["status"], task.get("output"))
JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };

// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/namifusion/head-swap/image-edit", {
  method: "POST",
  headers: { ...HEADERS, "Content-Type": "application/json" },
  body: JSON.stringify({
    "input": {
      "images": [
        "https://assets-public.namifusion.com/uploads/images/2026-04-21/76c1186af77d.png",
        "https://assets-public.namifusion.com/uploads/images/2026-04-21/149467630166.png"
      ]
    }
  }),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();

// 2) Poll until a terminal state (completed / failed / cancelled).
//    This model is allowed up to 600s server-side.
const deadline = Date.now() + 660 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
  if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
  await new Promise((r) => setTimeout(r, 3000));
  const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
  if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
  task = await poll.json();
}

console.log(task.status, task.output);

API 문서

Head Swap Image Edit

Transfer a head from one reference image onto a target photo while preserving the target body, pose, and scene.

Head Swap Image Edit is a focused two-image workflow for replacing the head in a target photograph. The first image supplies the head reference and identity; the second image supplies the body, pose, clothing, lighting context, and background that should remain. The fixed input order makes the model straightforward to use, but respecting that order is essential for a correct result.

Key Features

  • Dedicated head replacement: Changes the head region while retaining the target photograph as the visual base.
  • Two-image control: Separates identity reference from target composition instead of relying on a text prompt.
  • Pose and scene preservation: Designed to keep the target body, clothing, framing, and background intact.
  • Simple deterministic contract: Exactly two image URLs are required in a documented order.
  • Square output: Produces a 1024 x 1024 edited image for consistent downstream use.

Technical Specifications

ItemDetails
TaskHead replacement / image editing
Required inputimages, exactly two image URLs
Image 1Head and identity reference
Image 2Target photograph and base composition
Input orderReference first, target second
PromptNot required
OutputEdited image URL
Output dimensions1024 x 1024

Input Guidance

Use a sharp reference image with a clearly visible head and minimal occlusion. For the target image, choose a photo where the head, neck, and surrounding hair or clothing boundaries are readable. Similar camera angles and compatible lighting generally produce a more natural blend. The two URLs must remain in the exact documented order.

Pricing

ItemPrice
One edited image22 credits

This value reproduces the existing Marketplace pricing configuration; this documentation update does not alter pricing.

Best Use Cases

  • Character and casting visualization for creative review.
  • Portrait concept variations while retaining an approved pose and scene.
  • Marketing mockups that require a different head reference on an existing composition.
  • Controlled visual experiments where a text prompt would introduce unnecessary variation.

Best Practices

Avoid tiny, heavily blurred, side-profile, or obstructed reference heads. Match approximate viewing angle and lighting direction between the two images. Check the result around hairlines, ears, neck boundaries, and accessories. If alignment is poor, improve the input crops rather than changing the required image order.

관련 모델

xAI Grok Imagine Image v2.0 Edit
이미지 변환X Ai

xAI Grok Imagine Image v2.0 Edit

x-ai/grok-imagine-image-v2.0/edit. 이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.

최저 $0.090 / 실행당
qwen-image-edit-spicy
이미지 변환

qwen-image-edit-spicy

qwen-image-edit-spicy. 이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.

최저 $0.040 / 실행당
Qwen Image 3.0 Pro Edit | Fast Image Editing
이미지 변환Qwen Image 3.0 Pro

Qwen Image 3.0 Pro Edit | Fast Image Editing

qwen-image-3.0-pro/edit. 이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.

최저 $0.078 / 실행당
OpenAI GPT Image 2.5 Sunburst Edit
이미지 변환OpenAI

OpenAI GPT Image 2.5 Sunburst Edit

openai/gpt-image-2.5-sunburst/edit. 이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.

최저 $0.220 / 실행당
OpenAI GPT Image 2.5 Flare Edit
이미지 변환OpenAI

OpenAI GPT Image 2.5 Flare Edit

openai/gpt-image-2.5-flare/edit. 이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.

최저 $0.220 / 실행당
Nano Banana Image Edit
이미지 변환Google

Nano Banana Image Edit

google/nano-banana/edit. 이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.

최저 $0.038 / 실행당
Nano Banana Pro Image Edit
이미지 변환Google

Nano Banana Pro Image Edit

google/nano-banana-pro/edit. 이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.

최저 $0.140 / 실행당
Nano Banana 2 Image Edit
이미지 변환Google

Nano Banana 2 Image Edit

google/nano-banana-2/edit. 이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.

최저 $0.070 / 실행당