API 레퍼런스

이 API는 무엇인가요

MyDreamVid API를 사용하면 누구도 스튜디오를 클릭할 필요 없이, 여러분의 소프트웨어가 직접 Seedance와 Seedream 모델로 영상과 이미지를 생성할 수 있습니다. 프로그램이 프롬프트(와 선택적 참조 파일)를 보내면, 저희가 웹 스튜디오와 동일한 안전 검사와 동일한 가격을 적용하고, 프로그램이 완성된 파일을 가져갑니다. 크레딧은 같은 계정 잔액에서 차감됩니다.

누구를 위한 것인가요

• 대량 생성이 필요한 팀: 제품 카탈로그, 광고 배리에이션, SNS 클립, 한 영상의 현지화 버전.
• 자신의 앱, 도구, 봇, 내부 파이프라인에 영상·이미지 생성을 추가하려는 개발자.
• 자체 프런트엔드를 갖추고 모델·대기열·과금은 저희에게 맡기고 싶은 에이전시와 스튜디오.

일주일에 몇 편만 직접 만드신다면 API가 필요 없습니다. 스튜디오가 API와 똑같은 일을 똑같은 가격에 해 줍니다.

인증

모든 요청에는 Bearer 키가 필요합니다. 키는 스튜디오에서 만들며 단 한 번만 표시됩니다.

• Header: Authorization: Bearer mdv_live_…
• write 권한은 작업 생성·취소와 파일 업로드가 가능하고, read 권한은 목록 조회와 가져오기만 가능합니다.
• 키는 Creator($25) 또는 Studio($50) 충전 후 사용할 수 있습니다. 크레딧은 만료되지 않습니다.
• 이 API는 여러분의 서버에서 호출하도록 설계되었습니다. 브라우저나 모바일 코드에 키를 포함하지 마세요.

가격을 먼저 확인하세요

모든 작업은 크레딧이 듭니다(1 크레딧 = $0.01). 생성 전에 견적을 요청하세요. 견적은 무료이고 Idempotency-Key가 필요 없으며, 작업이 예약할 금액을 정확히 반환합니다. 작업 생성 시 같은 숫자가 credits_reserved로 돌아오고, 완료된 작업의 credits_charged가 실제 결제 금액입니다(미사용 예약분은 반환됩니다).

GET /v1/credits는 언제든 사용 가능 잔액과 예약 잔액을 보여 줍니다. API로 만든 작업도 스튜디오의 내 작품과 크레딧 내역에 표시됩니다.

엔드포인트

• GET /v1/models — 모델별 길이, 해상도, 비율, 초당 크레딧 가격, 참조 제한.
• POST /v1/videos/quote — 작업의 정확한 크레딧 비용. 무료, 예약 없음.
• POST /v1/videos — 작업 생성. Body: kind (t2v | i2v | r2v), model, prompt, duration_s, resolution, ratio, 선택적 generate_audio, references. Idempotency-Key 필수.
• GET /v1/videos/{id} — 작업 상태. succeeded 상태의 작업에는 video_url이 포함됩니다.
• GET /v1/videos — 내 작업 목록, 최신순, 커서 페이지네이션 (limit, cursor).
• POST /v1/videos/{id}/cancel — waiting 또는 queued 상태의 작업을 취소합니다.
• POST /v1/files/presign — 참조 이미지·영상·오디오 파일의 업로드 슬롯을 발급합니다.
• POST /v1/files/{media_id}/confirm — 업로드 완료 처리: 파일이 분석·안전 검사를 거친 뒤 참조로 사용 가능해집니다.
• GET /v1/credits — 사용 가능 크레딧과 예약된 크레딧.

제한

• 키당 분당 60 요청.
• API를 통한 계정당 진행 중 작업(waiting, queued, running) 2개.
• 모델별 레인은 모든 사용자가 공유합니다. 레인이 꽉 차면 작업이 순서대로 대기하다가 자동으로 전송됩니다.
• 계정당 활성 키 최대 5개.
• 파일: 이미지 최대 10 MB, 영상 최대 50 MB, 오디오 최대 20 MB. 참조 영상은 2초 이상이어야 하며, 영상과 오디오는 최대 5분까지 가능합니다.