모델

요청의 model에는 devdive-로 시작하는 데브다이브 모델 ID를 넣어요. 모델을 만든 회사의 모델 이름 (gpt-…, claude-…)은 받지 않아요. model을 빼면 각 엔드포인트의 기본 모델로 불러요.

지금 쓸 수 있는 목록은 언제든 GET /v1/models로 받을 수 있어요(키 없이도 돼요).

글 모델

POST /v1/text에서 써요. → 글 생성

모델 ID모델이런 때
devdive-text-5-6-lunaGPT-5.6 Luna기본값. GPT-5.6에서 가장 가볍고 빨라요. 요약, 분류, 짧은 글
devdive-text-5-6-terraGPT-5.6 TerraLuna와 Sol 사이. 보통 길이의 글과 일반 작업
devdive-text-5-6-solGPT-5.6 SolGPT-5.6에서 가장 높은 단계. 어려운 추론, 긴 글
devdive-claude-haikuClaude Haiku 4.5빠르고 가벼운 Claude. 많은 양을 빠르게 처리할 때
devdive-claude-sonnetClaude Sonnet 4.6품질과 속도의 균형. 글쓰기, 코드, 분석
devdive-claude-sonnet-5Claude Sonnet 5Sonnet의 새 세대
devdive-claude-opusClaude Opus 4.6가장 강력한 Claude. 어렵고 긴 작업

이미지 모델

POST /v1/images에서 써요. → 이미지

모델 ID모델이런 때
devdive-image-gpt-2-5-flareGPT Image 2.5 Flare기본값. 문장으로 이미지 만들기. 빨라요
devdive-image-gpt-2-5-sunburstGPT Image 2.5 Sunburst문장으로 이미지 만들기. 가장 정밀하고 느려요
devdive-image-gpt-2-5-flare-editGPT Image 2.5 Flare 편집참고 이미지(1~3장)를 바탕으로 바꾸기. 얼굴·제품을 유지하고 장면 바꾸기 등
devdive-image-gpt-2-5-sunburst-editGPT Image 2.5 Sunburst 편집위와 같고 더 정밀해요

크기는 네 모델 모두 auto, 1024x1024, 1536x1024(가로), 1024x1536(세로)이에요.

영상 모델

POST /v1/videos에서 써요. 모델마다 받는 입력이 달라요. → 영상

모델 ID하는 일꼭 필요한 입력
devdive-video-wan30-t2v기본값. WAN 3.0, 문장으로 영상 만들기. 소리 켜고 끄기 가능prompt
devdive-video-wan30-r2vWAN 3.0, 시작·끝 장면을 정하거나 참고 이미지·영상·오디오로 만들기장면(image_url)이나 참고 자료 중 하나 이상
devdive-video-happyhorse-t2vHappyHorse 1.1, 문장으로 영상 만들기prompt
devdive-video-happyhorse-i2vHappyHorse 1.1, 사진을 첫 장면으로 움직이기prompt, image_url
devdive-video-happyhorse-r2vHappyHorse 1.1, 인물·사물 참고 이미지(1~9장)로 만들기prompt, reference_image_urls
devdive-video-happyhorse-editHappyHorse 1.0, 있는 영상을 문장으로 고치기prompt, video_url
devdive-video-wan-actionWAN, 사진 속 인물이 영상 속 동작을 따라 하기image_url, video_url (prompt는 받지 않음)

음성·음악 모델

모델 ID엔드포인트하는 일
devdive-tts-elevenPOST /v1/speech기본값. ElevenLabs로 글을 목소리로. voice_model로 eleven_v4(기본)나 eleven_v4_turbo(빠름)를 골라요
devdive-musicPOST /v1/musicMiniMax로 가사를 노래로. version으로 엔진을 골라요(music-2.5 기본, music-3.0, music-2.0)

→ 음성·음악

엔드포인트가 정해 둔 모델

아래 엔드포인트는 model을 고르지 않아요. 엔드포인트마다 정해진 모델이 일해요.

엔드포인트쓰는 모델고를 수 있는 것
POST /v1/transcriptionsWhisper언어(language)
POST /v1/image-analyses데브다이브 이미지 분석없음
POST /v1/document-analyses데브다이브 문서 분석요약 또는 마크다운 변환(operation)
POST /v1/searchBrave, Perplexity검색 엔진(engine)
POST /v1/researchPerplexity Sonarsonar(기본), sonar-pro, sonar-reasoning-pro

GET /v1/models

키 없이 부를 수 있어요. 각 모델이 어느 엔드포인트에서 무엇을 받는지 알려 줘요. 고정 모델은 목록에 없어요.

curl https://api.devdive.ai/v1/models
{
  "object": "list",
  "data": [
    { "id": "devdive-text-5-6-luna", "object": "model", "type": "text", "endpoint": "/v1/text", "stream": false },
    {
      "id": "devdive-image-gpt-2-5-flare-edit", "object": "model", "type": "image", "endpoint": "/v1/images",
      "needs_image": true, "sizes": ["auto", "1024x1024", "1536x1024", "1024x1536"]
    },
    {
      "id": "devdive-video-wan30-r2v", "object": "model", "type": "video", "endpoint": "/v1/videos",
      "prompt": "optional",
      "inputs": ["audio", "end_image_url", "image_url", "reference_audio_urls", "reference_image_urls", "reference_video_urls"],
      "required_inputs": [],
      "one_of": ["image_url", "reference_image_urls", "reference_video_urls", "reference_audio_urls"]
    },
    { "id": "devdive-music", "object": "model", "type": "music", "endpoint": "/v1/music", "versions": ["music-2.5", "music-3.0", "music-2.0"] }
  ]
}
필드뜻
id요청의 model에 넣는 값
typetext, image, video, speech, music
endpoint이 모델을 부르는 경로
stream글 모델. 스트리밍을 받는지(지금은 모두 false)
needs_image이미지 모델. true면 참고 이미지(image_urls)가 꼭 있어야 하는 편집 모델
sizes이미지 모델. 고를 수 있는 size 값
prompt영상 모델. required(필수), optional(선택), not_accepted(보내면 안 됨)
inputs영상 모델. 공통 설정 말고 이 모델만 받는 입력
required_inputs영상 모델. 꼭 보내야 하는 입력
one_of영상 모델. 이 중 하나 이상은 보내야 하는 입력
versions음악 모델. 고를 수 있는 엔진 버전

모델이 더해지거나 빠지면 변경 내역에 적어요.