한 문장으로 시작하기
아래 문장을 AI Agent에게 보내세요:agents.md는 Agent가 직접 실행하도록 작성된 연동 가이드입니다: API Key 확인, 실시간 카탈로그에서 모델 선택, 프로토콜별 호출, 엔드투엔드 검증 단계를 담고 있으며 문제 해결 표도 포함합니다.
엔트리 개요
모델별 llms.txt
모든 모델에는 가격, 검증된 기능 목록, 지원 프로토콜 엔드포인트, 실행 가능한 예제를 포함한 기계 판독형 호출 가이드가 있습니다:llms.txt 탭에서 해당 파일을 바로 열 수 있습니다. 아직 검증이 완료되지 않은 모델은 실시간 카탈로그와 파라미터 schema를 안내하는 문서를 반환하며, 검증되지 않은 기능 설명은 포함하지 않습니다.
Playground Skill
Playground의 기능(모델 체험, 파라미터 조정, 동일 프롬프트 비교, 이미지 및 비디오 생성, 딥링크 전달)을 Agent에게 맡기세요:/.well-known/skills/aihubmix-playground/SKILL.md에도 게시되어 있으며, GitHub 저장소를 통해 npx skills add AIhubmix/skills 명령으로 설치할 수도 있습니다. 연동 및 통합 시나리오에는 AIHubMix API Skill을 사용하세요.
Playground 딥링크
Agent는 사용자가 브라우저에서 이미 구성된 Playground 세션을 이어받을 수 있도록 바로가기 링크를 생성할 수 있습니다:- 다중 모델 비교:
https://playground.aihubmix.com/?models=gemini-3.7-flash,claude-opus-4-1(최대 6개) - 구성 바로가기:
https://playground.aihubmix.com/?config=<base64url로 인코딩된 JSON>, JSON 형식은{"model": "...", "proto": "chat", "params": {...}, "system": "...", "draft": "..."}이며,draft는 입력창에 미리 채워질 뿐 전송되지 않습니다
코드 생성
npm 패키지@aihubmix/codegen은 4개 프로토콜, 7개 언어의 프로그래밍 방식 코드 생성을 제공하며, 생성되는 요청 본문은 Playground가 실제로 전송하는 요청 본문과 동일합니다. @aihubmix/model-schema는 파라미터 schema를 codegen 입력으로 변환합니다.
자주 묻는 질문
Agent는 연동 성공을 어떻게 검증하나요?
agents.md에는 엔드투엔드 검증 단계가 포함되어 있습니다: 정확한 응답을 요구하는 최소 요청을 보내고, 응답 본문과 모델의 회신 내용을 확인합니다. HTTP 200이 곧 성공을 의미하지 않으므로 응답 내용을 반드시 확인해야 합니다.
호출에는 어떤 자격 증명이 필요한가요?
AIHubMix API Key 하나가 필요하며, 환경 변수AIHUBMIX_API_KEY로 전달합니다. Key는 콘솔에서 생성할 수 있습니다. Key를 코드, 스크립트, 대화에 작성하지 마세요.
모델별 llms.txt는 어떤 모델을 지원하나요?
검증이 완료된 모델은 전체 문서(공식 검증 데이터 기반의 기능 목록)를 반환하며, 나머지 모델은 안내 문서를 반환합니다. 지원 범위는 검증 진행에 따라 확대됩니다.현재 MCP 지원 상황은 어떤가요?
MCP 엔드포인트는 현재 이미지 생성 서비스를 제공하며, 기능 확장이 진행 중입니다. 현재 단계에서는 Skill과 agents.md를 우선 사용해 연동하는 것을 권장합니다.마지막 업데이트: 2026-08-20