계정과 키는 여전히 콘솔에서 직접 생성해야 합니다. “키가 있습니다”부터 “코드가 작동합니다”까지의 모든 과정은 아래 세 가지 경로 중 하나를 통해 AI에 위임할 수 있습니다.
경로 선택
스킬 · 채팅 에이전트
OpenClaw, Claude Code 및 스킬 시스템을 사용하는 기타 에이전트입니다. 스킬을 한 번 설치한 후 자연어로 APIYI를 호출합니다.
CLI · 터미널
코드가 필요 없습니다. 터미널에서 키를 확인하고, 모델을 나열하고, 메시지를 전송하고, 이미지를 생성합니다.
npx apiyi@latest check 설치가 필요 없습니다.개발자 키트 · 코딩 에이전트
Cursor, Claude Code 및 Codex는 통합 코드를 작성하기 전에 계약과 모델 레지스트리를 읽습니다. 존재하지 않는 엔드포인트를 임의로 만들지 않습니다.
키트에는 무엇이 포함되어 있습니까
모든 파일은 공개되어 있습니다. 로그인이 필요하지 않으며, 모든 에이전트가 직접 가져올 수 있습니다.코딩 에이전트를 위한 규칙
코딩 에이전트에서 가장 흔한 실패는 잘못된 코드가 아닙니다. 기억에 의존해 작성하는 것입니다. 존재하지 않는 엔드포인트를 만들어 내거나,gpt-5-4-mini 대신 gpt-5.4-mini을 입력하거나, Anthropic SDK 기본 URL에 불필요한 /v1을 추가하는 경우입니다. 다음 5가지 규칙으로 이를 방지할 수 있습니다.
- 엔드포인트, 매개변수 이름, 열거형 값 또는 응답 형태를 만들어 내지 마십시오.
skill.md엔드포인트 표에 있는 경로만 사용하십시오. 매개변수는 사용 중인 프로토콜(OpenAI, Anthropic 또는 Gemini)의 공식 정의를 따릅니다. model-registry.json은 모델 ID의 단일 기준입니다. ID는 점으로 버전이 구분되며 대소문자를 구분합니다. 문서 URL의 하이픈은 URL에서 안전하게 사용하기 위한 대체 표기일 뿐 모델 ID가 아닙니다.- 모델이 아니라 SDK에 따라 기본 URL을 선택하십시오. OpenAI SDK는
https://api.apiyi.com/v1을 사용하고, Anthropic SDK는 루트https://api.apiyi.com를 사용하며, Google GenAI SDK는api_version을v1beta로 설정한 루트를 사용합니다. - 키는
APIYI_API_KEY환경 변수에서만 읽으십시오. 키를 코드에 직접 입력하거나, 커밋하거나, 채팅에 붙여 넣지 마십시오. - 먼저 설명한 다음 편집하십시오. 에이전트가 사용할 엔드포인트, 모델 및 타임아웃을 명시하도록 하십시오. 확인한 후에만 코드를 편집합니다.
Cursor, Claude Code, Codex 및 기타 코딩 에이전트를 위한 전체 프롬프트입니다. 있는 그대로 복사하여 붙여 넣으십시오.
이 프롬프트가 방지하는 문제
이 프롬프트가 방지하는 문제
스킬
스킬은skill.md 그 자체입니다. 이는 머신을 위해 작성된 통합 레퍼런스입니다. 설치하면 에이전트는 APIYI를 호출해야 할 때마다 이 규칙을 기억합니다. 설치 방법은 세 가지입니다.
- npx 스킬(일반)
- OpenClaw
- 수동 복사
Claude Code, Cursor, Codex 및 Agent Skills 사양을 지원하는 기타 모든 도구에서 사용할 수 있습니다.검색은 이 사이트의
/.well-known/agent-skills/index.json를 통해 수행됩니다. 이 작업은 스크립트 없이 skill.md 자체를 설치합니다. 자체 점검에는 npx apiyi@latest check을 사용합니다.OpenClaw, Claude Code, Cursor 및 스킬을 지원하는 기타 에이전트용입니다. 있는 그대로 복사하여 붙여 넣습니다.
키가 에이전트에 전달되는 방식
- 환경 변수
APIYI_API_KEY이 먼저 사용됩니다. 스킬, CLI 및 이 문서의 모든 예시는 여기에서 해당 값을 읽습니다. - OpenClaw은
~/.openclaw/openclaw.json의skills.entries.apiyi.apiKey에 키를 저장하고 런타임에APIYI_API_KEY로 주입합니다. 이것이 스킬 frontmatter의primaryEnv필드에서 선언하는 내용입니다. 파일 구조는 OpenClaw 구성 파일을 참조하십시오. - CLI은
npx apiyi@latest auth set-key을 사용하여 해당 키를~/.config/apiyi/config.json에 모드 0600으로 저장합니다.
자체 점검 상태
스킬 스크립트, CLI 및 수동 curl은 모두 동일한 상태 집합을 반환합니다.CLI
코드를 작성하지 않고 터미널에서 첫 번째 호출을 실행할 수 있습니다. Node 18 이상이면 설치할 항목이 없습니다.터미널 명령을 실행할 수 있는 에이전트에서 실행하거나, 직접 해당 줄을 실행하십시오.
명령어
전역 플래그:
--api-key, --node api|vip|b|cf(노드 선택), --base-url, --timeout, --json(기계 판독 가능한 출력).
키 조회 순서
--api-key 플래그, APIYI_API_KEY 환경 변수, ~/.config/apiyi/config.json, OpenClaw의 ~/.openclaw/openclaw.json 순서로 조회합니다. OpenClaw 스킬을 이미 설치했다면 CLI가 해당 키를 재사용합니다.
종료 코드
스크립트와 에이전트는 텍스트를 파싱하는 대신 종료 코드를 기준으로 분기합니다.
소스는
github.com/apiyi-com/cli에 있으며 npm 패키지는 apiyi입니다. 문서에서는 항상 npx apiyi@latest을(를) 작성합니다. npx이(가) 이전 버전을 캐시하기 때문입니다.
model-registry.json 필드
model pricing 페이지와 동일한 데이터에서 가격표가 새로 고쳐질 때마다 재생성됩니다. 최상위 필드:
각 모델 항목:
레지스트리의 가격은 정가입니다. 충전 보너스와 그룹 할인이 포함되지 않으며, 실제 과금은 콘솔을 따릅니다. 그룹에 대한 설명은 그룹 설명을 참조하십시오.
관련 페이지
시작하기
두 가지 방법이 있습니다. AI에 통합을 맡기거나 직접 수행할 수 있습니다.
원클릭 통합이 지원됩니까?
버튼을 제공하는 대신 문서를 AI에 전달하는 방식으로 지원됩니다.
OpenClaw
오픈 소스 로컬 AI 어시스턴트입니다. 스킬을 설치하면 자연어로 APIYI를 호출합니다.
모델 가격
공급업체별로 그룹화하고 등급별 가격을 적용한 레지스트리의 사람이 읽기 쉬운 버전입니다.