real_person으로 실존 인물 참조 이미지 직접 제출
OfoxAI에서는 일반 POST /v1/videos 요청으로 사용 권한을 확보한 실존 인물 참조 이미지를 직접 제출할 수 있습니다. 최상위에 real_person: true를 추가하고 frame_images 또는 input_references로 이미지를 전달하기만 하면, Ofox가 작업을 동영상 서비스 제공업체에 넘기기 전에 개인정보 보호 전처리를 자동으로 수행합니다.
일부 공급자（예: Seedance）는 실존 인물의 얼굴이 포함된 참조 이미지를 먼저 자사 플랫폼에 소재로 등록하고 본인 인증을 거치도록 요구합니다. 비교 설명은 Seedance · 실존 인물 참조 이미지를 참고하십시오. real_person을 사용하면 이러한 절차를 미리 거칠 필요가 없습니다.
법적으로 사용할 권리가 있고 승인을 받은 이미지만 제출할 수 있습니다. real_person은 처리 지시일 뿐 승인 증명이 아니며, 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에 이미지가 1장 이상 있어야 하며, 두 참조 필드는 여전히 상호 배타적입니다. 구체적인 구조와 개수 제한은 동영상 작업 생성을 참고하십시오.
제출 후 처리 과정
- Ofox가 선택한 참조 필드의 모든 이미지를 검증하고 전처리합니다.
- 전처리된 요청이 선택한 동영상 서비스 제공업체에 제출됩니다.
- 서비스 제공업체는 자체적인 신원, 딥페이크 방지, 콘텐츠 안전 검사를 계속 수행합니다.
적합한 입력은 대개 일반적인 비동기 작업 흐름으로 진행되지만, 전처리가 업스트림의 수락을 보장하지는 않습니다. 일부 이미지는 여전히 업스트림의 실존 인물 심사나 거부를 받을 수 있으며, 거부된 작업에는 요금이 부과되지 않습니다.
이미지가 여전히 실존 인물 심사에 걸릴 때
인물이 더 안정적으로 식별되도록 조정한 뒤 real_person: true를 유지한 채 다시 제출하십시오.
- 뚜렷한 주요 인물 한 명만 남기고, 화면에 보이는 다른 얼굴의 수를 줄입니다.
- 자르거나 배치를 바꿔 주요 얼굴이 충분히 크고 화면 가장자리에 붙지 않도록 합니다.
- 선명하고 정면이며 가려지지 않고 조명이 고른 얼굴을 우선 사용합니다.
- 배경 인물, 포스터, 화면, 거울, 반사면에 비친 얼굴은 가능한 한 제거하거나 잘라냅니다.
- 극단적인 각도, 뚜렷한 모션 블러, 짙은 그림자, 마스크, 넓은 가림을 피합니다.
- 더 높은 품질의 원본 이미지로 바꾸고, 지나치게 복잡한 구도를 단순화합니다.
이러한 조정은 식별의 모호함을 줄일 수 있지만 서비스 제공업체의 정책을 무시하지는 않으며 통과를 보장하지도 않습니다. 계속 거부되면 승인을 받은 다른 참조 이미지로 교체하십시오.
직접 수정할 수 있는 전처리 오류
Ofox가 입력 이미지를 전처리할 수 없으면 요청은 HTTP 400을 반환하며 error.code는 "invalid_request"입니다. error.message 끝에는 안정적인 원인 코드가 포함됩니다.
전체 오류 객체와 진단 방법은 동영상 API 오류 코드를 참고하십시오.