APICK AI
LLM chat, text tools, image generation, editing, batch image jobs, and asynchronous video generation
사용해야 할까요
품질 및 안전성
발견 사항 (6)
- LOWtext_polish에서
- LOWimage_generate에서
- LOWimage_edit에서
- LOWimage_batch_create에서
- LOWimage_batch_status에서
- LOWimage_batch_result에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"ai": {
"url": "https://apick.app/mcp/ai"
}
}
}원격 엔드포인트
https://apick.app/mcp/aistreamable-http할 수 있는 일
도구 목록
도구 (15)
🟢llm_models(family, tag, use_case, multimodal)
List available text-generation LLM models with per-token pricing and max context. 텍스트 생성 모델 카탈로그를 반환합니다. 각 모델의 1M 토큰당 input/output 단가(포인트), 계열·크기·멀티모달 여부·태그·추천 용도(use_cases)·max_context 를 한 응답에 포함합니다. llm_chat Tool의 model 입력값을 찾을 때 사용합니다. 무료입니다. [무료]
입력 스키마
{
"type": "object",
"properties": {
"family": {
"type": "string",
"description": "모델 계열 필터 (deepseek, qwen, glm, google, nvidia, llama, mistral, gpt-oss, moonshot, seed, mimo, phi)"
},
"tag": {
"type": "string",
"description": "특수 태그 필터 — 'reasoning'(추론 특화) | 'coder'(코딩 특화)"
},
"use_case": {
"type": "string",
"description": "추천 용도 필터 — 'general' | 'reasoning' | 'coding' | 'multimodal' | 'economy'"
},
"multimodal": {
"type": "boolean",
"description": "멀티모달(이미지 이해) 지원 여부 필터 (true/false)"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢llm_chat(model, messages, content, system, compact, ...)
Send a chat request to a selected LLM model and receive the assistant reply. 선택한 LLM 모델에 대화를 보내고 assistant 응답을 받습니다. 서버는 대화 히스토리를 보관하지 않는 stateless 방식 — 매 호출마다 전체 히스토리를 messages 로 전송하고, 응답의 compacted_messages 를 다음 턴의 messages 로 그대로 재사용합니다. 사용 가능한 모델은 llm_models Tool로 조회합니다. 토큰 사용량에 비례해 포인트가 차감됩니다. [무료]
입력 스키마
{
"type": "object",
"properties": {
"model": {
"type": "string",
"description": "모델 id (llm_models Tool로 조회 가능, 예: openai/gpt-oss-120b)"
},
"messages": {
"type": "array",
"items": {},
"description": "OpenAI 형식 [{role, content}] 배열. role 은 'system'|'user'|'assistant'. content 와 둘 중 하나는 필수, 동시 지정 시 messages 우선. 멀티턴 대화는 응답의 compacted_messages 를 다음 턴에 그대로 전송"
},
"content": {
"type": "string",
"description": "단발 입력 — 사용자 메시지 한 건만 보내는 간편 형태. messages 와 둘 중 하나는 필수"
},
"system": {
"type": "string",
"description": "system 프롬프트 (역할·페르소나·정책·배경지식). 미지정 시 기본 한국어 어시스턴트 프롬프트가 적용됩니다"
},
"compact": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "히스토리 압축 옵션 { strategy: 'none'(기본) | 'sliding_window', window_pairs: 유지할 user/assistant 페어 수 (기본 10, 최소 1) }. 긴 대화의 input 토큰 누적 방지"
},
"temperature": {
"type": "number",
"description": "출력 다양성 0.0~2.0. 낮을수록 재현성, 높을수록 창의성 (미지정 시 모델 기본값)"
},
"max_tokens": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "응답 최대 토큰. 미지정 시 모델 컨텍스트 기반 안전 상한으로 자동 설정, 상한 초과 지정 시 자동 조정"
},
"speed": {
"type": "string",
"description": "응답 속도/추론 깊이 — 'fast'(얕게, 빠름) | 'medium' | 'slow'(깊게, 느림). 한글 '빠름'|'중간'|'느림' 허용. 추론 특화 모델에서 효과가 큽니다"
}
},
"required": [
"model"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢text_summary(text)
Summarize a long text (up to 100,000 characters) into a concise Korean summary. 입력 텍스트(최대 10만 자)의 핵심 내용을 간결하고 정확하게 요약합니다. 모델·파라미터는 서버가 고정하며 빠른 응답에 최적화되어 있습니다. 토큰 수와 무관하게 요청당 고정 포인트가 차감됩니다. [호출당 100포인트]
입력 스키마
{
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "요약할 원문 텍스트 (최대 100,000자)"
}
},
"required": [
"text"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢text_polish(text)
Polish a text (up to 100,000 characters) by fixing grammar, spelling, and awkward phrasing. 입력 텍스트(최대 10만 자)의 문법 오류, 맞춤법·오타, 어색한 표현, 문장 순서를 의미를 유지한 채 자연스럽게 다듬습니다. 모델·파라미터는 서버가 고정하며 빠른 응답에 최적화되어 있습니다. 토큰 수와 무관하게 요청당 고정 포인트가 차감됩니다. [호출당 100포인트]
입력 스키마
{
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "다듬을 원문 텍스트 (최대 100,000자)"
}
},
"required": [
"text"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}⚪image_generate(prompt, size, output_format, background, idempotency_key, ...)
텍스트만 사용하거나 참고 이미지와 텍스트를 함께 사용해 이미지 한 장을 생성합니다. 참고 이미지는 제품·인물·색감·구도를 이해하기 위한 자료이며 결과는 새 이미지로 만들어집니다. 장당 40포인트입니다. [이미지당 40포인트]
입력 스키마
{
"type": "object",
"properties": {
"prompt": {
"type": "string",
"maxLength": 28000,
"description": "생성 프롬프트, 최대 28,000자"
},
"size": {
"type": "string",
"enum": [
"1024x1024",
"1536x1024",
"1024x1536",
"1152x864",
"864x1152"
],
"description": "표준 이미지 크기, 기본 1024x1024"
},
"output_format": {
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
],
"description": "출력 포맷"
},
"background": {
"type": "string",
"enum": [
"auto",
"opaque",
"transparent"
],
"description": "배경 방식"
},
"idempotency_key": {
"type": "string",
"minLength": 8,
"maxLength": 128,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "같은 요청의 재전송으로 인한 중복 생성·과금을 막는 고유 키"
},
"reference_image_url": {
"type": "string",
"description": "새 이미지의 제품·인물·색감·구도 참고용 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
}
},
"required": [
"prompt"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡image_edit(prompt, size, output_format, background, idempotency_key, ...)
원본 이미지와 편집 지시로 이미지 한 장을 편집하고 이미지 콘텐츠로 반환합니다. 장당 40포인트입니다. [이미지당 40포인트]
입력 스키마
{
"type": "object",
"properties": {
"prompt": {
"type": "string",
"maxLength": 28000,
"description": "편집 지시, 최대 28,000자"
},
"size": {
"type": "string",
"enum": [
"1024x1024",
"1536x1024",
"1024x1536",
"1152x864",
"864x1152"
],
"description": "표준 출력 크기, 기본 1024x1024"
},
"output_format": {
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
],
"description": "출력 포맷"
},
"background": {
"type": "string",
"enum": [
"auto",
"opaque",
"transparent"
],
"description": "배경 방식"
},
"idempotency_key": {
"type": "string",
"minLength": 8,
"maxLength": 128,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "같은 요청의 재전송으로 인한 중복 생성·과금을 막는 고유 키"
},
"image_url": {
"type": "string",
"description": "원본 이미지 — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
}
},
"required": [
"prompt",
"image_url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡image_batch_create(mode, prompt, image_count, size, output_format, ...)
이미지 1~50장의 비동기 생성 또는 편집 작업을 접수합니다. 접수 즉시 장수×40포인트가 선차감되고 실패한 이미지의 포인트는 즉시 환급됩니다. 접수 후에는 취소할 수 없습니다. [이미지당 40포인트]
입력 스키마
{
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"generate",
"edit"
],
"description": "작업 방식"
},
"prompt": {
"type": "string",
"maxLength": 28000,
"description": "생성 또는 편집 지시, 최대 28,000자"
},
"image_count": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"description": "만들 이미지 장수, 1~50"
},
"size": {
"type": "string",
"enum": [
"1024x1024",
"1536x1024",
"1024x1536",
"1152x864",
"864x1152"
],
"description": "표준 출력 크기, 기본 1024x1024"
},
"output_format": {
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
],
"description": "출력 포맷"
},
"background": {
"type": "string",
"enum": [
"auto",
"opaque",
"transparent"
],
"description": "배경 방식"
},
"idempotency_key": {
"type": "string",
"minLength": 8,
"maxLength": 128,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "같은 요청의 재전송으로 인한 중복 생성·과금을 막는 고유 키"
},
"reference_image_url": {
"type": "string",
"description": "생성 모드에서 사용할 참고 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"image_url": {
"type": "string",
"description": "편집 모드에서 변경할 원본 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
}
},
"required": [
"mode",
"prompt",
"image_count"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢image_batch_status(job_id)
대량 이미지 작업의 진행 상태, 선차감·환급·현재 차감 포인트를 조회합니다. [무료]
입력 스키마
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "작업 ID"
}
},
"required": [
"job_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢image_batch_result(job_id, index)
완료된 대량 작업 결과 중 지정한 한 장을 이미지 콘텐츠로 반환합니다. [무료]
입력 스키마
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "작업 ID"
},
"index": {
"type": "integer",
"minimum": 0,
"maximum": 49,
"description": "0부터 시작하는 이미지 번호"
}
},
"required": [
"job_id",
"index"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡seedance_jobs_create(version, prompt, mode, duration, aspect_ratio, ...)
Submit an asynchronous Seedance video generation job. Select version and tier; supported modes, durations and prices depend on the selected version. Seedance 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, seedance_jobs_status Tool로 상태를 조회하고 완료되면 응답의 result_url(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 duration × 초당 포인트(해상도별로 다름, resolution 참고)가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다. [기본 버전 기준: 초당 480p 560P·720p 1,250P·1080p 2,810P × duration(초). 다른 버전은 개발가이드의 버전별 요금표 참고.]
입력 스키마
{
"type": "object",
"properties": {
"version": {
"type": "string",
"enum": [
"2.5",
"2.0",
"1.5",
"1.0"
],
"description": "영상 모델 버전. 생략 시 2.5. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요."
},
"prompt": {
"type": "string",
"maxLength": 2000,
"description": "영상 생성 프롬프트, 최대 2,000자"
},
"mode": {
"type": "string",
"enum": [
"text",
"image",
"reference"
],
"description": "입력 방식 — 'text'(텍스트만) | 'image'(첫 프레임 이미지 지정) | 'reference'(참조 이미지·영상으로 주체 지정). 기본 text"
},
"duration": {
"type": "integer",
"minimum": 2,
"maximum": 30,
"description": "영상 길이(초), 전체 버전 범위 2~30. 허용 값과 기본값은 버전·등급별로 다릅니다."
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"4:3",
"1:1",
"3:4",
"9:16",
"21:9",
"adaptive"
],
"description": "출력 화면 비율. 선택 버전·등급·모드에서 허용하는 값만 사용하세요."
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p",
"1080p"
],
"description": "출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다."
},
"audio": {
"type": "boolean",
"description": "오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다."
},
"tier": {
"type": "string",
"enum": [
"standard",
"fast",
"mini",
"pro"
],
"description": "품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다."
},
"seed": {
"type": "integer",
"minimum": 0,
"maximum": 2147483647,
"description": "재현성을 위한 시드 값"
},
"idempotency_key": {
"type": "string",
"minLength": 8,
"maxLength": 128,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키"
},
"image_url": {
"type": "string",
"description": "image 모드에서 사용할 첫 프레임 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"last_image_url": {
"type": "string",
"description": "image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url": {
"type": "string",
"description": "reference 모드에서 주체를 지정할 참조 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_2": {
"type": "string",
"description": "reference 모드 참조 이미지 URL(2번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_3": {
"type": "string",
"description": "reference 모드 참조 이미지 URL(3번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_video_url": {
"type": "string",
"description": "reference 모드에서 동작을 참조할 영상 URL — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 50MB)"
},
"reference_image_url_4": {
"type": "string",
"description": "참조 이미지 URL(4번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_5": {
"type": "string",
"description": "참조 이미지 URL(5번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_6": {
"type": "string",
"description": "참조 이미지 URL(6번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_7": {
"type": "string",
"description": "참조 이미지 URL(7번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_8": {
"type": "string",
"description": "참조 이미지 URL(8번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_9": {
"type": "string",
"description": "참조 이미지 URL(9번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_10": {
"type": "string",
"description": "참조 이미지 URL(10번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_11": {
"type": "string",
"description": "참조 이미지 URL(11번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_12": {
"type": "string",
"description": "참조 이미지 URL(12번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_13": {
"type": "string",
"description": "참조 이미지 URL(13번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_14": {
"type": "string",
"description": "참조 이미지 URL(14번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_15": {
"type": "string",
"description": "참조 이미지 URL(15번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_16": {
"type": "string",
"description": "참조 이미지 URL(16번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_17": {
"type": "string",
"description": "참조 이미지 URL(17번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_18": {
"type": "string",
"description": "참조 이미지 URL(18번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_19": {
"type": "string",
"description": "참조 이미지 URL(19번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_20": {
"type": "string",
"description": "참조 이미지 URL(20번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_21": {
"type": "string",
"description": "참조 이미지 URL(21번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_22": {
"type": "string",
"description": "참조 이미지 URL(22번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_23": {
"type": "string",
"description": "참조 이미지 URL(23번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_24": {
"type": "string",
"description": "참조 이미지 URL(24번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_25": {
"type": "string",
"description": "참조 이미지 URL(25번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_26": {
"type": "string",
"description": "참조 이미지 URL(26번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_27": {
"type": "string",
"description": "참조 이미지 URL(27번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_28": {
"type": "string",
"description": "참조 이미지 URL(28번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_29": {
"type": "string",
"description": "참조 이미지 URL(29번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_30": {
"type": "string",
"description": "참조 이미지 URL(30번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_video_url_2": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_3": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_4": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_5": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_6": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_7": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_8": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_9": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_10": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_audio_url": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_2": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_3": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_4": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_5": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_6": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_7": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_8": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_9": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_10": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
}
},
"required": [
"prompt"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢seedance_jobs_status(job_id)
Check the status of a Seedance video generation job submitted via seedance_jobs_create. Seedance 영상 작업의 진행 상태를 조회합니다. 완료되면 응답의 result_url(REST 다운로드 주소)로 안내하며, 결과는 완료 후 7일간 유효합니다. 무료입니다. [무료]
입력 스키마
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "작업 ID"
}
},
"required": [
"job_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡veo_jobs_create(version, prompt, mode, duration, aspect_ratio, ...)
Submit an asynchronous Veo video generation job. Select version and tier; supported modes, durations and prices depend on the selected version. Veo 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, veo_jobs_status Tool로 상태를 조회하고 완료되면 응답의 result_url(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 duration × 초당 900포인트가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다. [기본 버전 기준: 초당 900포인트 × duration(초). 다른 버전은 개발가이드의 버전별 요금표 참고.]
입력 스키마
{
"type": "object",
"properties": {
"version": {
"type": "string",
"enum": [
"3.1"
],
"description": "영상 모델 버전. 생략 시 3.1. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요."
},
"prompt": {
"type": "string",
"maxLength": 2000,
"description": "영상 생성 프롬프트, 최대 2,000자"
},
"mode": {
"type": "string",
"enum": [
"text",
"image",
"reference"
],
"description": "입력 방식 — 'text'(텍스트만) | 'image'(첫 프레임 이미지 지정) | 'reference'(참조 이미지·영상으로 주체 지정). 기본 text"
},
"duration": {
"type": "integer",
"minimum": 4,
"maximum": 8,
"description": "영상 길이(초), 전체 버전 범위 4~8. 허용 값과 기본값은 버전·등급별로 다릅니다."
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16"
],
"description": "출력 화면 비율. 선택 버전·등급·모드에서 허용하는 값만 사용하세요."
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p",
"4k"
],
"description": "출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다."
},
"audio": {
"type": "boolean",
"description": "오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다."
},
"tier": {
"type": "string",
"enum": [
"standard",
"fast",
"lite"
],
"description": "품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다."
},
"negative_prompt": {
"type": "string",
"maxLength": 1000,
"description": "제외할 요소를 설명하는 텍스트"
},
"seed": {
"type": "integer",
"minimum": 0,
"maximum": 2147483647,
"description": "재현성을 위한 시드 값"
},
"idempotency_key": {
"type": "string",
"minLength": 8,
"maxLength": 128,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키"
},
"image_url": {
"type": "string",
"description": "image 모드에서 사용할 첫 프레임 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"last_image_url": {
"type": "string",
"description": "image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url": {
"type": "string",
"description": "reference 모드에서 주체를 지정할 참조 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_2": {
"type": "string",
"description": "reference 모드 참조 이미지 URL(2번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_3": {
"type": "string",
"description": "reference 모드 참조 이미지 URL(3번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
}
},
"required": [
"prompt"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢veo_jobs_status(job_id)
Check the status of a Veo video generation job submitted via veo_jobs_create. Veo 영상 작업의 진행 상태를 조회합니다. 완료되면 응답의 result_url(REST 다운로드 주소)로 안내하며, 결과는 완료 후 7일간 유효합니다. 무료입니다. [무료]
입력 스키마
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "작업 ID"
}
},
"required": [
"job_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡kling_jobs_create(version, prompt, mode, duration, aspect_ratio, ...)
Submit an asynchronous Kling video generation job. Select version and tier; supported modes, durations and prices depend on the selected version. Kling 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, kling_jobs_status Tool로 상태를 조회하고 완료되면 응답의 result_url(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 duration × 초당 410포인트가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다. [기본 버전 기준: 초당 410포인트 × duration(초). 다른 버전은 개발가이드의 버전별 요금표 참고.]
입력 스키마
{
"type": "object",
"properties": {
"version": {
"type": "string",
"enum": [
"3.0",
"o3",
"o1",
"2.6",
"2.5",
"2.1",
"2.0",
"1.6"
],
"description": "영상 모델 버전. 생략 시 3.0. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요."
},
"prompt": {
"type": "string",
"maxLength": 2000,
"description": "영상 생성 프롬프트, 최대 2,000자"
},
"mode": {
"type": "string",
"enum": [
"text",
"image",
"reference"
],
"description": "입력 방식 — 'text'(텍스트만) | 'image'(첫 프레임 이미지 지정) | 'reference'(참조 이미지·영상으로 주체 지정). 기본 text"
},
"duration": {
"type": "integer",
"minimum": 3,
"maximum": 15,
"description": "영상 길이(초), 전체 버전 범위 3~15. 허용 값과 기본값은 버전·등급별로 다릅니다."
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
],
"description": "출력 화면 비율. 선택 버전·등급·모드에서 허용하는 값만 사용하세요."
},
"resolution": {
"type": "string",
"enum": [
"720p",
"1080p",
"720P",
"1080P-SR",
"1440P-SR",
"1080P"
],
"description": "출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다."
},
"audio": {
"type": "boolean",
"description": "오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다."
},
"tier": {
"type": "string",
"enum": [
"std",
"pro",
"turbo",
"4k",
"standard",
"master"
],
"description": "품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다."
},
"negative_prompt": {
"type": "string",
"maxLength": 1000,
"description": "제외할 요소를 설명하는 텍스트"
},
"cfg_scale": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "프롬프트 반영 강도(0~1), 기본 0.5"
},
"idempotency_key": {
"type": "string",
"minLength": 8,
"maxLength": 128,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키"
},
"image_url": {
"type": "string",
"description": "image 모드에서 사용할 첫 프레임 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
},
"last_image_url": {
"type": "string",
"description": "image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
},
"reference_image_url": {
"type": "string",
"description": "reference 모드에서 주체를 지정할 참조 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
},
"reference_image_url_2": {
"type": "string",
"description": "reference 모드 참조 이미지 URL(2번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
},
"reference_image_url_3": {
"type": "string",
"description": "reference 모드 참조 이미지 URL(3번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
},
"reference_image_url_4": {
"type": "string",
"description": "참조 이미지 URL(4번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
},
"reference_image_url_5": {
"type": "string",
"description": "참조 이미지 URL(5번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
},
"reference_image_url_6": {
"type": "string",
"description": "참조 이미지 URL(6번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
},
"reference_image_url_7": {
"type": "string",
"description": "참조 이미지 URL(7번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
},
"reference_video_url": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_2": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_3": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_4": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
}
},
"required": [
"prompt"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢kling_jobs_status(job_id)
Check the status of a Kling video generation job submitted via kling_jobs_create. Kling 영상 작업의 진행 상태를 조회합니다. 완료되면 응답의 result_url(REST 다운로드 주소)로 안내하며, 결과는 완료 후 7일간 유효합니다. 무료입니다. [무료]
입력 스키마
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "작업 ID"
}
},
"required": [
"job_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}커뮤니티
증거