메인 콘텐츠로 건너뛰기

개요

Oxygen은 싱가포르 기반 AI 동영상 제작 플랫폼인 AZ8(구 Videoinu)에서 제공하는 동영상 생성 모델입니다. APIYI는 이를 oxygen-1.0 모델로 OpenAI Videos 호환 API(제출은 POST /v1/videos, 조회는 GET /v1/videos/{id})를 통해 제공하며, 480p / 768p 해상도의 4~15초 클립을 지원하고 해상도와 관계없이 초당 $0.02로 과금합니다.
주요 특징: 단일 모델로 텍스트 투 비디오, 첫 프레임 기반 동영상, 첫 프레임 및 마지막 프레임 기반 동영상, 최대 9개의 이미지, 3개의 동영상, 3개의 오디오 클립을 활용한 참조 생성을 모두 지원합니다. 결과물에는 오디오 트랙이 포함됩니다. 초당 $0.02: 5초 클립은 $0.10, 15초 클립은 $0.30이며 실패한 작업은 자동으로 환불됩니다. 대량 및 저비용 동영상 생성을 위해 구축되었습니다.

동영상 생성 API 레퍼런스

Python / cURL / Node.js 예제 및 라이브 Playground와 함께 제출, 폴링, 다운로드 지원

충전 보너스

충전 보너스로 실질 가격을 더욱 낮출 수 있습니다

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. … 에서 확인할 수 있습니다.

  1. 엔드포인트: OpenAI Videos 형식입니다. POST https://api.apiyi.com/v1/videos (JSON)으로 제출하고, GET https://api.apiyi.com/v1/videos/{id}(으)로 조회하세요. 제출 …

총 10가지 요구사항이 있습니다. 아래 버튼을 사용하여 전체 프롬프트를 복사하세요.

왜 APIYI의 Oxygen을 선택해야 합니까?

대량 요금제

해상도에 관계없이 초당 $0.02, 4초 기준 $0.08로 대량 생성 및 A/B 테스트 초안 제작에 적합합니다

자동 환불

실패한 작업은 전액 환불되며 거부된 제출 건은 비용이 청구되지 않으므로, 실제로 완성된 동영상에 대해서만 비용을 지불하시면 됩니다

OpenAI Videos 호환

/v1/videos와(과) 동일한 제출 및 조회 방식을 지원하여 기존 Sora 스타일의 코드를 거의 수정하지 않고 사용할 수 있습니다

충전 보너스 중복 적용

충전 보너스와 결합하여 실질적인 비용을 더욱 낮출 수 있습니다

전체 동영상 모델 라인업

동일한 키로 Seedance 2.0 / 2.5, MiniMax-H3, Wan2.7 등도 호출할 수 있습니다

글로벌 접속

해외 계정 없이 하나의 API 키로 api.apiyi.com에 직접 연결할 수 있습니다

핵심 기능

4가지 생성 모드

텍스트, 첫 프레임, 첫 프레임 및 마지막 프레임, 참조 이미지/동영상/오디오를 모두 하나의 엔드포인트에서 지원합니다

2가지 해상도

동일한 가격으로 480p 및 768p를 제공하며, 필요에 따라 속도와 디테일을 조율할 수 있습니다

4초에서 15초 사이의 자유로운 정수 길이

요청한 초 단위로 과금되므로 짧은 영상 클립일수록 비용이 적게 듭니다

내장 오디오

출력 MP4에 오디오 트랙이 포함되어 별도의 더빙 작업이 필요하지 않습니다

요금 안내

가격은 변동될 수 있습니다. 위 표는 참고용일 뿐이며, 상단 내비게이션의 모델 요금 탭이 기준이 됩니다: 모델 요금.
과금 안내:
  • 요청된 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 엔드포인트

기본 도메인은 https://api.apiyi.com, 백업 도메인은 https://b.apiyi.com이며 경로는 동일합니다. 다운로드 시에는 조회 응답의 video_url을 직접 사용하십시오.

생성 모드

최상위 필드 중 적용되는 것은 model, prompt, seconds, size, input_reference 등 5개뿐입니다. 첫 프레임과 마지막 프레임, 참조 미디어, 1:1 비율 및 품질 티어는 input_reference JSON 엔벨로프에 들어가는 고급 매개변수({(으)로 시작하는 JSON 문자열)입니다: size(이)가 해상도에 매핑되는 방식: 엔벨로프 예시 (첫 프레임 및 마지막 프레임):
  • last_image, reference_images, resolution, aspect_ratio 및 유사한 필드는 최상위 레벨에 배치될 경우 오류 없이 무시됩니다: 오류가 발생하지 않고 정상 과금되지만, 마지막 프레임은 무시되고 참조 미디어도 무시되며 해상도는 size을(를) 따릅니다. 항상 input_reference 엔벨로프에 배치하십시오.
  • duration은(는) 엔벨로프에서 허용되지 않습니다. 최상위 레벨의 seconds을(를) 사용하십시오. 유효하지 않은 JSON이나 철자가 틀린 키는 비용 청구 없이 400 (param: input_reference) 오류를 반환합니다.
  • 첫 프레임/마지막 프레임은 참조 미디어와 함께 혼용할 수 없습니다.
  • input_reference은(는) 반드시 문자열이어야 합니다. 엔벨로프를 먼저 직렬화하십시오(Python의 경우 json.dumps, JS의 경우 JSON.stringify). 객체나 배열을 직접 전달하면 거부됩니다.

모범 사례

1

먼저 4초로 테스트하십시오

초 단위로 과금되므로, 10~15초 분량의 최종본을 렌더링하기 전에 4초 길이로 구도와 스타일을 먼저 확인하십시오.
2

항상 size를 설정하십시오

가로 방향은 1280x720, 세로 방향은 720x1280이며, 더 상세한 디테일을 원하시면 1792x1024 / 1024x1792 (768p)를 사용하십시오.
3

첫 프레임과 마지막 프레임의 가로세로 비율을 비슷하게 맞추십시오

출력 결과는 첫 프레임의 비율을 따르므로, 마지막 프레임의 비율 차이가 크면 화면 전환 시 잘림 현상이 발생합니다.
4

안정적인 퍼블릭 스토리지에 미디어를 호스팅하십시오

핫링크 방지나 서명 만료로 인해 다운로드가 실패하지 않도록 자체 OSS / CDN 직접 링크를 사용하십시오.
5

15분 타임아웃으로 5초마다 폴링하십시오

대부분의 클립은 1~3분 내에 완료되지만 피크 시간대에는 더 오래 걸릴 수 있습니다.
6

video_url을 즉시 자체 스토리지로 복사하십시오

해당 링크는 약 24시간 후에 만료되므로, 직접 다운로드하여 자체 스토리지에서 서비스하십시오.

오류 코드 및 재시도

오류 세부 정보는 응답의 message 필드 내에 있는 JSON 문자열(예: {"message":"{\"error\":{\"code\":\"invalid_params\",...}}","type":"task_error"})이므로 한 번 더 파싱해야 합니다.

자주 묻는 질문

size이(가) 전달되지 않았습니다. 이 값이 없으면 게이트웨이는 기본적으로 720x1280(세로형)을 적용합니다. 가로형의 경우 1280x720 또는 1792x1024을(를) 명시적으로 전달하십시오.
요청의 최상위에 배치되었기 때문입니다. 최상위에서는 model, prompt, seconds, size 및 input_reference만 적용되며, 그 외의 항목은 알림 없이 무시됩니다. input_reference JSON 엔벨로프 안에 넣어 전달하십시오. 상단의 “생성 모드”를 참고하십시오.
사용할 수 없습니다. AZ8은 2026-10-14에 320p 티어를 지원 중단했습니다. 엔벨로프에 "resolution":"320p"을(를) 전달하면 제출 시 400(must be one of 480p/768p) 오류가 반환되며 과금되지 않습니다. 대신 480p를 사용하십시오.
최상위의 resolution은(는) 무시됩니다. 엔벨로프에 넣어 전달하거나("input_reference": "{\"resolution\":\"768p\"}"), size(1792x1024 / 1024x1792 = 768p)을(를) 통해 선택하십시오. 두 해상도의 요금은 동일합니다.
아닙니다, 둘 다 초당 $0.02입니다. 480p는 파일 크기가 작고 렌더링 속도가 빠르며, 768p는 더 선명합니다.
일반적으로는 필요하지 않습니다. quality은(는) 품질 티어(high / normal)이며, prompt_enhance은(는) 모델이 프롬프트를 재작성할지 여부를 제어합니다. refine은(는) 프롬프트를 다듬고 확장하며, format은(는) 서식만 정리하고, none은(는) 작성된 프롬프트 그대로 사용합니다. 기본값인 high + refine은(는) 2026-10-14 이전의 동작 방식과 동일합니다. 프롬프트가 단어 그대로 적용되도록 하려면 엔벨로프에 "prompt_enhance":"none"을(를) 전달하십시오. 두 파라미터 모두 요금에 영향을 주지 않습니다.
상태가 completed(으)로 변경된 직후에는 /v1/videos/{id}/content에 몇 초가 더 필요할 수 있습니다. 대신 조회 응답에 포함된 video_url을(를) 사용하십시오.
약 24시간입니다(조회 응답의 expires_at 참고). 신속하게 다운로드하여 보관하십시오.
아닙니다. failed 상태로 종료된 작업은 자동으로 전액 환불되며, 400을 반환하는 제출 건에는 과금되지 않습니다.
제공자 측의 일시적인 오류이며 이미 환불 처리되었습니다. 몇 분 후 다시 제출하면 대부분 정상 처리됩니다.
출력 영상의 길이가 약간 더 길게 생성됩니다(4초 요청 시 약 4.5초, 5초 요청 시 약 5.2초). 과금은 요청된 seconds을(를) 기준으로 이루어지므로 추가 요금은 발생하지 않습니다.
네, 가능합니다. 엔벨로프의 input_reference 및 images 모두 이미지 데이터 URI(예: data:image/jpeg;base64,...)를 지원합니다. 참조 동영상 및 오디오는 https URL만 지원합니다.
불가능합니다. 이미지 기반 동영상 생성은 첫 번째 프레임의 화면 비율을 따르며 aspect_ratio을(를) 무시합니다. 해상도는 엔벨로프 내 size 또는 resolution을(를) 통해 지정할 수 있습니다.

관련 문서