`real_person`으로 실제 인물 참조 이미지 직접 제출

OfoxAI에서는 일반 POST /v1/videos 요청에 사용 권한을 확보한 실제 인물 참조 이미지를 바로 넣을 수 있습니다. 최상위에 real_person: true를 추가하고 frame_images 또는 input_references로 이미지를 보내면, Ofox가 동영상 공급자에게 작업을 전달하기 전에 개인정보 보호 전처리를 수행합니다.

따라서 첫 요청 전에 Seedance 측 실제 인물 자산 그룹을 만들고, 당사자의 본인 인증과 사용 허가를 받고, 자산 활성화를 기다리고, Asset ID를 얻어 이미지를 asset://... URI로 바꾸는 절차가 필요하지 않습니다.

법적으로 사용할 권리와 필요한 동의를 확보한 이미지만 제출하세요. real_person은 처리 지시일 뿐 동의 증명이 아니며, Ofox 또는 상위 공급자의 콘텐츠 정책을 우회하지 않습니다.

Ofox 절차가 더 간단한 이유

BytePlus Seedance 2.0 공식 Video API 문서 는 실제 사람의 얼굴이 포함된 참조 이미지나 동영상을 직접 업로드할 수 없고, 승인된 실제 인물 자산을 사용해야 한다고 설명합니다. 공식 비공개 실제 인물 자산 라이브러리 가이드 에는 본인 인증, 자산 일치성 검사, Active 상태, 생성용 Asset URI 절차가 있습니다. Volcano Ark 가이드 는 초대, 본인 인증과 승인, 업로드, 승인 수령, Asset ID 획득 단계까지 설명합니다.

단계	Seedance 2.0 공식 API 직접 연결	Ofox Video API
첫 요청 전	자산 그룹 생성, 본인 인증과 승인, 자산 업로드와 검사, Asset ID 획득	공급자 측 사전 등록 없음. 처리 권한을 확보한 이미지 사용
참조 값	활성 승인 자산을 `asset://<asset_id>`로 참조	기존 `frame_images` 또는 `input_references`에 이미지 URL이나 `data:` URI 전송
요청 설정	승인된 자산 URI 사용	최상위에 `"real_person": true` 추가

Ofox는 기술 연동을 단순화하지만, 초상권과 승인 및 합법적 사용에 대한 사용자의 책임을 없애지 않습니다.

빠른 시작


curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "인물이 영화 같은 야시장을 걷는다",
    "real_person": true,
    "input_references": [
      {
        "type": "image_url",
        "image_url": { "url": "https://example.com/person.jpg" }
      }
    ]
  }'

real_person은 요청 최상위에 있어야 합니다. frame_images 또는 input_references 중 한 곳에 이미지가 하나 이상 필요하며 두 필드는 함께 사용할 수 없습니다. 정확한 구조와 제한은 동영상 작업 생성을 참고하세요.

제출 후 처리 과정

Ofox가 선택한 참조 필드의 모든 이미지를 검증하고 전처리합니다.
전처리된 요청을 선택한 동영상 공급자에게 제출합니다.
공급자는 자체 신원, 딥페이크 방지, 콘텐츠 안전 검사를 계속 적용합니다.

적합한 입력 대부분은 일반 비동기 작업으로 진행되지만, 전처리가 상위 공급자의 승인을 보장하지는 않습니다. 일부 이미지는 실제 인물 추가 심사 또는 거절을 받을 수 있습니다. 거절된 작업에는 요금이 청구되지 않습니다.

실제 인물 심사가 계속 발생할 때

인물을 일관되게 식별하기 쉽게 조정한 뒤 real_person: true로 다시 제출하세요.

주 인물을 한 명으로 명확히 하고 다른 얼굴 수를 줄입니다;
주 얼굴이 충분히 크고 화면 가장자리에 붙지 않도록 자르기와 배치를 조정합니다;
선명하고 정면이며 가리지 않고 조명이 고른 얼굴을 우선합니다;
배경 인물, 포스터, 화면, 거울, 반사 속 얼굴을 가능한 한 제거합니다;
극단적인 각도, 심한 모션 블러, 강한 그림자, 마스크와 큰 가림을 피합니다;
더 고품질의 원본을 사용하고 복잡한 구도를 단순화합니다.

이 조정은 식별 모호성을 줄이지만 공급자 정책을 무시하거나 승인을 보장하지 않습니다. 계속 거절되면 다른 승인된 참조 이미지를 사용하세요.

직접 수정할 수 있는 전처리 오류

Ofox가 입력 이미지를 전처리하지 못하면 HTTP 400과 error.code: "invalid_request"를 반환합니다. error.message 끝에는 안정적인 원인 토큰이 포함됩니다.

원인 토큰	수정 방법
`bad_data_uri`	잘못된 `data:` URI 또는 base64를 수정합니다
`download_failed`	연결, 시간 초과, 접근 제어 문제 없이 URL을 내려받을 수 있게 합니다
`unreachable`	성공 HTTP 상태를 반환하는 URL을 사용합니다
`not_image`	지원되고 디코딩 가능한 이미지를 제공합니다
`too_large`	파일, 픽셀 크기 또는 요청당 처리 이미지 수를 줄입니다

전체 오류 형식은 Video API 오류를 참고하세요.

real_person으로 실제 인물 참조 이미지 직접 제출