두 명의 개발자가 오늘 아침 PixVerse 문서를 읽었습니다. 한 명은 네거티브 프롬프트 기능을 출시했고, 다른 한 명은 해당 매개변수가 더 이상 존재하지 않는다는 것을 알게 되었습니다.
두 사람 모두 공식 페이지를 읽고 있었습니다. 이것이 2026년 PixVerse API의 실제 상태입니다: 이전 페이지와 새 페이지가 조용히 충돌하는 문서에 둘러싸인, 빠르게 진화하는 유능한 비디오 생성 서비스입니다. 대부분의 PixVerse AI API 개발자 질문은 두 가지로 귀결됩니다. 실제로 최신인 문서는 어디에 있나요? 그리고 코드가 작동하면 클립 하나에 얼마가 들까요?
이 가이드가 두 질문에 모두 답합니다. 아래의 모든 엔드포인트, 매개변수 및 가격은 2026년 7월 23일 이번 주에 자사 페이지에서 확인했습니다.
핵심 요약
- 공식 PixVerse API 문서는 docs.platform.pixverse.ai에 있습니다. 키와 크레딧은 platform.pixverse.ai에 있습니다. 소비자 앱 app.pixverse.ai는 별도의 제품이며 별도로 청구됩니다.
- 모든 호출에는 두 개의 헤더가 필요합니다. API-KEY와 요청마다 새로운 Ai-trace-id UUID입니다. 생성은 비동기식입니다: 제출하고 video_id를 받은 후 결과를 폴링합니다.
- 문서는 곳곳에서 모순됩니다. 오래된 방법 페이지에는 여전히 negative_prompt와 water_mark가 표시되지만, 최신 생성 참조에는 둘 다 없습니다. 페이지가 충돌할 때는 엔드포인트 참조를 신뢰하세요.
- 공식 청구는 크레딧으로 이루어집니다 ($10에 1,000 크레딧). 동일한 V6 모델은 Atlas Cloud에서 초당 $0.025부터 시작하는 종량제로 실행되며, 기본 5초 720p 오디오 포함 클립의 경우 팩 요금 크레딧의 $0.60 대비 $0.30입니다.
PixVerse API 문서 지도: 실제 문서가 있는 곳
PixVerse API 문서를 검색하면 네 개의 자사 페이지와 많은 리셀러가 나타납니다. 중요한 네 가지는 다음과 같습니다:
| 표면 | URL | 내용 |
|---|---|---|
| 플랫폼 문서 | docs.platform.pixverse.ai | 빠른 시작, 전체 API 참조, 크레딧 가격, 오류 참조, FAQ |
| 개발자 콘솔 | platform.pixverse.ai | API 키 생성, 크레딧 팩 구매, 사용량 추적 |
| 소비자 앱 | app.pixverse.ai | 웹 앱. 해당 플랜, 무료 크레딧 및 워터마크 규칙은 API에 적용되지 않음 |
| 공식 MCP 서버 | github.com/PixVerseAI/PixVerse-MCP | AI 어시스턴트가 PixVerse를 직접 호출할 수 있게 해주는 공식 래퍼 |
사람들을 혼란스럽게 하는 차이는 앱과 플랫폼의 구분입니다. 앱은 $10부터 시작하는 월간 플랜을 판매하고 가변적인 일일 무료 크레딧을 제공합니다. 플랫폼은 별도의 원장에 API 크레딧과 멤버십을 판매합니다. 유료 앱 구독은 API 측에서 아무것도 제공하지 않으며, 그 반대도 마찬가지입니다.
플랫폼 문서에 숨겨진 실질적으로 유용한 세부 정보가 하나 있습니다: PixVerse-api-llm.txt라는 통합 일반 텍스트 페이지로, 전체 API 참조를 하나의 문서로 압축합니다. 코딩 어시스턴트에 붙여넣으면 훈련 데이터에 기억된 내용 대신 현재 사양에 맞춰 PixVerse 호출을 작성할 수 있습니다.
문서는 "175개국 1억 명 이상의 창작자와 기업"을 대상으로 하는 서비스를 설명합니다. 규모는 실제입니다. 그에 따른 버전 변동이 이 기사에 모순 섹션이 있는 이유입니다.
오늘날 PixVerse AI API를 사용하는 두 가지 방법
PixVerse 자체 플랫폼과의 통합은 다음 섹션에서 전체 설명을 제공합니다. 먼저 모델을 가장 빠르게 접하는 방법은 호스트를 이용하는 것입니다: Atlas Cloud는 400개 이상의 모델 중 PixVerse V6 및 C1을 실행하며, 크레딧 팩이나 워터마크 없이 초당 달러로 청구됩니다. PixVerse 제품군 페이지는 텍스트-투-비디오부터 참조-투-비디오 및 확장까지 9개의 호스팅된 엔드포인트를 모두 나열합니다. 두 가지 진입 방법: 플레이그라운드에서 테스트한 다음 코드에서 동일한 엔드포인트를 호출합니다. 자연스러운 시작점은 V6 텍스트-투-비디오 플레이그라운드입니다.
방법 1: 플레이그라운드에서 PixVerse V6 API 테스트
코드를 작성하기 전에 여기서 10분을 보내세요. 플레이그라운드는 코드가 호출할 동일한 엔드포인트에 가격 견적이 첨부되어 있습니다.
- 로그인하고 플레이그라운드를 엽니다. 프롬프트 필드가 유일한 필수 입력입니다.
- 지속 시간, 품질 및 화면 비율을 설정합니다. 기본값은 5초, 720p, 16:9입니다.
- 오디오 토글을 확인합니다. 사운드는 기본적으로 켜져 있으며 초당 요금을 높입니다.
- 실행 버튼을 읽습니다. 현재 설정의 정확한 비용을 표시합니다. 기본값에서는 $0.30이므로 $10로 약 33회 실행이 가능합니다.
- 실행, 검토, 다운로드. 출력이 만족스러울 때까지 프롬프트를 반복한 다음 해당 정확한 구성을 코드로 옮깁니다.
방법 2: 코드에서 PixVerse V6 API 호출
Atlas Cloud의 PixVerse V6 개발자 워크플로는 두 개의 HTTP 요청입니다.
1단계: API 키를 받습니다. Atlas Cloud 콘솔에서 키를 생성하고 환경 변수로 저장합니다. 클라이언트 코드에는 절대 저장하지 마세요.
이미지: 생성-키 버튼과 복사 컨트롤 옆에 새로 생성된 키를 보여주는 Atlas Cloud 콘솔의 API 키 페이지 스크린샷.
2단계: API 문서를 확인합니다. 엔드포인트, 매개변수 및 인증은 API 문서에 있습니다.
3단계: 첫 번째 요청을 보냅니다. 작업을 제출합니다:
plaintext1curl -X POST https://api.atlascloud.ai/api/v1/model/generateVideo \ 2 -H "Content-Type: application/json" \ 3 -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \ 4 -d '{ 5 "model": "pixverse/v6/text-to-video", 6 "prompt": "A slow dolly shot through a rain-wet night market, neon signs reflecting in puddles, steam rising from food stalls", 7 "duration": 5, 8 "quality": "720p", 9 "aspect_ratio": "16:9", 10 "sound": true 11 }'
응답은 예측 ID를 반환합니다. 상태가 완료됨으로 표시될 때까지 폴링합니다:
plaintext1curl https://api.atlascloud.ai/api/v1/model/prediction/<prediction_id> \ 2 -H "Authorization: Bearer $ATLASCLOUD_API_KEY"
완료된 응답은 호스팅된 비디오 URL을 전달합니다. 지속적인 이점은 요청 형태입니다: Atlas Cloud는 모든 모델에서 하나의 API를 실행하므로 하나의 키, 하나의 인증 헤더 및 하나의 제출-및-폴링 루프로 오늘의 PixVerse와 나중에 추가할 모든 것을 처리할 수 있습니다. 모델을 전환한다는 것은 모델 문자열만 변경하면 된다는 뜻이며, 다른 것은 변경할 필요가 없습니다.
공식 PixVerse AI API 문서 내부: 호출이 실제로 실행되는 방식
대신 PixVerse 자체 플랫폼과 통합하는 경우 API 개요는 기본 도메인 app-api.pixverse.ai에 대해 3단계 흐름을 정의합니다:
| 단계 | 엔드포인트 | 참고 |
|---|---|---|
| 업로드 (이미지-투-비디오만 해당) | POST /openapi/v2/image/upload | 멀티파트 폼. PNG, WebP 또는 JPEG, 20MB 미만. img_id 정수 반환 |
| 생성 | POST /openapi/v2/video/text/generate | JSON 본문. video_id 반환 |
| 폴링 | GET /openapi/v2/video/result/{video_id} | 상태 1은 완료를 의미하며, 응답에 다운로드 url 포함 |
인증은 모든 호출에 두 개의 헤더가 필요합니다. API-KEY는 플랫폼 콘솔의 키를 보유합니다. Ai-trace-id는 요청마다 새로운 UUID여야 합니다. 문서는 하나를 재사용하면 새 생성이 시작되지 않는다고 경고합니다.
현재 텍스트-투-비디오 참조는 5개의 필드를 필수로 표시합니다: prompt(최대 5,000자), model, duration, quality, aspect_ratio. model 열거형은 v3.5부터 v5.6, v6, c1까지 8개의 값을 허용하며, 지속 시간 제한은 생성에 따라 다릅니다: v5까지는 5초 또는 8초, v5.5 및 v5.6에서는 10초 옵션, v6 및 c1에서는 1~15초 사이입니다. 오디오는 generate_audio_switch를 통해 선택 사항이며 기본값은 false입니다. 이 기본값은 예산 책정에 중요합니다: 위의 Atlas Cloud 플레이그라운드는 사운드를 기본적으로 켜므로 두 경로는 동일해 보이는 클립에 대해 다른 가격을 제시합니다.
이미지-투-비디오는 먼저 업로드 단계를 추가합니다. 공개 이미지 URL을 전달하는 것은 없습니다. 파일을 업로드하고 반환된 img_id를 가져와 생성 본문에서 참조합니다.
두 가지 운영 사실이 그림을 완성하며, 둘 다 오류 참조에서 가져왔습니다. 동시 생성은 멤버십 등급에 따라 제한되며, 멈춘 슬롯은 약 10분 후에 자동으로 해제됩니다. 그리고 폴링 상태는 명시적으로 처리할 가치가 있습니다: 7은 프롬프트가 콘텐츠 조정에 걸렸음을 의미하고, 8은 재시도할 가치가 있는 서버 측 오류를 의미합니다.
PixVerse API 문서가 스스로 모순되는 부분
PixVerse API 문서는 최신 엔드포인트 참조와 완전히 업데이트되지 않은 오래된 방법 페이지가 혼합되어 있습니다. 잘못된 페이지를 읽으면 실제 디버깅 시간이 낭비됩니다. 우리가 직접 확인한 충돌은 다음과 같습니다:
| 주제 | 오래된 문서 페이지에서 말하는 내용 | 현재 참조에서 말하는 내용 |
|---|---|---|
| negative_prompt | API 개요의 예제 요청 본문에 표시됨 | 생성 엔드포인트의 필드가 아님 |
| water_mark | "water_mark": false가 동일한 예제에 나타남 | 현재 매개변수 목록에 없음 |
| 클립 길이 | MCP README에 "5s 또는 8s"로 하드코딩됨 | v6 및 c1에서 1~15초 사이 |
| 이미지 업로드 제한 | 문제 해결 페이지: 4000×4000 픽셀 | 업로드 참조: 10,000 픽셀 |
| 프롬프트 길이 | 방법 가이드: 프롬프트를 25~200단어로 유지 | 5,000자 하드 제한, 단어 지침 없음 |
두 가지 규칙이 다섯 행 모두를 다룹니다. 페이지가 충돌할 때는 방법 페이지보다 엔드포인트 참조를 신뢰하세요. 참조는 현재 사양을 전달하고 가이드는 기록을 전달합니다. 그리고 제한이 충돌할 때는 더 엄격한 쪽으로 코딩하세요. 따라서 업로드의 경우 4000픽셀입니다.
버전 열거형에는 자체 경고가 필요합니다. 이전 모델 이름은 여전히 작동합니다: v3.5, v4, v4.5는 여전히 유효한 값이므로 2025년대 통합이 중단되지 않았습니다. 단지 더 많은 비용을 지불할 뿐입니다. 동일한 설정에서 720p 5초 오디오 없는 경우 공식 가격은 V4에서 60 크레딧이지만 V6에서는 45 크레딧입니다. 이전 모델 문자열이 있는 코드베이스를 상속받은 경우 업그레이드는 한 줄 변경으로 비용을 절감하고 출력을 개선합니다. V2 생성만 자사 액세스에서 완전히 사라졌습니다.
PixVerse API 가격: 플랫폼의 크레딧, Atlas Cloud의 달러
공식 PixVerse 플랫폼은 크레딧으로 청구하며, 가격 페이지는 모델 테이블에 "초당 계산"이라고 표시합니다. 크레딧 팩은 $10에 1,000 크레딧부터 $5,000에 500,000 크레딧까지이며, 월간 멤버십은 $100 Essential 플랜(15,000 크레딧)에서 $6,000 Business 등급까지 있습니다. 현재 모델의 초당 크레딧 소모량:
| 품질 | V6 (오디오 없음 / 오디오 있음) | C1 (오디오 없음 / 오디오 있음) |
|---|---|---|
| 360p | 5 / 7 크레딧 | 6 / 8 크레딧 |
| 540p | 7 / 9 크레딧 | 8 / 10 크레딧 |
| 720p | 9 / 12 크레딧 | 10 / 13 크레딧 |
| 1080p | 18 / 23 크레딧 | 19 / 24 크레딧 |
Atlas Cloud는 동일한 두 모델을 초당 달러로 측정하며, 팩이나 멤버십이 필요하지 않습니다. 2026년 7월 23일 라이브 모델 페이지에서 확인했으며, 할인 없이 정가 기준입니다:
| 품질 | V6 (오디오 없음 / 오디오 있음) | C1 (오디오 없음 / 오디오 있음) |
|---|---|---|
| 360p | $0.025 / $0.035 | $0.030 / $0.040 |
| 540p | $0.035 / $0.045 | $0.040 / $0.050 |
| 720p | $0.045 / $0.060 | $0.050 / $0.065 |
| 1080p | $0.090 / $0.115 | $0.095 / $0.120 |
하나의 클립이 비교를 구체적으로 만들어 줍니다. 오디오가 포함된 5초 720p V6 클립은 60 크레딧입니다: $10 팩 요금으로 약 $0.60, Essential 멤버십 요금으로 한 달에 $100을 약정한 후 약 $0.40입니다. Atlas Cloud에서 종량제로 측정하면 동일한 클립은 $0.30입니다. C1 모델은 초당 약간 더 높은 가격으로, C1 플레이그라운드를 통해 동일한 클립에 대해 $0.325이며, 이는 영화 제작 튜닝을 제공합니다.
크레딧은 특히 Scale 등급 볼륨에서 유효 요금이 낮아지는 PixVerse 플랫폼 내에 이미 있는 팀에게 여전히 의미가 있습니다. 다른 모든 사람에게는 초당 달러 가격이 예측하기 더 쉽습니다: 렌더링 비용은 지속 시간에 요금을 곱한 값이며, 지출하기 전에 읽을 수 있습니다.
API 뒤에 있는 PixVerse AI 개발자 회사
API는 그것을 운영하는 회사에 대한 베팅이며, PixVerse AI 개발자 회사는 구축하기 전에 알아둘 가치가 있습니다. PixVerse는 2023년 4월 베이징에서 설립된 AISphere (Aishi Technology)에 의해 구축되었으며, 현재 싱가포르에 본사를 두고 약 150명의 직원이 있습니다. 설립자 겸 CEO Wang Changhu는 2017년부터 2021년까지 ByteDance의 AI Lab 비전 작업을 이끌었으며, 이는 PixVerse를 그의 전 고용주가 만든 Seedance의 직접적인 라이벌로 만듭니다. 공동 설립자 Jaden Xie는 Lighthouse Capital 출신입니다.
자금 조달 상황은 독립 비디오 모델 업체로서는 이례적으로 강력합니다. 2026년 7월 13일, 회사는 TechCrunch에 따르면 Alibaba가 참여한 시리즈 C 확장 라운드를 마감하여 총 4억 3900만 달러, 평가액은 20억 달러를 넘었습니다. 개발자에게 이는 운영 자금을 의미합니다: 이번 분기에 통합하는 API가 내년에 사라질 가능성은 낮습니다.
잘 지원받는 연구소의 단점은 출시 속도입니다. 2026년 릴리스 라인만으로도:
3개월 안에 세 가지 모델 출시는 이 기사가 계속 지적하는 문서 지연을 설명합니다. 이에 따라 구축하세요: 모델 문자열을 고정하고, 업데이트 전에 릴리스 노트를 읽고, 지난 분기의 매개변수가 살아남았다고 가정하지 말고 엔드포인트 참조를 다시 확인하세요.
자주 묻는 질문
공식 PixVerse API 문서는 어디에 있나요?
docs.platform.pixverse.ai에 있으며, 개발자 콘솔은 platform.pixverse.ai에 있습니다. app.pixverse.ai에 호스팅된 것은 소비자 제품이며, 타사 "PixVerse API 문서" 페이지는 종종 v4 시대 매개변수를 설명합니다. 문서에는 코딩 어시스턴트에 제공할 수 있는 통합 LLM 준비 텍스트 페이지도 포함되어 있습니다.
PixVerse API 키를 어떻게 얻나요?
platform.pixverse.ai의 플랫폼 콘솔에 등록하고, 키를 생성한 후 요청마다 고유한 Ai-trace-id UUID와 함께 API-KEY 헤더로 전달합니다. 키는 소비자 앱 구독과 별도로 구매되는 플랫폼 크레딧에 연결됩니다. Atlas Cloud에서 이에 상응하는 것은 표준 Bearer 토큰으로 전달되는 콘솔 키입니다.
PixVerse API에 무료 등급이 있나요?
플랫폼 가격 문서는 유료 크레딧 팩과 멤버십만 나열합니다. PixVerse가 광고하는 가변적인 일일 무료 크레딧은 소비자 앱에 속하며 API 원장으로 흐르지 않습니다. 가장 저렴한 유료 진입점은 공식 플랫폼의 $10 크레딧 팩 또는 Atlas Cloud의 초당 $0.025부터 시작하는 종량제 생성입니다.
PixVerse API는 어떤 모델을 실행할 수 있나요?
현재 생성 엔드포인트는 v3.5, v4, v4.5, v5, v5.5, v5.6, v6, c1의 8개 모델 값을 허용합니다. V6와 C1은 현재 세대이며, 1~15초 클립과 선택적 기본 오디오를 제공합니다. 이전 이름은 여전히 작동하지만 동일한 설정에서 V6보다 더 많은 크레딧이 소모됩니다. V2 생성은 더 이상 자사에서 사용할 수 없습니다.
PixVerse AI API 비디오 하나당 비용은 얼마인가요?
공식 플랫폼: 오디오가 포함된 5초 720p V6 클립은 60 크레딧으로, $10 팩 요금으로 약 $0.60입니다. Atlas Cloud: 동일한 클립은 해상도와 오디오에 따라 초당 $0.025~$0.115 범위의 종량제로 $0.30입니다. C1은 약간 더 높아서 해당 클립에 $0.325입니다. 가격은 2026년 7월 23일에 확인되었습니다.
결론
PixVerse API는 문서보다 상태가 더 좋습니다. 서비스 자체는 빠르고, 자금이 충분하며, 최신 상태입니다: 8개의 모델 값, 최대 15초 클립, 동일한 패스의 오디오, 주니어 개발자도 오후에 연결할 수 있는 비동기 흐름. 문서가 출시 일정을 따라잡지 못했을 뿐이므로 엔드포인트 참조와 방법 가이드는 서로 다른 제품을 설명합니다.
작업 방법은 간단합니다. 엔드포인트 참조를 신뢰하고, 페이지가 충돌할 때는 더 엄격한 제한으로 코딩하며, 모델 문자열을 고정하세요. 그런 다음 청구 형태를 선택하세요: 팀이 이미 그곳에 있다면 공식 플랫폼의 크레딧, 또는 보내기 전에 모든 렌더링의 가격을 읽을 수 있게 하려면 초당 $0.025부터 시작하는 종량제 달러. 플레이그라운드의 기본 $0.30 클립은 어느 쪽에 속하는지 알아내기 위한 저렴한 방법입니다.
