Modelflare Media Skill

Modelflare Media Skill은 설치 가능한 에이전트 스킬입니다. SKILL.md이 있는 폴더, 생성된 모델 참조 및 하나의 도우미 스크립트입니다. 에이전트의 기술 디렉터리에 있으면 Claude Code, Codex 또는 SKILL.md을 읽는 모든 에이전트는 Modelflare 이미지 또는 비디오 모델을 선택하고, 가격을 제시하고, 올바른 요청을 보내고, 비디오를 기다리고 결과를 저장하는 방법을 알고 있습니다.

패키지는 몇 분마다 라이브 모델 카탈로그에서 생성되므로 패키지의 모델 목록과 가격은 결코 오래되지 않습니다. 텍스트 모델은 의도적으로 범위를 벗어났습니다. 에이전트에 이미 텍스트 모델이 있습니다. 도우미 스크립트에는 Claude Code 및 Codex가 이미 요구하는 Node.js 18 이상만 필요하며 macOS, Windows 및 Linux에서 동일하게 작동합니다.

1. 설치

에이전트가 스킬을 어디에 보관하는지 알 필요가 없습니다. 대리인이 그렇습니다. 모든 상담원에게 동일한 메시지를 보냅니다.

Install this skill: https://modelflare.dev/skills/modelflare-media/modelflare-media.zip (or use the attached zip), then read its SKILL.md. If you do not support skills, extract it anywhere and follow SKILL.md. My key is in the environment variable MODELFLARE_API_KEY.

에이전트가 파일을 다운로드할 수 없는 경우 zip을 직접 다운로드하여 메시지에 첨부하세요. 스킬을 지원하는 에이전트(Claude Code, Codex 등)는 자신의 스킬 위치에 이를 설치합니다. 스킬 메커니즘이 없는 에이전트는 패키지를 추출한 모든 위치에서 SKILL.md를 계속 읽을 수 있습니다.

수동 설치(옵션)

예를 들어 공유 시스템이나 CI에 파일을 직접 배치하려는 경우에만 필요합니다.

curl -fsSL https://modelflare.dev/skills/modelflare-media/install.sh | sh

irm https://modelflare.dev/skills/modelflare-media/install.ps1 | iex

둘 다 ~/.claude/skills/modelflare-media(Windows의 경우 %USERPROFILE%\.claude\skills)에 설치되며 Claude Code는 이를 사용자 수준 기술로 읽습니다. 프로젝트 수준 복사본은 저장소 내부의 .claude/skills/에 들어갑니다. 다른 에이전트의 경우 먼저 SKILL_DIR를 해당 스킬 폴더로 설정하세요(정확한 경로는 해당 에이전트의 설명서 참조).

SKILL_DIR=~/.codex/skills curl -fsSL https://modelflare.dev/skills/modelflare-media/install.sh | sh

$env:SKILL_DIR = "$HOME\.codex\skills"; irm https://modelflare.dev/skills/modelflare-media/install.ps1 | iex

SKILL.md을 직접 읽어 에이전트가 무엇을 따를지 확인할 수도 있습니다.

2. 에이전트에게 키를 제공하세요

콘솔에서 API 키를 생성하고 에이전트가 실행되는 환경에 설정합니다. macOS 및 Linux에서는 내보내기를 셸 프로필에 추가하여 유지합니다. Windows에서는 두 번째 줄이 이를 지속시킵니다.

macOS 또는 Linux
윈도우 파워셸

export MODELFLARE_API_KEY="sk-..."

$env:MODELFLARE_API_KEY = "sk-..."
setx MODELFLARE_API_KEY "sk-..."

환경 변수를 직접 설정하는 것이 불편하다면 비공개 세션에서 신뢰할 수 있는 에이전트에 키를 보내고 환경을 구성하도록 요청할 수 있습니다. 키를 비밀번호처럼 취급하십시오. 에이전트가 작성할 내용과 위치를 확인하고 신뢰할 수 없는 서비스나 공개/공유 채팅, 문제, 저장소 또는 티켓으로 보내지 마십시오. 에이전트에게 키를 반복하거나 복사본을 저장하거나 소스 코드, 프롬프트, 로그 또는 셸 기록에 넣거나 커밋하지 않도록 요청하세요. 키가 노출되었다고 생각되면 즉시 키를 취소하고 새 키를 생성하세요.

이 스킬은 키를 파일이나 프롬프트에 쓰지 않으며 인쇄하지도 않습니다. Castaly를 통해 생성된 계정에는 잠금 해제된 모든 그룹을 통해 라우팅되는 Castaly이라는 키가 이미 있습니다. 이미지 또는 비디오 그룹이 있는 다른 키도 작동합니다.

3. 미디어 요청

평소처럼 에이전트와 대화하세요.

“gpt-image-2.을 사용하여 황혼 무렵 해안 관측소의 16:9 포스터를 생성합니다.”
“Seedance를 사용하여 이 시작 프레임을 5초 1080p 비디오로 변환합니다.”
“초당 0.10달러 미만의 비디오 모델 중 이미지를 비디오로 변환할 수 있는 모델은 무엇입니까?”

에이전트는 SKILL.md을 읽고 https://modelflare.dev/api/pricing에서 라이브 카탈로그를 가져와 키가 사용할 수 있는 모델과 비용을 확인한 다음 정확한 요청 본문, 매개변수 테이블 및 제한에 대해 문서 사이트에서 해당 모델의 자체 페이지를 열고 자체 HTTP 클라이언트로 API를 호출합니다. 모든 호출에는 X-Modelflare-Skill: modelflare-media/1.0 헤더가 포함되어 있으므로 사용 로그는 어떤 요청이 해당 스킬에서 나왔는지 표시합니다.

4. Castaly 작업대에서

Castaly 워크벤치의 모든 세대에는 설치 메시지, zip 및 작업 요약이 포함된 “Reproduce this in your own Agent” 패널이 있습니다. 설치 메시지를 한 번 보낸 다음 개요를 붙여넣으면 에이전트가 사용자의 키에 대해 동일한 모델과 매개변수를 재현합니다.

스킬이 하지 않는 것

에이전트에게 작업 방법을 알려주지 않습니다. 재시도, 일괄 처리 및 보고 내용은 귀하와 상담원 사이에 있습니다. 스킬은 API만 문서화합니다.
자체 모델 목록이 없습니다. 카탈로그와 모든 요청 계약서는 실시간으로 읽혀지므로 오늘 게시된 모델을 오늘 사용할 수 있습니다.
어떤 저장소에도 파일을 업로드하지 않습니다. 로컬 참조 이미지는 요청에 데이터 URL로 포함되므로 작게(몇 MB) 유지하세요.
모델 그룹을 잠금 해제할 수 없습니다. API가 model_unavailable으로 응답하면 이 계정에서는 해당 모델을 사용할 수 없습니다.

패키지 레이아웃

modelflare-media/
  SKILL.md   authentication, where the live catalog is, how to find each model's
             request contract on the docs site, and what the error codes mean

패키지에는 모델 데이터가 없으므로 오래되지 않습니다. 새로운 스킬 버전을 선택하기 위해서만 다시 설치하세요.