DDEUNDEUN API
AI 콘텐츠 워크플로우를 여러분의 서비스에 연결하세요
프로젝트 생성, 쇼츠 자동 제작, 업로드 예약, 성과 분석까지 모든 기능을 API 한 번으로 통합할 수 있습니다. OAuth 기반 인증과 세분화된 권한으로 엔터프라이즈 환경에서도 안전하게 사용할 수 있습니다.
Authentication
API 인증 방식
OAuth 2.0 Client Credentials Flow를 기본으로 사용하며, 서버 간 통신을 위해 전용 서비스 계정 발급을 지원합니다.
- 파트너 콘솔에서 애플리케이션을 등록합니다.
- Client ID / Secret을 발급받아 토큰 엔드포인트로 액세스 토큰을 요청합니다.
- 요청 헤더에 `Authorization: Bearer <token>`을 포함하여 API를 호출합니다.
POST https://api.ddeundeun.ai/oauth/token
Content-Type: application/json
{
"client_id": "your-client-id",
"client_secret": "your-client-secret",
"audience": "https://api.ddeundeun.ai",
"grant_type": "client_credentials"
}Security
보안 및 거버넌스
GDPR, 국내 개인정보 보호법을 준수하며, 고객 자료는 서울 리전에서 암호화되어 저장됩니다.
- 모든 API는 TLS 1.2 이상에서만 통신합니다.
- 필요 시 IP 화이트리스트와 요청 서명 기능을 활성화할 수 있습니다.
- 감사 로그를 12개월간 보관하고 CSV로 내보내기할 수 있습니다.
주요 엔드포인트
콘텐츠 제작과 운영을 자동화하기 위해 가장 많이 사용하는 엔드포인트입니다.
POST
/v1/projects
새 프로젝트를 생성하고 기본 콘텐츠 파이프라인을 초기화합니다.
POST
/v1/projects/{projectId}/shorts
설명과 자료를 입력하면 쇼츠 스크립트, 썸네일, 음성을 생성합니다.
GET
/v1/projects/{projectId}/analytics
노출, 클릭, 전환 데이터와 추천 액션을 반환합니다.
POST
/v1/projects/{projectId}/publish
YouTube, TikTok 등 연결된 채널로 예약 업로드를 실행합니다.
샘플 요청
프로젝트를 생성하고 쇼츠를 만드는 과정을 단일 스크립트로 살펴보세요.
import { DdeundeunAI } from "@ddeundeunai/sdk";
const client = new DdeundeunAI({ apiKey: process.env.DDEUNDEUN_API_KEY });
const project = await client.projects.create({
title: "시니어 건강 콘텐츠",
targetAudience: "활동적인 60대",
primaryGoal: "구독자 전환",
});
const short = await client.shorts.generate(project.id, {
topic: "무릎 스트레칭 루틴",
assets: [
"https://cdn.ddeundeun.ai/reference/mobility.pdf",
"https://cdn.ddeundeun.ai/reference/stretching.jpg",
],
});
await client.shorts.publish(project.id, short.id, {
channel: "youtube",
scheduledAt: "2024-11-15T09:00:00+09:00",
});
console.log("Published!", short.previewUrl);전체 API 문서 열기Webhook 이벤트
워크플로우 자동화를 위해 주요 이벤트를 웹훅으로 전달합니다.
project.generated
AI 생성 작업이 완료되면 호출됩니다. 결과물 URL이 payload에 포함됩니다.
project.published
콘텐츠가 채널에 업로드되었을 때 전달됩니다. 게시물 상태를 동기화하세요.
project.analytics.ready
지난 24시간 동안의 지표와 추천 액션이 준비되었을 때 호출됩니다.
지금 든든AI API를 도입해 보세요
사용 목적과 기존 시스템 환경을 알려주시면 적합한 통합 전략과 PoC 일정, 요금제를 제안해 드립니다.