Servers Playground How we check Add a server Log in

APICK AI

Working · 1.5 s

app.apick/aiv3.5.0 Domain verified

LLM chat, text tools, image generation, editing, batch image jobs, and asynchronous video generation

Design & Creative

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://apick.app/mcp/ai

Authorization (optional)

Bearer <APICK license key>. Get a free key with 1,000 free points at https://apick.app (tools/list works without a key).

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

image_batch_create

이미지 1~50장의 비동기 생성 또는 편집 작업을 접수합니다. 요금은 품질별 장당 고정가(기본 40P·고급 350P·최고급 1,400P)이며 장수만큼 선차감하고 실패한 장은 환급합니다. 같은 요청도 매번 새 작업으로 접수하며, 접수 후에는 취소할 수 없습니다. [장당 기본 40P · 고급 350P · 최고급 1,400P]

modestring, required

작업 방식

promptstring, required

생성 또는 편집 지시, 최대 28,000자

image_countinteger, required

만들 이미지 장수, 1~50

sizestring

표준 출력 크기, 기본 1024x1024

qualitystring

이미지 품질. basic(기본) 40P, advanced(고급) 350P, premium(최고급) 1,400P(장당). 기본 basic

image_urlstring

편집 모드에서 변경할 원본 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)

backgroundstring

배경 방식

output_formatstring

출력 포맷

reference_image_urlstring

생성 모드에서 사용할 참고 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

APICK AI MCP server | mcptry

APICK AI

Working · 1.5 s

app.apick/aiv3.5.0 Domain verified

LLM chat, text tools, image generation, editing, batch image jobs, and asynchronous video generation

Design & Creative

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://apick.app/mcp/ai

Authorization (optional)

Bearer <APICK license key>. Get a free key with 1,000 free points at https://apick.app (tools/list works without a key).

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

image_batch_create

modestring, required

작업 방식

promptstring, required

생성 또는 편집 지시, 최대 28,000자

image_countinteger, required

만들 이미지 장수, 1~50

sizestring

표준 출력 크기, 기본 1024x1024

qualitystring

이미지 품질. basic(기본) 40P, advanced(고급) 350P, premium(최고급) 1,400P(장당). 기본 basic

image_urlstring

편집 모드에서 변경할 원본 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)

backgroundstring

배경 방식

output_formatstring

출력 포맷

reference_image_urlstring

생성 모드에서 사용할 참고 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (15)

image_batch_create

Argument	Type	Description
mode*	string	작업 방식
size	string	표준 출력 크기, 기본 1024x1024
prompt*	string	생성 또는 편집 지시, 최대 28,000자
quality	string	이미지 품질. basic(기본) 40P, advanced(고급) 350P, premium(최고급) 1,400P(장당). 기본 basic
image_url	string	편집 모드에서 변경할 원본 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)
background	string	배경 방식
image_count*	integer	만들 이미지 장수, 1~50
output_format	string	출력 포맷
reference_image_url	string	생성 모드에서 사용할 참고 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "mode",
    "prompt",
    "image_count"
  ],
  "properties": {
    "mode": {
      "enum": [
        "generate",
        "edit"
      ],
      "type": "string",
      "description": "작업 방식"
    },
    "size": {
      "enum": [
        "1024x1024",
        "1536x1024",
        "1024x1536",
        "1152x864",
        "864x1152"
      ],
      "type": "string",
      "description": "표준 출력 크기, 기본 1024x1024"
    },
    "prompt": {
      "type": "string",
      "maxLength": 28000,
      "description": "생성 또는 편집 지시, 최대 28,000자"
    },
    "quality": {
      "enum": [
        "basic",
        "advanced",
        "premium"
      ],
      "type": "string",
      "description": "이미지 품질. basic(기본) 40P, advanced(고급) 350P, premium(최고급) 1,400P(장당). 기본 basic"
    },
    "image_url": {
      "type": "string",
      "description": "편집 모드에서 변경할 원본 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
    },
    "background": {
      "enum": [
        "auto",
        "opaque",
        "transparent"
      ],
      "type": "string",
      "description": "배경 방식"
    },
    "image_count": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "만들 이미지 장수, 1~50"
    },
    "output_format": {
      "enum": [
        "png",
        "jpeg",
        "webp"
      ],
      "type": "string",
      "description": "출력 포맷"
    },
    "reference_image_url": {
      "type": "string",
      "description": "생성 모드에서 사용할 참고 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
    }
  }
}

image_batch_result

완료된 대량 작업 결과 중 지정한 한 장을 이미지 콘텐츠로 반환합니다. [무료]

read-only

Argument	Type	Description
index*	integer	0부터 시작하는 이미지 번호
job_id*	string	작업 ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "job_id",
    "index"
  ],
  "properties": {
    "index": {
      "type": "integer",
      "maximum": 49,
      "minimum": 0,
      "description": "0부터 시작하는 이미지 번호"
    },
    "job_id": {
      "type": "string",
      "pattern": "^[a-f0-9]{32}$",
      "description": "작업 ID"
    }
  }
}

image_batch_status

대량 이미지 작업의 진행 상태, 선차감·환급·현재 차감 포인트를 조회합니다. [무료]

read-only

Argument	Type	Description
job_id*	string	작업 ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "pattern": "^[a-f0-9]{32}$",
      "description": "작업 ID"
    }
  }
}

image_edit

원본 이미지와 편집 지시로 이미지 한 장을 편집합니다. 요금은 품질별 장당 고정가(기본 40P·고급 350P·최고급 1,400P)이며, 같은 요청을 다시 보내도 매번 새로 편집하고 과금합니다. [장당 기본 40P · 고급 350P · 최고급 1,400P]

Argument	Type	Description
size	string	표준 출력 크기, 기본 1024x1024
prompt*	string	편집 지시, 최대 28,000자
quality	string	이미지 품질. basic(기본) 40P, advanced(고급) 350P, premium(최고급) 1,400P(장당). 기본 basic
image_url*	string	원본 이미지 — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)
background	string	배경 방식
output_format	string	출력 포맷

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "prompt",
    "image_url"
  ],
  "properties": {
    "size": {
      "enum": [
        "1024x1024",
        "1536x1024",
        "1024x1536",
        "1152x864",
        "864x1152"
      ],
      "type": "string",
      "description": "표준 출력 크기, 기본 1024x1024"
    },
    "prompt": {
      "type": "string",
      "maxLength": 28000,
      "description": "편집 지시, 최대 28,000자"
    },
    "quality": {
      "enum": [
        "basic",
        "advanced",
        "premium"
      ],
      "type": "string",
      "description": "이미지 품질. basic(기본) 40P, advanced(고급) 350P, premium(최고급) 1,400P(장당). 기본 basic"
    },
    "image_url": {
      "type": "string",
      "description": "원본 이미지 — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
    },
    "background": {
      "enum": [
        "auto",
        "opaque",
        "transparent"
      ],
      "type": "string",
      "description": "배경 방식"
    },
    "output_format": {
      "enum": [
        "png",
        "jpeg",
        "webp"
      ],
      "type": "string",
      "description": "출력 포맷"
    }
  }
}

image_generate

텍스트만 사용하거나 참고 이미지와 텍스트를 함께 사용해 이미지 한 장을 생성합니다. 요금은 품질별 장당 고정가(기본 40P·고급 350P·최고급 1,400P)이며, 같은 요청을 다시 보내도 매번 새로 생성하고 과금합니다. [장당 기본 40P · 고급 350P · 최고급 1,400P]

Argument	Type	Description
size	string	표준 이미지 크기, 기본 1024x1024
prompt*	string	생성 프롬프트, 최대 28,000자
quality	string	이미지 품질. basic(기본) 40P, advanced(고급) 350P, premium(최고급) 1,400P(장당). 기본 basic
background	string	배경 방식
output_format	string	출력 포맷
reference_image_url	string	새 이미지의 제품·인물·색감·구도 참고용 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "prompt"
  ],
  "properties": {
    "size": {
      "enum": [
        "1024x1024",
        "1536x1024",
        "1024x1536",
        "1152x864",
        "864x1152"
      ],
      "type": "string",
      "description": "표준 이미지 크기, 기본 1024x1024"
    },
    "prompt": {
      "type": "string",
      "maxLength": 28000,
      "description": "생성 프롬프트, 최대 28,000자"
    },
    "quality": {
      "enum": [
        "basic",
        "advanced",
        "premium"
      ],
      "type": "string",
      "description": "이미지 품질. basic(기본) 40P, advanced(고급) 350P, premium(최고급) 1,400P(장당). 기본 basic"
    },
    "background": {
      "enum": [
        "auto",
        "opaque",
        "transparent"
      ],
      "type": "string",
      "description": "배경 방식"
    },
    "output_format": {
      "enum": [
        "png",
        "jpeg",
        "webp"
      ],
      "type": "string",
      "description": "출력 포맷"
    },
    "reference_image_url": {
      "type": "string",
      "description": "새 이미지의 제품·인물·색감·구도 참고용 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
    }
  }
}

kling_jobs_create

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(초). 다른 버전은 개발가이드의 버전별 요금표 참고.]

Argument	Type	Description
mode	string	입력 방식 — 'text'(텍스트만) \| 'image'(첫 프레임 이미지 지정) \| 'reference'(참조 이미지·영상으로 주체 지정). 기본 text
tier	string	품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다.
audio	boolean	오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다.
prompt*	string	영상 생성 프롬프트, 최대 2,000자
version	string	영상 모델 버전. 생략 시 3.0. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요.
duration	integer	영상 길이(초), 전체 버전 범위 3~15. 허용 값과 기본값은 버전·등급별로 다릅니다.
cfg_scale	number	프롬프트 반영 강도(0~1), 기본 0.5
image_url	string	image 모드에서 사용할 첫 프레임 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)

kling_jobs_status

Check the status of a Kling video generation job submitted via kling_jobs_create. Kling 영상 작업의 진행 상태를 조회합니다. 완료되면 응답의 result_url(REST 다운로드 주소)로 안내하며, 결과는 완료 후 7일간 유효합니다. 무료입니다. [무료]

read-only

Argument	Type	Description
job_id*	string	작업 ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "pattern": "^[a-f0-9]{32}$",
      "description": "작업 ID"
    }
  }
}

llm_chat

Send a chat request to a selected LLM model and receive the assistant reply. 선택한 LLM 모델에 대화를 보내고 assistant 응답을 받습니다. 서버는 대화 히스토리를 보관하지 않는 stateless 방식 — 매 호출마다 전체 히스토리를 messages 로 전송하고, 응답의 compacted_messages 를 다음 턴의 messages 로 그대로 재사용합니다. 사용 가능한 모델은 llm_models Tool로 조회합니다. 한 요청 안에서 쓰인 토큰 사용량(긴 대화의 이전 내용을 정리하는 처리 포함)에 비례해 포인트가 차감됩니다. [모델별 토큰 단가 × 사용량(요청당 기본 5P)]

read-only

Argument	Type	Description
model*	string	모델 id (llm_models Tool로 조회 가능, 예: openai/gpt-oss-120b)
speed	string	응답 속도/추론 깊이 — 'fast'(얕게, 빠름) \| 'medium' \| 'slow'(깊게, 느림). 한글 '빠름'\|'중간'\|'느림' 허용. 추론 특화 모델에서 효과가 큽니다
system	string	system 프롬프트 (역할·페르소나·정책·배경지식). 미지정 시 기본 한국어 어시스턴트 프롬프트가 적용됩니다
compact	object	히스토리 압축 옵션 { strategy: 'none'(기본) \| 'sliding_window' \| 'relevance', window_pairs: 유지할 user/assistant 페어 수 (기본 10, 최소 1) }. relevance 는 최근 대화와 함께 최신 질문에 필요한 이전 대화를 골라 남긴다. 긴 대화의 input 토큰 누적 방지
content	string	단발 입력 — 사용자 메시지 한 건만 보내는 간편 형태. messages 와 둘 중 하나는 필수
messages	array	OpenAI 형식 [{role, content}] 배열. role 은 'system'\|'user'\|'assistant'. content 와 둘 중 하나는 필수, 동시 지정 시 messages 우선. 멀티턴 대화는 응답의 compacted_messages 를 다음 턴에 그대로 전송
max_tokens

llm_models

List available text-generation LLM models with per-token pricing and max context. 텍스트 생성 모델 카탈로그를 반환합니다. 각 모델의 1M 토큰당 input/output 단가(포인트), 계열·크기·멀티모달 여부·태그·추천 용도(use_cases)·max_context 를 한 응답에 포함합니다. llm_chat Tool의 model 입력값을 찾을 때 사용합니다. 무료입니다. [무료]

read-only

Argument	Type	Description
tag	string	특수 태그 필터 — 'reasoning'(추론 특화) \| 'coder'(코딩 특화)
family	string	모델 계열 필터 (deepseek, qwen, glm, google, nvidia, llama, mistral, gpt-oss, moonshot, seed, mimo, phi)
use_case	string	추천 용도 필터 — 'general' \| 'reasoning' \| 'coding' \| 'multimodal' \| 'economy'
multimodal	boolean	멀티모달(이미지 이해) 지원 여부 필터 (true/false)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "tag": {
      "type": "string",
      "description": "특수 태그 필터 — 'reasoning'(추론 특화) | 'coder'(코딩 특화)"
    },
    "family": {
      "type": "string",
      "description": "모델 계열 필터 (deepseek, qwen, glm, google, nvidia, llama, mistral, gpt-oss, moonshot, seed, mimo, phi)"
    },
    "use_case": {
      "type": "string",
      "description": "추천 용도 필터 — 'general' | 'reasoning' | 'coding' | 'multimodal' | 'economy'"
    },
    "multimodal": {
      "type": "boolean",
      "description": "멀티모달(이미지 이해) 지원 여부 필터 (true/false)"
    }
  }
}

seedance_jobs_create

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(초). 다른 버전은 개발가이드의 버전별 요금표 참고.]

Argument	Type	Description
mode	string	입력 방식 — 'text'(텍스트만) \| 'image'(첫 프레임 이미지 지정) \| 'reference'(참조 이미지·영상으로 주체 지정). 기본 text
seed	integer	재현성을 위한 시드 값
tier	string	품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다.
audio	boolean	오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다.
prompt*	string	영상 생성 프롬프트, 최대 2,000자
version	string	영상 모델 버전. 생략 시 2.5. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요.
duration	integer	영상 길이(초), 전체 버전 범위 2~30. 허용 값과 기본값은 버전·등급별로 다릅니다.
image_url	string	image 모드에서 사용할 첫 프레임 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)

seedance_jobs_status

Check the status of a Seedance video generation job submitted via seedance_jobs_create. Seedance 영상 작업의 진행 상태를 조회합니다. 완료되면 응답의 result_url(REST 다운로드 주소)로 안내하며, 결과는 완료 후 7일간 유효합니다. 무료입니다. [무료]

read-only

Argument	Type	Description
job_id*	string	작업 ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "pattern": "^[a-f0-9]{32}$",
      "description": "작업 ID"
    }
  }
}

text_polish

Polish a text (up to 100,000 characters) by fixing grammar, spelling, and awkward phrasing. 입력 텍스트(최대 10만 자)의 문법 오류, 맞춤법·오타, 어색한 표현, 문장 순서를 의미를 유지한 채 자연스럽게 다듬습니다. 모델·파라미터는 서버가 고정하며 빠른 응답에 최적화되어 있습니다. 요청당 기본 100포인트이며, 사용량 금액(모델별 단가 기준)이 더 크면 그 금액이 차감됩니다. [호출당 100포인트]

read-only

Argument	Type	Description
text*	string	다듬을 원문 텍스트 (최대 100,000자)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "다듬을 원문 텍스트 (최대 100,000자)"
    }
  }
}

text_summary

Summarize a long text (up to 100,000 characters) into a concise Korean summary. 입력 텍스트(최대 10만 자)의 핵심 내용을 간결하고 정확하게 요약합니다. 모델·파라미터는 서버가 고정하며 빠른 응답에 최적화되어 있습니다. 요청당 기본 100포인트이며, 사용량 금액(모델별 단가 기준)이 더 크면 그 금액이 차감됩니다. [호출당 100포인트]

read-only

Argument	Type	Description
text*	string	요약할 원문 텍스트 (최대 100,000자)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "요약할 원문 텍스트 (최대 100,000자)"
    }
  }
}

veo_jobs_create

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(초). 다른 버전은 개발가이드의 버전별 요금표 참고.]

Argument	Type	Description
mode	string	입력 방식 — 'text'(텍스트만) \| 'image'(첫 프레임 이미지 지정) \| 'reference'(참조 이미지·영상으로 주체 지정). 기본 text
seed	integer	재현성을 위한 시드 값
tier	string	품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다.
audio	boolean	오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다.
prompt*	string	영상 생성 프롬프트, 최대 2,000자
version	string	영상 모델 버전. 생략 시 3.1. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요.
duration	integer	영상 길이(초), 전체 버전 범위 4~8. 허용 값과 기본값은 버전·등급별로 다릅니다.
image_url	string	image 모드에서 사용할 첫 프레임 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)

veo_jobs_status

Check the status of a Veo video generation job submitted via veo_jobs_create. Veo 영상 작업의 진행 상태를 조회합니다. 완료되면 응답의 result_url(REST 다운로드 주소)로 안내하며, 결과는 완료 후 7일간 유효합니다. 무료입니다. [무료]

read-only

Argument	Type	Description
job_id*	string	작업 ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "pattern": "^[a-f0-9]{32}$",
      "description": "작업 ID"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "prompt"
  ],
  "properties": {
    "mode": {
      "enum": [
        "text",
        "image",
        "reference"
      ],
      "type": "string",
      "description": "입력 방식 — 'text'(텍스트만) | 'image'(첫 프레임 이미지 지정) | 'reference'(참조 이미지·영상으로 주체 지정). 기본 text"
    },
    "tier": {
      "enum": [
        "std",
        "pro",
        "turbo",
        "4k",
        "standard"
      ],
      "type": "string",
      "description": "품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다."
    },
    "audio": {
      "type": "boolean",
      "description": "오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다."
    },
    "prompt": {
      "type": "string",
      "maxLength": 2000,
      "description": "영상 생성 프롬프트, 최대 2,000자"
    },
    "version": {
      "enum": [
        "3.0",
        "o3",
        "o1"
      ],
      "type": "string",
      "description": "영상 모델 버전. 생략 시 3.0. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요."
    },
    "duration": {
      "type": "integer",
      "maximum": 15,
      "minimum": 3,
      "description": "영상 길이(초), 전체 버전 범위 3~15. 허용 값과 기본값은 버전·등급별로 다릅니다."
    },
    "cfg_scale": {
      "type": "number",
      "maximum": 1,
      "minimum": 0,
      "description": "프롬프트 반영 강도(0~1), 기본 0.5"
    },
    "image_url": {
      "type": "string",
      "description": "image 모드에서 사용할 첫 프레임 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
    },
    "resolution": {
      "enum": [
        "720p",
        "1080p",
        "720P",
        "1080P-SR",
        "1440P-SR",
        "1080P"
      ],
      "type": "string",
      "description": "출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다."
    },
    "aspect_ratio": {
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "type": "string",
      "description": "출력 화면 비율. 선택 버전·등급·모드에서 허용하는 값만 사용하세요."
    },
    "last_image_url": {
      "type": "string",
      "description": "image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]+$",
      "maxLength": 128,
      "minLength": 8,
      "description": "같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키"
    },
    "negative_prompt": {
      "type": "string",
      "maxLength": 1000,
      "description": "제외할 요소를 설명하는 텍스트"
    },
    "reference_image_url": {
      "type": "string",
      "description": "reference 모드에서 주체를 지정할 참조 이미지 URL — 다운로드 가능한 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_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_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)"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "model"
  ],
  "properties": {
    "model": {
      "type": "string",
      "description": "모델 id (llm_models Tool로 조회 가능, 예: openai/gpt-oss-120b)"
    },
    "speed": {
      "type": "string",
      "description": "응답 속도/추론 깊이 — 'fast'(얕게, 빠름) | 'medium' | 'slow'(깊게, 느림). 한글 '빠름'|'중간'|'느림' 허용. 추론 특화 모델에서 효과가 큽니다"
    },
    "system": {
      "type": "string",
      "description": "system 프롬프트 (역할·페르소나·정책·배경지식). 미지정 시 기본 한국어 어시스턴트 프롬프트가 적용됩니다"
    },
    "compact": {
      "type": "object",
      "description": "히스토리 압축 옵션 { strategy: 'none'(기본) | 'sliding_window' | 'relevance', window_pairs: 유지할 user/assistant 페어 수 (기본 10, 최소 1) }. relevance 는 최근 대화와 함께 최신 질문에 필요한 이전 대화를 골라 남긴다. 긴 대화의 input 토큰 누적 방지",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "content": {
      "type": "string",
      "description": "단발 입력 — 사용자 메시지 한 건만 보내는 간편 형태. messages 와 둘 중 하나는 필수"
    },
    "messages": {
      "type": "array",
      "items": {},
      "description": "OpenAI 형식 [{role, content}] 배열. role 은 'system'|'user'|'assistant'. content 와 둘 중 하나는 필수, 동시 지정 시 messages 우선. 멀티턴 대화는 응답의 compacted_messages 를 다음 턴에 그대로 전송"
    },
    "max_tokens": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "응답 최대 토큰. 미지정 시 모델 컨텍스트 기반 안전 상한으로 자동 설정, 명시한 값은 클램프 없이 그대로 적용"
    },
    "temperature": {
      "type": "number",
      "description": "출력 다양성 0.0~2.0. 낮을수록 재현성, 높을수록 창의성 (미지정 시 모델 기본값)"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "prompt"
  ],
  "properties": {
    "mode": {
      "enum": [
        "text",
        "image",
        "reference"
      ],
      "type": "string",
      "description": "입력 방식 — 'text'(텍스트만) | 'image'(첫 프레임 이미지 지정) | 'reference'(참조 이미지·영상으로 주체 지정). 기본 text"
    },
    "seed": {
      "type": "integer",
      "maximum": 2147483647,
      "minimum": 0,
      "description": "재현성을 위한 시드 값"
    },
    "tier": {
      "enum": [
        "standard",
        "fast",
        "mini",
        "pro"
      ],
      "type": "string",
      "description": "품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다."
    },
    "audio": {
      "type": "boolean",
      "description": "오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다."
    },
    "prompt": {
      "type": "string",
      "maxLength": 2000,
      "description": "영상 생성 프롬프트, 최대 2,000자"
    },
    "version": {
      "enum": [
        "2.5",
        "2.0",
        "1.5",
        "1.0"
      ],
      "type": "string",
      "description": "영상 모델 버전. 생략 시 2.5. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요."
    },
    "duration": {
      "type": "integer",
      "maximum": 30,
      "minimum": 2,
      "description": "영상 길이(초), 전체 버전 범위 2~30. 허용 값과 기본값은 버전·등급별로 다릅니다."
    },
    "image_url": {
      "type": "string",
      "description": "image 모드에서 사용할 첫 프레임 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
    },
    "resolution": {
      "enum": [
        "480p",
        "720p",
        "1080p"
      ],
      "type": "string",
      "description": "출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다."
    },
    "aspect_ratio": {
      "enum": [
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16",
        "21:9",
        "adaptive"
      ],
      "type": "string",
      "description": "출력 화면 비율. 선택 버전·등급·모드에서 허용하는 값만 사용하세요."
    },
    "last_image_url": {
      "type": "string",
      "description": "image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]+$",
      "maxLength": 128,
      "minLength": 8,
      "description": "같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키"
    },
    "reference_audio_url": {
      "type": "string",
      "description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
    },
    "reference_image_url": {
      "type": "string",
      "description": "reference 모드에서 주체를 지정할 참조 이미지 URL — 다운로드 가능한 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_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_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_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_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_audio_url_10": {
      "type": "string",
      "description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
    },
    "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_10": {
      "type": "string",
      "description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "prompt"
  ],
  "properties": {
    "mode": {
      "enum": [
        "text",
        "image",
        "reference"
      ],
      "type": "string",
      "description": "입력 방식 — 'text'(텍스트만) | 'image'(첫 프레임 이미지 지정) | 'reference'(참조 이미지·영상으로 주체 지정). 기본 text"
    },
    "seed": {
      "type": "integer",
      "maximum": 2147483647,
      "minimum": 0,
      "description": "재현성을 위한 시드 값"
    },
    "tier": {
      "enum": [
        "standard",
        "fast",
        "lite"
      ],
      "type": "string",
      "description": "품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다."
    },
    "audio": {
      "type": "boolean",
      "description": "오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다."
    },
    "prompt": {
      "type": "string",
      "maxLength": 2000,
      "description": "영상 생성 프롬프트, 최대 2,000자"
    },
    "version": {
      "enum": [
        "3.1"
      ],
      "type": "string",
      "description": "영상 모델 버전. 생략 시 3.1. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요."
    },
    "duration": {
      "type": "integer",
      "maximum": 8,
      "minimum": 4,
      "description": "영상 길이(초), 전체 버전 범위 4~8. 허용 값과 기본값은 버전·등급별로 다릅니다."
    },
    "image_url": {
      "type": "string",
      "description": "image 모드에서 사용할 첫 프레임 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
    },
    "resolution": {
      "enum": [
        "720p",
        "1080p",
        "4k"
      ],
      "type": "string",
      "description": "출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다."
    },
    "aspect_ratio": {
      "enum": [
        "16:9",
        "9:16"
      ],
      "type": "string",
      "description": "출력 화면 비율. 선택 버전·등급·모드에서 허용하는 값만 사용하세요."
    },
    "last_image_url": {
      "type": "string",
      "description": "image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]+$",
      "maxLength": 128,
      "minLength": 8,
      "description": "같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키"
    },
    "negative_prompt": {
      "type": "string",
      "maxLength": 1000,
      "description": "제외할 요소를 설명하는 텍스트"
    },
    "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)"
    }
  }
}