본문으로 건너뛰기
DER.run
스튜디오 열기

API

AI 이미지·영상 생성 API

스튜디오의 모델과 도구를 API 키와 HTTPS로 사용할 수 있어요. 모델 카탈로그를 읽고, 생성을 요청하고, 상태를 폴링해 결과를 다운로드하세요. MCP로 AI 에이전트를 DER에 연결할 수도 있어요.

API 키 받기AI 에이전트 연결하기
  • 인증Bearer API 키
  • 모델과 도구카탈로그에 55개
  • 폴링5~30초마다
  • 요금1 크레딧 = US$0.01

두 가지 방법

코드에는 REST, 에이전트에는 MCP

REST API

https://api.der.run/v1

직접 작성한 코드에서 쓰는 방법이에요. 생성을 요청하고, 폴링하고, 결과를 다운로드하세요.

  • GET/v1/capabilities모든 모델과 파라미터, 업로드 슬롯, 가격 방식, 폴링 간격
  • POST/v1/quotes요청 전에 생성 가격 확인
  • POST/v1/uploads업로드를 시작한 뒤, 반환된 주소로 파일을 PUT
  • POST/v1/uploads/{id}/complete업로드를 마치고 입력에 쓸 asset id 받기
  • POST/v1/jobs생성 요청 · Idempotency-Key 필수
  • GET/v1/jobs생성 목록(최신순, 페이지당 최대 100개)
  • GET/v1/jobs/{id}생성 상태
  • GET/v1/jobs/{id}/assets/{index}약 1시간 동안 유효한 비공개 링크로 출력물 다운로드

MCP 서버와 DER 스킬

https://api.der.run/mcp

Claude Code, Cursor, Codex 같은 AI 에이전트용이에요. 주소를 추가하고 DER 계정으로 로그인한 뒤 평소 말투로 요청하세요.

  • der_list_models모델, 가격, 제한
  • der_quote실행 전 작업 가격 확인(무료)
  • der_create_job동영상, 이미지, AIdol, 얼굴 바꾸기, 음악 작업 시작
  • der_get_job상태와 결과 링크
  • der_get_results다운로드 링크
  • + MCP 서버의 도구 13개 더
AI 에이전트 설정하기

인증

키 하나로 계정 전체를

API 키를 Bearer 토큰으로 보내세요. 키는 계정과 똑같이 작동해서 크레딧도 등급도 같아요. 키는 최대 366일 동안 유효하며, “API 키”에서 만들고 폐기할 수 있어요. 한 번에 최대 10개까지 가질 수 있어요.

HTTP 헤더
# 모든 요청
Authorization: Bearer der_user_…

빠른 시작

세 단계로 첫 생성 실행하기

  1. API 키 만들기

    스튜디오의 “API 키”에서 만들 수 있어요. 키는 한 번만 표시되니 안전한 곳에 보관하세요.

    API 키 열기

  2. 카탈로그 읽기

    GET /v1/capabilities는 모든 모델과 파라미터, 업로드 슬롯, 가격 방식, 폴링 간격을 보여 줘요.

    터미널
    curl "https://api.der.run/v1/capabilities" \
  -H "Authorization: Bearer $DER_API_KEY"

  3. 요청하고 폴링하기

    먼저 사진을 업로드한 뒤 Idempotency-Key와 함께 POST /v1/jobs를 보내고, 생성이 끝날 때까지 GET /v1/jobs/{id}를 폴링하세요. 같은 키로 다시 보내면 같은 생성이 반환돼요.

    터미널
    curl -X POST "https://api.der.run/v1/jobs" \
  -H "Authorization: Bearer $DER_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "der-v2",
    "params": {
      "prompt": "…"
    },
    "inputs": {
      "image": "<asset id>"
    }
  }'

curl "https://api.der.run/v1/jobs/{id}" \
  -H "Authorization: Bearer $DER_API_KEY"

알아 두면 좋아요

출시 전에 확인하세요

  • 결과는 비공개예요

    REST에서는 출력물을 키로 다운로드해요. GET /v1/jobs/{id}/assets/{index}는 약 1시간 동안 유효한 비공개 링크로 연결돼요. 공개 링크는 없으며, MCP 도구도 같은 종류의 링크를 제공해요. 결과와 업로드 파일은 7일 동안 보관된 후 자동으로 삭제됩니다.

  • 목록은 페이지 단위로 와요

    GET /v1/jobs는 최신순으로 최대 100개의 생성을 반환해요. 이전 항목을 받으려면 next_before 값을 before로 넘기고, 모델, 출력, 상태로 필터링할 수 있어요.

  • 가격

    일부 모델은 카탈로그에 고정 가격이 있고, 나머지는 요청할 때 가격이 정해져요. POST /v1/quotes로 먼저 가격을 확인할 수 있어요.

  • 등급

    일부 모델은 Pro 또는 Max 계정이 필요해요. 더 낮은 등급에서 이런 모델을 요청하면 403이 반환돼요.

  • 같은 크레딧

    API는 스튜디오와 같은 크레딧을 사용해요. 실패한 생성의 크레딧은 자동으로 반환돼요.

  • 모델의 속도에 맞춰 폴링

    모델마다 카탈로그에 poll_seconds 값이 있어요. 요청이 너무 많으면 Retry-After 헤더와 함께 429가 반환돼요.

AI 에이전트용

Claude Code, Cursor, Codex에서 DER 사용하기

명령 하나로 연결돼요. 모델과 크레딧은 같고, 결과도 스튜디오에 함께 표시돼요.

AI 에이전트 가이드 열기