Communitygithub.com

imaginevid-ai-generation

ImagineVid의 인증된 에이전트 생성 도구를 사용하여 AI 이미지, AI 비디오, AI 음악을 생성합니다. 사용자가 미디어 생성, ImagineVid 기능 선택, 로컬 자산 업로드, 크레딧 견적, 생성 제출 또는 상태 확인을 요청할 때 사용합니다.

imaginevid-ai-generation란 무엇인가요?

이 스킬은 ImagineVid 플랫폼의 에이전트 기반 생성 도구를 통해 AI 이미지, AI 비디오, AI 음악을 생성하는 방법을 제공합니다. ImagineVid의 공개 MCP(Skill)는 `https://imaginevid.io/api/mcp`에 OAuth 원격 MCP가 연결되어 있다고 가정합니다. 호스트가 OAuth 및 동의를 처리하도록 하고, 사용자에게 액세스 토큰을 붙여넣거나 자격 증명을 요청하지 않습니다. 이 스킬은 여러 AI 모델에 걸친 공급자 중립적인 기능 카탈로그를 통해 작동하며, `models_list`, `generation_quote`, `generation_create`, `generation_get`, `credits_get`의 다섯 가지 안정적인 에이전트 도구를 사용합니다. 사용자 워크플로우는 기능 발견, 자산 업로드(필요시), 견적, 사용자 확인, 단일 생성 제출, 상태 폴링으로 구성됩니다. 가드레일은 중복 생성 방지, 크레딧 부족 시 오류 처리, 인증 문제 처리 등을 포함합니다. 이 스킬은 Claude Code, Cursor, Codex 등 OAuth 원격 MCP를 지원하는 모든 호스트에서 작동합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imagineVid/agent-skills/tree/main/skills/imaginevid-ai-generation

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

ImagineVid AI 생성

기능 카탈로그를 사용하고, 공급자별 API를 사용하지 마십시오. 이 공개 스킬은 호스트가 https://imaginevid.io/api/mcp에 ImagineVid의 OAuth 원격 MCP를 연결했다고 가정합니다. 호스트가 OAuth 및 동의를 처리하도록 하십시오. 사용자에게 액세스 토큰을 붙여넣거나 프롬프트에서 자격 증명을 처리하도록 요청하지 마십시오. 공급자 엔드포인트, 콜백 URL, 원시 공급자 매개변수 또는 전체 개인 계정 식별자를 절대 노출하지 마십시오.

원격 MCP가 연결되지 않은 경우 중지하고 사용자에게 호스트의 OAuth 흐름을 통해 연결하도록 요청하십시오. 임의의 API 엔드포인트를 대체하지 마십시오.

ImagineVid 정보

ImagineVid는 AI 이미지, AI 비디오 및 AI 음악을 생성하기 위한 AI 생성 플랫폼입니다. 에이전트 인터페이스는 5개의 안정적인 에이전트 도구를 통해 성장하는 공급자 중립적인 기능 카탈로그를 노출하므로, 연결된 에이전트가 공급자별 API를 하나씩 하드 코딩하지 않고도 다양한 최신 모델 및 생성 도구를 검색하고 사용할 수 있습니다.

워크플로우

  1. 발견. 요청된 기능(image, video 또는 music)이 알려진 경우 models_list를 호출하십시오. 반환된 안정적인 기능 id를 선택하고, 이를 capabilityId로 이후 도구에 전달하고, 반환된 필드, 기본값 및 제약 조건을 사용하십시오. 카탈로그가 반환하지 않은 모델이나 기능을 임의로 만들지 마십시오.
  2. 소유 자산 준비. 로컬 미디어가 필요한 경우, 신뢰할 수 있는 호스트 업로드 표면 또는 ImagineVid CLI 업로드 명령(해당 CLI가 이미 설치된 경우)을 사용하십시오. 반환된 소유자 범위의 assetId를 유지하십시오. MCP assetIds 필드를 통해 자산 ID를 전달하고, 로컬 파일 시스템 경로, 임의의 원격 URL 또는 큰 Base64 페이로드를 절대 전달하지 마십시오.
  3. 견적. 선택한 capabilityId, 제품 values 및 assetIds 객체를 별도로 사용하여 generation_quote를 호출하십시오. 생성 단계를 위해 정확한 prompt, values 및 assetIds 요청을 유지하십시오. quotedCredits와 서버가 반환한 정규화된 요청을 권위 있는 것으로 간주하십시오. 로컬에서 가격을 계산하거나 선택하지 마십시오. 사용자가 사용 가능한 잔액을 보거나 호스트가 사전 점검을 필요로 할 때만 credits_get을 사용하십시오.
  4. 확인. generation_create 전에 선택한 기능, 중요한 값/자산 및 정확한 quotedCredits를 표시하십시오. 해당 금액을 지출하는 데 대한 명시적인 승인을 사람에게 요청하십시오. 생성하라는 모호한 요청은 크레딧 확인이 아닙니다. 서버가 quote_changed를 보고하면 새 견적을 표시하고 다시 물어보십시오.
  5. 한 번 생성. generation_create를 호출하기 전에 안정적인 clientRequestId를 생성하십시오. 견적에 사용된 것과 동일한 capabilityId, prompt, values 및 assetIds를 확인된 견적과 동일한 confirmedCredits와 함께 보내십시오. 해당 요청에 대해 정확히 한 번 제출하십시오. 동일한 ID는 동일한 요청을 재생하는 데에만 재사용하십시오. 다른 입력에는 새로 견적된 요청과 새 ID가 필요합니다. 시간 초과, 네트워크 모호성 또는 공급자 시간 초과 후에는 재시도하지 마십시오.
  6. 폴링. 반환된 소유 generationId를 사용하여 간격을 늘리면서 generation_get을 호출하십시오. 반환된 상태, 안전한 오류 및 결과 URL/메타데이터만 보고하십시오. 도구가 반환하지 않은 모델, 출력 또는 성공을 주장하지 마십시오. submission_unknown을 특수 모호한 결과로 처리하십시오. 다시 생성하지 말고, 내구성 있는 ID를 사용할 수 있을 때 계속 폴링하십시오.

가드레일

  • submission_unknown은 공급자가 해당 제출을 수락했을 수 있음을 의미합니다. 재시도하지 말고 환불하지 마십시오. 내구성 있는 생성 ID가 반환된 경우 계속 폴링하고, 그렇지 않으면 운영자 후속 조치를 위해 모호성을 보고하십시오.
  • insufficient_credits는 워크플로우를 중지합니다. 재시도하거나, 자동으로 다운그레이드하거나, 로컬에서 계산된 가격을 제안하지 마십시오.
  • unauthorized 및 forbidden_scope는 사용자가 인증하거나 필요한 범위를 부여해야 합니다. 세션 쿠키나 다른 사용자의 자격 증명으로 우회하지 마십시오.
  • invalid_input, capability_not_found, asset_not_found 및 asset_expired는 요청을 수정하거나 새 소유 자산을 업로드해야 합니다. 공급자 URL을 대체하지 마십시오.
  • idempotency_conflict는 요청 ID가 다른 입력과 함께 사용되었음을 의미합니다. 기존 요청을 덮어쓰지 마십시오. 수정된 요청을 새 안정적인 ID로 다시 견적하십시오.
  • 공급자 오류가 중복이 안전하다는 증거는 아닙니다. 안전한 서버 오류를 표시하고 새로운 사람의 승인 시도를 기다리십시오.

정확한 요청/응답 필드 및 안정적인 오류 어휘는 references/tool-contract.md를 읽으십시오. 참조는 와이어 계약 지원 도구이며, 라이브 기능 카탈로그를 대체하지 않습니다.

관련 스킬