개요
Oxygen은 싱가포르 기반 AI 동영상 제작 플랫폼인 AZ8(구 Videoinu)에서 제공하는 동영상 생성 모델입니다. APIYI는 이를oxygen-1.0 모델로 OpenAI Videos 호환 API(제출은 POST /v1/videos, 조회는 GET /v1/videos/{id})를 통해 제공하며, 480p / 768p 해상도의 4~15초 클립을 지원하고 해상도와 관계없이 초당 $0.02로 과금합니다.
동영상 생성 API 레퍼런스
충전 보너스
AI 에이전트에게 연동 작업 맡기기
이 프롬프트를 복사하여 Codex / Claude Code / Cursor에 붙여넣으세요
에이전트는 먼저 이 페이지의 일반 텍스트 버전을 가져온 후(임의의 문서 URL 뒤에 .md 추가), 사용자의 기술 스택에 맞는 코드를 작성합니다. 흔히 발생하는 실수가 이미 명시되어 있습니다. 항상 size 전달하기, 고급 매개변수를 input_reference JSON 엔벨로프에 넣기, seconds(으)로만 길이를 설정하기 등입니다.
이 프로젝트에서 Oxygen (oxygen-1.0) 동영상 생성(텍스트-동영상 / 첫 프레임 / 첫 프레임 및 마지막 프레임 / 참조 미디어)을 연동하거나 디버깅하세요.
코드를 작성하기 전에 문서를 읽으세요. 이 페이지의 일반 텍스트 버전을 보려면 https://docs.apiyi.com/en/api-capabilities/oxygen/overview.md 를 가져오세요. 매개변수 및 코드 예제는 https://docs.apiyi. … 에서 확인할 수 있습니다.
- 엔드포인트: OpenAI Videos 형식입니다.
POST https://api.apiyi.com/v1/videos(JSON)으로 제출하고,GET https://api.apiyi.com/v1/videos/{id}(으)로 조회하세요. 제출 …
총 10가지 요구사항이 있습니다. 아래 버튼을 사용하여 전체 프롬프트를 복사하세요.
이 프롬프트가 방지하는 문제
이 프롬프트가 방지하는 문제
왜 APIYI의 Oxygen을 선택해야 합니까?
대량 요금제
자동 환불
OpenAI Videos 호환
/v1/videos와(과) 동일한 제출 및 조회 방식을 지원하여 기존 Sora 스타일의 코드를 거의 수정하지 않고 사용할 수 있습니다충전 보너스 중복 적용
전체 동영상 모델 라인업
글로벌 접속
api.apiyi.com에 직접 연결할 수 있습니다핵심 기능
4가지 생성 모드
2가지 해상도
4초에서 15초 사이의 자유로운 정수 길이
내장 오디오
요금 안내
- 요청된
seconds기준으로 과금되며, 작업이 접수될 때 청구됩니다. 실제 클립은 추가 비용 없이 약간 더 길게 생성됩니다(4초 요청 시 약 4.5초). - 해상도, 화면 비율, 품질 등급(
quality), prompt 향상(prompt_enhance) 및 참조 미디어는 가격에 영향을 미치지 않습니다. - 실패한 작업(제공업체 오류, 시간 초과 등)은 자동으로 전액 환불됩니다.
- 400을 반환하는 제출 작업은 과금되지 않으며, 조회 및 다운로드는 무료입니다.
그룹 설정
oxygen-1.0은(는) default 그룹에서 작동하며, svip 그룹에서도 작동합니다. token의 과금 모드를 종량제 우선으로 설정하십시오. 호출 시 “no available channel in the current group”이 반환된다면, 해당 token의 그룹에 이 모델이 포함되어 있지 않거나 model 이름에 오타가 있는 것입니다.
기술 사양
API 엔드포인트
생성 모드
최상위 필드 중 적용되는 것은model, prompt, seconds, size, input_reference 등 5개뿐입니다. 첫 프레임과 마지막 프레임, 참조 미디어, 1:1 비율 및 품질 티어는 input_reference JSON 엔벨로프에 들어가는 고급 매개변수({(으)로 시작하는 JSON 문자열)입니다:
size(이)가 해상도에 매핑되는 방식:
모범 사례
먼저 4초로 테스트하십시오
항상 size를 설정하십시오
1280x720, 세로 방향은 720x1280이며, 더 상세한 디테일을 원하시면 1792x1024 / 1024x1792 (768p)를 사용하십시오.첫 프레임과 마지막 프레임의 가로세로 비율을 비슷하게 맞추십시오
안정적인 퍼블릭 스토리지에 미디어를 호스팅하십시오
15분 타임아웃으로 5초마다 폴링하십시오
video_url을 즉시 자체 스토리지로 복사하십시오
오류 코드 및 재시도
message 필드 내에 있는 JSON 문자열(예: {"message":"{\"error\":{\"code\":\"invalid_params\",...}}","type":"task_error"})이므로 한 번 더 파싱해야 합니다.자주 묻는 질문
가로형 동영상이 왜 세로형으로 생성되었습니까?
가로형 동영상이 왜 세로형으로 생성되었습니까?
size이(가) 전달되지 않았습니다. 이 값이 없으면 게이트웨이는 기본적으로 720x1280(세로형)을 적용합니다. 가로형의 경우 1280x720 또는 1792x1024을(를) 명시적으로 전달하십시오.last_image / reference_images가 왜 적용되지 않습니까?
last_image / reference_images가 왜 적용되지 않습니까?
model, prompt, seconds, size 및 input_reference만 적용되며, 그 외의 항목은 알림 없이 무시됩니다. input_reference JSON 엔벨로프 안에 넣어 전달하십시오. 상단의 “생성 모드”를 참고하십시오.320p를 계속 사용할 수 있습니까?
320p를 계속 사용할 수 있습니까?
"resolution":"320p"을(를) 전달하면 제출 시 400(must be one of 480p/768p) 오류가 반환되며 과금되지 않습니다. 대신 480p를 사용하십시오.resolution을 전달해도 아무런 변화가 없습니까?
resolution을 전달해도 아무런 변화가 없습니까?
resolution은(는) 무시됩니다. 엔벨로프에 넣어 전달하거나("input_reference": "{\"resolution\":\"768p\"}"), size(1792x1024 / 1024x1792 = 768p)을(를) 통해 선택하십시오. 두 해상도의 요금은 동일합니다.해상도에 따라 요금이 다릅니까?
해상도에 따라 요금이 다릅니까?
quality와 prompt_enhance는 무엇이며, 사용해야 합니까?
quality와 prompt_enhance는 무엇이며, 사용해야 합니까?
quality은(는) 품질 티어(high / normal)이며, prompt_enhance은(는) 모델이 프롬프트를 재작성할지 여부를 제어합니다. refine은(는) 프롬프트를 다듬고 확장하며, format은(는) 서식만 정리하고, none은(는) 작성된 프롬프트 그대로 사용합니다. 기본값인 high + refine은(는) 2026-10-14 이전의 동작 방식과 동일합니다. 프롬프트가 단어 그대로 적용되도록 하려면 엔벨로프에 "prompt_enhance":"none"을(를) 전달하십시오. 두 파라미터 모두 요금에 영향을 주지 않습니다.상태는 completed인데 /content에서 400이 반환됩니까?
상태는 completed인데 /content에서 400이 반환됩니까?
completed(으)로 변경된 직후에는 /v1/videos/{id}/content에 몇 초가 더 필요할 수 있습니다. 대신 조회 응답에 포함된 video_url을(를) 사용하십시오.동영상 링크의 유효 기간은 얼마나 됩니까?
동영상 링크의 유효 기간은 얼마나 됩니까?
expires_at 참고). 신속하게 다운로드하여 보관하십시오.실패한 작업에 대해서도 과금됩니까?
실패한 작업에 대해서도 과금됩니까?
failed 상태로 종료된 작업은 자동으로 전액 환불되며, 400을 반환하는 제출 건에는 과금되지 않습니다.간혹 발생하는 upstream_error는 어떻게 해야 합니까?
간혹 발생하는 upstream_error는 어떻게 해야 합니까?
생성된 영상이 요청한 seconds보다 약간 긴 이유는 무엇입니까?
생성된 영상이 요청한 seconds보다 약간 긴 이유는 무엇입니까?
seconds을(를) 기준으로 이루어지므로 추가 요금은 발생하지 않습니다.첫 번째 프레임으로 base64를 사용할 수 있습니까?
첫 번째 프레임으로 base64를 사용할 수 있습니까?
input_reference 및 images 모두 이미지 데이터 URI(예: data:image/jpeg;base64,...)를 지원합니다. 참조 동영상 및 오디오는 https URL만 지원합니다.이미지 기반 동영상 생성(image-to-video) 시 화면 비율을 설정할 수 있습니까?
이미지 기반 동영상 생성(image-to-video) 시 화면 비율을 설정할 수 있습니까?
aspect_ratio을(를) 무시합니다. 해상도는 엔벨로프 내 size 또는 resolution을(를) 통해 지정할 수 있습니다.