API 문서

DeepManim 공개 API v1

시작하기

DeepManim API를 사용하면 프로그래밍 방식으로 교육용 애니메이션 동영상을 생성할 수 있습니다. 텍스트 프롬프트로 동영상을 만들고, 반복해서 개선하고, 내레이션을 추가하세요. 모두 간단한 REST API로 가능합니다.

기본 URL: https://api.deepmanim.com/api/v1

중요 안내

  • 생성 시 오디오: /generate를 통해 새 동영상을 생성하면 오디오 내레이션이 기본으로 포함됩니다.
  • 수정 시 오디오 없음: /improve로 동영상을 개선한 결과에는 오디오가 없습니다. 모든 수정을 마친 후 동영상이 마음에 들면 /audio로 오디오를 추가하세요.
  • 예상 시간: 동영상 생성에는 약 6분이 걸립니다. 작업 응답의 estimated_time_remaining_seconds 필드에서 실시간 카운트다운을 확인할 수 있습니다.

인증

모든 API 요청에는 API 키가 필요합니다. 앱의 설정 → API 키에서 키를 생성하세요.

크레딧 구매가 필요합니다. API는 크레딧을 한 번 이상 구매한 사용자만 이용할 수 있습니다. 무료 요금제 크레딧만으로는 충분하지 않습니다.

Authorization 헤더에 키를 포함하세요:

Authorization: Bearer dm_k_your_api_key_here

API 키를 안전하게 보관하세요. 공개 저장소나 클라이언트 측 애플리케이션에 공유하지 마세요.

빠른 시작

세 단계로 동영상을 생성하세요. 작업을 만들고, 완료될 때까지 폴링한 다음, 결과를 가져옵니다.

1. 동영상 생성

curl -X POST https://api.deepmanim.com/api/v1/generate \
  -H "Authorization: Bearer dm_k_your_key" \
  -H "Content-Type: application/json" \
  -d '{"message": "광합성이 어떻게 작동하는지 설명해 주세요", "preferred_locale": "ko"}'

2. 완료될 때까지 폴링

curl https://api.deepmanim.com/api/v1/jobs/JOB_ID \
  -H "Authorization: Bearer dm_k_your_key"

# 응답에는 다음이 포함됩니다:
#   status: "pending" | "running" | "completed" | "failed"
#   phase: "exploring_ideas" | "brainstorming" | "crafting_vision" | "refining_details" | "assembling_pieces" | "polishing" | "adding_voice" | "iterating" | "done"
#   estimated_time_remaining_seconds: 285

3. 결과 가져오기

# status가 \"completed\"이면 응답에는 다음이 포함됩니다:
{
  "job_id": "...",
  "status": "completed",
  "phase": "done",
  "estimated_time_remaining_seconds": 0,
  "result": {
    "video_url": "https://...",
    "description": "광합성을 설명하는 애니메이션…",
    "session_id": "...",
    "message_id": "...",
    "duration_seconds": 24.6,
    "has_audio": true,
    "follow_up": "세포 호흡은 광합성과 어떤 관련이 있나요?"
  }
}

엔드포인트

동영상 생성

작업

세션

메시지

계정

크레딧 및 가격

작업을 생성하는 각 API 호출은 잔액에서 크레딧을 차감합니다:

작업비용
동영상 생성1.5크레딧부터 시작
동영상 개선1.5크레딧부터 시작
오디오 추가1 크레딧
내레이션 개선1 크레딧

생성 및 개선 비용은 선택한 프리셋에 따라 달라지며 현재 1.5~70크레딧입니다. 세션, 메시지, 작업 상태, 계정 정보 조회는 무료이며 크레딧을 차감하지 않습니다.

오류 응답

상태의미
401API 키가 없거나 유효하지 않음
402크레딧 부족
404리소스를 찾을 수 없음(세션, 메시지 또는 작업)
400잘못된 요청(예: 개선할 동영상이 없거나 다듬을 내레이션이 없음)
API 문서 | DeepManim