모델
요청의 model에는 devdive-로 시작하는 데브다이브 모델 ID를 넣어요. 모델을 만든 회사의 모델 이름
(gpt-…, claude-…)은 받지 않아요. model을 빼면 각 엔드포인트의 기본 모델로 불러요.
지금 쓸 수 있는 목록은 언제든 GET /v1/models로 받을 수 있어요(키 없이도 돼요).
글 모델
POST /v1/text에서 써요. → 글 생성
| 모델 ID | 모델 | 이런 때 |
|---|---|---|
devdive-text-5-6-luna | GPT-5.6 Luna | 기본값. GPT-5.6에서 가장 가볍고 빨라요. 요약, 분류, 짧은 글 |
devdive-text-5-6-terra | GPT-5.6 Terra | Luna와 Sol 사이. 보통 길이의 글과 일반 작업 |
devdive-text-5-6-sol | GPT-5.6 Sol | GPT-5.6에서 가장 높은 단계. 어려운 추론, 긴 글 |
devdive-claude-haiku | Claude Haiku 4.5 | 빠르고 가벼운 Claude. 많은 양을 빠르게 처리할 때 |
devdive-claude-sonnet | Claude Sonnet 4.6 | 품질과 속도의 균형. 글쓰기, 코드, 분석 |
devdive-claude-sonnet-5 | Claude Sonnet 5 | Sonnet의 새 세대 |
devdive-claude-opus | Claude Opus 4.6 | 가장 강력한 Claude. 어렵고 긴 작업 |
이미지 모델
POST /v1/images에서 써요. → 이미지
| 모델 ID | 모델 | 이런 때 |
|---|---|---|
devdive-image-gpt-2-5-flare | GPT Image 2.5 Flare | 기본값. 문장으로 이미지 만들기. 빨라요 |
devdive-image-gpt-2-5-sunburst | GPT Image 2.5 Sunburst | 문장으로 이미지 만들기. 가장 정밀하고 느려요 |
devdive-image-gpt-2-5-flare-edit | GPT Image 2.5 Flare 편집 | 참고 이미지(1~3장)를 바탕으로 바꾸기. 얼굴·제품을 유지하고 장면 바꾸기 등 |
devdive-image-gpt-2-5-sunburst-edit | GPT Image 2.5 Sunburst 편집 | 위와 같고 더 정밀해요 |
크기는 네 모델 모두 auto, 1024x1024, 1536x1024(가로), 1024x1536(세로)이에요.
영상 모델
POST /v1/videos에서 써요. 모델마다 받는 입력이 달라요. → 영상
| 모델 ID | 하는 일 | 꼭 필요한 입력 |
|---|---|---|
devdive-video-wan30-t2v | 기본값. WAN 3.0, 문장으로 영상 만들기. 소리 켜고 끄기 가능 | prompt |
devdive-video-wan30-r2v | WAN 3.0, 시작·끝 장면을 정하거나 참고 이미지·영상·오디오로 만들기 | 장면(image_url)이나 참고 자료 중 하나 이상 |
devdive-video-happyhorse-t2v | HappyHorse 1.1, 문장으로 영상 만들기 | prompt |
devdive-video-happyhorse-i2v | HappyHorse 1.1, 사진을 첫 장면으로 움직이기 | prompt, image_url |
devdive-video-happyhorse-r2v | HappyHorse 1.1, 인물·사물 참고 이미지(1~9장)로 만들기 | prompt, reference_image_urls |
devdive-video-happyhorse-edit | HappyHorse 1.0, 있는 영상을 문장으로 고치기 | prompt, video_url |
devdive-video-wan-action | WAN, 사진 속 인물이 영상 속 동작을 따라 하기 | image_url, video_url (prompt는 받지 않음) |
음성·음악 모델
| 모델 ID | 엔드포인트 | 하는 일 |
|---|---|---|
devdive-tts-eleven | POST /v1/speech | 기본값. ElevenLabs로 글을 목소리로. voice_model로 eleven_v4(기본)나 eleven_v4_turbo(빠름)를 골라요 |
devdive-music | POST /v1/music | MiniMax로 가사를 노래로. version으로 엔진을 골라요(music-2.5 기본, music-3.0, music-2.0) |
→ 음성·음악
엔드포인트가 정해 둔 모델
아래 엔드포인트는 model을 고르지 않아요. 엔드포인트마다 정해진 모델이 일해요.
| 엔드포인트 | 쓰는 모델 | 고를 수 있는 것 |
|---|---|---|
POST /v1/transcriptions | Whisper | 언어(language) |
POST /v1/image-analyses | 데브다이브 이미지 분석 | 없음 |
POST /v1/document-analyses | 데브다이브 문서 분석 | 요약 또는 마크다운 변환(operation) |
POST /v1/search | Brave, Perplexity | 검색 엔진(engine) |
POST /v1/research | Perplexity Sonar | sonar(기본), 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에 넣는 값 |
type | text, 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 | 음악 모델. 고를 수 있는 엔진 버전 |
모델이 더해지거나 빠지면 변경 내역에 적어요.