AI 에이전트에서 바로 이미지와 영상을

클라이언트 연결

fa_live_your_key를 내 키로 바꾸세요. 공유 파일이나 저장소에는 키를 넣지 마세요.

claude mcp add --transport http flyaigh https://www.flyaigh.com/api/mcp \
  --header "Authorization: Bearer fa_live_your_key"

[mcp_servers.flyaigh]
url = "https://www.flyaigh.com/api/mcp"
bearer_token_env_var = "FLYAIGH_API_KEY"

{
  "mcpServers": {
    "flyaigh": {
      "url": "https://www.flyaigh.com/api/mcp",
      "headers": { "Authorization": "Bearer fa_live_your_key" }
    }
  }
}

npx -y mcp-remote https://www.flyaigh.com/api/mcp \
  --header "Authorization: Bearer fa_live_your_key"

도구

에이전트에는 8개 도구가 보입니다. 그중 2개만 크레딧을 쓰고 나머지는 조회만 합니다.

list_models

이미지·영상 모델 목록: 지원 모드, 길이, 해상도, 화면비, 참고 자료 한도와 예시 가격.

quote

요청에 드는 크레딧을 정확히 계산합니다. 실제 호출과 같은 검사와 가격을 쓰며 차감은 없습니다.

generate_image

이미지 생성: 텍스트로, 또는 참고 이미지를 바탕으로 편집. 크레딧을 씁니다.

generate_video

영상 생성: 텍스트, 첫 프레임, 첫·끝 프레임, 또는 참고 이미지·영상·오디오로. 크레딧을 씁니다.

get_job

작업 상태. 완료되면 다운로드 링크를 주고, 실패한 작업은 자동 환불됩니다.

list_my_generations

최근 생성물. 참고 자료로 다시 쓰거나 다시 내려받을 수 있습니다.

upload_file

내 이미지·영상·오디오를 올리고 참고 자료로 쓸 파일 ID를 받습니다.

get_balance

남은 크레딧, 구독 요금제, 이 키가 오늘과 이번 달에 쓴 양.

이렇게 요청해 보세요

FlyAIgh로 비 오는 밤거리를 종이배가 떠내려가는 5초짜리 9:16 영상을 만들어 줘. 먼저 가격을 보여 주고, 확인하면 생성해서 ./out에 저장해 줘.

좋은 에이전트는 quote를 호출해 확인을 받고, expected_credits와 idempotency_key를 붙여 생성한 뒤 파일이 준비될 때까지 get_job을 확인합니다.

가격과 한도

• 같은 모델·같은 설정이면 크레딧은 웹사이트와 같습니다. API 추가 요금도, 별도 청구서도 없습니다.
• 지출 한도는 크레딧 잔액입니다. MCP 페이지에서 키별 일일 한도를 따로 정할 수도 있으며, 기본값은 한도 없음입니다. 키별 일일 사용량도 MCP 페이지에서 볼 수 있습니다.
• quote 이후 가격이 바뀌면 차감하지 않고 새 가격을 돌려줍니다(expected_credits).
• 키마다 1분에 10개 작업까지 보낼 수 있어 폭주하는 루프도 금방 멈춥니다. 24시간 안에 같은 idempotency_key로 다시 시도해도 두 번 차감되지 않습니다.
• 업로드: 이미지 25MB, 영상 200MB, 오디오 30MB까지, base64 업로드는 3MB까지. 참고 자료로는 내 파일과 생성물만 쓸 수 있습니다.
• 실패한 작업은 자동 환불됩니다. 비공개 원본은 1시간 뒤 만료되는 서명된 링크로 제공됩니다.

자주 묻는 질문