메인 콘텐츠로 건너뛰기
새 계정에는 체험 크레딧 $0.05가 제공되므로, 충전하지 않고도 아래의 첫 호출을 할 수 있습니다. gpt-5.4-mini와 같은 경량 모델이면 통합이 제대로 작동하는지 확인하기에 충분합니다.

두 가지 경로, 하나를 선택하십시오

AI에게 맡기기

하나의 prompt를 Codex, Claude Code 또는 Cursor에 복사합니다. 문서를 읽고, 코드를 작성하고, 실행합니다. 이미 코딩 에이전트와 함께 작업하고 있다면 가장 적합합니다.

직접 해보기

등록하고, key를 만들고, 첫 API 호출을 수행합니다. 세 단계, 5분입니다. 각 부분을 이해하고 싶다면 가장 적합합니다.
두 경로는 모두 같은 방식으로 시작합니다: 계정을 등록하고 key를 직접 생성합니다. AI가 대신할 수 있는 것은 그 이후의 모든 것입니다 — 모델을 선택하고, base URL을 올바르게 설정하고, 예제를 작성하고, 디버깅하는 일입니다.

AI에게 맡기기

에이전트에 이 프롬프트 보내기

코딩 에이전트가 APIYI를 직접 통합하도록 합니다. Codex, Claude Code, Cursor 및 유사한 도구에 복사하여 붙여 넣으십시오.

수행할 작업

1

스킬을 설치하거나 skill.md를 직접 읽습니다

https://docs.apiyi.com/skill.md는 기계를 위해 작성된 통합 참조 문서로, 엔드포인트, 인증, 모델 명명 규칙, 알려진 문제 및 검증 체크리스트를 담고 있습니다. 이를 읽으면 에이전트가 APIYI를 통합하는 데 필요한 모든 정보를 얻을 수 있습니다.
2

필요한 페이지를 찾아봅니다

llms.txt는 이 사이트의 모든 페이지에 대한 색인입니다. 에이전트는 관련 페이지를 선택하고 .md를 추가하여 일반 텍스트로 읽습니다.
3

코드를 작성하고 실제로 실행합니다

문서의 Python 코드를 그대로 복사하는 대신, 프로젝트에서 기존에 사용하는 언어와 종속성으로 예제를 작성합니다. 호출이 성공하기 전에는 작업이 완료된 것으로 간주하지 않습니다.

AI에 제공할 수 있는 다섯 가지 진입점

코딩 에이전트를 위한 스킬, CLI 및 계약+레지스트리 경로는 모두 AI 개발자 키트에 설명되어 있습니다.
예를 들어 이 페이지의 일반 텍스트 버전은 https://docs.apiyi.com/en/getting-started.md입니다. 사이트의 모든 페이지에서 이 접미사를 지원합니다.

모든 페이지를 AI에 바로 보내기

모든 문서 페이지의 오른쪽 상단에는 페이지 복사 버튼이 있습니다. 버튼 옆의 화살표를 열면 더 많은 옵션이 표시됩니다. 문서 페이지 오른쪽 상단의 페이지 복사 메뉴입니다. 페이지 복사, Markdown으로 보기, ChatGPT, Claude, Perplexity 또는 Google AI Studio에서 열기 옵션이 표시됩니다 특정 모델에서 문제가 발생하면 가장 빠른 방법은 해당 모델의 페이지를 열고 페이지 복사를 누른 다음, 오류와 함께 AI에 보내는 것입니다.

직접 시작하기

1단계: 회원가입 및 키 발급

1

계정 생성

APIYI 웹사이트로 이동하여 이메일로 회원가입 및 인증을 완료한 후(대학교 또는 기업 이메일 주소 권장), 콘솔에 로그인합니다.
회원가입 직후 2FA 또는 Passkey를 연동하여 2단계 인증을 추가하십시오. 비밀번호가 유출되더라도 사용자의 기기나 일회용 인증 코드가 없으면 아무도 로그인할 수 없습니다. 몇 분이면 완료할 수 있으며, 자세한 내용은 계정 보안 유지 방법을 참고하십시오.
2

API 키 생성

token 페이지를 엽니다:
  1. 기본 token을 복사하여 바로 사용할 수 있습니다 (오른쪽 복사 아이콘)
  2. 또는 오른쪽 상단의 새로 만들기를 클릭하여 생성하고, 이름(예: test-key)을 지정한 후 확인을 누릅니다
키는 sk-(으)로 시작합니다. 자세한 내용은 키 생성 방법을 참고하십시오.
3

필요 시 충전

$0.05의 체험 크레딧이 모두 소진되면 콘솔에서 충전할 수 있습니다. 결제 채널에 따라 최소 금액 및 정산 규칙이 다르므로 결제 수단을 참고하십시오. 보너스 정책은 충전 프로모션에서 안내합니다.

2단계: 연결 정보 올바르게 설정하기

모델이 아닌 SDK를 기준으로 Base URL을 선택하십시오. 이는 가장 흔히 발생하는 연동 실수입니다:
base_url 끝에 후행 슬래시를 남기지 마십시오. 슬래시가 중복되어 404 오류가 발생합니다. 자세한 내용과 노드 선택 방법은 Base URL 설정을 참고하십시오.

3단계: 첫 번째 호출 실행하기

gpt-5 시리즈 이상에는 세 가지 매개변수 제한이 있습니다: temperature은(는) 반드시 1이어야 하고, max_tokens 대신 max_completion_tokens을(를) 사용해야 하며, top_p을(를) 전송해서는 안 됩니다.

다음 단계

Claude Code 연결

APIYI를 통해 ANTHROPIC_BASE_URL를 설정하고 Claude Code를 구동합니다

Codex 연결

하나의 config.toml가 데스크톱 앱, IDE 플러그인 및 CLI를 모두 지원합니다

모델 목록 살펴보기

지원되는 모든 모델과 기능 요약표입니다

API 매뉴얼 읽기

전체 엔드포인트 레퍼런스, 오류 코드 및 디버깅입니다

FAQ

모델을 어떻게 전환합니까?

요청에서 model 매개변수만 변경하면 됩니다:
모델 ID는 하이픈이 아니라 점을 사용합니다. 문서 URL의 하이픈은 URL 안전성을 위한 대체 표기이며, 실제 모델 ID에는 점이 그대로 유지됩니다. 페이지 /models/qwen3-7-max는 모델 ID qwen3.7-max에 해당합니다. gpt-5-4-mini로 작성하면 404가 반환되며, 올바른 형식은 gpt-5.4-mini입니다.잘 모르겠으면 다음과 같이 나열하십시오: GET https://api.apiyi.com/v1/models.

지원되는 프로그래밍 언어는 무엇입니까?

APIYI는 OpenAI API 표준과 호환되며 OpenAI SDK가 지원하는 모든 언어를 지원합니다:
  • Python
  • JavaScript/TypeScript
  • Java
  • C#/.NET
  • Go
  • Ruby
  • PHP
  • 그 외 더 많습니다…

잔액은 어떻게 확인합니까?

콘솔에 로그인하여 다음을 확인하십시오:
  • 계정 잔액
  • 사용 내역
  • 사용 통계
또한 API를 통해 프로그램으로 조회할 수도 있습니다:
  • 잔액 조회 API: API를 통해 계정 잔액, 만료일 등 더 많은 정보를 가져옵니다
  • 잔액 알림 설정: 잔액이 부족할 때 자동으로 알림을 받아 서비스 중단을 방지합니다

문제가 발생하면 어떻게 합니까?

  1. 문제가 발생한 페이지를 열고, 오른쪽 상단의 페이지 복사를 눌러 오류와 함께 AI에 보내십시오
  2. API 설명서를 확인하십시오
  3. 일반적인 오류를 검토하십시오
  4. 지원팀에 문의하십시오: [email protected]
팁: API key를 안전하게 보관하고 콘솔에서 사용 로그를 정기적으로 확인하십시오. 모든 요청에는 비용 최적화를 위한 메시지 내역이 포함됩니다. 잘 사용하시기 바랍니다!